PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Overview of List Box control
  • Creating a List Box control
  • Vocabulary
  • Notes
  • Browsing List Box control or List Box control 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 list elements 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 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 from a query.
  • come from a variable (global to the project, to the window or to the page, class member, ...).
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. 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 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 is greater than 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 a query. The elements of the List Box correspond to the records of the data file. There are two types of browsing List Box control:
  • 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 can be accessed more quickly. 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 control displays the content of the data file or query directly. The current record corresponds to the selected element. Each move performed in the List Box control involves an access to the linked data file. This type of List Box control 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 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, to the window or to the 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). 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 control 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 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
Video ListBox
https://youtu.be/Ccgg6GELY5Q
https://windevdesenvolvimento.blogspot.com/2019/09/dicas-2333-windev-webdev-mobile-listbox.html
amarildo
30 Sep. 2019