Condividi tramite


Panoramica del componente HelpProvider (Windows Forms)

Il componente HelpProvider di Windows Forms viene usato per associare un file della Guida HTML 1.x (un file con estensione .chm, prodotto con HTML Help Workshop, o un file .htm) all'applicazione Windows. È possibile fornire assistenza in diversi modi:

  • Fornire la Guida sensibile al contesto per i controlli nei Windows Forms.

  • Fornire una Guida sensibile al contesto in una finestra di dialogo specifica o controlli specifici in una finestra di dialogo.

  • Aprire un file della Guida in aree specifiche, come la pagina principale di un sommario, l'indice o una funzione di ricerca.

Uso del fornitore della Guida

L'aggiunta di un componente HelpProvider al tuo Windows Form consente agli altri controlli sul modulo di esporre le proprietà Guida del componente HelpProvider. In questo modo è possibile fornire assistenza per i controlli in Windows Form. È possibile associare un file della Guida al componente HelpProvider usando la proprietà HelpNamespace. Tu specifichi il tipo di Guida fornita chiamando SetHelpNavigator, fornendo un valore dall'enumerazione HelpNavigator per il controllo specificato. Fornisci la parola chiave o l'argomento della Guida chiamando il metodo SetHelpKeyword.

Per associare facoltativamente una stringa della Guida specifica a un altro controllo, utilizzare il metodo SetHelpString. La stringa che associ a un controllo con questo metodo viene visualizzata in una finestra popup quando l'utente preme il tasto F1 mentre il controllo è in focus.

Se HelpNamespace non è stato impostato, è obbligatorio usare SetHelpString per fornire il testo della Guida. Se hai impostato sia HelpNamespace che la stringa della Guida, la Guida basata su HelpNamespace avrà la precedenza.

Nota

È possibile che si verifichino problemi durante l'utilizzo del percorso relativo specificando il percorso del file Guida nel metodo ShowHelp o nella proprietà HelpNamespace del controllo HelpProvider. Di conseguenza, assicurarsi di usare il percorso assoluto del file per specificare il file della Guida.

Vedere anche