PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Creating an Organizer report
  • Creating the report
  • Information specific to the Organizer creation
  • Characteristics of Organizer report and Organizer control
  • Handling an organizer in a report by programming
  • WLanguage functions
  • WLanguage properties
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
The report editor gives you the ability to create "Organizer" reports.
In this case, the report includes an Organizer control only. This type of control is created when creating an Organizer report: it cannot be created independently of this report.
Example:
In the editor, this control includes two blocks:
  • The "Header" block, displaying the titles of the organizer columns.
  • The "Organizer" block, displaying the appointments in an Organizer control.
Versions 21 and later
Universal Windows 10 App The Organizer reports are now available.
New in version 21
Universal Windows 10 App The Organizer reports are now available.
Universal Windows 10 App The Organizer reports are now available.
Creating an Organizer report

Creating the report

To create an "Organizer" report:
  1. Select "File .. New .. Report". The wizard for report creation starts. Click among the quick access buttons.
    • Click "Report" in the wheel that is displayed. The window for creating a new element is displayed: click "Report" then "Report".
    • The wizard for report creation starts.
  2. Select an "Organizer or Scheduler" report.
  3. In the rest of the wizard, specify:

Information specific to the Organizer creation

The information specific to the Organizer creation is as follows:
  • Initial display mode: The organizer can be displayed:
    • on a daily basis,
    • on a weekly basis,
    • on a monthly basis.
  • The granularity of gridlines. This granularity is used to define the size of the grid used to display the gridlines of Organizer control. This granularity is set to 30 minutes by default. This information must be modified according to the number of days to display.
    This characteristic can be modified by programming via ..GranularityGridlines.
Note: If the Organizer report is linked to a data source (query, data file), you must specify the items that will be taken into account for displaying the appointments. The following information must be specified:
  • the title of appointment.
  • the start and end dates of appointment.
Characteristics of Organizer report and Organizer control
You have the ability to modify the following characteristics of Organizer report:
  • The data source of Organizer report can be modified in the "Data" tab of description window of report ("Report description" from the popup menu of report).
  • The "General" tab of description window of Organizer control is used to specify:
    • the initial display mode: Day, week, month.
    • the number of days displayed.
    • the visible time period.
    • the first day of the week.
    • the granularity of gridlines.
    • Versions 18 and later
      the display of appointments for the entire day. If the option "Display the appointments for the whole day" is checked, the report takes into account the appointments for which the "Whole day" characteristic is supported (see Appointment variable for more details). In this case, an area used to display the daily appointments appears in the organizer:
      Note: Make sure that the area used to display the daily appointments has the proper dimensions in the report editor. It can be resized if necessary.
      New in version 18
      the display of appointments for the entire day. If the option "Display the appointments for the whole day" is checked, the report takes into account the appointments for which the "Whole day" characteristic is supported (see Appointment variable for more details). In this case, an area used to display the daily appointments appears in the organizer:
      Note: Make sure that the area used to display the daily appointments has the proper dimensions in the report editor. It can be resized if necessary.
      the display of appointments for the entire day. If the option "Display the appointments for the whole day" is checked, the report takes into account the appointments for which the "Whole day" characteristic is supported (see Appointment variable for more details). In this case, an area used to display the daily appointments appears in the organizer:
      Note: Make sure that the area used to display the daily appointments has the proper dimensions in the report editor. It can be resized if necessary.
    • the display mask for the date and schedules.
    • Versions 20 and later
      the custom report to display the appointments.
      • If the selected option is "None", the default display is used.
      • If "Preset report" is selected, a preset report is automatically added to the project. This report is named "RPT_WinDevViewAPT" by default and it is automatically used to display the appointments.
        This report can be customized, renamed, ...
      • If the selected option corresponds to a project report, this report will be used to display the appointments.
        We advise you to customize the report proposed by default.
        The same report can be used to customize the appointments in a Scheduler or Organizer report.
      New in version 20
      the custom report to display the appointments.
      • If the selected option is "None", the default display is used.
      • If "Preset report" is selected, a preset report is automatically added to the project. This report is named "RPT_WinDevViewAPT" by default and it is automatically used to display the appointments.
        This report can be customized, renamed, ...
      • If the selected option corresponds to a project report, this report will be used to display the appointments.
        We advise you to customize the report proposed by default.
        The same report can be used to customize the appointments in a Scheduler or Organizer report.
      the custom report to display the appointments.
      • If the selected option is "None", the default display is used.
      • If "Preset report" is selected, a preset report is automatically added to the project. This report is named "RPT_WinDevViewAPT" by default and it is automatically used to display the appointments.
        This report can be customized, renamed, ...
      • If the selected option corresponds to a project report, this report will be used to display the appointments.
        We advise you to customize the report proposed by default.
        The same report can be used to customize the appointments in a Scheduler or Organizer report.
  • If the Organizer control is linked to a data source (data file, query, ...), the "Content" tab found in the description window of the control is used to linked the appointment data with the data found in the data source.
  • The "Style" tab found in the description window of Organizer control is used to specify the style of appointments displayed in the Organizer control.
Handling an organizer in a report by programming

WLanguage functions

