Navigation bar
  Home Print document Start Previous page
 109 of 234 
Next page End  

Gravitybox Schedule Primer
Page 107 
1998-2004 Gravitybox Software LLC
Chapter 12
Advanced Functionality
The schedule also contains some advanced functionality. This functionality allows you
to create routines that perform some complex actions. There may be times when you
may need to blackout appointments or zoom in on areas of a schedule. Perhaps you
need to associate people (Providers) with appointments or relate additional categories.
No matter your need, the schedule component probably provides the required
functionality with a minimal amount of code.
AllowInterWindowDrop
Depending on the properties AllowMove and AllowCopy, the
schedule may or may not allow their related actions. If the
schedule does allow them, the user may move (or copy)
appointments too any valid area of the schedule. There may
be times that two or more schedules may be open and information needs to be shared
between them. This is possible, if the AllowInterWindowDrop schedule property is true.
Two windows or even two separate applications each with a GbSchedule, may share
information. Just drag an appointment and move the mouse to the destination window.
There is no NoDrop pointer because the move is perfectly valid. When the user drops
the appointment, it will disappear from the source window and reappear on the
destination window. If this is a copy, the source appointment will not disappear.
Activities and Events
Activities and events are non-traditional appointments. Instead of having a start time
and length that keeps an appointment confined to a column or row these objects have
differing ways of displaying information. First an event is an appointment with no start
time and no length. It takes place on a day or in a room. If you try to access its
StartTime property you will get 12:00 AM or the default time. Also its length will be 0.
However its IsEvent property will be set and this is what makes it an event. Events are
displayed at the top of the screen and are only displayed when days (or and days and
rooms) are displayed on the top of the schedule and time is displayed on the left. The
appointments mark an event for the day such as a birthday. The event does not happen
at a specific time nor does it have a specific length. All that is known is that is occurs on
an explicit date.
Unlike an event, an activity does have a specific time and
length. What differentiates it is that these two properties
combined cause the appointment to over lap a day
boundary. The appointment takes up 2 or more columns and for this reason is actually
displayed at the top of the screen in the event header. You can make a distinction
Quick Tip
Appointments may be dragged and
dropped to other schedules if the
“AllowInterWindowDrop” property is
set to True.
Quick Tip
To allow the user to create multi-day
appointments, set the AllowActivities
property to True.
http://www.purepage.com