<PAVE_OVER> Отображение контекстной справки

Статья
06/10/2015

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

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

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

Если необходимо, добавьте 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. Контекстная справка для программ

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