PA_CreateSet

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


   
    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 .