Condividi tramite

Procedura: Visualizzare la Guida in un'applicazione Windows

  • Articolo

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

Fornire assistenza

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

    Il componente verrà posizionato sulla barra delle applicazioni in basso in Progettazione Windows Form.

  2. Nella finestra Proprietà impostare la HelpNamespace proprietà sul file della Guida con estensione chm, col o htm.

  3. Selezionare un altro controllo presente nel modulo e nella finestra Proprietà impostare la SetHelpKeyword proprietà .

    Si tratta della stringa passata attraverso il HelpProvider componente al file della Guida per richiamare l'argomento della Guida appropriato.

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

    Questa impostazione determina il modo in cui la proprietà HelpKeyword viene passata al sistema della Guida. La tabella seguente elenca le impostazioni possibili e le relative descrizioni.

    Nome del membro Descrizione
    AssociateIndex Specifica che l'indice di un argomento specificato viene eseguito nell'URL specificato.
    Trova Specifica che viene visualizzata la pagina di ricerca di un URL specificato.
    Indice Specifica che viene visualizzato l'indice di un URL specificato.
    KeywordIndex Specifica una parola chiave da cercare e l'azione da eseguire nell'URL specificato.
    TableOfContents Specifica che viene visualizzato il sommario del file della 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 , lo stato attivo aprirà il file della Guida associato a tale HelpProvider componente.

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 http:// indirizzo, ad esempio una pagina Web. In tal caso, nel browser predefinito verrà visualizzata la pagina Web con la stringa specificata nella proprietà HelpKeyword usata come ancoraggio. L'ancoraggio viene usato per passare direttamente a una parte specifica di una pagina HTML.

Importante

Assicurarsi di verificare tutte le informazioni inviate da un client prima di usarle nell'applicazione, dal momento che utenti malintenzionati potrebbero tentare di inviare script eseguibili, istruzioni SQL o altro codice. Prima di visualizzare l'input di un utente, archiviarlo in un database o usarlo, assicurarsi che non contenga informazioni potenzialmente pericolose. Un modo per effettuare questo controllo consiste nell'usare un'espressione regolare per cercare parole chiave come "SCRIPT" quando si riceve input da un utente.

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

Vedi anche