PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Events managed by default
  • Events managed by WINDEV and WINDEV Mobile
  • Events managed by WEBDEV
  • Events with procedures
  • Advanced use of events with procedure
  • Optional events
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Events managed by default
WINDEVAndroidiPhone/iPad

Events managed by WINDEV and WINDEV Mobile

Versions 21 and later
Android The Scheduler controls are available for the Android applications.
iPhone/iPad The Scheduler controls are available for the iPhone/iPad applications.
New in version 21
Android The Scheduler controls are available for the Android applications.
iPhone/iPad The Scheduler controls are available for the iPhone/iPad applications.
Android The Scheduler controls are available for the Android applications.
iPhone/iPad The Scheduler controls are available for the iPhone/iPad applications.
WINDEV and WINDEV Mobile manage the following events by default (in order of appearance in the code editor):
EventRuntime condition
InitializingRun when opening the window. *
Before creating the appointmentRun:
  • WINDEV when "New appointment" is selected from the popup menu of Scheduler control.
  • during the direct input of a new appointment via the keyboard.
AndroidiPhone/iPad To create an appointment ("Allow the direct input of an appointment" option in the "Details" tab of the description window of control):
  • Click the Scheduler control: the selected period is highlighted and a "+" sign is displayed.
  • Click the "+" sign: the event "Before creating the appointment" is run. The appointment passed in parameter contains the start and end dates of the appointment. If this event returns nothing or True, the appointment is added and the Scheduler control is refreshed.
WINDEV Enter an appointment in input
Run:
  • when "New appointment" is selected from the popup menu of Scheduler control.
  • during the direct input of a new appointment via the keyboard.
This event is run immediately after the event "Before creating the appointment".
WINDEV 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 appointmentRun when an existing appointment is selected in the Scheduler control.
Moving an appointmentRun when an appointment is moved in the Scheduler control.
WINDEV This event is run at the end of the movement with the mouse (when the mouse is "released").
Versions 22 and later
Note: The move performed is canceled if this event runs the following code line:
RESULT False
New in version 22
Note: The move performed is canceled if this event runs the following code line:
RESULT False
Note: The move performed is canceled if this event runs the following code line:
RESULT False
AndroidiPhone/iPad To move an appointment, a long press must be performed: the appointment switches to move mode and it can be moved with the finger toward its destination. This event is run at the end of the move.
WINDEV Resizing an appointment
Run when resizing an appointment in the Scheduler control (resize operation performed with the mouse for example). This event is run at the end of the resize (when the mouse is "released").
WINDEV Deleting an appointment
Run:
  • when "Delete the appointment" is selected from the popup menu of Scheduler control.
  • when an appointment is deleted via the DEL key of keyboard.
WINDEV Selecting a period
Run when selecting a time period in the Scheduler control (click performed on a time range for example). When several time ranges are selected with the mouse, the event is run for each new selected range.
Whenever changing period
WINDEV Run when modifying the period displayed in the Scheduler control (via the arrow buttons found at the top left of Scheduler control or when the period is changed by programming with SchedulerDisplayPreviousPeriod and SchedulerDisplayNextPeriod).
AndroidiPhone/iPad Run when modifying the period displayed in the Scheduler control (swipe performed in the Scheduler control or when the period is changed by programming with SchedulerDisplayPreviousPeriod and SchedulerDisplayNextPeriod).
Reassigning an appointmentRun when moving an appointment triggers the modification of the resource associated with the appointment.
Versions 17 and later
WINDEV Whenever changing the display mode
New in version 17
WINDEV Whenever changing the display mode
WINDEV Whenever changing the display mode
Run when the user changes the display mode of the Scheduler control. The new mode can be known in this event via SchedulerMode.

(*) By default, the "Initializing" event of each control is run according to the order in which the controls were created in the window. To modify this runtime order:
  1. Select "Windows .. Edit the initialization order".On the "Window" pane, in the "Order" group, click "Initialization".
  2. In the window that is displayed, use the arrows on the right to modify the initialization order of controls.
