PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Overview
  • Description window of report controls
  • Characteristics by tab
  • Main print parameters of report controls
  • Using the modifier
  • Overview
  • Viewing and/or modifying the characteristics of one or more controls with the modifier
  • Modifying the control caption
  • Modifying the control name
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
Modifying the characteristics of report controls
Overview
The characteristics of one or more controls can be viewed and/or modified in:
  • the description window of this control.
  • the modifier.
The report editor also allows you to:
  • modify the control caption.
  • modify the control name.
Description window of report controls
To display the description window of a control, use one of the following methods:
  • double-click the control (recommended).
  • select "Description" from the popup menu of control (right mouse click).
  • select the control and select "Control .. Description" (Alt + Enter keys).
  • select the control and select "Display .. Description of the selection".
  • select "Report .. Report controls and blocks" (F12 key). Then, select the control and click the "Description" button.
  • double-click the control (recommended).
  • select "Description" from the popup menu of control (right mouse click).
  • select the control and on the "Modification" pane, click the group icon Group icon of "Quick edit" group (Alt + Enter keys).
  • on the "Display" pane, click the group icon Group icon of "Options" group (F12 key). Then, select the control and click the "Description" button.
Note: The description window can be displayed for a selection of controls. Only the characteristics common to the selected controls will be displayed.

Characteristics by tab

The description window groups the characteristics of selected controls by tab:
TabCharacteristics
GeneralUsed to specify the control name and the display characteristics of control. For example:
  • the control caption (this caption can be multilingual).
  • the type of information displayed in the control (text, numeric, ...).
  • the display mask used for the control (the mask can be multilingual). See the Different display masks for more details.
  • the image displayed in an Image control, the type of bar code used in a Bar Code control, the type of chart used in a Chart control, etc. See the online help about this type of control for more details.
DetailsGUIUsed to define:
  • the print parameters of control (visible, breakable, ...). See Print parameters of report controls for more details.
  • the control size.
  • the control position in the report and in the block to which the control belongs.
  • Versions 19 and later
    the control anchoring.
    New in version 19
    the control anchoring.
    the control anchoring.
  • the associated group of controls.
  • Versions 19 and later
    the associated plane.
    New in version 19
    the associated plane.
    the associated plane.
LinkUsed to define the item or the variable found in the data source to which the control is linked. The value of this item or variable will be displayed in the control.
To link the control to an item or to a variable that belongs to the data source of report, select this item in the "Linked item" list.
To link the control to an item that does not belong to the data source of report, select "Multi-file" then select the item linked to the current control.
Versions 24 and later
Note
New in version 24
Note
Note
Used to describe the detailed operating mode of control.
This information will be printed in the program documentation ( Print icon icon on the "Home" pane, in the "General" group).
This information can be completed and found by programming via ..Note and ..NoteTitle.
StyleUsed to define:
  • the control style (background color, border, ...).
  • the font used in the control.
Note: The font used in the control can also be defined via the icons found in the "Popup toolbar".
Context-sensitive bar
Note: The font used in the control can also be defined via the icons of "Quick edit" group in the "Modification" pane.
Note: See the online help about the description window ( Context-sensitive help ) for more details.
Versions 22 and later
Note: All options found in the description window of report editor propose full tooltips, displaying for example, in addition to the help about the option, the corresponding WLanguage property, the availability for each platform, the multilingual values, ...
New in version 22
Note: All options found in the description window of report editor propose full tooltips, displaying for example, in addition to the help about the option, the corresponding WLanguage property, the availability for each platform, the multilingual values, ...
Note: All options found in the description window of report editor propose full tooltips, displaying for example, in addition to the help about the option, the corresponding WLanguage property, the availability for each platform, the multilingual values, ...
Main print parameters of report controls
The print parameters of a control are as follows (defined in the "Details" tab of description window):The print parameters of a control are as follows (defined in the "GUI" tab of description window):
ParameterDescriptionAvailable for the following controls
VisibleThe control can be displayed or not. This characteristic can be modified by programming with ..Visible.Caption, Item, Calculated control, Image, Bar code, RTF control, Preset control, Chart, Shape, Internal Report control
Auto-SizableAuto-resizableThe control size defined in the report editor can be enlarged according to the control content. The controls that follow the "auto-resizable" control will be moved automatically.
Notes:
  • If a control is not an auto-resizable control, its content can be truncated if the control size is too small.
    To know the height of an auto-resizable control by programming when the control enlarged, use ..FutureHeight.
  • If a control found in a block is an auto-resizable control, the associated block will automatically be auto-resizable. A block containing auto-resizable controls is auto-resizable. A block containing no auto-resizable control is not auto-resizable.
  • The controls found in a page footer cannot be auto-resizable.
Limit: In a Label report, the controls cannot be auto-resizable controls.
Caption, Item, Calculated control, Shape, Bar code, Internal Report control
Multi-lineThe control content can be displayed over several lines. This characteristic can be modified by programming with ..Multiline.
Notes:
  • The control height must be sufficient to display several lines.
  • To modify the control height by programming, use ..Height.
  • If an orientation angle is applied to a multiline control, the automatic CR characters are ignored. Only the manual CR characters are taken into account.
Caption, Item, Calculated control, Preset control
BreakableThe content of a breakable control can be printed over several pages if there is not enough space to print the entire control on a page.
Notes:
  • In order for a control to be a breakable control, the block containing the control must also be breakable.
  • If there is not enough space on the current page to print a non-breakable control, the entire control will be printed on the next page.
Caption, Item, Calculated control, Image, Bar code, RTF control, Preset control, Chart, Shape
Reset if zeroThe control value is displayed only if the control value differs from 0.
If the control value is equal to 0, the control displays an empty string ("").
Caption, Item
Versions 23 and later
Ellipsis (long captions will end with '...')
New in version 23
Ellipsis (long captions will end with '...')
Ellipsis (long captions will end with '...')
The ellipsis is used to indicate that a caption is too long to be entirely displayed. The following characters are added to the caption: "...". These characters can be added at the end of caption or in the middle of the text (recommended when displaying file paths). Item, Calculated control
Displayed when the value changesThe control value is displayed only if the value of linked item changes when going to the next record in the data source of report.Item, Calculated control
Reset to 0 after printThe control value is automatically reset to 0 once it was printed.
This parameter is often used for the calculations on break.
Calculated control
RTF formatThe control value can be in RTF format.
Reminder: The RTF format is used to take into account the attributes of characters (bold, italic, underline, ...) in a text.
Caption, Item, RTF control
Use the shared information at run timeThe control will display the "shared information" of the item linked to the control (and not the subscript corresponding to this "shared information").
For example, the "RAD info" of the "Title" item correspond to the following combo box:
RAD Information
Only the subscripts of "Shared info" are stored in the database.
Item
Horizontal/Vertical gridlinesThe horizontal and/or vertical gridlines can be displayed (or not) in a chart.Chart
Using the modifier

Overview

The modifier is used to view and/or modify from the report editor the main characteristics:
  • of selected controls.
  • of the selected report or block.
See the Modifier for more details.

Viewing and/or modifying the characteristics of one or more controls with the modifier

To view and/or modify the characteristics of one or more controls with the modifier:
  1. Select the controls to modify:
    • in the report directly (see Select one or more controls).
    • via the drop-down list of modifier. In this case, a single control can be selected at a time. The handles of the selected control are automatically displayed.
      If several controls are selected, only the information common to the selected controls is displayed in the modifier.
  2. Perform the necessary modifications. These modifications are performed on all controls. You can:
    • select the new value in a drop-down list.
    • select the new value in a screen (color modification for example).
    • modify the value directly.
Modifying the control caption
To modify the caption of a control in the report currently created:
  1. Select the control to modify.
  2. Click the control again or press the Enter key. The mouse cursor turns into an input cursor.
    Modifying the caption
  3. Type the new caption of control.
  4. Validate the input by pressing the Enter key.
Modifying the control name
The name of a control can be modified from the status bar of the report editor.
To modify the control name:
  1. Select the control to modify.
  2. Type the new control name in the status bar.
    Modifying the name of the control
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment