Note: See the online help about each type of control for more details.

Versions 18 and later

Most of these controls are available in the reports created for the iPhone/iPad applications.

New in version 18

Most of these controls are available in the reports created for the iPhone/iPad applications.

Most of these controls are available in the reports created for the iPhone/iPad applications.

Short description of the different types of controls

Static control

The "Static" control is used to display a character string. This character string can contain:

the content of an item (or variable) found in the data source of the report.

the content of another control found in the report.

a value defined by programming.

To insert the value of a report item or control into the text, the name of the item or control must be entered between the [% and %] characters.

For example, the caption can correspond to: The [%SupplierName%] supplier sells the [%ProductName%] product at [%PriceIOT%]. The SupplierName, ProductName and PriceIOT items will be replaced by their value when printing the report.

The character string can be entered over several lines. In this case, the control must be a multiline control and its size must be large enough.

Reminder: The "Auto-sizable" option is used to automatically increase the size of the control according to its content.

Examples:

Modifying the captionThe caption of a "Static" control can be modified:

Modify (if necessary) the formatting of the caption via the layout options found on the "Modification" pane, in the "Fast edit" group of the ribbon:

Method 2:

Select the control.

Display the description window of the control ("Description" from the popup menu of the control).

Type the new caption in each language supported by the control.

Modify (if necessary) the formatting in the "Style" tab.

Multilingual captionsIf your application or your site is multilingual, a different caption can be entered for each language supported by the report.The corresponding caption will be printed according to the runtime language of the project.

Transforming a "Static" control into an "RTF" controlTo display text in RTF format in a "Static" control, check "RTF format" in the "Details" tab of the control description ("Description" from the popup menu of control).The "Static" control becomes an "RTF" control. All the characteristics of the "Static" control are kept.See Static control for more details.

The RTF controls are not available.

The "Static" control is used to display different types of data:

text, RTF, HTML

numeric, currency, currency + Euro,

date,

time, duration.

To specify the type of data displayed in the control:

Display the "General" tab in the description window of the Static control ("Description" from the popup menu of control).

Select the type of information displayed ("Type" combo box).

Validate.

The displayed data can contain:

the content of an item (or variable) found in the data source of the report.Note: The item or the variable linked to the control is defined in the "Link" tab of the description window of control.

the content of another control found in the report.

a value defined by programming.

To insert the value of a report item or control into the text, the name of the item or control must be entered between the [% and %] characters.

For example, the caption can correspond to: The [%SupplierName%] supplier sells the [%ProductName%] product at [%PriceIOT%]. The SupplierName, ProductName and PriceIOT items will be replaced by their value when printing the report.

Note: 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-Sizable" option ("GUI" tab in the description window of the control) is used to automatically enlarge the control according to its content during the print.

Examples:

Modifying the captionThe caption of a "Static" control can be modified:

for a text caption: via the formatting options found on the "Modification" pane, in the "Fast edit" group of the ribbon:

for an RTF caption: via the formatting toolbar that is displayed above the control:

Method 2:

Select the control.

Display the description window of the control ("Description" from the popup menu of the control).

Type the new caption in each language supported by the control.

Modify (if necessary) the formatting in the "Style" tab.

Multilingual captionsIf your application or your site is multilingual, a different caption can be entered for each language supported by the report.The corresponding caption will be printed according to the runtime language of the project.

An "Image" control is used to display an image in the report. The image displayed in the control can:

be selected via the file picker (from the description window of the control).

correspond to the content of an item found in the data source (for example, if the data source is a HFSQL file, the item can be an Image memo or a character string containing the full path of the image). The "Image" control is linked to this item.

Note: The item or the variable linked to the control is defined in the "Link" tab of the description window of control.

Multilingual imagesIf your application or your site is multilingual, a different image can be selected for each language supported by the report. This option is useful when the images contain a text for example.The corresponding image will be printed according to the runtime language of the project.

The "Chart" control is used to view and print a chart in your reports. The available types of charts are as follows:

Pie, donut, semi-circular.

Column (grouped or stacked, vertical or horizontal)

Line, area

Scatter, radar

Versions 17 and laterBubble chart

New in version 17Bubble chart

Bubble chart

Stock chart (Candlestick, MinMax or BarChart).

Notes:

This control is not available in WINDEV Mobile.

This control cannot be linked to a variable.

Example:

