Файл hlpmore/helpmwh.cpp
// ---------------------------------------- // Демонстрация использования функции WinHelp // ---------------------------------------- #define STRICT #include <windows.h>
#include <mem.h>
#include "helpmwh.hpp"
BOOL InitApp(HINSTANCE);
LRESULT CALLBACK _export WndProc(HWND, UINT, WPARAM, LPARAM);
BOOL CALLBACK _export DlgProc(HWND, UINT, WPARAM, LPARAM);
char const szClassName[] = "HelpmWhClass"; char const szWindowTitle[] = "WinHelp Demo"; HACCEL hAccel; BOOL bF1 = FALSE; HWND hwndDlg = NULL; DLGPROC lpfnDlgProc; HINSTANCE hInst;
// ===================================== // Функция WinMain // ===================================== #pragma argsused int PASCAL WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpszCmdLine, int nCmdShow) { MSG msg; // структура для работы с сообщениями HWND hwnd; // идентификатор главного окна приложения
if(!InitApp(hInstance)) return FALSE;
hInst = hInstance;
hwnd = CreateWindow( szClassName, szWindowTitle, WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, 0, 0, hInstance, NULL);
if(!hwnd) return FALSE;
ShowWindow(hwnd, nCmdShow);
UpdateWindow(hwnd);
// Загружаем таблицу акселераторов hAccel = LoadAccelerators(hInstance, "APP_ACCEL");
while(GetMessage(&msg, 0, 0, 0)) { if(!TranslateAccelerator(hwnd, hAccel, &msg)) { TranslateMessage(&msg);
DispatchMessage(&msg);
} } return msg.wParam; }
// ===================================== // Функция InitApp // Выполняет регистрацию класса окна // ===================================== BOOL InitApp(HINSTANCE hInstance) { ATOM aWndClass; WNDCLASS wc;
memset(&wc, 0, sizeof(wc));
wc.lpszMenuName = "APP_MENU"; wc.style = 0; wc.lpfnWndProc = (WNDPROC) WndProc; wc.cbClsExtra = 0; wc.cbWndExtra = 0; wc.hInstance = hInstance; wc.hIcon = LoadIcon(NULL, IDI_APPLICATION);
wc.hCursor = LoadCursor(NULL, IDC_ARROW);
wc.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);
wc.lpszClassName = (LPSTR)szClassName;
aWndClass = RegisterClass(&wc);
return (aWndClass != 0);
}
// ===================================== // Функция WndProc // ===================================== LRESULT CALLBACK _export WndProc( HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam) { switch (msg) { // Это сообщение поступает, если меню или модальная // диалоговая панель находится в состоянии ожидания case WM_ENTERIDLE: { // Пользователь выделил строку меню // Проверяем, была ли нажата клавиша <F1>
if((wParam == MSGF_MENU) && ((GetKeyState(VK_F1) & 0x8000) != 0)) { // Если была нажата клавиша <F1>
, устанавливаем // флаг bF1, а затем имитируем нажатие // клавиши <Enter>
bF1 = TRUE; PostMessage(hwnd, WM_KEYDOWN, VK_RETURN, 0l);
}
// Если клавиша <F1>
была нажата во время отображения // диалоговой панели, вызываем раздел оглавления // справочной системы else if((wParam == MSGF_DIALOGBOX) && ((GetKeyState(VK_F1) & 0x8000) != 0)) { hwndDlg = (HWND)LOWORD(lParam);
WinHelp(hwnd, "hlpmore.hlp", HELP_CONTENTS, 0L);
} break; }
case WM_COMMAND: { switch (wParam) { // Отображаем раздел оглавления справочной системы case CM_HELPINDEX: { WinHelp(hwnd, "hlpmore.hlp", HELP_CONTENTS, 0L);
return 0L; } case CM_HELPCOMMANDS: { // Если строка меню была выбрана клавишей <F1>
, // выводим справочную информацию, в противном // случае выполняем команду if(bF1) { WinHelp(hwnd, "hlpmore.hlp", HELP_CONTENTS, 0L);
bF1 = FALSE; } else WinHelp(hwnd, "hlpmore.hlp", HELP_CONTEXT, (DWORD)IDN_cmd);
return 0L; }
case CM_HELPKEYBOARD: { if(bF1) { WinHelp(hwnd, "hlpmore.hlp", HELP_CONTENTS, 0L);
bF1 = FALSE; } else WinHelp(hwnd, "hlpmore.hlp", HELP_CONTEXT, (DWORD)IDN_key);
return 0L; }
case CM_HELPUSING_HELP: { if(bF1) { WinHelp(hwnd, "hlpmore.hlp", HELP_CONTENTS, 0L);
bF1 = FALSE; } else WinHelp(hwnd, "hlpmore.hlp", HELP_HELPONHELP, 0L);
return 0L; }
case CM_HELPABOUT: { if(bF1) { WinHelp(hwnd, "hlpmore.hlp", HELP_CONTENTS, 0L);
bF1 = FALSE; } else { lpfnDlgProc = (DLGPROC)MakeProcInstance( (FARPROC)DlgProc, hInst);
DialogBox(hInst, "ABOUT_DIALOG", hwnd, lpfnDlgProc);
} return 0; }
case CM_FILEPRINTER_SETUP: case CM_FILEPAGE_SETUP: case CM_FILEPRINT: case CM_FILESAVEAS: case CM_FILESAVE: case CM_FILEOPEN: case CM_FILENEW: { if(bF1) { WinHelp(hwnd,"hlpmore.hlp", HELP_CONTEXT, (DWORD)IDN_file);
bF1 = FALSE; } else MessageBox(hwnd, "Меню File", "WinHelp Demo", MB_OK);
return 0; }
case CM_EDITPASTE: case CM_EDITCOPY: case CM_EDITCUT: case CM_EDITUNDO: { if(bF1) { WinHelp(hwnd,"hlpmore.hlp", HELP_CONTEXT, (DWORD)IDN_edit);
bF1 = FALSE; } else MessageBox(hwnd, "Меню Edit", "WinHelp Demo", MB_OK);
return 0; }
case CM_VIEWNORMAL: case CM_VIEWZOOM: { if(bF1) { WinHelp(hwnd,"hlpmore.hlp", HELP_CONTEXT, (DWORD)IDN_view);
bF1 = FALSE; } else MessageBox(hwnd, "Меню View", "WinHelp Demo", MB_OK);
return 0; }
case CM_FILEEXIT: { DestroyWindow(hwnd);
return 0; }
default: return 0; } }
case WM_DESTROY: { PostQuitMessage(0);
return 0; }
default: break; } return DefWindowProc(hwnd, msg, wParam, lParam);
}
// ===================================== // Функция DldProc // ===================================== #pragma argsused BOOL CALLBACK _export DlgProc(HWND hdlg, UINT msg, WPARAM wParam, LPARAM lParam) { switch(msg) { case WM_INITDIALOG: { return TRUE; }
case WM_COMMAND: { switch(wParam) { case IDOK: case IDCANCEL: { EndDialog(hdlg, 0);
return TRUE; } } } } return FALSE; }
В функции WinMain после обычной инициализации загружается таблица акселераторов, состоящая из одного определения. Комбинации клавиш <Shift+F1>
ставится в соответствие сообщение CM_HELPINDEX, попадающее в функцию окна приложения при выборе строки "Index" из меню "Help". Используя эту комбинацию клавиш, пользователь сможет отобразить раздел оглавления справочной системы.
Функция окна обрабатывает сообщение WM_ENTERIDLE, которое и помогает нам организовать контекстно-зависимую подсказку.
Это сообщение попадает в функцию окна приложения в том случае, если активизировано меню или диалоговая панель, и эти органы управления находятся в состоянии ожидания.
Если сообщение WM_ENTERIDLE попало в функцию окна в результате отображения меню, параметр wParam этого сообщения содержит значение MSGF_MENU.
Если же указанное выше сообщение явилось результатом отображения диалоговой панели, параметр wParam содержит значение MSGF_DIALOGBOX.
В обоих случаях младшее слово параметра lParam содержит идентификатор окна (при отображении меню) или диалоговой панели (при отображении диалоговой панели).
Чем же нам может помочь сообщение WM_ENTERIDLE для организации контекстно-зависимой подсказки?
При обработке этого сообщения приложение может проверить состояние клавиши <F1>
. Если эта клавиша была нажата, можно установить глобальный флаг запроса подсказки и поместить в очередь приложения сообщение WM_KEYDOWN с кодом клавиши <Enter>
.
Результат будет такой же, как если бы пользователь выбрал строку меню при помощи клавиатуры, вначале выделив ее, а затем нажав клавишу <Enter>
. Отличие заключается в том, что теперь установлен глобальный флаг запроса подсказки. Обработчик, запускаемый при выборе строки меню, может проверить этот флаг, и если он установлен, сбросить его и запросить контекстно-зависимую подсказку. Так как каждой строке меню соответствует свой индивидуальный обработчик, с организацией контекстно-зависимой подсказки не возникнет никаких проблем.
Именно по такому алгоритму и происходит обработка сообщения WM_COMMAND в нашем приложении.
Все необходимые константы определены в файле helpmwh.hpp (листинг4.4).
