ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
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)
  • A deletable appointment
  • Modes for filling a Scheduler control
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Overview

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,
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.
WEBDEV - Server code Remark: Scheduler control fields are also available in Planning 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. WEBDEV - Server code The Scheduler control creation wizard starts. Answer the questions and validate.
  4. The control appears in the editor.
Note: The dimensions of the field created are optimized to occupy the space available at the position indicated.. If the field size doesn't suit you, use the Ctrl + Z key combination: the field will return to its default size.
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.
On 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 Dequeue: This option displays buttons so that the user can dequeue the different periods of the schedule. These buttons are displayed at the top left of schedule.
  • WEBDEV - Server codePHP Number of days to display: By default, the schedule is displayed by the month, but it is also possible to display a schedule by the day, by the week (5 or 7 days), by the number of appointments, or by the number of days specified..
  • Resource display mode: By default, resources are displayed online.
    WEBDEV - Server codePHP They can also be displayed by columns.
  • Time display: Allows you 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 format: "Sem. %1".
  • Time range: Allows you to define:
    • Visible time range Time range to be displayed in the.
    • the working time range: Time range for which an appointment can be defined.
  • Appointment: Allows you to specify appointment characteristics:
    • WEBDEV - Server codePHP Overlapping: Managing overlapping appointments. The appointments can be displayed side by side or slightly shifted.
    • WEBDEV - Server code Appointment granularity Schedule display accuracy. By default, the granularity is set to 30 minutes.
      You can define:
      • the granularity regarding the move of an appointment.
        New in version 2025
        WEBDEV - Server code This displacement granularity is represented by a thin line in the time range.
      • the granularity of the appointment duration, which means the minimum duration of an appointment. Warning default setting is 24 hours.
  • Other parameters:
    • Allow direct input of an appointment: Allows the user to directly add an appointment.
      WEBDEV - Server codePHP To do so, click the Scheduler control to create the appointment and enter its caption via the keyboard.
    • WEBDEV - Server codePHP Display and allow the appointments for the entire day: Indicates that an appointment can correspond to an entire day.. In this case, a specific area is displayed in the Scheduler control. This area is used to enter the daily appointments.

      Examples:
      • if the schedule is displayed with the resources in rows:
        • WEBDEV - Server codePHP In WEBDEV:
      • if the schedule is displayed with the resources in columns:
        • WEBDEV - Server codePHP In WEBDEV:
The edit options via the mouse are as follows:
  • WEBDEV - Server codePHP Change duration. You can allow or prevent users from changing the duration of appointments.
  • Move. You can allow or prevent users from moving appointments.
The zone size options are as follows:
  • WEBDEV - Server codePHP if the resources are displayed by rows:
    • WEBDEV - Server codePHP Minimum width of an hour. The width of the day is calculated according to the number of hours displayed.
    • Minimum height of a resource.
    • Width of the resource header.
  • WEBDEV - Server codePHP if the resources are displayed by columns:
    • Minimum width of the resource.
    • WEBDEV - Server codePHP Time minimum height. The height of the day is calculated according to the number of hours displayed.
    • Height of the break (for changing day)
Most of these parameters can be modified programmatically. For more details, see Scheduler control properties.
WEBDEV - Server code

A deletable appointment

The Scheduler control allows the user to delete the selected appointment via the red cross displayed in the upper-right corner of appointment.
When the user clicks this cross:
  • the appointment is deleted from the Scheduler control.
  • if the Scheduler control is linked to a data file or to a variable, the appointment is deleted from the data file.
Note: If the field is linked to a variable or data file, it is possible not to allow deletion (option "Allow deletion (also deletes from data source)" in the "Contents" tab of the control description window)..
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…
Comments
Click [Add] to post a comment

Last update: 10/29/2024

Send a report | Local help