ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / Editors / Report editor / Report controls
  • The different types of controls
  • Short description of different types of controls
  • Static control
  • Calculated control
  • Image control
  • Bar Code control
  • Preset control
  • Chart control
  • Shape control
  • Check Box control
  • Internal Report control
  • URL Link control
  • Edit control
  • Signature control
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
The different types of controls
Several types of controls can be handled in a report created by the report editor:Remarks:
  • For more details, see the online help about each type of control.
  • The report editor also offers several controls that enable user interaction:
    • Edit control.
      Android Not available.
    • Check Box control.
    • Combo Box control.
    For more details, see Editable reports.
Short description of different types of controls

Static control

The "Static" control is used to display different types of data:
  • plain text, RTF, HTML, Markdown,
  • numeric, currency, currency + Euro,
  • date,
  • time, duration.
To specify the type of data displayed in the control:
  1. Go to the "General" tab in the Static control description window ("Description" in the control context menu).
  2. Select the type of information displayed ("Type" combo box).
  3. Validate.
The displayed data can contain:
  • the data from an item (or variable) in the report data source.
    Remark: The item or variable bound to the control is defined in the "Binding" tab of the control description window.
  • the content of another control found in the report.
  • a value defined through programming.
To insert the value of a report item or control into the text of the Static control, enter the item or control name between [% and %].
For example, the text of the control can correspond to: The [%SupplierName%] supplier sells the [%ProductName%] product at [%PriceIOT%]. SupplierName, ProductName and PriceIOT will be replaced with their value when the report is executed.
Remark: If the Static control must display a text on several lines, all you have to do is choose the "Multiline text" type. In this case, the control size must be large enough.
Reminder: The "Auto-resizing" option ("UI" tab in the control description window) is used to automatically enlarge the control according to its content when printing.
Examples:
Static controls
Modifying the caption of a Static control
The caption of a "Static" control can be modified:
  • through programming (Static property).
  • in the report editor. In this case, two methods are available:
    • Method 1:
      1. Select the control. The selection handles appear around the control.
      2. Click the control again. The mouse cursor turns into an input cursor.
      3. Enter the new text.
      4. Modify (if necessary) the formatting of the caption:
        • for a text caption: via the formatting options on the "Modification" tab, in the "Quick edit" group:
          Text formatting
        • for an RTF caption: via the formatting toolbar that is displayed above the control:
          RTF caption formatting
    • Method 2:
      1. Select the control.
      2. Open the control description window ("Description" in the context menu).
      3. Enter the new text in each language supported by the control.
      4. Modify (if necessary) the formatting in the "Style" tab.
        Style of caption
Multilingual Static control
If your application or your site is multilingual, a different caption can be typed for each language supported by the report.
Depending on the language of the project, the corresponding text will be printed.
"Currency + Euro" Static control
For a "Currency + Euro" Static control, you have the ability to manage:
  • the stored currency: currency of the data in the report data source. If the control is handled through programming, the currency used for the value will be the stored currency.
  • the display currency: currency used to display the value when printing the report. This currency can differ from the stored currency. The conversion is automatically performed.
  • the dual display: two "Currency + Euro" controls can be bound. In this case, the report editor distinguishes between two types of controls:
    • the base control: this control contains the value in the report data source.
    • the tracker control: this control is used to display the value of base control in the selected currency.
For more details, see Currency + Euro type.

Calculated control

The "Calculated" control is used to perform calculations in a report. These calculations can be made:
  • on an item of the data source.
  • on a control found in the report.
  • programmatically.
Examples:
Calculated control
Specific "Calculated" control: "Currency + Euro"
For a "Currency + Euro" Calculated control, you have the ability to manage:
  • the stored currency: currency of the data in the report data source. If the control is handled through programming, the currency used for the value will be the stored currency.
  • the display currency: currency used to display the value when printing the report. This currency can differ from the stored currency. The conversion is automatically performed.
  • the dual display: two "Currency + Euro" controls can be bound. In this case, the report editor distinguishes between two types of controls:
    • the base control: this control contains the value in the report data source.
    • the tracker control: this control is used to display the value of base control in the selected currency.
For more details, see Currency + Euro type and Calculated control.

Image control

An "Image" control is used to display an image in the report. The image displayed in the control can:
  • be selected from the control description window ("General" tab) by clicking Drop-down button:
    • The "Browse" option is used to select an image file accessible from your computer.
    • The "Catalog" button is used to choose an image found in the image catalog of WINDEV.
  • correspond to the content of an item found in the data source (for example, if the data source is an HFSQL file, the item can be an Image memo or a character string containing the full image path). The "Image" control is bound to this item.
    Remark: The item (or variable) bound to the control is defined in the "Binding" tab of the control description window.
Multilingual images
If your application or your site is multilingual, a different image can be selected for each language supported by the report. This option is useful for images with text, for example.
The corresponding image will be printed according to the runtime language of project. To select image for each language, click Drop-down button and select "Multilingual".
For more details, see The Image control.
WINDEVWEBDEV - Server codeReports and QueriesiPhone/iPadIOS WidgetMac Catalyst

Bar Code control

The "Bar code" control is used to easily print bar codes in your reports.
The value of a "Bar code" control corresponds to an alphanumeric string.
The "Bar Code" control can be bound to an item from the report data source or can be specified programmatically. Remark: You can also specify an initial value in the "General" tab of the control description window.
The report editor proposes several types of bar codes that can be printed horizontally or vertically.
Example:
Bar code
Remark: The item or variable bound to the control is defined in the "Binding" tab of the control description window.
For more details, see The Bar Code control.

Preset control

