HelpNavigator Enumeración

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Especifica constantes que indican qué elementos del archivo de ayuda se van a mostrar.

C#

public enum HelpNavigator

Herencia

Object

ValueType

Enum

HelpNavigator

Campos

AssociateIndex	-2147483643	El archivo de ayuda se abre en la entrada de índice por la primera letra de un tema especificado.
Find	-2147483644	El archivo de ayuda se abre en la página de búsqueda.
Index	-2147483645	El archivo de ayuda se abre en el índice.
KeywordIndex	-2147483642	El archivo de ayuda se abre en el tema con la entrada de índice especificada, si existe alguna; en caso contrario, se muestra la entrada de índice más próxima a la palabra clave especificada.
TableOfContents	-2147483646	El archivo de ayuda se abre en la tabla de contenido.
Topic	-2147483647	El archivo de ayuda se abre en un tema especificado, si existe.
TopicId	-2147483641	El archivo de ayuda se abre en un tema indicado por un identificador numérico del tema.

Ejemplos

En el ejemplo de código siguiente se muestra un formulario con tres botones que se pueden usar para interactuar con el archivo de ayuda mspaint.chm. El botón Mostrar índice de ayuda muestra la pestaña Índice del archivo de Ayuda. El botón Mostrar ayuda muestra contenido en el archivo de Ayuda en función del valor seleccionado en la lista Navegador de ayuda . El botón Mostrar palabra clave muestra contenido en el archivo de Ayuda en función de la palabra clave especificada en el cuadro de texto Palabra clave .

Por ejemplo, para mostrar la página ayuda de Ovals por el valor de índice, seleccione el valor KeywordIndex en la lista desplegable Navegador de ayuda , escriba óvalos en el cuadro de texto Parámetro y, a continuación, haga clic en el botón Mostrar ayuda . Para mostrar el tema de ayuda "Para pintar con un pincel" por la palabra clave, escriba mspaint.chm::/paint_brush.htm en el cuadro de texto Palabra clave y, a continuación, haga clic en el botón Mostrar palabra clave .

En el ejemplo se usa el ShowHelp método para mostrar las distintas pestañas de Ayuda y temas de Ayuda, y el ShowHelpIndex método para mostrar el índice de Ayuda.

C#

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

public class Form1 : System.Windows.Forms.Form
{
    private const string helpfile = "mspaint.chm";
    private System.Windows.Forms.Button showIndex;
    private System.Windows.Forms.Button showHelp;
    private System.Windows.Forms.Label label1;
    private System.Windows.Forms.ComboBox navigatorCombo;
    private System.Windows.Forms.Button showKeyword;
    private System.Windows.Forms.TextBox keyword;
    private System.Windows.Forms.Label label2;
    private System.Windows.Forms.Label label3;
    private System.Windows.Forms.TextBox parameterTextBox;

    [STAThread]
    static void Main() 
    {
        Application.Run(new Form1());
    }

    public Form1()
    {
        this.showIndex = new System.Windows.Forms.Button();
        this.showHelp = new System.Windows.Forms.Button();
        this.navigatorCombo = new System.Windows.Forms.ComboBox();
        this.label1 = new System.Windows.Forms.Label();
        this.showKeyword = new System.Windows.Forms.Button();
        this.keyword = new System.Windows.Forms.TextBox();
        this.label2 = new System.Windows.Forms.Label();
        this.label3 = new System.Windows.Forms.Label();
        this.parameterTextBox = new System.Windows.Forms.TextBox();

        // Help Navigator Label
        this.label1.Location = new System.Drawing.Point(112, 64);
        this.label1.Size = new System.Drawing.Size(168, 16);
        this.label1.Text = "Help Navigator:";

        // Keyword Label
        this.label2.Location = new System.Drawing.Point(120, 184);
        this.label2.Size = new System.Drawing.Size(100, 16);
        this.label2.Text = "Keyword:";

        // Parameter Label
        this.label3.Location = new System.Drawing.Point(112, 120);
        this.label3.Size = new System.Drawing.Size(168, 16);
        this.label3.Text = "Parameter:";

        // Show Index Button
        this.showIndex.Location = new System.Drawing.Point(16, 16);
        this.showIndex.Size = new System.Drawing.Size(264, 32);
        this.showIndex.TabIndex = 0;
        this.showIndex.Text = "Show Help Index";
        this.showIndex.Click += new System.EventHandler(this.showIndex_Click);

        // Show Help Button
        this.showHelp.Location = new System.Drawing.Point(16, 80);
        this.showHelp.Size = new System.Drawing.Size(80, 80);
        this.showHelp.TabIndex = 1;
        this.showHelp.Text = "Show Help";
        this.showHelp.Click += new System.EventHandler(this.showHelp_Click);

        // Show Keyword Button
        this.showKeyword.Location = new System.Drawing.Point(16, 192);
        this.showKeyword.Size = new System.Drawing.Size(88, 32);
        this.showKeyword.TabIndex = 4;
        this.showKeyword.Text = "Show Keyword";
        this.showKeyword.Click += new System.EventHandler(this.showKeyword_Click);

        // Help Navigator ComboBox
        this.navigatorCombo.DropDownStyle = System.Windows.Forms.ComboBoxStyle.DropDownList;
        this.navigatorCombo.Location = new System.Drawing.Point(112, 80);
        this.navigatorCombo.Size = new System.Drawing.Size(168, 21);
        this.navigatorCombo.TabIndex = 2;

        // Keyword TextBox
        this.keyword.Location = new System.Drawing.Point(120, 200);
        this.keyword.Size = new System.Drawing.Size(160, 20);
        this.keyword.TabIndex = 5;
        this.keyword.Text = "";

        // Parameter TextBox
        this.parameterTextBox.Location = new System.Drawing.Point(112, 136);
        this.parameterTextBox.Size = new 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 = new System.Drawing.Size(292, 266);
        this.Controls.AddRange(new System.Windows.Forms.Control[] {
                                        this.parameterTextBox, this.label3,
                                        this.label2, this.keyword,
                                        this.showKeyword, this.label1,
                                        this.navigatorCombo, this.showHelp,
                                        this.showIndex});
        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(typeof(HelpNavigator));
        foreach(object value in converter.GetStandardValues()) 
        {
            navigatorCombo.Items.Add(value);
        }
    }

    private void showIndex_Click(object sender, System.EventArgs e)
    {
        // Display the index for the help file.
        Help.ShowHelpIndex(this, helpfile);
    }
    private 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 != null)
        {
            navigator = (HelpNavigator)navigatorCombo.SelectedItem;
        }
        Help.ShowHelp(this, helpfile, navigator, parameterTextBox.Text);
    }
    private void showKeyword_Click(object sender, System.EventArgs e)
    {
        // Display help using the provided keyword.
        Help.ShowHelp(this, helpfile, keyword.Text);
    }
}

Comentarios

Las clases y HelpProvider usan Help esta enumeración para proporcionar acceso a elementos específicos de un archivo de Ayuda. Por ejemplo, cuando se usa con el HelpProvider componente que proporciona ayuda F1, se podría especificar el valor TopicId o Topic para abrir ayuda en un tema específico del contexto.

Se aplica a