Работа с кнопкой Help в заголовке окна

В самом начале развития Windows во многих приложениях очень часто встречалась кнопка "Help" в заголовке окна. Кликнув на нее и переместив курсор на нужный элемент, пользователь мог получить подсказку, например, какие данные надо вводить в конкретное текстовое поле или что получится, если нажать какую-нибудь кнопку. Сейчас UIX-дизайнеры прокачали свои навыки, кнопка справки стала уже не так популярна, по крайней мере я не встречал ее ни в одном современном приложении. Но может быть кому-нибудь будет интересно, как ей пользоваться и как правильно обрабатывать ее сообщения. Начнем с интерфейса. Чтобы в заголовке окна появилась кнопка справки, оно должно быть изначально создано с расширенным стилем WS_EX_CONTEXTHELP. Для динамического управления кнопкой справки можно воспользоваться способом, описанным в этой статье.

Из программной части нам понадобится одна структура, которую почему-то не знает коробочный FASM. Хотя, блин, чему я удивляюсь...Суть контекстной справки заключается в том, чтобы при выборе пользователем какого-либо элемента диалогового окна, ему была предоставлена информация именно по этому элементу. Для персонализации справки можно назначить конкретному элементу окна контекстный идентификатор справки при помощи функции SetWindowContextHelpId. Это один из вариантов, с помощью которого в дальнейшем можно будет персонализировать справку.При нажатии кнопки справки в заголовке окна и выборе какого-нибудь элемента диалогового окна, родительскому окну отправляется сообщение WM_HELP, которое мы должны обработать.

Когда окну приходит сообщение WM_HELP, в параметре lParam передается указатель на структуру HELPINFO, в которой содержится исчерпывающая информация об элементе и координатах окна, по которым пользователь запросил справку.В поле iCtrlId передается ID элемента, в поле hItemHandle - хэндл элемента, в dwContextId - контекстный идентификатор справки, назначенный ранее функцией SetWindowContextHelpId, а во вложенной структуре MousePos - координаты в окне, на которых была запрошена справка. Определив координаты клика, можно определить их вхождение в границы нужного элемента или область окна с помощью функции PtInRect. В зависимости от решаемой задачи, вы можете применить тот или иной способ для определения, какой раздел справки хотел бы увидеть пользователь.

Теперь, зная, к какому элементу диалогового окна пользователь запросил подсказку, можно открыть файл справки на требуемом разделе, вывести окно сообщения с подсказкой или еще как-нибудь помочь пользователю с запрошенной информацией.

В приложении пример программы с исходным текстом, которая использует контекстную справку для элементов диалогового окна.

Комментарии

Добавить комментарий

Для вставки цитаты выделите текст и нажмите сюда

Имя*:

Текст комментария (не более 2000 символов)*:

*Все поля обязательны для заполнения.

Комментарии, содержащие рекламу, ненормативную лексику, оскорбления и т.п., а также флуд и сообщения не по теме, будут удаляться. Нарушителям может быть заблокирован доступ к сайту.