PA_CreateSet

4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next

version 2003


PA_CreateSet (tableNum; setName)

ParameterTypeDescription
tableNumshortTable number
setNamechar *Name of the set

Description

The command PA_CreateSet creates a new set of name setName for table number tableNum, and places the current selection in setName.

setName can be a standard C string null terminated or a Pascal string, depending on previous calls to PA_USePStrings or PA_UseCStrings.

This is the same as the CREATE SET command. The current record pointer for the table is saved with setName. If set is used with PA_UseSet, the current selection and current record are restored. As with all sets, there is no sorted order; when setName is used, the default order is used. If a set with the same name already exists, the existing set is cleared by the new set.

Once a set has been created using PA_CreateSet, the 4D plug-in can:

Reuse the set to create a selection for the Table using PA_UseSet.

Add records to the set using the entry point PA_AddToSet.

Delete the set when it is no longer needed, using PA_DeleteSet.

See Also

CREATE SET, PA_AddToSet, PA_DeleteSet, PA_UsePStrings, PA_UseSet.


4D - Documentation   Français   English   German   4D Plugin API, Command Theme List   4D Plugin API, Command Alphabetical List   Back   Previous   Next