Visualizzazione della guida sensibile al contesto

Articolo
03/05/2013

La guida sensibile al contesto, allo scopo di questa discussione, si riferisce a supporto della Guida per i controlli in una finestra di dialogo dell'accesso utente:

Premendo F1.
Fare clic con il pulsante destro del mouse su un controllo (qual è il?Guida.
Utilizzando il puntatore del domanda- flag (qual è il?Puntatore della guida.

Per ogni controllo che si desidera supportare la guida sensibile al contesto, impostare la proprietà HelpID su True.

Se necessario, aggiungere htmlhelp.lib alla proprietà Dipendenze aggiuntive, nella pagina delle proprietà Input della cartella Linker nella finestra di dialogo Pagine delle proprietà del progetto.

Le informazioni di origine per guida sensibile al contesto sono archiviate in un file txt di includere nel progetto della guida HTML.

Per creare il file di testo della guida sensibile al contesto

Utilizzare un editor di testo per creare un file txt.
Formattare gli argomenti come segue:

.topic 1

help text for control 1

.topic 2

help text for control 2

[!NOTA]

Per ulteriori informazioni, vedere "progettare la guida sensibile al contesto" nella Guida HTML help.Dal menu Guida (in HTML help workshop), scegliere Guida.

Dopo aver creato il file txt, aggiungerlo alla sezione [programmi] file nel file HHP.

Per supportare la guida per le risorse in una finestra di dialogo, è necessario creare una matrice bidimensionale che esegue il mapping del controllo ID per gli ID (numeri di argomento).

Per creare la matrice bidimensionale

Nel file CPP, per ogni classe che rappresenta una finestra di dialogo, aggiungere una matrice bidimensionale alla fine della classe.Ad esempio:
```
static DWORD myarray[] = {
   IDC_CHECK1, 1,
   IDC_BUTTON1, 2,
   IDC_EDIT1, (DWORD)-1,
   0,0
};
```

Ogni voce della matrice bidimensionale associa un ID di risorsa per un controllo finestra di dialogo con un numero di argomenti dal file di testo della guida sensibile al contesto.Se non si desidera una risorsa specifica per disporre qual è il?La guida, utilizzo e 1.L'ultima coppia di questa matrice deve essere 0,0.

L'accesso a F1 guida sensibile al contesto indica che gli utenti potranno premere F1 quando un controllo è attivo per accedere alla guida.

Per consentire l'accesso a F1 guida sensibile al contesto

Implementare un gestore per un messaggio WM_HELPINFO (in ogni classe della finestra di dialogo in cui si desidera accedere tramite F1 alla guida sensibile al contesto) e implementare il codice seguente al gestore:

BOOL CMyDlg::OnHelpInfo(HELPINFO* pHelpInfo)
{
   BOOL bRet = TRUE;

   if (pHelpInfo->iContextType == HELPINFO_WINDOW)
   {
      HWND hwnd = ::HtmlHelp(
         (HWND)pHelpInfo->hItemHandle,
         _T("my_chm.chm::/ctrlhlp.txt"),
         HH_TP_HELP_WM_HELP,
         (DWORD)(LPVOID)myarray);
      bRet = (NULL != hwnd);
   }

   return bRet;
}

Qual è il?La guida visualizzata la guida del controllo quando un utente fa clic con il pulsante destro del mouse sul controllo.

Per distribuire fare clic con il pulsante destro del mouse sulla definizione di questo?Help

Implementare un gestore (vedere Messaggi del mapping delle funzioni) per il messaggio WM_CONTEXTMENU in ogni classe della finestra di dialogo in cui si desidera qual è la?Guida (select l'id della finestra di dialogo dall'oggetto ID).Implementare il codice seguente al gestore:
```
void CMyDlg::OnContextMenu(CWnd* pWnd, CPoint point)
{
   UNREFERENCED_PARAMETER(point);

   ::HtmlHelp(
      pWnd->GetSafeHwnd(),
      _T("my_chm.chm::/ctrlhlp.txt"),
      HH_TP_HELP_CONTEXTMENU,
      (DWORD)(LPVOID)myarray);
}
```

Quando si specifica il file chm, la posizione prevista la directory di lavoro del progetto.Vedere la scheda Debug la finestra di dialogo Pagine delle proprietà per il percorso della directory di lavoro (per impostazione predefinita, la directory del progetto).Quando si specifica il file di testo in help che contiene la guida sensibile al contesto, è necessario specificare le stesse informazioni sulla posizione di è specificato per il file txt in file chm .hhp.

Se già distribuite l'accesso F1 alla guida sensibile al contesto, è possibile attivare facilmente qual è il?puntatore, che comporta un punto interrogativo a essere visualizzato nella barra del titolo, nell'angolo superiore destro della finestra di dialogo.

Per abilitare qual è il?Puntatore del domanda- contrassegno della guida

Selezionare la casella di controllo Guida sensibile al contesto nella scheda Stili estesi proprietà finestra di dialogo.

Vedere anche

Concetti

Guida HTML: Guida sensibile al contesto per i programmi

Condividi tramite