Organizer control events

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Organizer control

Events managed by default (window control)
Events with procedures for quick use
Advanced use of events with procedures
Optional events

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Organizer control events

Events managed by default (window control)

The following events appear by default in the WINDEV and WINDEV Mobile code editor:

Event	Runtime condition

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

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

On the "Window" tab, in the "Order" group, click "Initialization".
In the window that appears, use the arrows on the right to change the order in which the controls are initialized.

Events with procedures for quick use

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

when using the context 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 the appointment variable (Appointment variable) as parameter. All the characteristics of the appointment handled by the context menu, by the mouse or fingertips are automatically assigned to this variable.

Example: To store an appointment added by the user via the context menu in an APT data file, simply write the following in the "Enter input mode in an appointment" event:

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 procedures

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 "Entry in edit in an appointment" event. To lock the direct input via the context menu of the Organizer control, the event must return False.

This principle can be applied to all the events called by the context 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
RETURN False

Optional events

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

Select the desired 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.
Note: Several optional events can be selected.
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.
Note: If the deactivated code contains WLanguage code, this code is automatically deleted..

For example, you can use the following events:

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

For more details, see the Optional events.