Supporto della guida

Finestre di dialogo comuni forniscono Guida sensibile al contesto per i controlli della finestra di dialogo standard. Per fornire ulteriore assistenza per una dialogo comune, potete visualizzare un pulsante aiuto ed elaborare i messaggi generati quando l'utente fa clic sul pulsante. Il pulsante Help è un supplemento di default Guida sensibile al contesto. Il pulsante Help è utile per descrivere lo scopo generale della finestra di dialogo applicato all'applicazione.

Guida sensibile al contesto

Tutte le finestre di dialogo comuni forniscono Guida sensibile al contesto per i controlli della finestra di dialogo standard. L'utente può visualizzare la guida per singoli controlli da uno qualsiasi dei seguenti metodi:

Se una finestra di dialogo Personalizza aggiungendo nuovi controlli, è necessario estendere anche il supporto della guida per questi controlli di elaborazione delle richieste di aiuto per la routine di hook. La routine di hook riceve i seguenti messaggi quando l'utente richiede aiuto.

Azione dell'utente Messaggio
L'utente fa clic sul pulsante destro del mouse su un controllo. WM_CONTEXTMENU
L'utente ha premuto il tasto f1. WM_HELP
L'utente fa clic sul pulsante ? sulla barra del titolo e quindi ha scelto un controllo. WM_HELP

Si devono elaborare questi messaggi per i controlli che avete aggiunto, ma lasciare che la procedura di casella di dialogo predefinita di elaborare i messaggi per i controlli standard. Per ulteriori informazioni su come elaborare questi messaggi, vedere la aiutare panoramica.

Il pulsante Help

È possibile visualizzare un pulsante aiuto in una qualsiasi delle finestre di dialogo comuni impostando un valore SHOWHELP nel membro Flags della struttura di inizializzazione per la finestra di dialogo. Se si visualizza il pulsante Help , è necessario elaborare la richiesta dell'utente di aiuto. Il trattamento può essere fatto in una delle routine di finestra dell'applicazione o in una routine di hook per la finestra di dialogo. In genere, si sarebbe elabora la richiesta di aiuto chiamando il funzione WinHelp.

Per elaborare i messaggi di aiuto in una delle vostre procedure di finestra, è necessario ottenere un identificatore di messaggio per la stringa definita dal valore HELPMSGSTRING e identificare la finestra per ricevere i messaggi. Per ottenere l'identificativo del messaggio, specificare HELPMSGSTRING come parametro in una chiamata alla funzione RegisterWindowMessage . Quando si crea la finestra di dialogo comune, utilizzare il membro hwndOwner della finestra di dialogo casella inizializzazione struttura per identificare la finestra che riceverà i messaggi. La procedura di finestra di dialogo Invia il messaggio di routine di finestra ogni volta che l'utente fa clic sul pulsante Guida.

Per elaborare i messaggi di aiuto nell'ambito di un gancio, si deve elaborare il messaggio WM_COMMAND . La routine di hook fornisce l'aiuto se il parametro wParam di questo messaggio indica che l'utente fa clic sul pulsante Guida . L'identificatore del pulsante Guida è la costante di pshHelp definita nel DLGS.File H.

Procedure di hook per le finestre di dialogo comuni tipo Esplora risorse aperte e Salva con nome non ricevono messaggi WM_COMMAND per il pulsante Help . Invece, nella finestra di dialogo Invia un messaggio di notifica CDN_HELP alla routine di hook, quando viene fatto clic sul pulsante ?.

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index