Information specific to the chart creationA wizard for chart creation is automatically started. 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 mode for filling the chart (source identical to the one of the report or fill by programming).

the number of series.

the source of caption for the series. This caption comes from a control or from an item found in the data source associated with the report. This caption corresponds to:

the label of a data category (or section).

the label of a data series.

Category label

Series label

For each series:

the color and the caption of series.

the source of series. The values of the series come from a control or from an item found in the data source associated with the report.

the fill block.

the frequency of the marks on the vertical/horizontal axis of the chart (if necessary).

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 style, the thickness and the color of the line can be 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::

If the control value is set to False, the box is unchecked:

A "Check box" control can be linked to an item or variable found in the data source of the report. For example, if the data source corresponds to a HFSQL file, the item can be a boolean or a check box.

The size, the background color and the color of the check box can be configured.

Example:

Note: The item or the variable linked to the control is defined in the "Link" tab of the description window of control.

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:

Benefits of internal reports compared to the nested reportsThe 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 "RTF" (Rich Text Format) control is used to display a formatted character string in your report. This character string is in RTF format. Specific tags are used to define the formatting of each character or character string. These tags are not displayed in the control.

Note: The text displayed in the control can:

contain the value of an item or variable printed in the report. To insert the value of a report item or control into the text, type the name of the item or control between the [% and %] characters. For example, the text of the control can correspond to: The [%SupplierName%] supplier sells the [%ProductName%] product at [%PriceIOT%]. The SupplierName, ProductName and PriceIOT items will be replaced by their value when printing the report.

come from a text item or variable found in the data source of the report.If the control is linked to an item (or to a variable), the name of the associated item is displayed in the "Linked item" list of the "Link" tab of the control description.

Example:

Caption of a report that is using fonts of different colors

Modifying the text of an "RTF" controlThe text of an "RTF" control can be modified:

Select the control (click the control for example). The selection handles appear around the control.

Click the control again. The mouse cursor turns into an input cursor.

Enter the new text of the control.

Modify (if necessary) the formatting of the text via the formatting toolbar that is displayed above the control:

Transforming a "Static" control into an "RTF" controlTo display text in RTF format in a "Static" control, check "RTF format" in the "Details" tab of the control description ("Description" from the popup menu of control).The "Static" control becomes an "RTF" control. All the characteristics of the "Static" control are kept.

Transforming an "Item" control into an "RTF" controlTo display text in RTF format in an "Item" control, check "RTF format" in the "Details" tab of the control description ("Description" from the popup menu of the control).The "Item" control becomes an "RTF" control. All the characteristics of the "Item" control are kept.

Transforming an "RTF" Control into an "Item" controlTo display the RTF tags or to link the control to an item other than a text item, uncheck "RTF format" in the "Details" tab of the control description ("Description" from the popup menu of the control).The "RTF" control becomes an "Item" control. All the characteristics of the "RTF" control are kept.

Versions 18 and later

HTML control

The "HTML" control is used to display and print an HTML content in your report. The HTML content corresponds to a character string in HTML format. Specific tags are used to define the formatting of each character or character string. These tags are not displayed in the control.

Note: The text displayed in the control can:

contain the value of an HTML edit control found in a window.

come from an HTML file found on the computer.

come from a Memo item or from a text variable found in the data source of the report.If the control is linked to an item (or to a variable), the name of the associated item is displayed in the "Linked item" list of the "Link" tab of the control description.

The "HTML" control is used to display and print an HTML content in your report. The HTML content corresponds to a character string in HTML format. Specific tags are used to define the formatting of each character or character string. These tags are not displayed in the control.

Note: The text displayed in the control can:

contain the value of an HTML edit control found in a window.

come from an HTML file found on the computer.

come from a Memo item or from a text variable found in the data source of the report.If the control is linked to an item (or to a variable), the name of the associated item is displayed in the "Linked item" list of the "Link" tab of the control description.

The "HTML" control is used to display and print an HTML content in your report. The HTML content corresponds to a character string in HTML format. Specific tags are used to define the formatting of each character or character string. These tags are not displayed in the control.

Note: The text displayed in the control can:

contain the value of an HTML edit control found in a window.

come from an HTML file found on the computer.

come from a Memo item or from a text variable found in the data source of the report.If the control is linked to an item (or to a variable), the name of the associated item is displayed in the "Linked item" list of the "Link" tab of the control description.