Events associated with an Organizer control

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Organizer control

Events associated with an Organizer control

Events managed by default (window control)

Optional events

See also

Events associated with an Organizer control

Events managed by default (window control)

WINDEV and WINDEV Mobile manage the following events by default (order of appearance in the code editor):

Event	Runtime condition

Initializing	Run when the window is opened. *
Before creating the appointment	Run when selecting "New appointment" in the popup menu of Organizer control.
Entry in edit in an appointment	Run when selecting "New appointment" in the popup menu of Organizer control. This event is run immediately after the event "Before creating the appointment".
Exit from input for the appointment	Run during the exit from appointment input (exit when adding an appointment or when modifying an appointment via the popup menu for example).
Selecting an appointment	Run when selecting an existing appointment in the Organizer control. This event is executed when the popup menu opens.
Moving an appointment	Run when moving an appointment in the Organizer control (move performed with the mouse for example).
Resizing an appointment	Run when resizing an appointment in the Organizer control (resize operation performed with the mouse for example).
Deleting an appointment	Run when selecting "Delete the appointment" from the popup menu of Organizer control.
Range selection	Run when selecting a time range in the Organizer control.
Whenever changing period	Run when modifying the period displayed in the Organizer control.
Versions 17 and later Whenever changing the display mode New in version 17 Whenever changing the display mode Whenever changing the display mode	Run when the user changes the display mode of Organizer control. The new mode can be known in this event via OrganizerMode.

(*) By default, the event "Initializing" of each control is run according to the order in which the controls were created in the window. To modify this runtime order:

On the "Window" pane, in the "Order" group, click "Initialization".
In the window that is displayed, use the arrows on the right to modify the initialization order of controls.

Events with procedures for quick use

Most of the events associated with the Organizer control are run:

when using the popup menu of the Organizer control.
when using the mouse or the fingertips.

To simplify the operations performed on the appointments of an Organizer control, several procedures are proposed in each event. These procedures take in parameter the appointment variable (Appointment variable) to use. All the characteristics of the appointment handled by the popup menu, by the mouse or fingertips are automatically assigned to this variable.

Example: To store an appointment added by the user via the popup menu in an APT data file, simply write the following in the event "Entry in edit in an appointment":

PROCEDURE Edit(aptEdited is Appointment)

// Store the data
APT.Title = aptEdited..Title
APT.StartDate = aptEdited..StartDate
APT.EndDate = aptEdited..EndDate
...
HAdd(APT)

Advanced use of events with procedure

You can also allow the user to define more precisely the characteristics of his appointment during an addition or a modification.

To do so, create a window with the information to specify.

In the code, simply open the window in the event "Entry in edit in an appointment". To lock the direct input via the popup menu of the Organizer control, the event must return False.

This principle can be applied to all the events called by the popup menu of the Organizer control.

Example:

PROCEDURE Edit(aptEdited is Appointment)

// Opens the window for entering an appointment
// with the selected appointment (in Creation or Modification mode)
Open(WIN_InputAPT_HFSQL, aptEdited)

// Returns False to lock the direct input in the Organizer control
RESULT False

Optional events

Several optional events can be managed. To add an optional event:

Select the requested control.
Display the code window of this control (F2 key).
Click the link "Add other events to xxx" at the bottom of the window code, after the last event.
All the optional events available for the control are displayed.
Check the optional event to add and validate.
Remark: You can select several optional events.
The selected optional event is automatically added to the events managed by the control.

To disable an optional event, simply perform the same operations to display the list of optional events. Then simply uncheck the optional events to delete.
Remark: If the disabled code contains WLanguage code, this code is automatically deleted.

You can manage, for example:

the mouse hover over the control,
the left mouse button down, up, with a double click,
right mouse button down, up, with double click,
the mouse wheel, etc.

See Optional events for more details.