Share via

Esempio TESTHELP: controllo ActiveX con descrizioni comandi e Guida

  • Articolo

Aggiornamento: novembre 2007

Nell'esempio TESTHELP viene illustrato come utilizzare MFC per generare un controllo ActiveX in cui sia disponibile un file della Guida per visualizzare le informazioni per l'utente. In Testhelp.ocx viene illustrato inoltre come aggiungere le descrizioni comandi a un controllo ActiveX MFC.

Nota sulla sicurezza:

Questo esempio di codice viene fornito solo a scopo dimostrativo e non deve essere utilizzato in applicazioni o siti Web, poiché potrebbe non implementare le tecniche migliori a livello di sicurezza. Microsoft esclude ogni responsabilità per danni diretti o indiretti derivanti dall'utilizzo dell'esempio di codice per scopi diversi da quelli previsti.

Per ottenere gli esempi e le istruzioni per l'installazione:

  • In Visual Studio scegliere Esempi dal menu ?.

    Per ulteriori informazioni, vedere Individuazione dei file di esempio.

  • La versione più recente e l'elenco completo degli esempi sono disponibili in linea alla pagina Visual Studio 2008 Samples.

  • È anche possibile trovare gli esempi sul disco rigido del computer. Per impostazione predefinita, gli esempi e il file Leggimi vengono copiati in una cartella nel percorso \Programmi\Visual Studio 9.0\Samples\. Per le versioni Express di Visual Studio, tutti gli esempi sono disponibili in linea.

Generazione ed esecuzione dell'esempio

Per generare ed eseguire l'esempio TESTHELP

  1. Aprire il file di soluzione Testhelp.sln.

  2. Scegliere Genera dal menu Genera.

Una volta generato, l'esempio TESTHELP può essere utilizzato in qualsiasi applicazione contenitore ActiveX. Per ulteriori informazioni sulla modalità di accesso a Test Container, vedere Verifica di proprietà ed eventi tramite Test Container. Includere il controllo TESTHELP nel progetto del contenitore ed eseguire il progetto. Le proprietà del controllo TESTHELP possono essere impostate aprendo la finestra di dialogo delle proprietà del contenitore.

In questo esempio sono inclusi il file di progetto della Guida e tutti i file di origine del progetto della Guida.

Per rigenerare ed eseguire il file della Guida di TESTHELP

  1. Scegliere Help Workshop dal menu Start.

  2. Aprire Testhelp.hpj. Verrà visualizzata una procedura guidata di Help Workshop per la conversione del file in un file HHP. Eseguire la procedura guidata assegnando un nome al file e accettando le modifiche.

  3. Scegliere Compile dal menu File. Nella finestra di dialogo Create a compiled file, specificare dove si desidera memorizzare il file compilato e scegliere Compile.

  4. Per visualizzare il file compilato, scegliere Compiled Help File dal menu View.

Funzionalità di TESTHELP

In TESTHELP viene illustro quanto segue:

  • Visualizzazione di una descrizione comandi per il controllo ActiveX.

  • Attivazione e disattivazione della descrizione comandi utilizzando la pagina delle proprietà del controllo.

  • Modifica del testo della descrizione comandi utilizzando la pagina delle proprietà del controllo.

  • Attivazione del pulsante ? della finestra della proprietà del contenitore di controlli ActiveX, per visualizzare il file della Guida del controllo quando il pulsante ? viene scelto.

  • Attivazione del pulsante ? nella Raccolta componenti e controlli di Visual C++, in modo che il file della Guida del controllo venga visualizzato quando il controllo viene scelto dalla raccolta e si fa clic sul pulsante ?.

  • Visualizzazione delle informazioni della Guida in fase di esecuzione, quando il controllo è attivo e viene premuto F1.

  • Utilizzo delle proprietà predefinite Font, BackColor e ForeColor di un controllo ActiveX.

Pagina delle proprietà Generale

  • Type of Help to Use
    Questa proprietà consente di stabilire la modalità di utilizzo della Guida quando l'utente preme F1 e lo stato del controllo TESTHELP è attivo. Help in a pop-up window indica che quando l'utente preme F1 e il controllo TESTHELP è in esecuzione in un contenitore e ha lo stato attivo, viene visualizzata una finestra popup con l'argomento "What is this thing?" del file della Guida Testhelp.hlp. Show the Whole Help File indica che quando l'utente preme F1 e il controllo TESTHELP è in esecuzione in un contenitore e ha lo stato attivo, verrà avviato il programma della Guida di Windows e verrà visualizzato il sommario degli argomenti del file Testhelp.hlp.

  • Use Control's Help File
    Se questa casella è selezionata, la Guida verrà visualizzata nel formato determinato dalla proprietà Type of Help to Use quando l'utente preme F1 e il controllo è in esecuzione in un contenitore e ha lo stato attivo.

  • Use ToolTip for this Control
    Se questa casella è selezionata, una descrizione comandi verrà visualizzata in primo piano sulla finestra del controllo, se quest'ultimo è in esecuzione nel contenitore e il cursore del mouse viene spostato nella finestra stessa. Il testo da visualizzare è determinato dalla proprietà Tooltip Caption.

  • Tooltip Caption
    Il testo da visualizzare in una descrizione comandi se l'utente sceglie di visualizzare tale descrizione.

    • Name1   Nome visualizzato nella parte superiore del controllo.

    • Name2   Nome visualizzato nella parte centrale del controllo.

    • Name3   Nome visualizzato nella parte inferiore del controllo.

Pagina delle proprietà dei colori

Consente di scegliere i colori da utilizzare nel disegno del controllo.

Pagina delle proprietà dei tipi di caratteri

Consente di specificare il tipo di carattere utilizzato per il testo del controllo.

Nota:

Alcuni esempi, tra cui il presente, non sono stati cambiati per riflettere le modifiche apportate alle procedure guidate, alle librerie e al compilatore di Visual C++, tuttavia forniscono comunque le istruzioni per completare l'attività desiderata.

Parole chiave

Nell'esempio TESTHELP vengono illustrate le classi e le seguenti parole chiave:

CToolTipCtrl; COleControl::OnDraw; COleControl::OnResetState; COlePropertyPage::OnHelp

Nota:

Alcuni esempi, tra cui il presente, non sono stati cambiati per riflettere le modifiche apportate alle procedure guidate, alle librerie e al compilatore di Visual C++, tuttavia forniscono comunque le istruzioni per completare l'attività desiderata.

Vedere anche

Altre risorse

Esempi relativi ad MFC