PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Describing an Organizer control
  • A popup menu automatically proposed
  • Customizing the appointment area
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
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).
Versions 24 and later
Android Organizer controls are now available on Android applications.
iPhone/iPad Organizer controls now are available on iPhone/iPad applications.
New in version 24
Android Organizer controls are now available on Android applications.
iPhone/iPad Organizer controls now are available on iPhone/iPad applications.
Android Organizer controls are now available on Android applications.
iPhone/iPad Organizer controls now are available on iPhone/iPad applications.
The available options are as follows:
  • Initial display mode: By default, the display is performed on a weekly basis but an organizer can also be displayed on a daily basis or on a monthly basis. This display mode can be modified by the user via the popup menu of the control.
    WINDEV If the option "Storing the mode" is checked, the mode chosen by the user will be applied automatically.
  • Parameters of the organizer:
    • First day: First day displayed in the Organizer control
    • Number of days: Number of days displayed in the Organizer control for a week.
    • Versions 16 and later
      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.
      Versions 17 and later
      You also have the ability to indicate 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
      You also have the ability to indicate 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".
      You also have the ability to indicate 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 16
      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.
      Versions 17 and later
      You also have the ability to indicate 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
      You also have the ability to indicate 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".
      You also have the ability to indicate 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".
      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.
      Versions 17 and later
      You also have the ability to indicate 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
      You also have the ability to indicate 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".
      You also have the ability to indicate 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:
      • Visible time slot: Time period that will be displayed in the control.
      • Working time slot: Time period for which an appointment can be defined.
        Versions 22 and later
        WINDEV To define specific time slots, use OrganizerWorkingHour.
        New in version 22
        WINDEV To define specific time slots, use OrganizerWorkingHour.
        WINDEV To define specific time slots, use OrganizerWorkingHour.
      • Modify the range during the resize operation: Used to enlarge the time period when the control is enlarged. 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.
    • Characteristics of the appointment:
      • Overlaying: Used to define how the overlap is managed. The appointments can be displayed side by side or they can be shifted.
      • Granularity: Display granularity of the Organizer control. By default, the granularity is set to 30 minutes. The granularity unit is:
        • the minute,
        • the hour,
        • the day.
        Versions 16 and later
        You can define:
        • the granularity regarding the move of an appointment. If the granularity for the move is set to 30 minutes, the appointments can be moved by period of 30 minutes.
        • the granularity of appointment duration. If the granularity for the duration is set to 10 minutes, the duration of an appointment will be a multiple of 10.
        New in version 16
        You can define:
        • the granularity regarding the move of an appointment. If the granularity for the move is set to 30 minutes, the appointments can be moved by period of 30 minutes.
        • the granularity of appointment duration. If the granularity for the duration is set to 10 minutes, the duration of an appointment will be a multiple of 10.
        You can define:
        • the granularity regarding the move of an appointment. If the granularity for the move is set to 30 minutes, the appointments can be moved by period of 30 minutes.
        • the granularity of appointment duration. If the granularity for the duration is set to 10 minutes, the duration of an appointment will be a multiple of 10.
    • Other parameters:
      • 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 directly enter an appointment in the Organizer control.
  • 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 at the top of the Organizer control. This area is used to enter the daily appointments.
    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 at the top of the Organizer control. This area is used to enter the daily appointments.
    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 at the top of the Organizer control. This area is used to enter the daily appointments.
  • 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 at the top of the Organizer control. This area is used to enter the daily appointments.
    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 at the top of the Organizer control. This area is used to enter the daily appointments.
    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 at the top of the Organizer control. This area is used to enter the daily appointments.
The edit options via the mouse are as follows:
  • Modifying the duration. You can allow (or not) the user to modify the appointment duration.
  • Movement. You can allow (or not) the user to move an appointment.
  • Versions 17 and later
    Allow the user to make the appointments 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 make the appointments 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 make the appointments 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.
The available options are as follows:
  • Parameters of the organizer:
    • Display mode and granularities: By default, the appointments are displayed:
      • WINDEV over a 5-day week, with move granularity and duration granularity set to 30 minutes.
      • 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 description window of control.
    WINDEV The display mode can be modified by the user via the popup menu of the control.
  • The option "Storing the 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.
    • "Display the 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 the 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.
  • WINDEV Characteristics of the appointment: The "Overlaying" option makes it possible to manage several overlapping appointments. The appointments can be displayed side by side or they can be shifted.
  • Other parameters:
    • WINDEV "Allow range selection": Allows the user to select a period with the mouse.
    • "Allow the direct input of an appointment": Allows the user to directly enter an appointment in the Organizer control.
      WINDEV By default, the appointment goes into editing, and the user can enter the appointment title.
      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.
    • 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 at the top of the Organizer control. This area is used to enter the daily appointments.
  • Edit with the mouse (or touch):
    • WINDEV "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.
    • "Allow the user to overlap". If this option is selected, the user will be able to overlap appointments when moving them.
      WINDEV In this case, the options defined for overlapping appointments (offset or side by side) will be taken into account.
WINDEV

A popup menu automatically proposed

The Organizer control can display a specific popup menu proposing automatic features to the user. This menu is proposed by the AAF (Automatic Application Features).
This menu allows the user to:
  • Modify the display mode of the Organizer control: daily, weekly, monthly display or display of the current day only.
  • Add, delete or modify an appointment when selecting a time period.
    Versions 16 and later
    Notes: If the control is linked to a data source, the deletion performed in the control is performed at the same time in the linked data source.
    New in version 16
    Notes: If the control is linked to a data source, the deletion performed in the control is performed at the same time in the linked data source.
    Notes: If the control is linked to a data source, the deletion performed in the control is performed at the same time in the linked data source.
  • Versions 17 and later
    Print the content of the Organizer control.
    New in version 17
    Print the content of the Organizer control.
    Print the content of the Organizer control.

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, ...
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 Organizer 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 and modify the requested characteristics.
    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 entirely display the 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 entirely display the 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 entirely display the 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 Organizer 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 and modify the requested characteristics.
    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 entirely display the 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 entirely display the 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 entirely display the 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 Organizer 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 and modify the requested characteristics.
    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 entirely display the 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 entirely display the 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 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": a preset window is automatically added to the project. By default, this window is named IW_WinDevViewAPT.wdw."Preset window": a preset window is automatically added to the project, in the internal component "WDAAF".
      WINDEV By default, this window is named IW_WinDevViewAPT.wdw.
      AndroidiPhone/iPad By default, this window is named IW_WinDevMobileViewAPT.wdw.

      Notes:
      • You also have the ability to use any internal window of your project.
      • The default internal window works only in Day/Week display mode. This window does not operate in Month display mode.
      • 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.
  3. The internal window is available in the project explorer. It can be modified in the window editor.The internal window is available in the project explorer, in the "Internal component" folder. It can be modified in the window editor.
Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment