<Looper>.Insert (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Looper functions

Use conditions
Row characteristics
Handling a binary memo
Sort

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Looper>.Insert (Function)

In french: <Zone répétée>.Insère

Inserts a row into a Looper control.

Note: It is recommended to use <Looper>.InsertLine. Indeed, <Looper>.InsertLine allows you to insert:

TAB characters into the attributes/controls.
all types of values into the attributes/controls.

Example

// Initialize the Looper control named LOOP_LOOPER1
LOOP_LOOPER1.DeleteAll()
Product.ReadFirst(ProdName)
WHILE Product.Out() = False
	LOOP_LOOPER1.Insert(Product.ProdName + TAB + Product.Code)
	Product.ReadNext(ProdName)
END

// Add values into the Looper control at position 12
LOOP_LOOPER1.Insert(LastName + TAB + FirstName + TAB + PhoneNum + TAB + FaxNum, 12)

Syntax

<Result> = <Looper control>.Insert(<Value> [, <Index>])

<Result>: Boolean

True if the addition was successful,
False otherwise.

<Looper control>: Control name

Name of the Looper control to be used.

<Value>: Character string

List of values that will be inserted into the new row. This parameter must have the following format:
<Value 1> + TAB + ... + <Value N>

The different values must be specified in the order of the attributes (Looper control description window).
To specify no value for an attribute, use an empty string ("") or 0 (depending on the type of the attribute).

<Index>: Optional integer

Index of the row from which the new row will be inserted.
If this parameter is not specified or is equal to -1, the row will be inserted before the current row. If no row is selected, the row will be inserted at the end of the Looper control.
If <Index> is greater than the number of rows, the row will be inserted at the last position in the Looper control. In this case, <Looper>.Insert is equivalent to <Looper>.Add.
If this parameter is 0, the row will be inserted at the first position in the Looper control.

Remarks

Use conditions

<Looper>.Insert can be used on:

a Looper control based on a data file,
a Looper control populated programmatically.

Row characteristics

If a value is the result of a calculation, enclose the numerical expression in brackets. For example:

LOOP_CalculationZone.Insert((53+29) + TAB + (83-21), 12)

Handling a binary memo

To insert a binary memo into a Looper control, use <Looper>.InsertLine.

Sort

<Looper>.Insert ignores the sort.

Component: wd300obj.dll