PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview of List Box control
  • Creating a List Box control
  • Vocabulary
  • Notes
  • Browsing list box or list box on source: Number of rows
  • Limits 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 List Box control
The List Box control is used to display a list of elements and to select one or more elements in this list.
The list is expanded, which means that several elements of the list are displayed in the window or in the page.
Versions 15 and later
Android The List Box controls are now available for the Android applications.
New in version 15
Android The List Box controls are now available for the Android applications.
Android The List Box controls are now available for the Android applications.
Versions 16 and later
WINDEVLinux The List Box controls are now available for the WINDEV applications in Linux.
New in version 16
WINDEVLinux The List Box controls are now available for the WINDEV applications in Linux.
WINDEVLinux The List Box controls are now available for the WINDEV applications in Linux.
Versions 17 and later
iPhone/iPad The List Box controls are now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad The List Box controls are now available for the iPhone/iPad applications.
iPhone/iPad The List Box controls are now available for the iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App The List Box controls are now available for the applications in Windows Store apps mode.
New in version 18
Universal Windows 10 App The List Box controls are now available for the applications in Windows Store apps mode.
Universal Windows 10 App The List Box controls are now available for the applications in Windows Store apps mode.
WINDEVWINDEV Mobile The following list boxes are available in WINDEV and WINDEV Mobile:
Text list box
List box combining images and text.
Multicolumn graphic list box used to easily select a color
WEBDEV - Server code In WEBDEV, the list boxes have the following format:
These elements can:
  • be defined when the control is created in the editor.
  • be defined by programming.
  • come from a data file or from a query.
  • come from a variable (global to the project, to the window or to the page, class member, ...).
WINDEVWindows Mobile You also have the ability to draw in the list boxes or to display an image with the functions for handling graphic strings.
Creating a List Box control
To create a List Box control:
  1. In the window editor, click (or select "Insert .. Control .. List box").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 the position where the control will be created in the window. The wizard for creating a List Box control is automatically started.
To display the control characteristics, select "Description" from the popup menu of control.
Vocabulary
To easily handle a list box, 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 list box.
A vertical scrollbar is automatically displayed if the number of elements displayed in the list exceeds the number of visible elements.
If the size of an element is greater than the width of the list, this element will be truncated. No horizontal scrollbar is automatically displayed.
Browsing list boxThe list box is based on a data file or on a query. The elements of the list box correspond to the records of the data file. Two types of browsing list boxes are available:
  • Browsing list box "Loaded in memory": the content of the list box is loaded in memory then it is displayed. The access to the different elements of the list box is faster. This mode is reserved for the data files containing less than 100 000 records.
  • Browsing list box in "Direct access mode (no limit)": The list box displays the content of the data file or the content of the query. The current record corresponds to the selected element. Each move in the list box involves an access to the linked file. This type of list box is reserved for the data files containing more than 100 000 records.
Memory list boxThe list box is not based on a data file or on a query. The elements displayed in the list box 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.
Multiselection List BoxThe user can select several elements at the same time in the list.
To select several elements, the user must:
  • select the elements 1 by 1 while keeping the [Ctrl] key down.
  • select several consecutive elements at the same time while keeping the [Shift] key down.
List box on sourceThe list box is based on a variable (global to the project, to the window or to the page, class member, ...).
Notes
WEBDEV - Server code

Browsing list box or list box on source: Number of rows

You have the ability to specify the maximum number of rows displayed in a browsing List Box control or in a List Box control on source ("Content" tab). An error message is displayed when the page is loaded if this number is less than the number of elements found in the List Box control.
For example: A list box contains 10 elements. The maximum number of rows corresponds to 5. An error message will be displayed when the page is loaded.
Note: The greater the number of elements found in the control is, the longer the page will take to load.
Java

Limits in Java

The following characteristics are not supported in Java:
  • tooltip on scrollbar.
  • multicolumn list box.
  • help number associated with the list box.
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 required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment