DisplayedItem (Property)

Handling the browsing Table, Looper, List Box, ListView and Combo Box controls via the properties
Modifying the item displayed in the memory Table controls, browsing Table controls and Table controls on source
Memory table
Memory list box
ListView
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

DisplayedItem (Property)

In french: RubriqueAffichée

..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.

This modification is available for the "Automatic" or "Dynamic" controls only ("Details" tab of control description).

This modification is available for the "Automatic" or "Dynamic" controls only ("GUI" tab of control description).

Notes:

In the "Opening" process of report, this property is used to modify the item displayed in a control when the data source of report was modified by programming (by ..SourceName for example).
If this property is used in the "Before printing" process of control, the change will be performed during the next control print (indeed, the item value is already read when running the "Before printing" process of control).
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.

For a ListView control, this item corresponds to the caption displayed in the listview.

Versions 15 and later

This property is now available for the Android applications.

New in version 15

This property is now available for the Android applications.

Versions 17 and later

This property is now available for the iPhone/iPad applications.

New in version 17

This property is now available for the iPhone/iPad applications.

Versions 18 and later

This property is now available in Windows Store Apps mode.

This property is now available for the report controls in the iPhone/iPad applications.

New in version 18

This property is now available in Windows Store Apps mode.

This property is now available for the report controls in the iPhone/iPad applications.

This property is now available in Windows Store Apps mode.

This property is now available for the report controls in the iPhone/iPad applications.

Versions 20 and later

This property is now available for the Table controls in the Android applications and in the iPhone/iPad applications.

New in version 20

This property is now available for the Table controls in the Android applications and in the iPhone/iPad applications.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

Example

// -- Report opening
// Change the browsed file
RPT_Report1..SourceName = Customer
// New item displayed in "CustomerName" control
CustomerName..DisplayedItem = "CustomerName"

// Change the data file associated with the report
// Switch from Customer file to Prospect file
RPT_CustomerReport..SourceName = Prospect
// Change the view associated with the report.
// This view is based on the Prospect file.
RPT_CustomerReport..ViewName = MyCustomerView84
CustomerName..DisplayedItem = "ProspectName"

// Modify the items displayed in "TABLE_CustomerTable"
TABLE_CustomerTable..DisplayedItem = "CustomerFirstName|CustomerLastName|ZIP|City"
// Modify the item displayed in "LIST_CustomerList"
LIST_CustomerList..DisplayedItem "CustomerFirstName"

Syntax

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 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). This variable belongs to the variable browsed by the control (returned or modified by ..BrowsedFile).
For a table, lists the names of items or variables displayed by each table 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 (table, list box, listview or combo box) to use.

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 (table, list box, listview or combo box) to use.

<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). This variable belongs to the variable browsed by the control (returned or modified by ..BrowsedFile).
For a table, lists the names of items or variables displayed by each table column. The names of items/variables are separated by the "|" character (AltGr + 6 keys).

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 of 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

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

Handling the browsing Table, Looper, List Box, ListView and Combo Box controls via the properties

The records displayed in a browsing List Box, Table, Looper or Combo Box control come from the data file or from the query specified by ..BrowsedFile.
The sort direction is defined by ..BrowsedItem.
The records can be filtered by ..Filter or by HFilter.

Modifying the item displayed in the memory Table controls, browsing Table controls and Table controls on source

If <New item/variable> contains:

A number of items greater than the number of columns in the table, only the first items (or variables) are associated with the existing table columns.
A number of item less than the number of table columns, the "additional" columns will not be associated with any item (or variable).

Note: To associate a column with an item or with a variable, use ..FileLink.

Memory table

If a memory Table control must display data coming from a data file, a query or a view:

Create a memory Table control in the window editor.
In your program, specify the item that will be browsed by ..BrowsedItem. This item must belong to the data file, to the query or to the view whose data will be displayed in the memory Table control.
Use FileToMemoryTable to initialize the Table control with the requested data. The data will be sorted according to the specified search item.
..DisplayedItem will be automatically initialized.

Memory list box

If a memory List Box or Combo Box control must display data coming from a data file, a query or a view:

Create a memory List Box or Combo Box control in the window editor.
Use FileToMemoryList to initialize the List Box or Combo Box control with the requested data.
..BrowsedFile, ..DisplayedItem, ..BrowsedItem and ..StoredItem will be automatically initialized.

ListView

In a listview, ..DisplayedItem is used to find out and modify the item corresponding to the captions of the elements displayed in the control.

To find out and modify the item corresponding to the images displayed in the control, use ..DisplayedItemImage.

Limits

In the windows, ..DisplayedItem only applies to the:

tables,
list boxes (or listviews),
combo boxes.

In the pages, ..DisplayedItem only applies to the:

tables,
loopers,
list boxes,
combo boxes.

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.