ShowSubjects2 Method (Utility Control)
Windows - Visual C++

Description
The ShowSubjects2 method displays a dialog box containing subject names and codes for selection. The dialog box contains Full View and Current View option buttons that enable the user to choose the view in which to apply the search.

Syntax
long result = ShowSubjects2();

The ShowSubjects2 syntax has these parts:

Part	Description
result	Return value. A long integer containing 0 if the user clicked the OK button and -1 if the user clicked the Cancel button.

Remarks
After ShowSubjects2 is called, the chosen subject code is stored in the SubjectCode property, the chosen subject name is stored in the SubjectName property and the resulting search string is stored in the SubjectSearchString property. The search string is used to set the Headline control's SearchCriteria property. Note that these properties are only valid if the return value from ShowSubjects2 is 0.

The Full View and Current View option buttons enable the user to choose the view in which to apply the search. The ViewType property contains the search type selected in the "Apply To" group (1 = Full View, 2 = Current View). The DisableViewType property allows you to disable a view type option button.

The Full View option enables the user to perform the search on all stories in the NewsEdge Server database. No other search criteria is incorporated into the search. For example, if the user brings up the ShowSubjects2 dialog box to search on [SSPL] and chooses Full View, the user will see all stories about stock splits.

The Current View option enables the user to perform the search on the current set of stories in the Headline View. For example, if the user performs a Source View on the news feed "AP" and then brings up the ShowSubjects dialog box to search on [SSPL] and chooses Current View, the user will see stories about stock splits from the "AP" news feed.

See Also: SearchCriteria SubjectCode SubjectName SubjectSearchString

Back to: Utility Methods