Condividi tramite

Cenni preliminari sul componente HelpProvider (Windows Form)

  • Articolo

Il componente helpProvider Windows Form 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 in Windows Form.

  • 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, ad esempio la pagina principale di un sommario, l'indice o una funzione di ricerca.

Uso del provider della Guida

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

Facoltativamente, per associare una stringa della Guida specifica a un altro controllo, usare il SetHelpString metodo . La stringa associata a un controllo utilizzando questo metodo viene visualizzata in una finestra popup quando l'utente preme il tasto F1 mentre il controllo ha lo stato attivo.

Se HelpNamespace non è stato impostato, è necessario usare SetHelpString per fornire il testo della Guida. Se sono state impostate 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 quando si specifica il percorso del file della Guida nel metodo o HelpNamespace nella ShowHelp proprietà del HelpProvider controllo . Di conseguenza, assicurarsi di usare il percorso assoluto del file per specificare il file della Guida.

Vedi anche