Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Scheduler control
  • Overview
  • Control found in a window, page or report
  • Creating a Scheduler control (window and page editor)
  • Describing a scheduler (window and page editor)
  • The control options (window editor and page editor)
  • Context menu proposed automatically
  • Modes for filling a Scheduler control
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures

Control found in a window, page or report

The Scheduler control is used to automatically display and handle schedules. It is used to manage the display of multiple resources and it is used in several applications or sites.
The display is performed:
  • on a daily, weekly or montly basis,
  • WINDEV on 6 months or on 1 year.
The time slot, the first day of the week and the number of days to display can be configured. These parameters can be easily defined in the control description window.
WINDEV Remark: Scheduler controls are also available in Scheduler reports. For more details on how schedulers work in reports, see Scheduler report.
Creating a Scheduler control (window and page editor)
To create a Scheduler control:
  1. On the "Creation" tab, in the "Graphic controls" group, expand "Time" and select "Scheduler".
  2. Click where the control will be created in the window or page.
  3. WINDEV The Scheduler control creation wizard starts. Answer the questions and validate.
  4. The control appears in the editor.
Remark: The dimensions of the control are optimized to take up the available space at the specified position. If the control size does not suit you, press Ctrl + Z: the control size will be reset to default.
To view the characteristics of the control, select "Description" in the context menu.
Describing a scheduler (window and page editor)

The control options (window editor and page editor)

The Scheduler control can be customized in the editor, via the description window.
In the "General" tab, you can specify the window or internal page to be used to customize the aspect of appointments. For more details, see Scheduler control: Customize appointments.
The "Details" tab of the Scheduler control contains the following settings:
  • With buttons to change the time range: This option adds buttons to allow the user to scroll through the different periods of the schedule. These buttons are displayed at the top left of schedule.
  • WINDEV Display: By default, the display is performed on a monthly basis with a granularity for move and duration set to one day. When clicking the display options, a window is opened, allowing you to define the different display options:
    It is possible to define the following elements:
    • Total schedule range: day, week (5 or 7 days), according to the number of appointments, according to the number of days, 6 months, one year.
    • Granularity of appointments: Corresponds the display precision of schedule. The appointments can start on a multiple of XX minutes, hours, ... and they can have a duration multiple of XX minutes, hours, ... The arrow button is used to enter preset values. The lock is used to link (or not) the values.
    • Range viewed: The range viewed is calculated from the control size in the editor. By entering the range to view, you get the minimum dimension of the element according to the selected unit.
    • When validating this window, the selected characteristics are summarized in the control description window.
  • Resource display mode: By default, resources are displayed by rows.
    WINDEV They can also be displayed by columns.
  • Time display: Used to define:
    • the format of the date displayed for the "day" columns (or rows) of the scheduler.
    • whether the time must be displayed or not in the control.
    • the format of the time displayed for the "day" columns (or rows) of scheduler.
    • whether the week number must be displayed or not, as well as its format. In the format, the '%1' string corresponds to the week number. Example of format: "Wk. %1".
  • Time slot: Used to define:
    • the time slot shown: Time slot that will be shown in the control.
    • the working time slot: Time slot for which an appointment can be defined.
    WINDEV To define specific time slots, use SchedulerWorkingHour and SchedulerWorkingHourResource.
  • Appointments: Used to specify the characteristics of the appointments:
    • WINDEV Overlap: Appointment overlap options. The appointments can be displayed side by side or slightly shifted.
    • WINDEV Continuous display if several days: Used to display an appointment over several days as a single appointment. If this option is unchecked, the appointments on several days will correspond to as many appointments as the number of days.
  • Other parameters:
    • WINDEV Allow time range selection: Allows the user to select a period with the mouse.
    • Allow direct input of an appointment: Allows the user to add an appointment directly.
      WINDEV To do so, click the Scheduler control to create the appointment and enter its caption via the keyboard.
    • WINDEV Display and allow the appointments for the entire day: Used to specify that an appointment can correspond to a whole day. In this case, a specific area is displayed in the Scheduler control. This area is used to enter the daily appointments.
      WINDEV You can specify the height of the area.
      • if the schedule is displayed with the resources in rows:
        • WINDEV In WINDEV:
      • if the schedule is displayed with the resources in columns:
        • WINDEV In WINDEV:
The editing options via the mouse are as follows:
  • WINDEV Change duration. You can allow or prevent users from changing the duration of appointments.
  • Move. You can allow or prevent users from moving appointments.
  • WINDEV Allow users to change resources. If this option is checked, users will be able to move appointments and associate them with different resources.
  • WINDEV Allow users to overlap elements. If this option is checked, when moving appointments, the user will be able to make them overlap. In this case, the options defined for overlapping appointments (offset or side by side) will be taken into account.
The options regarding the dimension of areas are as follows:
  • WINDEV if the resources are displayed in rows:
    • Minimum height of a resource.
    • Width of the resource header.
  • WINDEV if the resources are displayed in columns:
    • Minimum width of the resource.
    • Height of the break (for changing day)
Most of these parameters can be modified through programming. For more details, see Scheduler control properties.

Context menu proposed automatically

The Scheduler control can display a specific context menu with automatic features available to the user. This menu is proposed by the AAF (Automatic Application Features).
As soon as at least one resource is found in the schedule, this menu allows the user to:
  • Change the display mode of the scheduler: daily, weekly, monthly display or display of the current day only.
  • Add, delete or modify an appointment when selecting a time slot.
  • Copy the content of an appointment.
  • Print the contents of the Scheduler control.
Related Examples:
WD Schedule Complete examples (WINDEV): WD Schedule
[ + ] This example presents the management of a graphic schedule.

The following topics are presented in this example:
1/ the scheduler control
2/ the Google Calendar functions
The Scheduler control Unit examples (WEBDEV): The Scheduler control
[ + ] This example explains how to use the Scheduler control. Two uses are presented:
- Filling the schedule by programming,
- Filling the schedule by databinding from a code variable.
WW_Schedule Complete examples (WEBDEV): WW_Schedule
[ + ] This example is used to dynamically display the tasks of the different contributors.
You have the ability to add, modify or delete tasks by clicking the schedule elements.
All the operations are performed via AJAX.
This example is also used to move a control by programming.
Minimum version required
  • Version 16
This page is also available for…
Click [Add] to post a comment

Last update: 07/03/2023

Send a report | Local help