ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Organizer control
  • Describing an Organizer control
  • Customizing the appointment area
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Description of an Organizer control (control of a window)
Describing an Organizer control
The Organizer control can be configured in the editor via the description window ("Details" tab).
The available options are as follows:
  • Parameters of the organizer:
    • Display mode and granularities: By default, the appointments are displayed:
      • AndroidiPhone/iPad over a day, with move granularity set to 15 minutes and duration granularity set to one hour.
      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:
      • Display mode of the Organizer control: Allows you to define the duration of the displayed range: Day, month, week, ... or custom number of days.
      • Granularity of appointments: Corresponds to the precision of the Organizer control. 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.
      When validating this window, the selected characteristics are summarized in the control description window.
  • The option "Remember mode" makes it possible to save and re-apply the display mode chosen by the user.
  • Display mask for the date:
    Used to define the format of the date displayed at the top of the "day" columns of the Organizer control.
    • "Show week number" is used to specify whether the week number must be displayed or not. It is then possible to specify its format. In the format, the '%1' string corresponds to the week number. Example of format: "Wk. %1".
    • The option "ISO 8601 format" is used to make sure that the weeks are numbered according to the ISO 8601 standard.
    • The option "Display month if necessary" makes it possible to specify a shortened month name in the first date displayed in the control (if the date mask does not show the month) .
  • Time slot:
    • The visible time slot is the time range that will be displayed in the control.
    • The working time slot corresponds to the time slot for which an appointment can be defined.
      It is possible to modify these values by clicking on the double arrow.
      To define specific time slots, use OrganizerWorkingHour.
    • The option "Modify the range during the resize operation" makes it possible to enlarge the time slot when enlarging the control. For example, if the time slot goes from 9:00 to 18:00, when the control is enlarged, this visible time slot can become 6:00 to 23:00. In this case, the height of the rows remains constant.
  • Other parameters:
    • "Allow direct input of an appointment": Allows the user to directly enter an appointment in the Organizer control.

      AndroidiPhone/iPad By default, a "+" sign appears in the selected period in day and week mode. An appointment can be created by clicking on "+".
      It is possible to display a window to set the appointment options.
  • Edit with the mouse (or touch):
    • "Move". You can allow (or not) the user to move an appointment.
    • "Allow users to overlap elements". If this option is selected, the user will be able to overlap appointments when moving them.

Customizing the appointment area

In the Organizer 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. Display the description window of the Organizer control.
  2. In the "Style" tab, select the "Appointments" element and modify the desired characteristics.
    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 entirely display the title).
    • define the fonts used, ...
To customize the display of appointments:
  1. Display the description window of the Organizer control.
  2. In the "General" tab, select the internal window used for the appointments:
    • "None": the default display will be used.
    • "Preset window": If this option is selected, the WDAAF internal component is immediately added to the current project.
      • AndroidiPhone/iPad The "IW_WinDevMobileViewAPT" internal window is automatically associated with the "Internal window for the appointments" option.
      Remarks:
      • If the WDAAF component already exists, only the window is added to the component.
      • This window is also used to customize appointments in Scheduler controls.
    • Any internal window in your project.
  3. If necessary, validate the control description window.
Remarks:
  • The custom internal window is available in the "Project explorer" pane, in the "Internal components" folder. 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.
  • If you are using the suggested preset window, the style options of the appointment (selected in the "Style" tag) are applied.
  • The default internal window works only in Day/Week display mode. This window does not operate in Month display mode.
Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help