The preset control is used to display current information without any programming. A "Preset" control can be inserted into a report to display the following information:
  • System date,
  • System time,
  • Number of the current page,
  • Total number of pages in the report,
  • Number of the current page in relation to the total number of pages in the report.
Example:
Preset control
To modify the type of information displayed in a "Preset" control:
  1. Go to the "General" tab in the "Preset" control description window ("Description" in the control context menu).
  2. Select the type of information displayed ("Type" combo box).
  3. Validate.
For more details, see Preset control.

Chart control

The "Chart" control is used to view and print a chart in your reports. The types of charts available are as follows:
  • Pie, donut, semi-circular.
  • Column (clustered or stacked, vertical or horizontal).
  • Line, area.
  • Scatter, radar.
  • Bubble chart.
  • Stock chart (Candlestick, MinMax or BarChart).
Remarks:
  • Android This control is not available. To display a chart in a report, you can:
    • Create a chart in a window via a Chart control.
    • Save an image of the chart with grSaveImage.
    • Display this image via an Image control in the report.
  • iPhone/iPadIOS WidgetMac Catalyst Only the Chart controls created from version 17 (or updated) are available.
  • The series of the Chart control can be bound to an Array variable.
Example:
Chart report
Information specific to chart creation
A chart creation wizard starts automatically. This wizard is used to enter the information required to create the Chart control. This information is as follows:
  • the type of chart (stock, pie, line, ...).
  • the chart parameters: title, legend, 3D chart, display of labels, ...
  • the parameters of axes: titles, grid, ...
  • the characteristics of series:
    • the source and data displayed by the category labels (programming, data file, query, WLanguage array, report data source).
      Category labels
    • the name of series (used for the series labels):
      Series labels
    • the source of series (programming, data file, query, WLanguage array, report data source)
    • the data displayed by the series.
    • the line thickness, the color and the type of dots.
Remark: if the data source corresponds to the report data source, you can define:
  • the fill block,
  • the control or the item corresponding to the series,
  • the selection mode of data.
For more details, see Chart control.

Shape control

A "Shape" control is used to insert geometric shapes into a report. You have the ability to insert:
  • horizontal or vertical lines,
  • circles,
  • rectangles (with straight or rounded borders).
The line style, thickness and color can be entirely configured.

Check Box control

A "Check box" control corresponds to a box to check.
If the control value is set to True, the box is checked: Checked box
If the control value is set to False, the box is unchecked: Unchecked box
A "Check box" control can be bound to an item or variable in the report data source. For example, if the data source corresponds to an HFSQL file, the item can be a boolean or a check box.
The size, the background color and the color of check box can be configured.
Example:
Check Box control
Remark: The item or variable bound to the control is defined in the "Binding" tab of the control description window.

Internal Report control

The "Internal report" controls are used to print several reports (secondary reports) in a single report (main report) without programming.
For example, the following main report is made of two secondary reports printed side-by-side:
  • a report displaying the data in a table.
  • a report displaying the data in a chart.
    Internal report
For more details, see Internal report.
Benefits of internal reports compared to the nested reports
The report editor can also be used to simultaneously print several reports via nested reports. However, the nested reports are a bit more complicated to use. Indeed, the nested reports require:
  • the call to iPrintReport to print the secondary report.
  • the obligation to print the nested report after the main report. These reports cannot be printed side by side.
The internal reports allow you to print several reports without programming:
  • one below another,
  • side by side.
For more details, see Nested reports.

URL Link control

A "URL link" control is used to insert links into a report. You have the ability to insert:
  • a link to an email address,
  • a link to an Internet site,
  • ...
The "URL Link" control is enabled only if the report is printed in an HTML file. Otherwise, the "URL link" control is visible but it is disabled. When printing to PDF, only the links that correspond to site or page addresses are active.
Example:
Link control
Remark: The item or variable bound to the control is defined in the "Binding" tab of the control description window.

Edit control

An edit control is used to type and display text in a report. You can use an edit control:
  • to allow the user to type the information to print,
  • to allow the user to modify the information to print,
  • ...
The edit control is enabled only if the report is displayed in "Print preview" mode or if it is printed to a PDF file. In the other cases, the edit control is visible but it is disabled.
Characteristics of edit controls
When creating an edit control in a report, you have the ability to define:
  • the type of control (text, numeric, date, time),
  • the associated mask: the available masks are the ones supported by the PDF format. They are available for the numerics, the dates and the times.
  • the input size, which means the maximum number of characters allowed in the control. If this parameter is set to 0, there is no limit.
  • the horizontal alignment,
  • the initial value,
  • the style of caption and input area.
Remarks:
  • Multiline edit control: if the users enter more lines than what is visible, the non-visible lines will not be printed. During the input, the edit controls manage a vertical scrollbar.
  • Style of input area: In this version, only the "Arial" font can be used.
  • The edit control is not bound to an item in a data file or query. To display information coming form a file or from a query, the control must be assigned by programming.
  • The borders of the input area cannot be configured (thickness, color, etc.).
  • No currency type can be used (the Euro symbol is not supported).
  • iPhone/iPadIOS WidgetMac Catalyst This type of control is not available (Acrobat on iOS does not support the input).
For more details, see Editable reports.
WINDEVWEBDEV - Server codeWindows

Signature control

The "Signature" control is used to sign the reports printed in PDF format. Two types of signatures are available:
  • Approval signature,
  • Certification signature.
For more details, see Signature control.
Related Examples:
WD Reports Training (WINDEV): WD Reports
[ + ] This example presents the different methods for creating a report:

- prints based on different data sources (queries, variables, ...)
- prints based on controls (Table, Spreadsheet, PVT, ...)
- printing composite reports
- specific prints (portrait/landscape, report with watermark, report with bar code, ...)
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 11/05/2024

Send a report | Local help