SaveSelectionSet Method (Headline Control)
Windows - Visual C++
Description
The SaveSelectionSet method
preserves a "snapshot" of the currently selected headlines.
Syntax
long result =
SaveSelectionSet(long* selectionSetID);
The SaveSelectionSet syntax has these parts:
Part |
Description |
selectionSetID |
A long integer that receives the ID used to refer to the selection set. |
result |
A long integer containing 0 if successful and an error code if not. |
Remarks
The SaveSelectionSet method
preserves a "snapshot" of the currently selected headlines.
If the user changes the selection after the call to this method, the
headlines referred to by the selection set ID do not change. The GetNewestHeadlineFromSelectionSet
and GetOldestHeadlineFromSelectionSet
methods may be used to sequentially obtain each headline in the
selection set. DeleteSelectionSet must
be called for the selection set when you are finished using it.
It is recommended that you obtain the number of selected headlines using the GetNumberSelected method before performing any operation on a group of selected headlines. If this number is large, you may want to alert the user to this fact and allow him to confirm that he wants to continue.
See Also: DeleteSelectionSet GetNumberSelected GetNewestHeadlineFromSelectionSet GetOldestHeadlineFromSelectionSet
Back to: Headline Methods