PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK

  • Limits
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
..DisplayedItem is used to:
  • Find out the item or the variable displayed by the control.
  • Modify the item or the variable displayed by the control.
Notes:
  • In the report "Opening" event, this property is used to modify the item displayed in a control when the data source of the report is modified by programming (by ..SourceName for example).
  • If this property is used in the control "Before printing" event, the change will be performed the next time the control is printed (indeed, the item value is already read when running the control "Before printing" event).
  • The displayed item can come from a data file, a view or a query.
  • The stored item or the stored variable is defined in the window editor or in the page editor, in the "Content" tab of control description.
Example
Reports and Queries
// -- Report opening
// Change the browsed data file
RPT_Report1..SourceName = Customer
// New item displayed in "CustomerName" control
CustomerName..DisplayedItem = "CustomerName"
Reports and Queries
// Change the data file associated with the report
// Switch from Customer data file to Prospect data file
RPT_CustomerReport..SourceName = Prospect
// Change the view associated with the report.
// This view is based on the Prospect data file.
RPT_CustomerReport..ViewName = MyCustomerView84
CustomerName..DisplayedItem = "ProspectName"
Syntax
Reports and Queries

Finding out the item/variable displayed by a Table, List Box or Combo Box control Hide the details

<Item/variable currently displayed> = <Control name>..DisplayedItem
<Item/variable currently displayed>: Character string
  • Name of item displayed by the specified control. This item belongs to the data file browsed by the control (returned or modified by ..BrowsedFile).
  • Name of variable displayed by the specified control. This name has the following format:
    ":<prefix><Variable name>"
    or
    ":<Variable name>"
    (the prefix is found only if the programming charter is enabled in the project).(the prefix is applied only if the code style is enabled in the project).
    This variable belongs to the variable browsed by the control (returned or modified by ..BrowsedFile).
  • For a Table control, list of the names of items or variables displayed by each column. The names of items/variables are separated by the "|" character (AltGr + 6 keys).
<Control name>: Character string (with or without quotes)
Name of control to use: Table, List Box, ListView or Combo Box.
Reports and Queries

Modifying the item/variable displayed by a Table, List Box or Combo Box control Hide the details

<Control name>..DisplayedItem = <New item/variable>
<Control name>: Character string (with or without quotes)
Name of control to use: Table, List Box, ListView or Combo Box.
<New item/variable>: Character string
  • Name of item that will be displayed in the specified control. This item belongs to the data file browsed by the control (returned or modified by ..BrowsedFile).
  • Name of variable that will be displayed in the specified control. This name has the following format:
    ":<prefix><Variable name>"
    or
    ":<Variable name>"
    The prefix must be specified only if the programming charter is enabled in the project (no matter whether prefixes are displayed or not).The prefix must be specified only if the code style is enabled in the project (no matter whether prefixes are displayed or not).
    This variable belongs to the variable browsed by the control (returned or modified by ..BrowsedFile).
  • For a Table control, list of the names of items or variables displayed by each column. The names of items/variables are separated by the "|" character (AltGr + 6 keys).
Reports and Queries

Finding out the item displayed by a report control Hide the details

<Item currently displayed> = <Control name>..DisplayedItem
<Item currently displayed>: Character string
Name of item associated with the specified control. For a multi-file link, the item name has the following format:
<Name File1>.<Item name> + TAB + <Name File2>.<Item name>
This item corresponds to:
  • an item belonging to the file used as data source for the report (returned or modified by ..SourceName).
  • an item (or its alias) belonging to the query used as data source of report.
<Control name>: Character string (with or without quotes)
Name of report control to use.
In a report, this control can be:
  • an Image control,
  • a Bar Code control,
  • a Rich Edit control,an RTF Static control,
  • an Item control,a Static control,
  • a Check Box control,
  • Versions 15 and later
    a Calculated control.
    New in version 15
    a Calculated control.
    a Calculated control.
  • Versions 21 and later
    a Spreadsheet control
    New in version 21
    a Spreadsheet control
    a Spreadsheet control
Reports and Queries

Modifying the item displayed by a report control Hide the details

<Control name>..DisplayedItem = <New item>
<Control name>: Character string (with or without quotes)
Name of report control to use.
In a report, this control can be:
  • an Image control,
  • a Bar Code control,
  • a Rich Edit control,an RTF Static control,
  • an Item control,a Static control,
  • a Check Box control,
  • Versions 15 and later
    a Calculated control.
    New in version 15
    a Calculated control.
    a Calculated control.
  • Versions 21 and later
    a Spreadsheet control
    New in version 21
    a Spreadsheet control
    a Spreadsheet control
<New item>: Character string with quotes
Name of new item associated with the specified control. For a multi-file link, the item name has the following format:
<Name File1>.<Item name> + TAB + <Name File2>.<Item name>
This item corresponds to:
  • an item belonging to the file used as data source for the report (returned or modified by ..SourceName).
  • an item (or its alias) belonging to the query used as data source of report.
Remarks

Limits

Reports and Queries In the reports, ..DisplayedItem applies to the following controls:
  • Image control.
  • Bar Code control.
  • Rich Edit control,RTF Static control.
  • Item control,Static control.
  • Check Box control.
  • Versions 15 and later
    calculated control.
    New in version 15
    calculated control.
    calculated control.
  • Versions 21 and later
    Spreadsheet control.
    New in version 21
    Spreadsheet control.
    Spreadsheet control.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment