Copying the key values of the next selected table record

table_next_selected_key()

Copy key values of next selected record


SYNTAX

table_next_selected_key(table_id)

This function is for use with tables whose source object is a file and which have the edit mode flag EM_MULTIPLE assigned. This flag enables multiple selections to be made from the table.

After table_first_selected_key() has been called, each subsequent call to table_next_selected_key() places the key values of the next selected record in the file’s record buffer. If the source object is a secondary index, the values copied are the main index key, not the secondary index key.

The program can then read the record from the file using read[u], or use the key values for any other purpose.

Returns zero (OKAY) if there is another selected record.

Returns a non-zero value if there are no more selected records, or if the table source object is not a file. In this case they key fields in the file’s record buffer remain unchanged.


RELATED TOPICS

Tables

Listbox and table functions