Контекстная справка отображения

Статья
02/20/2013

Контекстная справка, для данного материала ссылается, чтобы обеспечить поддержку для элементов управления в диалоговом окне, доступ пользователя:

Ключ, нажав клавишу F1.
Щелкнуть правой кнопкой мыши элемент управления (как это?Справка).
С помощью указатель-вопросительный знака (как это?Указатель справки).

Для каждого элемента управления, которые должны поддерживать контекстная справка, задайте свойство HelpID для Истина.

Если необходимо, добавьте htmlhelp.lib к свойству Дополнительные зависимости, на странице свойств папки ВводКомпоновщик в диалоговом окне Страницы свойств проекта.

Первичная информацию для контекстной справки сохраняется в файле .txt, который включается в проекте справки HTML.

Создать текстовый файл контекстной справки

С помощью текстового редактора создайте файл .txt.
Отформатируйте разделы следующим образом:

.topic 1

help text for control 1

.topic 2

help text for control 2

Примечание
Дополнительные сведения см. в разделе "проектирование контекстная справка" в справке справки HTML.В меню Справка (в HTML Help Workshop) выберите пункт Вызов справки.

После создания файла .txt, добавьте его в раздел [] файлов в файле .hhp.

Для поддержки справку для ресурсов в диалоговом окне необходимо создать двумерный массив, который сопоставляет идентификаторы элемента управления, чтобы помочь идентификаторы (числа раздела).

Создать двумерный массив

В cpp-файле, для каждого класса, представляющего диалоговое окно двумерный массив, добавьте в конец класса.Например:
```
static DWORD myarray[] = {
   IDC_CHECK1, 1,
   IDC_BUTTON1, 2,
   IDC_EDIT1, (DWORD)-1,
   0,0
};
```

Каждая запись в парах двумерного массива идентификатора ресурса для управления диалоговых окон с номером секции из текстового файла контекстной справки.Если нет необходимости иметь конкретный ресурс, что это?Справка, используя – 1.Последние пары в этом массиве должно быть равно 0,0.

Доступ к контекстной справке F1 означает, что пользователи смогут нажать клавишу F1, когда элемент управления имеет фокус для получения справки.

Включить доступ к контекстной справке F1

Реализуйте обработчик для сообщения WM_HELPINFO (в каждом классе диалоговых окон, где требуется доступ к контекстной справке F1) и реализуйте следующий код в обработчик:

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

Чтобы это?Справка по справке отображается элемента управления, когда пользователь щелкает правой кнопкой мыши элемент управления.

Для реализации щелкните правой кнопкой мыши, чтобы выполнить?Справка

Реализуйте обработчик (см. Сообщения сопоставления в функции) для сообщения WM_CONTEXTMENU в каждом классе диалоговых окон, где предполагается, что это?Справка (select идентификатор для диалогового окна из списка идентификаторов объектов).Реализуйте следующий код в обработчик:
```
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);
}
```

При определении chm-файл, заданное расположение рабочей папки проекта.В разделе вкладку Отладка диалогового окна Страницы свойств для расположения рабочей папки (по умолчанию - каталога проекта).При определении текстовый файл в .chm, содержащий контекстную справку, необходимо указать те же сведения о расположении, определяет для файла .txt в файле .chm .hhp.

Если такой реализации доступ к контекстной справке F1, можно легко включить, что это?указатель, который вызывает вопросительный знак отображаться в заголовке окна, в правом верхнем углу окна диалогового окна.

Чтобы включить это?Указатель-вопросительный знак справки

Выделите флажок Контекстная справка на вкладке Расширенные стили свойств диалогового окна.

См. также

Основные понятия

Справка HTML: Контекстная справка для программ

Поделиться через