PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

  • 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 popup menu automatically proposed
  • A deletable appointment
  • Customize the appointment area
  • 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 the 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,
  • Versions 22 and later
    WINDEV on 6 months or on 1 year.
    New in version 22
    WINDEV on 6 months or on 1 year.
    WINDEV on 6 months or on 1 year.
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 from the description window of the control.
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.
Notes:
  • A Scheduler control can be anchored:
    • WINDEVAndroidiPhone/iPad via the anchoring options of WINDEV and WINDEV Mobile.
    • WEBDEV - Server code via the positioning table in WEBDEV.
  • Versions 17 and later
    WINDEVWEBDEV - Server code The Scheduler controls are available in the Scheduler reports. See Scheduler report for more details.
    New in version 17
    WINDEVWEBDEV - Server code The Scheduler controls are available in the Scheduler reports. See Scheduler report for more details.
    WINDEVWEBDEV - Server code The Scheduler controls are available in the Scheduler reports. See Scheduler report for more details.
  • Linux The Scheduler control is available in Linux in the pages of Linux WEBDEV sites only. The Scheduler control is not available in the windows of WINDEV applications for Linux.
Creating a Scheduler control (window and page editor)
To create a Scheduler control:
  1. In the window or page editor, click (or select "Insert .. Control .. Scheduler control").On the "Creation" pane, in the "Graphic controls" group, expand "Time" and select "Scheduler".
  2. Click the position where the control will be created in the window or page.
  3. WINDEVWEBDEV - Server code The wizard for creating the Scheduler control starts. Answer the questions and validate.
  4. The control appears in creation mode.
Versions 20 and later
Note: The dimensions of created control are optimized in order to occupy the available space at the specified position. If the control size does not suit your, press [CTRL Z]: the default control size will be restored.
New in version 20
Note: The dimensions of created control are optimized in order to occupy the available space at the specified position. If the control size does not suit your, press [CTRL Z]: the default control size will be restored.
Note: The dimensions of created control are optimized in order to occupy the available space at the specified position. If the control size does not suit your, press [CTRL Z]: the default control size will be restored.
To display the control characteristics, select "Description" from the popup menu of control.
Note: A Scheduler control can be anchored:
  • WINDEVAndroidiPhone/iPad via the anchoring options of WINDEV and WINDEV Mobile.
    • 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 for WINDEV and "General" tab for WEBDEV).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.
    AndroidiPhone/iPad This option is not available. Indeed, the change of period is performed via an horizontal swipe on the Scheduler control.
  • 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.
    WINDEV This display mode can be modified by the user via the popup menu of the control.
    WEBDEV - Server codeAndroidiPhone/iPadPHP 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.
  • Versions 22 and later
    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:
    You have the ability to define:
    • The total range of schedule: day, week (5 or 7 days), according to the number of appointments, according to the number of days, 6 months, one year.
    • The 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.
    • The 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 description window of control.
    New in version 22
    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:
    You have the ability to define:
    • The total range of schedule: day, week (5 or 7 days), according to the number of appointments, according to the number of days, 6 months, one year.
    • The 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.
    • The 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 description window of control.
    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:
    You have the ability to define:
    • The total range of schedule: day, week (5 or 7 days), according to the number of appointments, according to the number of days, 6 months, one year.
    • The 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.
    • The 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 description window of control.
  • Display mode of resources: The resources are displayed in row by default.
    WINDEVWEBDEV - Server codePHP You also have the ability to display them in column. PHP The resources are always displayed in column.
  • Display masks: Used to define: 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.
    Versions 22 and later
    WINDEV To define specific time slots, use SchedulerWorkingHour and SchedulerWorkingHourResource.
    New in version 22
    WINDEV To define specific time slots, use SchedulerWorkingHour and SchedulerWorkingHourResource.
    WINDEV To define specific time slots, use SchedulerWorkingHour and SchedulerWorkingHourResource.
  • Appointments: Used to specify the characteristics of appointments:
    • WINDEVWEBDEV - Server codePHP Overlaying: Manage the overlap of appointments. The appointments can be displayed side by side or slightly shifted.
    • Granularity of appointments: Precision for displaying the schedule. By default, the granularity is set to 30 minutes.
      You have the ability to 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.
      WEBDEV - Server codeAndroidiPhone/iPad Granularity of appointments: Precision for displaying the schedule. By default, the granularity is set to 30 minutes.
      You have the ability to 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.
    • Versions 22 and later
      WINDEViPhone/iPad 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.
      New in version 22
      WINDEViPhone/iPad 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.
      WINDEViPhone/iPad 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 the selection of periods: Allows the user to select a period with the mouse.
    • Allow the direct input of an appointment: Allows the user to add an appointment directly.
      WINDEVWEBDEV - Server codePHP To do so, click the Scheduler control to create the appointment and enter its caption via the keyboard.
      AndroidiPhone/iPad All you have to do is click in the Scheduler control. A "+" button appears in the selected area. The "Before creating the appointment" process is run when clicking this "+" button. You have the ability to open a window to type the appointment characteristics. See Processes associated with a Scheduler control for more details.
    • Versions 18 and later
      WINDEVWEBDEV - 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.
      WINDEV You have the ability to specify the height of area.
      Examples:
      • if the schedule is displayed with the resources in row:
        • WINDEV In WINDEV:
        • WEBDEV - Server codePHP In WEBDEV:
      • if the schedule is displayed with the resources in column:
        • WINDEV In WINDEV:
        • WEBDEV - Server codePHP In WEBDEV:
      New in version 18
      WINDEVWEBDEV - 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.
      WINDEV You have the ability to specify the height of area.
      Examples:
      • if the schedule is displayed with the resources in row:
        • WINDEV In WINDEV:
        • WEBDEV - Server codePHP In WEBDEV:
      • if the schedule is displayed with the resources in column:
        • WINDEV In WINDEV:
        • WEBDEV - Server codePHP In WEBDEV:
      WINDEVWEBDEV - 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.
      WINDEV You have the ability to specify the height of area.
      Examples:
      • if the schedule is displayed with the resources in row:
        • WINDEV In WINDEV:
        • WEBDEV - Server codePHP In WEBDEV:
      • if the schedule is displayed with the resources in column:
        • WINDEV In WINDEV:
        • WEBDEV - Server codePHP In WEBDEV:
The edit options via the mouse are as follows:
  • WINDEVWEBDEV - Server codePHP Modifying the duration. You can allow (or not) the user to modify the duration of an appointment.
  • Move. You can allow (or not) the user to move an appointment.
  • Versions 19 and later
    WINDEVAndroidiPhone/iPad Allow the user to change resource. If this option is checked, when moving an appointment, the user will be able to associate it with a different resource.
    New in version 19
    WINDEVAndroidiPhone/iPad Allow the user to change resource. If this option is checked, when moving an appointment, the user will be able to associate it with a different resource.
    WINDEVAndroidiPhone/iPad Allow the user to change resource. If this option is checked, when moving an appointment, the user will be able to associate it with a different resource.
  • Versions 17 and later
    WINDEVAndroidiPhone/iPad Allow the overlapping by the user. 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.
    New in version 17
    WINDEVAndroidiPhone/iPad Allow the overlapping by the user. 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.
    WINDEVAndroidiPhone/iPad Allow the overlapping by the user. 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:
  • WINDEVWEBDEV - Server codePHP if the resources are displayed in row:
    • Minimum width of day.
      WEBDEV - Server codePHP In WEBDEV, you must define the 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.
  • WINDEVWEBDEV - Server codePHP if the resources are displayed in column:
    • Minimum width of resource.
    • Minimum height of a day.
      WEBDEV - Server codePHP In WEBDEV, you must define the minimum height of an hour. The height of the day is calculated according to the number of hours displayed.
    • Height of the break (for changing day)
  • AndroidiPhone/iPad the resources are always displayed in row. You have the ability to configure the following elements:
    • Minimum width of day.
    • Minimum height of a resource.
    • Width of header of resources.
Versions 17 and later
WINDEV Most of these parameters can be modified by programming. See Properties associated with the Scheduler control for more details.
New in version 17
WINDEV Most of these parameters can be modified by programming. See Properties associated with the Scheduler control for more details.
WINDEV Most of these parameters can be modified by programming. See Properties associated with the Scheduler control for more details.
Most of these parameters can be modified by programming. See Properties associated with the Scheduler control for more details.
The options regarding the dimension of areas are as follows:
  • WINDEVWEBDEV - 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.
  • WINDEVWEBDEV - 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)
  • AndroidiPhone/iPad the resources are always displayed in row. You have the ability to configure the following elements:
    • Height of a resource.
    • Width of header of resources.
