IWListInsert (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

IWListInsert (Function)

In french: FIListeInsère

Inserts a new internal window in the list of internal windows used by an Internal Window control.

Caution: If an internal window is associated in edit with the Internal Window control, this internal window will not be accessible anymore.

Versions 22 and later

This function is now available in Universal Windows 10 App mode.

New in version 22

This function is now available in Universal Windows 10 App mode.

Example

// Insert a customer
HAdd(CUSTOMER)
nCustomerPos is int = IWListPosition(IW_CustomerList)
IWListInsert(IW_CustomerList, nCustomerPos, IW_CustomerForm, CUSTOMER.CUSTOMERID)

Syntax

IWListInsert(<Internal Window control> , <Index> , <Internal window> [, <Parameter 1> [... [, <Parameter N>]]])

<Internal Window control>: Control name

Name of the Internal Window control to use.

<Index>: Integer

Index of the internal window to be inserted.

<Internal window>: Window name

Name of the internal window that must be associated with the control.

<Parameter 1>: Type of value sent to the window (optional)

First parameter that will be passed to the "Global declarations" event of the window to open. This parameter is passed by reference and it is considered as being a variable global to the window.

<Parameter N>: Type of value sent to the window (optional)

Nth parameter that must be passed to the "Global declarations" event of the window to open. This parameter is passed by reference and it is considered as being a variable global to the window.

Remarks

To navigate between the different internal windows inserted into the control, you can:
- perform an horizontal "scroll" in the control,
- use IWListPosition, IWListNext and/or IWListPrevious.
The added internal windows are numbered from 1 to x, according to the order in which they are added into the list.
- If an internal window is deleted by IWListDelete, the internal windows that follow the deleted window are re-numbered.
- To add an internal window into the list, use IWListAdd.
To modify the internal window currently displayed by the control, use ChangeSourceWindow.
For a browse performed on a data file or on a query: An exception will be triggered if this function is used.
Parameters passed to the internal window: Parameters are retrieved in the "Global declarations" event of the internal window. Simply write the following line of code at the start of the event:

PROCEDURE <Window name>(<Parameter1> [, <Parameter2> [, ...]])

For more details, see Window with parameters.
Versions 27 and later
You can now use named parameters. For more details, see Window with parameters.
New in version 27
You can now use named parameters. For more details, see Window with parameters.
You can now use named parameters. For more details, see Window with parameters.

Component: wd270obj.dll