<List Box>.Position (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

List Box functions

Prefix syntax

Position

Presentation

Example

Displaying an element at the beginning of a List Box control (syntax 1)

Limitations

Miscellaneous

See also

<List Box>.Position (Function)

In french: <Liste>.Position

Displays a List Box or ListView control from a specified element or returns the index of the first element displayed in a List Box control (if the scrollbar was used).

Remark: <List Box>.Position can be used on:

List Box controls based on a data file or populated programmatically,
single-selection or multi-selection List Box controls.

This function has no effect.

Example

// Index of the first element displayed in "LIST_CustomerList"
ResPosition = LIST_CustomerList.Position()

Syntax

Displaying a List Box control from a specified element Hide the details

<List Box control>.Position(<Element index>)

<List Box control>: Control name

Name of List Box control to use.

<Element index>: Integer

Index of the element to be displayed at the beginning of the List Box control.
A WLanguage error occurs if this parameter is greater than the number of elements found in the List Box control (returned by <List Box>.Count).
If this parameter is equal to 1, the List Box control is repositioned at the beginning.

Getting the index of the first element displayed in a List Box or Combo Box control Hide the details

<Result> = <List Box control>.Position()

<Result>: Integer

Index of the first element displayed in the specified List Box control.

<List Box control>: Control name

Name of List Box control to use.

Remarks

Displaying an element at the beginning of a List Box control (syntax 1)

The element displayed at the beginning of the List Box control may differ from the desired element. <List Box>.Position positions the element that allows to display a maximum of rows at the beginning of the control. If there are not enough elements displayed below the specified element, this element cannot be displayed at the beginning of the control.

For example, the "Smith Jimmy" element cannot be displayed at the beginning of the List Box control: there arre not enough elements displayed below this element.

Limitations

<List Box>.Position cannot be used on List Box controls based on a data file in "manual" mode that use a bouncing scrollbar.

Reminder:

A List Box control based on a data file in "manual" mode is a List Box control programmatically linked to a data file.
With a bouncing scrollbar, you can make the scrollbar scroll by keeping the mouse button pressed on the scrollbar button or by keeping the arrow keys (top or down arrow) pressed.

Miscellaneous

To display an element at the beginning of a Table control or to get the index of the first element displayed in a Table control, use <Table>.Position.
<List Box>.Position can be used on a "Combo Box" table column.

Component: wd280obj.dll