Most of these parameters can be modified by programming. See Properties associated with the Scheduler control for more details.
WINDEV

A popup menu automatically proposed

The Scheduler control can display a specific popup menu proposing automatic features 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:
  • Modifying 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 period.
  • Copy the content of an appointment.
  • Versions 17 and later
    Print the content of Scheduler control.
    New in version 17
    Print the content of Scheduler control.
    Print the content of Scheduler control.
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.
Note: If the control is linked to a variable or to a data file, you have the ability not to allow the deletion ("Allow the deletion (also deletes from the data source)" option in the "Content" tab of the description window of control).
WINDEVAndroidiPhone/iPad

Customize the appointment area

In the Scheduler control, the appointment is displayed in a specific area. You have the ability to translate and customize this area: color of title, background color of the appointment, ...
Versions 17 and later
To modify the aspect of the appointments proposed by default, you have the ability to modify the style options defined for this element.
  1. Display the description window of the Scheduler control.
  2. In the "Style" tab, select the "Appointments" element and modify the requested characteristics. You can:
    • use a shadow,
    • use a separator in dots between hours,
    1. use a gradient color,
      • define the fonts used, ...
    In the "Style" tab, select the "Appointments" element. You can:
    • use a shadow,
    • use a separator in dots between hours,
    • define the title and background options:
      • solid background,
      • gradient background,
      • Versions 22 and later
        Solid background, multiline title and bottom line. This option is used to display the title on several lines (especially if the appointment is not wide enough to display the entire title)).
        New in version 22
        Solid background, multiline title and bottom line. This option is used to display the title on several lines (especially if the appointment is not wide enough to display the entire title)).
        Solid background, multiline title and bottom line. This option is used to display the title on several lines (especially if the appointment is not wide enough to display the entire title)).
    • define the fonts used, ...
New in version 17
To modify the aspect of the appointments proposed by default, you have the ability to modify the style options defined for this element.
  1. Display the description window of the Scheduler control.
  2. In the "Style" tab, select the "Appointments" element and modify the requested characteristics. You can:
    • use a shadow,
    • use a separator in dots between hours,
    1. use a gradient color,
      • define the fonts used, ...
    In the "Style" tab, select the "Appointments" element. You can:
    • use a shadow,
    • use a separator in dots between hours,
    • define the title and background options:
      • solid background,
      • gradient background,
      • Versions 22 and later
        Solid background, multiline title and bottom line. This option is used to display the title on several lines (especially if the appointment is not wide enough to display the entire title)).
        New in version 22
        Solid background, multiline title and bottom line. This option is used to display the title on several lines (especially if the appointment is not wide enough to display the entire title)).
        Solid background, multiline title and bottom line. This option is used to display the title on several lines (especially if the appointment is not wide enough to display the entire title)).
    • define the fonts used, ...
To modify the aspect of the appointments proposed by default, you have the ability to modify the style options defined for this element.
  1. Display the description window of the Scheduler control.
  2. In the "Style" tab, select the "Appointments" element and modify the requested characteristics. You can:
    • use a shadow,
    • use a separator in dots between hours,
    1. use a gradient color,
      • define the fonts used, ...
    In the "Style" tab, select the "Appointments" element. You can:
    • use a shadow,
    • use a separator in dots between hours,
    • define the title and background options:
      • solid background,
      • gradient background,
      • Versions 22 and later
        Solid background, multiline title and bottom line. This option is used to display the title on several lines (especially if the appointment is not wide enough to display the entire title)).
        New in version 22
        Solid background, multiline title and bottom line. This option is used to display the title on several lines (especially if the appointment is not wide enough to display the entire title)).
        Solid background, multiline title and bottom line. This option is used to display the title on several lines (especially if the appointment is not wide enough to display the entire title)).
    • define the fonts used, ...
To customize the display of appointments:
  1. Display the description window of the Scheduler control.
  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.
      WINDEV By default, this window is named "IW_WinDevViewAPT.wdw".
      AndroidiPhone/iPad By default, this window is named "IW_WinDevMobileViewAPT.wdw".
  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 process for declaring the global variables is run. No other process is run. Therefore, you cannot add buttons with a specific click code.
Notes:
  • 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.

Modes for filling a Scheduler control

AndroidiPhone/iPad Only the fill of the Scheduler control by programming is available. See Scheduler control: programming via several processes and WLanguage functions for more details
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 required version
  • Version 16
This page is also available for…
Comments
Click [Add] to post a comment