PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Overview of the List Box control
  • Creating a List Box control
  • Vocabulary
  • Notes
  • Limitations in Java
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
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.
Versions 16 and later
WINDEVLinux List Box controls are now available for WINDEV applications in Linux.
New in version 16
WINDEVLinux List Box controls are now available for WINDEV applications in Linux.
WINDEVLinux List Box controls are now available for WINDEV applications in Linux.
Versions 18 and later
Universal Windows 10 App List Box controls are now available for applications in Windows Store apps mode.
New in version 18
Universal Windows 10 App List Box controls are now available for applications in Windows Store apps mode.
Universal Windows 10 App List Box controls are now available for applications in Windows Store apps mode.
WINDEV 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
The elements of a List Box control can:
  • be defined when the control is created in the editor.
  • be defined by programming.
  • 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 functions for handling graphic strings.
Creating a List Box control
To create a List Box control:
  1. On the "Creation" pane, in the "Data" group:
    • WINDEV expand "Table and List Box" and click "List Box".
  2. Click where you want to create the control. The List Box control creation wizard starts automatically.
To view the control characteristics, select "Description" in the popup menu of the control.
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 is automatically displayed 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.
Browsing List BoxThe 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 browsing List Box controls:
  • Browsing List Box "Loaded in memory": 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.
  • Browsing List Box in "Direct access mode (no limit)": 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.
Memory List BoxThe 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 by programming)
Single-selection List BoxThe user can select a single element in the List Box control.
Multiselection 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 on sourceThe List Box control is based on a variable (global to the project, window or page; class member, etc.).
Notes
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