<Table>.Position (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Displaying a row in first position (syntax 1)

Selection bar and <Table>.Position function

Table control based on a data file: limitations of <Table>.Position

Event "Entry in edit in a row of"

See also

<Table>.Position (Function)

In french: <Table>.Position

Displays a Table or TreeView Table control from a specified row or returns the index of the first row displayed in a Table or TreeView Table control.

Versions 15 and later

This function is now available for PHP sites.

New in version 15

This function is now available for PHP sites.

This function is now available for PHP sites.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Versions 18 and later

This function can now be used to handle TreeView Table controls in WEBDEV and PHP sites.

New in version 18

This function can now be used to handle TreeView Table controls in WEBDEV and PHP sites.

This function can now be used to handle TreeView Table controls in WEBDEV and PHP sites.

Versions 20 and later

This function is now available for Android applications.

This function is now available for iPhone/iPad applications.

New in version 20

This function is now available for Android applications.

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

This function is now available for iPhone/iPad applications.

Example

// Index of the first row displayed in the "TABLE_Product" control
ResPosition = TABLE_Product.Position()

Syntax

Displaying a Table or TreeView Table control from a specified row Hide the details

<Table control>.Position(<Subscript> [, <Option>])

<Table control>: Control name

Name of Table or TreeView Table control to use.

<Subscript>: Integer

Index of the row that will be displayed in the control. This row is displayed in first position by default.
If <Index> is greater than the number of rows in the control (returned by <Table>.Count), the last row is selected by default.

<Option>: Integer constant

Versions 22 and later
Position of the row in the control:
taFirst
(Default value) The row specified by <Indext> is displayed at the first position in the Table/TreeView Table control.
Versions 22 and later
taVisible
New in version 22
taVisible
taVisible The row specified by <Index> becomes visible in the Table/TreeView Table control. It is displayed:
at first position (if <Index> is less than the current row).
at last position (if <Index> is greater than the current row).
If the row is already visible, the display of the Table/TreeView Table control does not change.
New in version 22
Position of the row in the control:
taFirst
(Default value) The row specified by <Indext> is displayed at the first position in the Table/TreeView Table control.
Versions 22 and later
taVisible
New in version 22
taVisible
taVisible The row specified by <Index> becomes visible in the Table/TreeView Table control. It is displayed:
at first position (if <Index> is less than the current row).
at last position (if <Index> is greater than the current row).
If the row is already visible, the display of the Table/TreeView Table control does not change.
Position of the row in the control:
taFirst
(Default value) The row specified by <Indext> is displayed at the first position in the Table/TreeView Table control.
Versions 22 and later
taVisible
New in version 22
taVisible
taVisible The row specified by <Index> becomes visible in the Table/TreeView Table control. It is displayed:
at first position (if <Index> is less than the current row).
at last position (if <Index> is greater than the current row).
If the row is already visible, the display of the Table/TreeView Table control does not change.

Getting the index of the first row displayed in a Table or TreeView Table control Hide the details

<Result> = <Table control>.Position()

<Result>: Integer

Index of the first row displayed in the specified control.
Last value of <Index> specified in the syntax displaying a row. You cannot find out the first row actually displayed once the scrollbar of the Table control has been used.

<Table control>: Control name

Name of Table or TreeView Table control to use.

Remarks

Use conditions

<Table>.Position can be used on:

a Table or TreeView Table control based on a data file.
a Table or TreeView Table control populated programmatically.
a single-selection or multiselection control.

Reminder: Multi-selection is not available for "classic" Table controls.

The TreeView Table control is not available.

Displaying a row in first position (syntax 1)

The row displayed in first position may differ from the requested one. Indeed, <Table>.Position tries to display as many rows as possible in the control.

<Table>.Position will display the specified row only if this row is followed by a sufficient number of non-empty rows. In the following example, the "Durand" row cannot be displayed at the beginning of Table control.

Selection bar and <Table>.Position function

<Table>.Position does not modify the current row (i.e. the row selected with the selection bar).

Therefore, if the Table control has focus when <Table>.Position is run, the current row will have to be visible at the same time as the specified row. If the current row and the specified row cannot be displayed at the same time, the content of the control will be displayed from the current row (and not from the row specified by <Index>).

Table control based on a data file: limitations of <Table>.Position

<Table>.Position does not operate with Table controls based on a data file in "manual" mode that use a bouncing scrollbar ("Proportional scrollbar" not checked in the "Details" tab of the control description).

Reminder:

A browsing Table control in "manual" mode is a control that is linked by programming to a data file.
A bouncing scrollbar allows you to move the scrollbar by keeping the mouse button pressed on the scrollbar box or by keeping one of the arrow keys down.

Event "Entry in edit in a row of"

<Table>.Position does not force the execution of the event "Entry in edit in a row of".
<Table>.Position cannot be used in the event "Entry in edit in a row of" of the control (the result returned is incorrect).

Component: wd270obj.dll