Control found in a window, page or report

• on a daily, weekly or montly basis,
• Versions 22 and later
  on 6 months or on 1 year.
  New in version 22
  on 6 months or on 1 year.
  on 6 months or on 1 year.

• A Scheduler control can be anchored:
  • via the anchoring options of WINDEV and WINDEV Mobile.
• Versions 17 and later
  Scheduler controls are available in Scheduler reports. For more details on how schedulers work in reports, see Scheduler report.
  New in version 17
  Scheduler controls are available in Scheduler reports. For more details on how schedulers work in reports, see Scheduler report.
  Scheduler controls are available in Scheduler reports. For more details on how schedulers work in reports, see Scheduler report.
• 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.

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. 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.

• via the anchoring options of WINDEV and WINDEV Mobile.

The control options (window editor and page editor)

• 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.
  
• Versions 22 and later
  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.
  New in version 22
  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.
  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: The resources are displayed in row by default.
  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.
  Versions 22 and later
  To define specific time slots, use SchedulerWorkingHour and SchedulerWorkingHourResource.
  New in version 22
  To define specific time slots, use SchedulerWorkingHour and SchedulerWorkingHourResource.
  To define specific time slots, use SchedulerWorkingHour and SchedulerWorkingHourResource.
• Appointments: Used to specify the characteristics of appointments:
  • Overlaying: Manage the overlap of appointments. The appointments can be displayed side by side or slightly shifted.
  • Versions 22 and later
    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
    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.
    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:
  • 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.
    To do so, click the Scheduler control to create the appointment and enter its caption via the keyboard.
    
  • Versions 18 and later
    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.
    You have the ability to specify the height of area.
    Examples:

    • if the schedule is displayed with the resources in row:
      • In WINDEV:
        
    • if the schedule is displayed with the resources in column:
      • In WINDEV:
        
    New in version 18
    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.
    You have the ability to specify the height of area.
    Examples:

    • if the schedule is displayed with the resources in row:
      • In WINDEV:
        
    • if the schedule is displayed with the resources in column:
      • In 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.
    You have the ability to specify the height of area.
    Examples:
    • if the schedule is displayed with the resources in row:
      • In WINDEV:
        
    • if the schedule is displayed with the resources in column:
      • In WINDEV:
        

• Change 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.
• Versions 19 and later
  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
  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.
  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
  Allow the user to overlap. 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
  Allow the user to overlap. 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.
  Allow the user to overlap. 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.

• if the resources are displayed in row:
  • Minimum height of a resource.
  • Width of resource header.
• if the resources are displayed in column:
  • Minimum width of resource.
  • Height of the break (for changing day)

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. Open the Scheduler control description window.
2. 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. Open the Scheduler control description window.
2. 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. Open the Scheduler control description window.
2. 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, ...

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.
     By default, this window is named "IW_WinDevViewAPT.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 "Global declarations" event is executed. No other events are executed. Therefore, you cannot add buttons with a specific click code.

• 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

A Scheduler control can be filled:

• through programming, via the different associated events and WLanguage functions.
• via a data binding.
• by Data Binding (link with a variable).