HelpNavigator Enumeration
Specifies constants indicating which elements of the Help file to display.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Member name | Description | |
|---|---|---|
| AssociateIndex | The Help file opens to the index entry for the first letter of a specified topic. | |
| Find | The Help file opens to the search page. | |
| Index | The Help file opens to the index. | |
| KeywordIndex | The Help file opens to the topic with the specified index entry, if one exists; otherwise, the index entry closest to the specified keyword is displayed. | |
| TableOfContents | The Help file opens to the table of contents. | |
| Topic | The Help file opens to a specified topic, if the topic exists. | |
| TopicId | The Help file opens to a topic indicated by a numeric topic identifier. |
This enumeration is used by the Help and HelpProvider classes to provide access to specific elements of a Help file. For example, when used with the HelpProvider component that provides F1 Help, the TopicId or Topic value could be specified to open Help to a context-specific topic.
The following code example displays a form with three buttons that can be used to interact with the mspaint.chm Help file. The Show Help Index button displays the Index tab for the Help file. The Show Help button displays content in the Help file based on the value selected in the Help Navigator list. The Show Keyword button displays content in the Help file based on the keyword specified in the Keyword text box.
For example, to show the Ovals Help page by the index value, select the HelpNavigator::KeywordIndex value in the Help Navigator drop-down list, type ovals in the Parameter text box, and then click the Show Help button. To show the "To paint with a brush" Help topic by the keyword, type mspaint.chm::/paint_brush.htm in the Keyword text box, and then click the Show Keyword button.
The example uses the ShowHelp method to display the different Help tabs and Help topics, and the ShowHelpIndex method to display the Help index.
#using <System.dll> #using <System.Drawing.dll> #using <System.Windows.Forms.dll> using namespace System; using namespace System::Drawing; using namespace System::ComponentModel; using namespace System::Windows::Forms; public ref class Form1: public System::Windows::Forms::Form { private: String^ helpfile; System::Windows::Forms::Button^ showIndex; System::Windows::Forms::Button^ showHelp; System::Windows::Forms::Label ^ label1; System::Windows::Forms::ComboBox^ navigatorCombo; System::Windows::Forms::Button^ showKeyword; System::Windows::Forms::TextBox^ keyword; System::Windows::Forms::Label ^ label2; System::Windows::Forms::Label ^ label3; System::Windows::Forms::TextBox^ parameterTextBox; public: Form1() { helpfile = "mspaint.chm"; this->showIndex = gcnew System::Windows::Forms::Button; this->showHelp = gcnew System::Windows::Forms::Button; this->navigatorCombo = gcnew System::Windows::Forms::ComboBox; this->label1 = gcnew System::Windows::Forms::Label; this->showKeyword = gcnew System::Windows::Forms::Button; this->keyword = gcnew System::Windows::Forms::TextBox; this->label2 = gcnew System::Windows::Forms::Label; this->label3 = gcnew System::Windows::Forms::Label; this->parameterTextBox = gcnew System::Windows::Forms::TextBox; // Help Navigator Label this->label1->Location = System::Drawing::Point( 112, 64 ); this->label1->Size = System::Drawing::Size( 168, 16 ); this->label1->Text = "Help Navigator:"; // Keyword Label this->label2->Location = System::Drawing::Point( 120, 184 ); this->label2->Size = System::Drawing::Size( 100, 16 ); this->label2->Text = "Keyword:"; // Parameter Label this->label3->Location = System::Drawing::Point( 112, 120 ); this->label3->Size = System::Drawing::Size( 168, 16 ); this->label3->Text = "Parameter:"; // Show Index Button this->showIndex->Location = System::Drawing::Point( 16, 16 ); this->showIndex->Size = System::Drawing::Size( 264, 32 ); this->showIndex->TabIndex = 0; this->showIndex->Text = "Show Help Index"; this->showIndex->Click += gcnew System::EventHandler( this, &Form1::showIndex_Click ); // Show Help Button this->showHelp->Location = System::Drawing::Point( 16, 80 ); this->showHelp->Size = System::Drawing::Size( 80, 80 ); this->showHelp->TabIndex = 1; this->showHelp->Text = "Show Help"; this->showHelp->Click += gcnew System::EventHandler( this, &Form1::showHelp_Click ); // Show Keyword Button this->showKeyword->Location = System::Drawing::Point( 16, 192 ); this->showKeyword->Size = System::Drawing::Size( 88, 32 ); this->showKeyword->TabIndex = 4; this->showKeyword->Text = "Show Keyword"; this->showKeyword->Click += gcnew System::EventHandler( this, &Form1::showKeyword_Click ); // Help Navigator ComboBox this->navigatorCombo->DropDownStyle = System::Windows::Forms::ComboBoxStyle::DropDownList; this->navigatorCombo->Location = System::Drawing::Point( 112, 80 ); this->navigatorCombo->Size = System::Drawing::Size( 168, 21 ); this->navigatorCombo->TabIndex = 2; // Keyword TextBox this->keyword->Location = System::Drawing::Point( 120, 200 ); this->keyword->Size = System::Drawing::Size( 160, 20 ); this->keyword->TabIndex = 5; this->keyword->Text = ""; // Parameter TextBox this->parameterTextBox->Location = System::Drawing::Point( 112, 136 ); this->parameterTextBox->Size = System::Drawing::Size( 168, 20 ); this->parameterTextBox->TabIndex = 8; this->parameterTextBox->Text = ""; // Set up how the form should be displayed and add the controls to the form. this->ClientSize = System::Drawing::Size( 292, 266 ); array<System::Windows::Forms::Control^>^formControls = {this->parameterTextBox,this->label3,this->label2,this->keyword,this->showKeyword,this->label1,this->navigatorCombo,this->showHelp,this->showIndex}; this->Controls->AddRange( formControls ); this->FormBorderStyle = System::Windows::Forms::FormBorderStyle::FixedDialog; this->Text = "Help App"; // Load the various values of the HelpNavigator enumeration // into the combo box. TypeConverter^ converter; converter = TypeDescriptor::GetConverter( HelpNavigator::typeid ); System::Collections::IEnumerator^ myEnum = converter->GetStandardValues()->GetEnumerator(); while ( myEnum->MoveNext() ) { Object^ value = safe_cast<Object^>(myEnum->Current); navigatorCombo->Items->Add( value ); } } private: void showIndex_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { // Display the index for the help file. Help::ShowHelpIndex( this, helpfile ); } void showHelp_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { // Display Help using the Help navigator enumeration // that is selected in the combo box. Some enumeration // values make use of an extra parameter, which can // be passed in through the Parameter text box. HelpNavigator navigator = HelpNavigator::TableOfContents; if ( navigatorCombo->SelectedItem != nullptr ) { navigator = *safe_cast<HelpNavigator^>(navigatorCombo->SelectedItem); } Help::ShowHelp( this, helpfile, navigator, parameterTextBox->Text ); } void showKeyword_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { // Display help using the provided keyword. Help::ShowHelp( this, helpfile, keyword->Text ); } }; [STAThread] int main() { Application::Run( gcnew Form1 ); }
Available since 1.1