Events
Use
There are different types of events. On the one hand, there are events that enable the application to intervene directly in the behavior of the calendar ( action events). On the other hand, there are events that are used on the appointment maintenance screens to obtain additional information on an appointment from external sources and to display this information in the appointment processing dialogs in a subarea defined for it ( information events). The information can then be processed, either by double-clicking on this additional info area itself or by using an additional info button that has also been created, or read (in display mode of the calendar). There is normally a whole sequence of different events within one scenario.
In the case of action events, ERROR_MESSAGE-MSG_VAR1 is used as the interface parameter of the exit function module. A control command (OK-Code) for the calendar is transferred to this parameter. Data exchange for information events occurs using the table parameter TEXT.
Use of Action Events
The following action events are processed when the specified actions are executed:
|
Control Event |
Action |
|
c_event_copy |
Copy appointment. |
|
c_event_create(*) |
Create appointment. |
|
c_event_cut |
Cut appointment. |
|
c_event_delete |
Delete appointment. |
|
c_event_to_modify |
Change appointment. |
|
c_event_to_move |
Move appointment. |
|
c_event_to_display |
Display appointment. |
|
c_event_mark |
Select appointment. |
|
'CHECK' |
Check appointment during creation. |
(*)occurs both as an action event and as an information event.
The control parameter ERROR_MESSAGE-VAR1 currently supports the value 'EXIT'. If it is set whilst events are being processed, the calendar does not continue to behave as normal after the exit module has been called. In this case, the dialog box Change appointment would no longer be displayed after the event c_event_to_modify and a confirmation prompt would not appear after the event c_event_delete, for example. Further processing by the calendar should be suppressed if it has already been carried out by the application within the exit.
Use of Information Events
The following information events can be used:
|
Control Event |
Action |
|
c_event_create(*) |
Select an appointment type for the appointment; Generate additional information. |
|
c_event_modify |
Change additional information. |
|
c_event_descript |
Obtain additional information. |
|
c_event_display |
Create or refresh calendar. Display appointment. Display additional information. |
|
c_event_read |
Obtain additional information in display mode. |
(*)occurs both as an action event and as an information event.
The table TEXT is interpreted for the different information events as follows:
|
Event |
Text |
|||
|
Row 1 |
Row 2 |
Row 3 |
Row 4 |
|
|
c_event_create |
3-line info text in the additional info frame. |
|||
|
c_event_modify |
3-line info text in the additional info frame. |
|||
|
c_event_descript |
Title. Additional info box. |
Text. Additional info button. |
Icon. Additional info button. |
Quick info. Additional info button. |
|
c_event_display |
3-line info text in the additional info frame. |
|||
|
c_event_read |
3-line info text in the additional info frame. |