PA_CopyNamedSelection

version 2003

PA_CopyNamedSelection (tableNum; selName)

Parameter	Type		Description
tableNum	short		Table number
selName	char *		Name of the named selection to create

The routine PA_CopyNamedSelection copies the current selection of table tableNum to the named selection selName, which contains a copy of the selection. The current selection and the current record of the table tableNum for the process are not changed.

This is similar to the CREATE NAMED SELECTION command. Please refer to this command for more information.

Remember to free up memory used by selName once you have finish to working with it by calling PA_ClearNamedSelection.

Save the selection, and reuse it twice after.

   /* . . . previous code . . . */
   PA_CopyNamedSelection( tableNum, "\ptempSel"); // (using Pascal strings)
   DoMyQuery(tableNum); // internal routine that searches for records
   if(PA_RecordsInSelection(tableNum) = 0) // nothing found - back to previous ordered selection
      PA_UseNamedSelection(tableNum);
   // free memory
   PA_ClearNamedSelection(tableNum);

COPY NAMED SELECTION, Named selections and 4DPluginAPI, PA_ClearNamedSelection, PA_UseNamedSelection.

Use PA_GetLastError to see if an error occurred