Procedura: visualizzare la Guida in un'applicazione Windows
È possibile utilizzare il componente HelpProvider per includere argomenti della Guida all'interno di una file della guida in controlli specifici in Windows Form. Il file della Guida può essere in formato HTML o HTMLHelp 1.X o superiore.
Nota
È possibile che le finestre di dialogo e i comandi di menu visualizzati siano diversi da quelli descritti nella Guida a seconda delle impostazioni attive o dell'edizione del programma. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Gestione delle impostazioni.
Per visualizzare la Guida
Dalla Casella degli strumenti trascinare un componente HelpProvider nel form.
Il componente verrà posizionato nella barra delle applicazioni nella parte inferiore di Progettazione di Windows Form.
Nella finestra Proprietà impostare la proprietà HelpNamespace sul file della Guida chm, col o htm.
Selezionare un altro controllo presente nel form e impostare la proprietà HelpKeyword nella finestra Proprietà.
Questa è la stringa passata tramite il componente HelpProvider al file della Guida per richiamare l'argomento appropriato.
Nella finestra Proprietà, impostare la proprietà HelpNavigator su un valore dell'enumerazione HelpNavigator.
Questa impostazione determina la modalità in cui la proprietà HelpKeyword viene passata al sistema della Guida. Nella tabella riportata di seguito sono elencate tutte le impostazioni e le relative descrizioni.
Nome membro
Descrizione
AssociateIndex
Specifica che l'indice di un argomento specificato viene eseguito nell'URL specificato.
Find
Specifica che viene visualizzata la pagina di ricerca di un URL specificato.
Index
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 vengono visualizzati gli argomenti della Guida 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 si sono impostate le proprietà HelpKeyword e HelpNavigator ha lo stato attivo verrà visualizzato il file della Guida associato al componente HelpProvider.
Attualmente la proprietà HelpNamespace supporta i file della Guida nei formati HTMLHelp 1.x, HTMLHelp 2.0 e HTML. È quindi possibile impostare la proprietà HelpNamespace su un indirizzo http://, ad esempio una pagina Web. In tal caso, verrà visualizzata nel browser predefinito la pagina Web con la stringa specificata nella proprietà HelpKeyword utilizzata come ancoraggio. L'ancoraggio è utilizzato per passare direttamente a una parte specifica di una pagina HTML.
.gif "Nota sulla sicurezza") Nota sulla sicurezza |
|---|
Accertarsi di controllare ogni informazione inviata da un client prima di utilizzarla in un'applicazione, poiché utenti con pochi scrupoli possono tentare di inviare script eseguibili, istruzioni SQL o altro codice. Prima di visualizzare l'input di un utente, memorizzarlo in un database o utilizzarlo, verificare che non contenga informazioni potenzialmente pericolose. Un modo per effettuare questo controllo consiste nell'utilizzo di un'espressione regolare per cercare parole chiave come "SCRIPT" quando si riceve input da un utente. |
È inoltre possibile utilizzare il componente HelpProvider per visualizzare la Guida rapida, anche se è stata configurata per la visualizzazione dei file della Guida per i controlli nei Windows Form. Per ulteriori informazioni, vedere Procedura: visualizzare la Guida rapida.
Vedere anche
Attività
Procedura: visualizzare la Guida rapida
Concetti
Visualizzazione della Guida relativa a un controllo tramite le descrizioni comandi