version 2003
PA_CreateSet (tableNum; setName)
Parameter | Type | Description | |
tableNum | short | Table number | |
setName | char * | 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.