Condividi tramite

Cenni preliminari sul componente HelpProvider (Windows Form)

  • Articolo

Aggiornamento: novembre 2007

Il componente Windows Form HelpProvider viene utilizzato per associare un file della Guida HTML Help 1.x all'applicazione Windows personalizzata, vale a dire un file CHM creato con HTML Help Workshop o un file HTM. Le informazioni che è possibile fornire sono di diversi tipi:

  • La Guida sensibile al contesto per i controlli in Windows Form.

  • La Guida sensibile al contesto relativa a una particolare finestra di dialogo o a controlli specifici in una finestra di dialogo.

  • Un file della Guida per aree specifiche, come la pagina principale di un sommario, un indice o una funzione di ricerca.

Utilizzo del provider della Guida

L'aggiunta di un componente HelpProvider al Windows Form consente agli altri controlli del form di esporre le proprietà della Guida del componente HelpProvider consentendo in tal modo di fornire informazioni della Guida per i controlli in Windows Form. È possibile associare un file della Guida al componente HelpProvider utilizzando la proprietà HelpNamespace. Specificare il tipo di Guida fornito chiamando il metodo SetHelpNavigator e fornendo un valore dall'enumerazione HelpNavigator per il controllo specificato. Fornire la parola chiave o l'argomento per la Guida chiamando il metodo SetHelpKeyword.

È inoltre possibile associare una specifica stringa della Guida a un altro controllo, utilizzando il metodo SetHelpString. La stringa associata al controllo con tale metodo verrà visualizzata in una finestra popup quando l'utente preme il tasto F1 mentre il controllo è attivo.

Se la proprietà HelpNamespace non è stata impostata, è necessario utilizzare SetHelpString per specificare il testo della Guida. Se si è impostato sia HelpNamespace che la stringa della Guida, avranno la precedenza le informazioni della Guida basate su HelpNamespace.

Nota:

Si possono verificare problemi di utilizzo del percorso relativo, quando si specifica il percorso per il file della Guida nel metodo ShowHelp o nella proprietà HelpNamespace del controllo HelpProvider. Pertanto accertarsi di utilizzare il percorso assoluto per specificare il file della Guida.

Vedere anche

Concetti

Sistemi di Guida in linea nelle applicazioni per Windows Form