<PAVE_OVER> Отображение контекстной справки
Контекстная справка, для данного материала ссылается, чтобы обеспечить поддержку для элементов управления в диалоговом окне, доступ пользователя:
Ключ, нажав клавишу 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, можно легко включить, что это? указатель, который вызывает вопросительный знак отображаться в заголовке окна, в правом верхнем углу окна диалогового окна.
Чтобы включить это?Указатель-вопросительный знак справки
- Выделите флажок Справка контекста на вкладке Расширенные стили диалогового окна свойств.