![]() ![]() ![]() ![]() Gravitybox Schedule Primer
Page 42
1998-2004 Gravitybox Software LLC
After the user has been prompted for the move (or perhaps not prompted) and the
appointments properties have been modified, the AfterMove event is raised. Any
cleanup, saving, etc that needs to be done after an appointment move may be
performed here. This event has a single parameter, which is a reference to the newly
moved appointment object.
Coping
A copy is special case of move. A copy will add another
ScheduleItem object to the ScheduleItems collection and
set its StartTime, Date, and Room properties to the new
position. The original appointment will not be changed. The
Copy action is accomplished by holding the <CTRL> key
while dragging an appointment. If the user presses the <CTRL> key while dragging, he
will notice that the mouse pointer has changed from a normal arrow, to an arrow with a
plus sign. This indicates that there will be an extra appointment added to the schedule,
by performing this action.
Much like moving an appointment, coping raises its own sequence of events. The first
event that is raised is the BeforeDrag event, just like the move operation. As with the
previous, there is a Cancel parameter and a drop operation parameter. The
DragOverScheduleItem event is raised every time the mouse moves while dragging an
appointment. The DragDropScheduleItem event is then raised to inform that something
was dropped on the schedule.
The next event in sequence is the BeforeCopy event. This event is raised so that any
code that needs to be executed, before a copy is performed, is done so. It also has a
DoPrompt parameter, which is a Boolean value that determines whether the user will be
prompted, for a copy confirmation. Also remember the schedule property ConflictWarn
allows for the determination of whether the user is prompted about conflicts.
After the user has been prompted for the copy and the appointments properties have
been modified, the AfterCopy event is raised. Any cleanup, saving, etc that needs to be
executed, after an appointment copy, is performed here. This event has a single
parameter, which is a reference to the newly copied appointment object.
Editing
The user may edit an appointment, in a variety of ways. The most common way is to
double-click the appointment, for the display of its property box. This assumes that the
AllowEdit property is set to true. The default property box will display the StartTime,
Length, Room, Date, Category, and DisplayText for the selected appointment. There is
also a Notes tab that allows the user to associate some additional text to an
appointment.
Quick Tip
To copy an appointment, press the
<CTRL> button and move an
appointment. When dropping the
appointment, a new one will be
created and the original one will not
be removed, thus a copy.
|