WEBDEV - Server code

Events managed by WEBDEV

WEBDEV manages the following events by default (in order of appearance in the code editor):
EventRuntime condition
Initialization (server code)Run when opening the page.
Moving an appointment (server code)Run when an appointment is moved in the Scheduler control. This event is run at the end of the movement with the mouse (when the mouse is "released").
Resizing an appointment (server code)Run when resizing an appointment in the Scheduler control (resize operation performed with the mouse for example). This event is run at the end of the resize (when the mouse is "released").
Deleting an appointment (server code)Run when the appointment is deleted. This deletion is performed when clicking the icon for appointment deletion (the red cross) displayed on the right of selected appointment.
Before creating the appointment (server code)Run during the direct input of a new appointment with the keyboard. To perform the direct input, all you have to do is double-click the appointment and type its title.
Exit from appointment input (server code)Run during the exiting from appointment input (exit when adding an appointment or when modifying an appointment for example). This exit corresponds to the [ENTER] key pressed to validate the input.
Whenever the period changes (server code)Run when the period displayed in the Scheduler control is modified (via the arrow buttons found at the top left of Scheduler control).
Reassigning an appointment (server code)Run when moving an appointment triggers the modification of the resource associated with the appointment.
Selecting an appointment (browser code)Run when an existing appointment is selected in the Scheduler control.
Moving an appointment (browser code)Run when an appointment is moved in the Scheduler control. This event is run at the end of the movement with the mouse (when the mouse is "released").
Resizing an appointment (browser code)Run when resizing an appointment in the Scheduler control (resize operation performed with the mouse for example). This event is run at the end of the resize (when the mouse is "released").
Selecting a period (browser code)Run when a time range is selected in the Scheduler control.
Deleting an appointment (browser code)Run when the appointment is deleted. This deletion is performed when clicking the icon for appointment deletion (the red cross) displayed on the right of selected appointment.
Before creating the appointment (browser code)Run during the direct input of a new appointment with the keyboard. To perform the direct input, all you have to do is double-click the appointment and type its title.
Enter an appointment in input (browser code)Run during the direct input of the appointment. To perform the direct input, all you have to do is double-click the appointment and type its title. This event is run after the event "Before creating the appointment".
Exit from appointment input (browser code)Run during the exit from appointment input (exit when adding an appointment or when modifying an appointment for example). This exit corresponds to pressing Enter to validate the input.
Reassigning an appointment (browser code)Run when moving an appointment triggers the modification of the resource associated with the appointment.
Events with procedures
To simplify the operations performed on the appointments in a scheduler, several procedures are proposed in each event. These procedures take the Appointment variable as parameter. All the details of the appointment handled by the popup menu 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 in the event "Exit from input for the appointment":
PROCEDURE ExitFromInput(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, you must create a window or a page with the information to fill.
In the code, simply open the window or page in the event "Entry in edit in an appointment". To lock the direct input via the popup menu of the scheduler, the event must return False.
WINDEV This principle can be applied to all the events called by the popup menu of the Scheduler control.
WINDEV 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 Scheduler control
RESULT False
Optional events
Several optional events can be managed.
To manage an optional event, simply select it in the icon bar of the code window.
In WINDEV:
In WEBDEV:
In WINDEV Mobile:
To add an optional event:
  1. Select the requested control.
  2. Display the code window of this control (F2 key).
  3. Click the link "Add other processes to xxx" at the bottom of the window code, after the last event.Click the link "Add other events to xxx" at the bottom of the window code, after the last event.
  4. All the optional events available for the control are displayed.
  5. Check the optional event to add and validate.
    Note: You can select several optional events.
  6. 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 disabled code contains WLanguage code, this code is automatically deleted.
You can manage, for example:
  • the control rollover with the mouse,
  • the left mouse button down, up, with a double click,
  • the right mouse button down, up, with double click,
  • the mouse wheel, ...
See Optional events for more details.
Minimum version required
  • Version 16
This page is also available for…
Comments
Click [Add] to post a comment