ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
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
  • File List Box control or Variable List Box control: Number of lines
  • Limitations in Java
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
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:
control Text list
control List combining images and Text.
Graphic multi-column List Box control for easy Color
selection
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 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 file "Loaded into memory ": the contents of the List Box control are loaded into memory and 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 file "Direct access (unlimited) ": List Box control directly displays of the data file or query content. 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

File List Box control or Variable List Box control: Number of lines

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 an List Box control contains 10 elements with a maximum number of lines corresponding to 5, an error message will appear when the Page is loaded.
Remark: The greater the number of 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: 09/18/2024

Send a report | Local help