На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

Pop-up Topics



You can display a pop-up topic that contains information for a specific control or menu by calling the WinHelp function with the HELP_WM_HELP or HELP_CONTEXTMENU command. These commands display a topic in a pop-up window near the corresponding control or menu. To let the user return immediately to work in the application, the pop-up window is destroyed as soon as the user presses a key or clicks the left mouse button.

You use the HELP_WM_HELP command when processing WM_HELP messages for control windows. Because most controls pass the WM_HELP message to the DefWindowProc function, the corresponding dialog box procedure (or parent window procedure) processes this message. Rather than give a specific context identifier, the dialog box procedure must pass an array of control and context identifier pairs to WinHelp along with the control handle specified in the hItemHandle member of HELPINFO structure passed with the WM_HELP message. The function determines the identifier of the control for which the WM_HELP message was generated and uses the matching context identifier to display the appropriate topic.

You use the HELP_CONTEXTMENU command when processing WM_CONTEXTMENU messages. Because most controls pass the WM_CONTEXTMENU message to the DefWindowProc function, the corresponding dialog box procedure (or parent window procedure) processes this message. Again, the procedure specify an array of control and context identifier pairs and the handle in wParam when calling WinHelp so that the function can pick the appropriate context identifier from the array and display the appropriate topic. Unlike the HELP_WM_HELP command, HELP_CONTEXTMENU first displays a What's This? command in a menu. If the user chooses the command, WinHelp displays the topic. Otherwise, the request is canceled.

You can also display pop-up topics by using the HELP_CONTEXTPOPUP command and specifying a context identifier of the topic. This command is similar to the HELP_CONTEXT command but invokes the pop-up instance of Windows Help used by HELP_WM_HELP and HELP_CONTEXTMENU. Applications can use this command in response to WM_HELP messages to display help for menus and for windows that are not controls in a dialog box. To use this command most effectively, the application should assign context identifiers to these menus and windows.

You can assign a context identifier to any window or menu in the application. When the user's help requests generates a WM_HELP message, the system includes the context identifier in the HELPINFO structure that it passes to the parent window along with the WM_HELP message. The parent window can then pass the context identifier to WinHelp to display the requested help topic.
You use the SetWindowContextHelpId function to assign a context identifier to a window or control and the SetMenuContextHelpId function to assign a context identifier to a menu. You can retrieve the context identifier for a window or menu by using the GetWindowContextHelpId or GetMenuContextHelpId function.


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

Управляющие Темы



Вы можете отобразить управляющую тему, которая содержит информацию для специфического управления или меню вызывая функцию WinHelp с HELP_WM_HELP или команда HELP_CONTEXTMENU. Эти команды отображают тему в управляющем окне около соответствующего управления или меню. Чтобы позволять возврат пользователя немедленно, чтобы работать в приложении, управляющее окно уничтожено как только пользователь нажмет клавишу или щелкнет левую кнопку мыши.

Вы используете команда HELP_WM_HELP при обработке сообщений WM_HELP для управляющего окна. Поскольку большинство элементов управления прохода сообщение WM_HELP в функцию DefWindowProc, соответствующий диалоговый блок процедуры (или родительской процедуры окна) обрабатывает это сообщение. А не дайте специфический контекстный идентификатор, диалоговый блок процедуры должен передать массив управляющих и контекстных пар идентификатора на WinHelp вместе с управляющей ручкой определенной в элементе hItemHandle структуры HELPINFO пройденной сообщением WM_HELP. Функция определяет идентификатор управления для которого сообщение WM_HELP было сгенерировано и было использовано сочетающийся контекстный идентификатор, чтобы отображать подходящую тему.

Вы используете команда HELP_CONTEXTMENU при обработке сообщений WM_CONTEXTMENU. Поскольку большинство элементов управления прохода сообщение WM_CONTEXTMENU в функцию DefWindowProc, соответствующий диалоговый блок процедуры (или родительской процедуры окна) обрабатывает это сообщение. Кроме того, процедура определяет массив управляющих и контекстных пар идентификатора и ручка в wParam при разговоре WinHelp чтобы функция может выбрать подходящий контекстный идентификатор из массива и отображать подходящую тему. В отличие от команды HELP_WM_HELP, HELP_CONTEXTMENU сначала отображает Что - Эт? прикажите меню. Если пользователь выбирает команду, WinHelp отображает тему. В противном случае, запрос отменен.

Вы можете также отобразить управляющие темы используя команду HELP_CONTEXTPOPUP и определяя контекстный идентификатор темы. Эта команда подобная HELP_CONTEXT приказывать но вводит управляющий пример Подсказки Windows использованной HELP_WM_HELP и HELP_CONTEXTMENU. Приложения могут использовать эту команду в ответ на сообщения WM_HELP, чтобы отображать подсказку для меню и для окна, которое - не элементы управления в диалоговом блоке. Чтобы использовать эту команду наиболее эффективно, приложение должно назначать контекстными идентификаторами в эти меню и окно.

Вы можете назначить контекстным идентификатором в любое окно или меню в приложении. Когда запросы подсказки пользователя генерирует сообщение WM_HELP, система включает контекстный идентификатор в структуру HELPINFO, которая она передает в родительское окно вместе с сообщением WM_HELP. Родительское окно может затем передавать контекстный идентификатор на WinHelp, чтобы отображать запрошенную тему подсказки.
Вы используете функцию SetWindowContextHelpId, чтобы назначать контекстный идентификатор в окно или управлять и функция SetMenuContextHelpId, чтобы назначать контекстный идентификатор в меню. Вы можете извлечь контекстный идентификатор для окна или меню используя GetWindowContextHelpId или функция GetMenuContextHelpId.


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz