LooperSave (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Updating the data file linked to the Looper control

Cascading input and update of linked data file

Re-displaying the saved row

Locking and updating the data file

Duplicates and referential integrity

Use LooperSave to reduce the number of lines of code

See also

LooperSave (Function)

In french: ZoneRépétéeEnregistre

Validates the modification or addition of the record associated with the current row in the Looper control.. The record is updated in the data file linked to the Looper control.

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.

Example

// Save the data of the Looper control "LOOP_ProductLooper"
LooperSave(LOOP_ProductLooper)

Syntax

LooperSave(<Looper control>)

<Looper control>: Control name

Name of the Looper control to be used. The current row of this Looper control will be recorded in the linked data file.
If this parameter corresponds to an empty string (""), the Looper control to which the current event belongs is used.

Remarks

Updating the data file linked to the Looper control

LooperSave saves the current row of the Looper control to the data file. The items are automatically assigned with the values of associated controls in the current row.

When a modification is performed, LooperSave replaces the former values by the new ones. The items not found in the Looper control are not modified.

Caution:

LooperSave only supports the data file associated with the Looper control. If some attributes/controls are linked to items found in other data files, these data files are not automatically managed.
The "Image" attributes/controls are not saved by LooperSave. To modify the content of the memo associated with the image (rare case), use HLinkMemo.

Cascading input and update of linked data file

If cascading input is enabled, changes are automatically applied in the data file linked to the Looper control when the user moves to the next row LooperAdd, LooperAddLine, LooperInsert, LooperInsertLine, LooperModify and LooperModifyLine). LooperSave is useless.

If cascading input is not enabled, changes are not applied in the data file linked to the Looper control. To write the added row or the modified row into the linked data file, LooperSave must be called after the function used to perform the addition or the modification.

Remarks:

The NewLine property determines if the row has just been created by LooperAdd, LooperAddLine, LooperInsert or LooperInsertLine (..New = True).
The Modified property determines if the user has modified a row in the Looper control (..Modified = True).

Re-displaying the saved row

After the call to LooperSave, the saved row may "disappear". This "disappearance" is due to the value of the search key for the added or modified record.

To avoid this problem, redisplay the Looper control with LooperDisplay.

Locking and updating the data file

If the data file is locked in the current process, LooperSave saves the current row and unlocks the data file.

Duplicates and referential integrity

If the management of duplicates is enabled (HSetDuplicates), HErrorDuplicates must be checked after the execution of LooperSave to check the key uniqueness.
If the management of referential integrity is enabled (HSetIntegrity), HErrorIntegrity must be checked after the execution of LooperSave to check the referential integrity.

Use LooperSave to reduce the number of lines of code

LooperSave reduces several lines of code. This single line allows you to avoid assigning the item variables one by one.

For example, the following code:

Customer.LastName = ATT_LastName
Customer.FirstName = ATT_FirstName
Customer.Address = ATT_Address
Customer.ZC = ATT_ZC
Customer.City = ATT_City
HAdd(Customer)

is replaced with the following line:

LooperSave(LOOP_CustomerLooper)

Component: wd270obj.dll