Click here for NewsObjects Overview
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