Several WLanguage functions are available in the report editor for handling the Organizer controls. These functions are as follows:
Versions 15 and later
OrganizerAddAppointment
New in version 15
OrganizerAddAppointment
OrganizerAddAppointment
Adds a new appointment into an Organizer control.
Versions 17 and later
OrganizerBackgroundColor
New in version 17
OrganizerBackgroundColor
OrganizerBackgroundColor
Defines a background color for a time slot in an Organizer control.
Versions 16 and later
OrganizerChangeMode
New in version 16
OrganizerChangeMode
OrganizerChangeMode
Modifies the time range displayed by an Organizer control (Day/Week/Month).
Versions 15 and later
OrganizerChangeZoom
New in version 15
OrganizerChangeZoom
OrganizerChangeZoom
Modifies the time range displayed by an Organizer control (Day/Week/Month). This function is kept for backward compatibility.
Versions 15 and later
OrganizerDeleteAll
New in version 15
OrganizerDeleteAll
OrganizerDeleteAll
Deletes all appointments from an Organizer control.
Versions 15 and later
OrganizerDeleteAppointment
OrganizerDeleteAppointment
Deletes an appointment from an Organizer control.
Versions 15 and later
OrganizerListAppointment
New in version 15
OrganizerListAppointment
OrganizerListAppointment
Returns:
  • the list of appointments found between two dates in an Organizer control,
  • all the appointments found in an Organizer control,
  • a specific appointment (selected or hovered).
Versions 17 and later
OrganizerMode
New in version 17
OrganizerMode
OrganizerMode
Returns the display mode of an Organizer control: day, week, month, ...
Versions 15 and later
OrganizerPosition
New in version 15
OrganizerPosition
OrganizerPosition
Displays an Organizer control from a specified date or returns the date of the first day (or the date of the last day) displayed in an Organizer control.
Versions 15 and later
OrganizerTimeDisplayed
New in version 15
OrganizerTimeDisplayed
OrganizerTimeDisplayed
Defines the time range displayed by the Organizer control in Day mode or in Week mode.
Versions 15 and later
OrganizerZoom
New in version 15
OrganizerZoom
OrganizerZoom
Returns the time range displayed by an Organizer control.

WLanguage properties

Several WLanguage properties are available in the report editor for handling the Organizer controls. These properties are as follows:
Versions 17 and later
CaptionPeriodHeader
New in version 17
CaptionPeriodHeader
CaptionPeriodHeader
..CaptionPeriodHeader is used to find out and modify the content of the period caption displayed in the header of a Scheduler or Organizer control found in a report.
Versions 17 and later
EndDatePeriodDisplayed
New in version 17
EndDatePeriodDisplayed
EndDatePeriodDisplayed
..EndDatePeriodDisplayed is used to find out the end date of the period currently printed in a Scheduler control or in an Organizer control found in a report.
Versions 18 and later
FontAppointmentContent
New in version 18
FontAppointmentContent
FontAppointmentContent
..FontAppointmentContent is used to:
  • Find out the characteristics of the font used for the content of appointments in the Scheduler and Organizer reports.
  • Modify the characteristics of the font used for the content of appointments in the Scheduler and Organizer reports.
Versions 18 and later
FontAppointmentTitle
New in version 18
FontAppointmentTitle
FontAppointmentTitle
..FontAppointmentTitle is used to:
  • Find out the characteristics of the font used for the title of the appointments in the Scheduler and Organizer reports.
  • Modify the characteristics of the font used for the title of the appointments in the Scheduler and Organizer reports.
Versions 17 and later
GranularityGridlines
New in version 17
GranularityGridlines
GranularityGridlines
..GranularityGridlines allows you to find out and modify the size of the grid used to display the gridlines in a Scheduler control or in an Organizer control found in a report.
Versions 09 and later
Height
New in version 09
Height
Height
..Height is used to find out and modify the height:
  • of a control or block in a report.
  • of a control (found in a window), window, row found in a table, in a list box or in a listview, option found in a radio button or in a check box, break header or break footer found in a table or in a looper.
  • of a control (found in a page), break header or break footer found in a table or in a looper. The control can be stackable or not.
Versions 09 and later
Name
New in version 09
Name
Name
..Name is used to find out:
  • the name of the font associated with a Font variable.
  • the name of a control, report or report block.
  • the name of a control, group of controls or window.
  • the name of a control, group of controls or page.
Versions 17 and later
StartDatePeriodDisplayed
New in version 17
StartDatePeriodDisplayed
StartDatePeriodDisplayed
..StartDatePeriodDisplayed is used to find out the start date of the period currently printed in a Scheduler or Organizer control found in a report.
Versions 09 and later
Visible
New in version 09
Visible
Visible
..Visible is used to:
  • Find out whether an element is visible.
  • Make an element visible or invisible.
Versions 09 and later
Width
New in version 09
Width
Width
..Width is used to find out and modify the width:
  • of a control or block in a report.
  • of a control (found in a window), window, column found in a table or column found in a list box (including listview).
  • of a control (found in a page), column found in a table or column found in a list box. The control can be stackable or not.
Versions 09 and later
X
New in version 09
X
X
..X is used to:
  • Find out the X coordinate of a control, of a Table control column or of a window (position on X axis).
  • Modify the X coordinate of a control or window (position on X axis).
Versions 09 and later
Y
New in version 09
Y
Y
..Y is used to:
  • Find out the Y coordinate of a control or window (position on Y axis).
  • Modify the Y coordinate of a control or window.
Minimum required version
  • Version 17
This page is also available for…
Comments
Click [Add] to post a comment