Wyświetlanie pomocy kontekstowej

Artykuł
02/27/2013

Pomoc kontekstowa, przedmiotem dalszych dyskusji, odnosi się w celu wsparcia dla formantów w oknie dialogowym, że dostęp użytkowników:

Po naciśnięciu klawisza F1.
Klikając prawym przyciskiem myszy formant (co to jest?Pomoc).
Za pomocą wskaźnika znaku zapytania (co to jest?Wskaźnik pomocy).

Dla każdego formantu, który ma być obsługiwana Pomoc kontekstowa, ustawić HelpID właściwość, aby True.

W razie potrzeby dodaj htmlhelp.lib do Dodatkowe zależności właściwość, która znajduje się w wprowadzania strona właściwości programu łączącego folderu do projektu Stron właściwości okno dialogowe.

Informacje źródło dla pomocy kontekstowej są przechowywane w pliku txt, który można dołączyć do projektu Pomocy HTML.

Aby utworzyć plik tekstowy pomocy kontekstowej

Umożliwia utworzenie pliku .txt edytora tekstów.
Formatuj następujące tematy:

.topic 1

help text for control 1

.topic 2

help text for control 2

[!UWAGA]

Aby uzyskać więcej informacji zobacz "Designing pomocy kontekstowej" w Pomocy HTML pomocy online.Z Pomoc wybrać menu (w formacie HTML Help Workshop), Tematy pomocy.

Po utworzeniu pliku .txt należy dodać go do sekcji [Files] w pliku hhp.

Aby obsługiwać pomocy dla zasobów w oknie dialogowym, należy utworzyć dwuwymiarową tablicę, mapująca sterowania identyfikatory aby pomóc identyfikatory (numerach).

Aby utworzyć dwuwymiarowej tablicy

W pliku .cpp, dla każdej klasy, która reprezentuje okno dialogowe należy dodać dwuwymiarowej tablicy klasy.Na przykład:
```
static DWORD myarray[] = {
   IDC_CHECK1, 1,
   IDC_BUTTON1, 2,
   IDC_EDIT1, (DWORD)-1,
   0,0
};
```

Każda pozycja w dwuwymiarowej tablicy par identyfikator zasobu dla formantu okno dialogowe z numer tematu Pomocy kontekstowej w pliku tekstowym.Jeśli nie chcesz określonych zasobów, aby co to jest?Pomoc, użyj –1.Ostatnią parę w tej tablicy powinny być 0,0.

F1 dostęp do pomocy kontekstowej oznacza, że użytkownicy będą mogli naciśnij klawisz F1, jeśli formant ma fokus, aby uzyskać pomoc.

Aby włączyć F1 dostęp do pomocy kontekstowej

Wdrożenie obsługi dla WM_HELPINFO wiadomości (w każdej klasie okno dialogowe miejsce F1 dostęp do pomocy kontekstowej) i wdrożenie następujący kod dla programu obsługi:

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;
}

Co to jest?Pomoc Wyświetla Pomoc tego formantu, gdy użytkownik kliknie prawym przyciskiem myszy formant.

Do wykonania kliknij prawym przyciskiem myszy co to jest?Pomoc

Wdrożenie obsługi (zobacz Mapowanie wiadomości do funkcji) dla WM_CONTEXTMENU wiadomości w każdej klasie okno dialogowe, w którym ma, co to jest?Pomoc (Wybierz identyfikator dla okna dialogowego z listy identyfikatorów obiektów).Zaimplementować następujący kod dla programu obsługi:
```
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);
}
```

Po określeniu pliku chm, oczekiwanej lokalizacji jest katalogiem roboczym projektu.Zobacz program Debug: polecenie karta Stron właściwości w oknie dialogowym Lokalizacja katalogu roboczego (domyślnie katalogu projektu).Po określeniu pliku tekstowego w .chm, który zawiera pomoc kontekstową należy określić informacje o tej samej lokalizacji, co zostało określone dla pliku .txt w chm hhp.

Jeśli zostanie wprowadzona już F1 dostęp do pomocy kontekstowej, można łatwo włączyć, co to jest?wskaźnik, co powoduje, że znak zapytania są wyświetlane na pasku tytułu, w prawym górnym rogu okna dialogowego.

Aby włączyć, co to jest?Wskaźnik znaku zapytania pomocy

Wybierz Pomoc kontekstowa pole wyboru w Extended style karcie okna dialogowego właściwości pola.

Zobacz też

Koncepcje

Pomoc HTML: Pomoc kontekstową dla programów

Udostępnij za pośrednictwem