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
  • Browsing List Box control or List Box control on source: Number of rows
  • 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 15 and later
Android List Box controls are now available for Android applications.
New in version 15
Android List Box controls are now available for Android applications.
Android List Box controls are now available for Android applications.
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 17 and later
iPhone/iPad List Box controls are now available for iPhone/iPad applications.
New in version 17
iPhone/iPad List Box controls are now available for iPhone/iPad applications.
iPhone/iPad List Box controls are now available for iPhone/iPad applications.
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.
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 by programming.
  • come from a data file or query.
  • come from a variable (global to the project, window or page; class member, etc.).
WINDEVWindows Mobile 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".
    • WEBDEV - Server code click "List Box".
    • WINDEV Mobile expand "List Box" and click "List Box".
  2. Click where the control will be created in the window. 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
WEBDEV - Server code

Browsing List Box control or List Box control on source: Number of rows

You can specify the maximum number of rows displayed in a browsing List Box control or in a List Box control on source ("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