PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Use conditions
  • Adding an empty row
  • Characteristics of the row
  • Sort
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
Inserts a row into a browsing or memory Looper control.
Note: To add elements at the end of Looper control, use LooperAddLine.
Versions 15 and later
Android This function is now available for the Android applications.
New in version 15
Android This function is now available for the Android applications.
Android This function is now available for the Android applications.
Versions 16 and later
WINDEVLinux This function is now available for the WINDEV applications in Linux.
Universal Windows 10 App This function is now available for the Windows Phone applications.
New in version 16
WINDEVLinux This function is now available for the WINDEV applications in Linux.
Universal Windows 10 App This function is now available for the Windows Phone applications.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
Universal Windows 10 App This function is now available for the Windows Phone applications.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
WEBDEV - Browser code This function is now available in Browser code.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
WEBDEV - Browser code This function is now available in Browser code.
iPhone/iPad This function is now available for the iPhone/iPad applications.
WEBDEV - Browser code This function is now available in Browser code.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Example
// Add values into the looper at position 12
LooperInsertLine(LOOP_Looper1, 12, LastName, FirstName, PhoneNum, FaxNum)
// Insert sought information into the database.
i is int = 1
LooperDeleteAll(LOOP_LOOPER1)
HReadSeek(Product, ProdName, "Window")
WHILE HOut() = False
LooperInsertLine(LOOP_LOOPER1, i, Product.ProdName, Product.Code)
HReadNext(Product, ProdName)
i ++
END
Syntax

Looper with attributes Hide the details

LooperInsertLine(<Looper Control> [, <Subscript> [, <Value 1> [... [, <Value N>]]]])
<Looper Control>: Control name
Name of Looper control.
If this parameter corresponds to an empty string (""), the insertion will be performed into the current Looper control.
<Subscript>: Optional integer
Subscript of row from which the new row will be inserted.
  • If this parameter is not specified or if it is equal to -1, the insertion will be performed before the current row. If no row is selected, the insertion will be performed at the end of Looper control.
  • If <Subscript> is greater than the number of rows, the insertion will be performed at the end of Looper control. In this case, LooperInsertLine is equivalent to LooperAddLine.
  • If this parameter is equal to 0, the insertion will be performed at the beginning of Looper control.
<Value 1>: Type of associated attribute (optional)
Value of first attribute for the row to insert into the specified Looper control.
The different values must be specified in the order of attributes (description window of Looper control).
To specify no value for one of the attributes, use an empty string ("") or 0 (depending on the type of attribute).
If none of these parameters is specified, an empty row is inserted into the Looper control.
<Value N>: Type of associated attribute (optional)
Value of Nth attribute for the row to insert into the specified Looper control.
The different values must be specified in the order of attributes (description window of Looper control).
To specify no value for one of the attributes, use an empty string ("") or 0 (depending on the type of attribute).
If none of these parameters is specified, an empty row is inserted into the Looper control.
WINDEVReports and QueriesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaUser code (UMC)

Looper without attributes Hide the details

LooperInsertLine(<Looper Control> [, <Subscript>])
<Looper Control>: Control name
Name of Looper control.
If this parameter corresponds to an empty string (""), the insertion will be performed into the current Looper control.
<Subscript>: Optional integer
Subscript of row from which the new row will be inserted.
  • If this parameter is not specified or if it is equal to -1, the insertion will be performed before the current row. If no row is selected, the insertion will be performed at the end of Looper control.
  • If <Subscript> is greater than the number of rows, the insertion will be performed at the end of Looper control. In this case, LooperInsertLine is equivalent to LooperAddLine.
  • If this parameter is equal to 0, the insertion will be performed at the beginning of Looper control.
Remarks

Use conditions

LooperInsertLine can be used on a browsing or memory Looper control.
PHP LooperInsertLine can be used on a memory Looper control only.
WEBDEV - Browser code This function is not available for the linear Looper controls. This function is available for the Browser Looper controls only.
WEBDEV - Server codePHP This function is available for the Ajax Looper controls, the Classic Looper controls and the linear Looper controls.

Adding an empty row

Once an empty row was added, each attribute or each control must be initialized one by one.
For example:
  • For a looper with attributes:
    // Add an empty row
    LooperInsertLine(LOOP_Looper1, 14)

    // Position on the empty row
    Subscript = LooperCount(LOOP_Looper1)
    // Then, initialize the attributes
    AttributeLastName[Subscript] = "Hobbes"
    AttributeFirstName[Subscript] = "Samantha"
    AttributeFirstNameColor[Subscript] = LightRed
    AttributeAddressVisible[Subscript] = False
  • Case of a looper without attributes:
    // Add an empty row
    LooperInsertLine(LOOP_Looper1, 14)

    // Position on the empty row
    Subscript = LooperCount(LOOP_Looper1)
    // Then, initialize the controls
    LOOP_Looper1[Subscript].ControlLastName = "Hobbes"
    LOOP_Looper1[Subscript].ControlFirstName = "Samantha"
    LOOP_Looper1[Subscript].ControlFirstName..BrushColor = LightRed
    LOOP_Looper1[Subscript].ControlAddress..Visible = False

Characteristics of the row

If a value corresponds to the result of a calculation, the numeric expression must be enclosed in brackets.
For example:
LooperInsertLine(LOOP_CalculationLooper, 10, (53+29), (83-21))

Sort

LooperInsertLine ignores the sort.
Components
WINDEVReports and Queries wd230obj.dll
WEBDEV - Server code wd230page.dll
Windows Mobile wp230obj.dll
WEBDEV - Browser code WDJS.DLL
Java wd230java.jar
Linux wd230obj.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment