PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • 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
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
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 period, 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.
Remarks:
  • A Scheduler control can be anchored:
    • WEBDEV - Server code via the positioning table in WEBDEV.
  • Versions 17 and later
    WEBDEV - Server code Scheduler controls are available in Scheduler reports. For more details on how schedulers work in reports, see Scheduler report.
    New in version 17
    WEBDEV - Server code Scheduler controls are available in Scheduler reports. For more details on how schedulers work in reports, see Scheduler report.
    WEBDEV - Server code Scheduler controls are available in Scheduler reports. For more details on how schedulers work in reports, see Scheduler report.
  • Linux In Linux, Scheduler controls are available only in pages of WEBDEV sites for Linux. Scheduler controls are not available in windows of WINDEV applications for Linux.
Creating a Scheduler control (window and page editor)
To create a Scheduler control:
  1. On the "Creation" pane, 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.
Versions 20 and later
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.
New in version 20
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.
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 control characteristics, select "Description" in the popup menu of the control.
Remark: A Scheduler control can be anchored:
    • WEBDEV - Server code via the positioning table in WEBDEV.
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 ("Details" tab).
The parameters of the Scheduler control are as follows:
  • With buttons for changing period: This option is used to display buttons in order for the user to scroll 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 display is performed on a monthly basis but a schedule can also be displayed on a daily basis, on a weekly basis (on 5 or 7 days), according to the number of appointments or according to a specified number of days.
  • Display mode of resources: The resources are displayed in row by default.
    WEBDEV - Server codePHP You also have the ability to display them in column.
  • Time display: Used to define:
    • the format of the date displayed for the "day" columns (or rows) of the scheduler.
    • Versions 19 and later
      whether the time must be displayed or not in the control.
      New in version 19
      whether the time must be displayed or not in the control.
      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.
    • Versions 17 and later
      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".
      New in version 17
      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".
      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 period: Used to define:
    • the visible time period: Time period that will be displayed in the control.
    • the working time period: Time period for which an appointment can be defined.
  • Appointments: Used to specify the characteristics of appointments:
    • WEBDEV - Server codePHP Overlaying: Manage the overlap of appointments. The appointments can be displayed side by side or slightly shifted.
    • WEBDEV - Server code Granularity of appointments: Precision for displaying the schedule. By default, the granularity is set to 30 minutes.
      You can define:
      • the granularity regarding the move of an appointment.
      • the granularity of the appointment duration, which means the minimum duration of an appointment. Caution: by default, this duration is set to 24 hours.
  • Other parameters:
    • Allow the direct input of an appointment: Allows the user to add an appointment directly.
      WEBDEV - Server codePHP To do so, click the Scheduler control to create the appointment and enter its caption via the keyboard.
    • Versions 18 and later
      WEBDEV - Server codePHP 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.

      Examples:
      • if the schedule is displayed with the resources in row:
        • WEBDEV - Server codePHP In WEBDEV:
      • if the schedule is displayed with the resources in column:
        • WEBDEV - Server codePHP In WEBDEV:
      New in version 18
      WEBDEV - Server codePHP 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.

      Examples:
      • if the schedule is displayed with the resources in row:
        • WEBDEV - Server codePHP In WEBDEV:
      • if the schedule is displayed with the resources in column:
        • WEBDEV - Server codePHP In WEBDEV:
      WEBDEV - Server codePHP 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.

      Examples:
      • if the schedule is displayed with the resources in row:
        • WEBDEV - Server codePHP In WEBDEV:
      • if the schedule is displayed with the resources in column:
        • WEBDEV - Server codePHP In WEBDEV:
The edit options via the mouse are as follows:
  • WEBDEV - Server codePHP Modify duration. You can allow (or not) the user to modify the appointment duration.
  • Move. You can allow (or not) the user to move an appointment.
The options regarding the dimension of areas are as follows:
  • WEBDEV - Server codePHP if the resources are displayed in row:
    • 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 resource header.
  • WEBDEV - Server codePHP if the resources are displayed in column:
    • Minimum width of resource.
    • WEBDEV - Server codePHP Minimum height of time. 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 by programming. See Properties associated with the Scheduler control for more details.
WEBDEV - Server code

A deletable appointment

The Scheduler control allows the user to delete the selected appointment via the red cross displayed in the top 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.
Remark: If the control is linked to a variable or to a data file, you can prevent the deletion ("Allow the deletion (also deletes from the data source)" option in the "Content" tab of the control description window).
To customize the display of appointments:
  1. Open the Scheduler control description window.
  2. In the "General" tab, select the internal window used for the appointments:
    • "None": the default display will be used.
    • "Preset window": a preset window is automatically added to the project.

  3. The internal window is available in the project explorer. It can be modified in the window editor.
    Caution: this internal window can only be used to customize the drawing regarding the display of appointments. Only the "Global declarations" event is executed. No other events are executed. Therefore, you cannot add buttons with a specific click code.
Remarks:
  • You also have the ability to use any internal window of your project.
  • If you are using the suggested preset window, the style options of the appointment (selected in the "Style" tag) are applied.
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