ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / List Box control
  • Overview of the List Box control
  • Creating a List Box control
  • Vocabulary
  • Notes
  • List Box control based on a data file or on a variable: Number of rows
  • Limitations in Java
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
Overview of the List Box control
The List Box control is used to display a list of elements and to select one or more elements from this list.
The list is expanded, which means that multiple elements from the list are displayed in the window or page.
WINDEVWINDEV Mobile The following List Box controls are available in WINDEV and WINDEV Mobile:
Text List Box control
List Box control combining images and text.
Multicolumn graphic List Box used to easily select a color
WEBDEV - Server code In WEBDEV, List Box controls are in the following format::
The elements of a List Box control can:
  • be defined when the control is created in the editor.
  • be defined programmatically.
  • come from a data file or query.
  • come from a variable (global to the project, window or page; class member, etc.).
WINDEV You can also draw in the List Box controls or display an image with the graphic string management functions.
Creating a List Box control
To create a List Box control:
  1. On the "Creation" tab, in the "Data" group:
    • WINDEV expand "Table and List Box" and click "List Box".
    • WEBDEV - Server code click "List Box".
    • WINDEV Mobile expand "List Box" and click "List Box".
  2. Click at the desired location to create the control. The List Box control creation wizard starts automatically.
To view the characteristics of the control, select "Description" in the context menu.
Vocabulary
To easily handle a List Box control, you must be familiar with the following vocabulary:
NameDefinition
Selection barUsed to view the selected element. A specific color is used in most cases.
Vertical scrollScroll direction of the List Box control.
A vertical scrollbar appears automatically if the number of elements in the List Box control exceeds the number of visible elements.
If the size of an element exceeds the width of the List Box control, this element will be truncated. No horizontal scrollbar is automatically displayed.
List Box based on a data fileThe List Box control is based on a data file or query. The elements of the List Box correspond to the records of the data file. There are two types of List Box controls based on a data file:
  • List Box control with in-memory data source: the content of the List Box control is loaded in memory, then displayed. The elements of the List Box control can be accessed more quickly. This mode is reserved for data files with less than 100,000 records.
  • List Box control with direct access to the data source: The List Box control displays the content of the data file or query directly. The current record corresponds to the selected element. Selecting an element in the List Box control triggers an access to the linked data file. This type of List Box control is reserved for data files with more than 100,000 records.
List Box populated programmaticallyThe List Box is not based on a data file or query. The elements displayed in the List Box control are defined by the developer (in the description window or programmatically)
Single-selection List BoxThe user can select a single element in the List Box control.
Multi-selection List BoxThe user can select several elements at the same time in the List Box control.
To select multiple elements, the user can do one of the following:
  • select the elements one by one holding the Ctrl key down.
  • select several consecutive elements while holding the Shift key down.
List Box based on a variableThe List Box control is based on a variable (global to the project, window or page; class member, etc.).
Notes
WEBDEV - Server code

List Box control based on a data file or on a variable: Number of rows

You can specify the maximum number of rows displayed in a List Box control based on a data file or on a variable ("Content" tab). If this number is less than the number of elements in the List Box control, an error message appears when the page is loaded.
For example: If a List Box control contains 10 elements, but the maximum number of rows was set to 5, an error message will appear when the page is loaded.
Remark: The more elements contained in the control, the longer it will take to load the page.
Java

Limitations in Java

The following characteristics are not supported in Java:
  • tooltip on scrollbar.
  • multicolumn List Box.
  • help number associated with the List Box control.
Related Examples:
Moving elements between two list boxes Unit examples (WINDEV): Moving elements between two list boxes
[ + ] Using the ListXXX functions to move one or more elements from a list to another one.
Graphic lists Unit examples (WINDEV): Graphic lists
[ + ] Handling the graphic lists:
- Select or deselect an option in the list
- Manage a multi-column list
- Manage the selection by drag
- Manage a "hidden" value
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help