ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Editors / Report editor / Report controls
  • Overview
  • Creating a control in a report
  • Creating a simple control
  • Creating a control from a dictionary control
  • Creating a control from the clipboard content
  • Creating an Image control from an image file by Drag and Drop
  • Binding a control to a data file item or variable
  • Selecting and deleting the report controls
  • Selecting one or more controls in a report
  • Deleting one or more controls from a report
  • Copying the report controls
  • Overview
  • Copying a control into the same report
  • Copying a control from a report into another report
  • Copying the control style
  • Moving one or more report controls
  • Locking controls
  • Aligning the report controls
  • Using an off-report control
  • Overview
  • Creating an "off-report" control
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
Handling controls in a report
Overview
The different operations available for the report controls are as follows:Remark: These operations differ for the controls belonging to a table. For more details, see Handling the cells of report table.
Creating a control in a report

Creating a simple control

To create a control in a report:
  1. On the "Creation" tab, click the control you want to create:
  2. Click where you want to create the control.

Creating a control from a dictionary control

A report control can be created from a control from a control found in a dictionary. A dictionary is used to store several elements (controls, reports, ...) for a future use in new projects. For more details, see Dictionary.
To create a control from a control found in a dictionary:
  1. Display the "Dictionary" pane.
  2. Open the dictionary if necessary ("Open" in the context menu).
  3. Select the initial control found in the dictionary (in the "Report controls" category).
  4. Drag and Drop the control from the dictionary to the future position of the control in the report.
  5. Subscribe the created control to the dictionary if necessary. If the created control subscribes to the dictionary, the modifications made to the control found in the dictionary will be automatically applied to the created control. For more details, see Subscribing an element to the dictionary.

Creating a control from the clipboard content

The report editor allows you to create some types of controls according to the clipboard content:
Clipboard contentType of created control
Unformatted text, retrieved in a text editor for example.Static control
Formatted text, retrieved in a text editor for example.RTF control
Image file from Windows Explorer.Image control
Image, retrieved from Internet for example.Image control

To create a control from the clipboard content:
  1. Copy the element to the clipboard (Ctrl + C from the element editor).
  2. In the report editor, on the "Home" tab, in the "Editing" group, click "Paste" (or Ctrl + V).

Creating an Image control from an image file by Drag and Drop

The report editor allows you to create an Image control by dragging an image file from Windows explorer and dropping it onto a WINDEV report.
To create an Image control from an image file:
  1. Select the desired image file in Windows Explorer.
  2. Hold the left mouse button down and move the image file to a report opened in the editor.
  3. Release the mouse button. An Image control associated with the image file is automatically created.
Remark:
The following image formats are supported in Windows:
  • Bitmap (*.BMP)
  • Graphics Interchange Format (*.gif)
  • Joint Picture Experts Group (*.jpg ; *.jpeg)
  • Kodak Photo CD (*.pcd)
  • PaintBrush (*.pcx)
  • Adobe Photoshop Format (*.psd)
  • TrueVision TARGA (*.tga)
  • Tagged Image File Format (*.tif ; *.tiff)
    Remark: the "tiled tiff" option of tiff 6.0 standard is not supported. In this case, we advise you to save the image in tiff 5.0 standard.
  • Portable Network Graphics (*.png)
  • Windows MetaFiles (*.emf ; *.wmf)
  • Icons (*.ico ; *.icw)
    Remarks:
    • HQ display (High Quality) available.
    • Management of sheets in transparent BMP format (32 bits).
  • Cursors (*.cur)
  • Portable Document Format (*.pdf)
  • Scalable Vector Graphics (*.svg)
  • WINDEV images (generated by the image editor, *.WDPIC).
Binding a control to a data file item or variable
You can bind:
  • a report control (Static, Calculated, Image, Bar code, Check box, Link or Chart) to a data file item found (or not) in the report data source.
  • a report control (Static, Calculated, Image, Bar Code, Check box or Link) to a variable in the report data source.
To bind an existing control to data file item or variable:
  1. Select the desired control.
  2. Right-click and select "Description" in the context menu to open the control description window, then go to the "Binding" tab (or "Series" tab if it is a chart).
  3. Select the bound item or variable.
Remark: You can also create a Static control directly from a data file item:
  1. In the "Analysis" pane, select the item that will be bound to the control to be created.
  2. Drag the item and drop it onto the position where you want to create the bound control.
Selecting and deleting the report controls

Selecting one or more controls in a report

The report editor allows you to select one or more report controls with the keyboard or with the mouse. For more details, see Selecting one or more controls.

Deleting one or more controls from a report

To delete one or more report controls:
  1. Select the controls to delete.
  2. Press the Del key.
Copying the report controls

Overview

One or more controls can be copied in the same report or from one report to another. The description and the code of copied control will be identical to the ones of initial control.

Copying a control into the same report

To copy a control into the same report:
  1. Select the control to copy.
  2. On the "Home" tab, in the "Editing" group, click "Copy".
    Remark: You can also select "Copy" in the context menu of the control.
  3. On the "Home" tab, in the "Editing" group, click "Paste".
    Remark: You can also select "Paste" in the context menu of the control.
  4. Position the control with the mouse (the control outline appears in dotted lines and it helps you position the new control).

Copying a control from a report into another report

To copy a control from a report into another report:
  • 1st method:
    • In the first report, select the control to copy.
    • On the "Home" tab, in the "Editing" group, click "Copy".
      Remark: You can also select "Copy" in the context menu of the control.
    • Display the destination report in the report editor.
    • On the "Home" tab, in the "Editing" group, click "Paste".
      Remark: You can also select "Paste" in the context menu of the control.
    • Position the control with the mouse (the control outline appears in dotted lines and it helps you position the new control).
  • 2nd method: (both reports must be displayed in the editor)
    • In the first report, select the control to copy.
    • Keep the left mouse button down and drag the control toward the destination report.
    • Release the mouse button once the control is positioned in the destination report (the outline control appears in dotted lines and it helps you position the pasted control).

Copying the control style

Copying the style of a control consists in copying the characteristics of a control style to another control. Only the control style is copied (not its content).
For more details, see Copying the control style.

Moving one or more report controls

To move one or more report controls:
  1. Select the controls to move.
  2. Keep the left mouse button down and move the controls with the mouse. The real-time interface checker allows you to align the controls (see the paragraph below).
Remarks:
  • A control necessarily belongs to a block.
  • The selected controls can also be moved with the arrow keys found on the keyboard. To speed up the move, press the Ctrl key together with the arrow key. To slow down the move, press the Shift key together with the arrow key.

Locking controls

In some cases, you may want to lock the controls in a fixed position: in this case, the control cannot position be modified and the control is not selected during a selection performed with the lasso. This feature is often useful for the layout controls.
To lock a control:
  1. Select the control.
  2. Use:
    • "Lock" in the context menu of the control.
    • the Alt + V keys.

Aligning the report controls

The report editor provides multiple methods to align controls in a report:
Using an off-report control

Overview

In most cases, the controls belong to a report. Therefore, these controls appear in the report in edit mode and at runtime.
A control can also be positioned in the home window of a report: the control is said to be "off report". This control will be visible in edit mode only. This control will not be printed.
Home window
An "off-report" control is used to store a report control without printing it. This allows you to use the content of the control programmatically (like a variable).

Creating an "off-report" control

To create an "off-report" control:
  1. On the "Creation" tab, click the control you want to create.
  2. Click the left section of the home window where the control must be created.
See also
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 02/29/2024

Send a report | Local help