Condividi tramite

Procedura: Fornire assistenza in un'applicazione Windows

  • Articolo

È possibile utilizzare il componente HelpProvider per allegare gli argomenti della Guida all'interno di un file della Guida a specifici controlli su Windows Forms. Il file della Guida può essere in formato HTML o HTMLHelp 1.x o superiore.

Fornire assistenza

  1. In Visual Studio, trascina un componente HelpProvider dalla casella degli strumenti nel form.

    Il componente si troverà nella barra nella parte inferiore della finestra di progettazione di Windows Form.

  2. Nella finestra Proprietà impostare la proprietà HelpNamespace sui file Guida .chm, .col o .htm.

  3. Seleziona un altro controllo presente nel tuo form e nella finestra delle proprietà , imposta la proprietà SetHelpKeyword.

    Questa è la stringa passata attraverso il componente HelpProvider al file della Guida per richiamare l'argomento della Guida appropriato.

  4. Nella finestra Proprietà impostare la proprietà SetHelpNavigator su un valore dell'enumerazione HelpNavigator.

    In questo modo viene determinato il modo in cui la proprietà HelpKeyword viene passata al sistema della Guida. La tabella seguente illustra le possibili impostazioni e le relative descrizioni.

    Nome membro Descrizione
    AssociateIndex Specifica che l'indice per un argomento specificato viene eseguito nell'URL specificato.
    Trovare Specifica che viene visualizzata la pagina di ricerca di un URL specificato.
    Indice Specifica che viene visualizzato l'indice di un URL specificato.
    Indice delle parole chiave Specifica una parola chiave da cercare e l'azione da eseguire nell'URL specificato.
    TableOfContents Specifica che viene visualizzata la tabella dei contenuti del file Guida HTML 1.0.
    Argomento Specifica che viene visualizzato l'argomento a cui fa riferimento l'URL specificato.

In fase di esecuzione, premendo F1 quando il controllo, per il quale sono state impostate le proprietà HelpKeyword e HelpNavigator, ha il focus, verrà aperto il file della Guida associato a quel componente HelpProvider.

Attualmente, la proprietà HelpNamespace supporta i file della Guida nei tre formati seguenti: HTMLHelp 1.x, HTMLHelp 2.0 e HTML. È quindi possibile impostare la proprietà HelpNamespace su un indirizzo http://, ad esempio una pagina Web. In questo caso, aprirà il browser predefinito alla pagina Web con l'URL contenente la stringa specificata nella proprietà HelpKeyword utilizzata come ancoraggio. L'ancoraggio viene usato per passare a una parte specifica di una pagina HTML.

Importante

Prestare attenzione a controllare le informazioni inviate da un client prima di usarle nell'applicazione. Gli utenti malintenzionati potrebbero provare a inviare o inserire script eseguibili, istruzioni SQL o altro codice. Prima di visualizzare l'input di un utente, archiviarlo in un database o usarlo, verificare che non contenga informazioni potenzialmente non sicure. Un modo tipico per controllare consiste nell'usare un'espressione regolare per cercare parole chiave come "SCRIPT" quando si riceve l'input da un utente.

È anche possibile utilizzare il componente HelpProvider per visualizzare la Guida popup, anche se è stata configurata per visualizzare i file della Guida per i controlli in Windows Form. Per altre informazioni, vedere Procedura: Visualizzare la Guida popup.

Vedere anche