PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN

This content has been translated automatically. Click here to view the French version.
  • Handling the browsing Table, Looper, List Box, ListView and Combo Box controls using properties
  • Modifying the item displayed in the memory Table controls, browsing Table controls and Table controls on source
  • Memory Table control
  • Memory List Box control
  • ListView control
  • 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
The Property DisplayTopic allows you to:
  • Find out the item or the variable displayed by the control.
  • Modify the item or the variable displayed by the control.
Remarks:
  • 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 variable is defined in the window or page editor, in the "Content" tab of the control description.
WINDEVWINDEV Mobile For a ListView control, this item corresponds to the caption displayed in the ListView control.
Versions 15 and later
Android This property is now available for Android applications.
New in version 15
Android This property is now available for Android applications.
Android This property is now available for Android applications.
Versions 17 and later
iPhone/iPad This property is now available for iPhone/iPad applications.
New in version 17
iPhone/iPad This property is now available for iPhone/iPad applications.
iPhone/iPad This property is now available for iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This property is now available in Windows Store apps mode.
iPhone/iPad This property is now available for report controls in iPhone/iPad applications.
New in version 18
Universal Windows 10 App This property is now available in Windows Store apps mode.
iPhone/iPad This property is now available for report controls in iPhone/iPad applications.
Universal Windows 10 App This property is now available in Windows Store apps mode.
iPhone/iPad This property is now available for report controls in iPhone/iPad applications.
Versions 20 and later
AndroidiPhone/iPad This property is now available for Table controls in Android and iPhone/iPad applications.
New in version 20
AndroidiPhone/iPad This property is now available for Table controls in Android and iPhone/iPad applications.
AndroidiPhone/iPad This property is now available for Table controls in Android and iPhone/iPad applications.
Versions 21 and later
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Example
WINDEVWEBDEV - Server codeReports and QueriesiPhone/iPadUniversal Windows 10 AppWindows MobileAjaxUser code (UMC)
// -- Report opening
// Change the browsed data file
RPT_Report1.SourceName = Customer
// New item displayed in "CustomerName" control
CustomerName.DisplayedItem = "CustomerName"
WINDEVWEBDEV - Server codeReports and QueriesiPhone/iPadUniversal Windows 10 AppWindows MobileAjaxUser code (UMC)
// 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"
WINDEVWEBDEV - Server codeWindows MobileJavaAjaxUser code (UMC)
// 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
WINDEVWEBDEV - Server codeReports and QueriesAndroidiPhone/iPadUniversal Windows 10 AppWindows MobileJavaAjaxUser code (UMC)

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

<Item/variable currently displayed> = <Control used>.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 field (known or modified thanks to the Property BrowsedFile).
  • Name of variable displayed by the specified control. This name has the following format:
    ":<prefix><Variable name>"
    or
    ":<Variable name>"
    (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 used>: Control name
Name of control to use: Table, List Box, ListView or Combo Box.
WINDEVWEBDEV - Server codeReports and QueriesAndroidiPhone/iPadUniversal Windows 10 AppWindows MobileJavaAjaxUser code (UMC)

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

<Control used>.DisplayedItem = <New item/variable>
<Control used>: Control name
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 field (known or modified thanks to the Property 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 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).
WINDEVWEBDEV - Server codeReports and QueriesiPhone/iPadUniversal Windows 10 AppWindows MobileAjaxUser code (UMC)

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

<Item currently displayed> = <Control used>.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:
  • or to a field belonging to the report data source file (known or modified through Property SourceName).
  • an item (or its alias) belonging to the query used as data source of report.
<Control used>: Control name
Name of report control to use.
In a report, this control can be:
  • an Image control,
  • a Bar Code control,
  • an RTF Static 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
WINDEVWEBDEV - Server codeReports and QueriesiPhone/iPadUniversal Windows 10 AppWindows MobileAjax

Modifying the item displayed by a report control Hide the details

<Control used>.DisplayedItem = <New item>
<Control used>: Control name
Name of report control to use.
In a report, this control can be:
  • an Image control,
  • a Bar Code control,
  • an RTF Static 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:
  • or to a field belonging to the report data source file (known or modified through Property SourceName).
  • an item (or its alias) belonging to the query used as data source of report.
Remarks
WINDEVWEBDEV - Server codeAndroidiPhone/iPadUniversal Windows 10 AppWindows MobileJavaAjaxUser code (UMC)

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

  • The records displayed in a browsing List Box, Table, Looper or Combo Box control come from the data file or query specified with BrowsedFile.
  • The sort direction is defined by BrowsedItem.
  • A filtering of the records can be done with the Property Filter or the HFilter function.
WINDEVWEBDEV - Server codeAndroidiPhone/iPadUniversal Windows 10 AppWindows MobileJavaAjaxUser code (UMC)

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 control, only the first items (or variables) are associated with the existing table columns.
  • A number of items lower than the number of columns in the Table control, the "additional" columns will not be associated with any item (or variable).
Remark: To associate a column with an item or with a variable, use FileLink.
WINDEVWEBDEV - Server codeAndroidiPhone/iPadWindows MobileJavaAjaxUser code (UMC)

Memory Table control

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 desired data. The data will be sorted according to the specified search item.
  • The Property DisplayedItem will be automatically initialized.
WINDEVWEBDEV - Server codeiPhone/iPadUniversal Windows 10 AppWindows MobileAjaxUser code (UMC)

Memory List Box control

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 desired data.
  • The properties BrowsedFile, DisplayedItem, BrowsedItem and StoredItem will be automatically initialized.
WINDEVWindows MobileJavaUser code (UMC)

ListView control

In the case of an ListView control, the DisplayedItem property allows you to know and modify only the Item corresponding to the labels 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

WINDEVWINDEV MobileJava In windows, the Property DisplayedItem applies only to:
  • Table controls,
  • List Box or ListView controls,
  • Combo Box controls.
WEBDEV - Server code In the pages, the Property DisplayedItem applies only to:
  • Table controls,
  • Looper controls,
  • List Box controls,
  • Combo Box controls.
WINDEVWEBDEV - Server codeReports and QueriesiPhone/iPadUniversal Windows 10 AppWindows Mobile In reports, Property DisplayedItem applies only to the following fields:
  • Image control.
  • Bar Code control.
  • RTF Static 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