Control found in a window, page or report

• on a daily, weekly or montly basis,

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 control appears in the editor.

The control options (window editor and page editor)

• With buttons to change the time range: 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.
  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.
• Resource display mode: By default, resources are displayed in rows.
  
• 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 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 the appointments:
  • Appointment granularity: 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.
  • 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 direct input of an appointment: Allows the user to add an appointment directly.
    
    All you have to do is click in the Scheduler control. A "+" button appears in the selected area. The event "Before creating the appointment" is run when clicking "+". You can open a window to type the appointment characteristics. For more details, see Events associated with a Scheduler control.

• Move. You can allow (or not) the user to move an appointment.
• Allow users to change resources. If this option is checked, when moving an appointment, the user will be able to associate it with a different resource.
• 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 resources are always displayed in rows. You have the ability to configure the following elements:
  • Resource height.
  • Width of the resource header.

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

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,
     • 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_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 "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

Scheduler controls can only be filled through programming. For more details, see Scheduler control: programming via the different events and WLanguage functions.