лекции / Shchupak_Yu._Win32_API_Razrabotka_prilozheniy_dlya_Windows

x0 = rect.right / 2;

y0 = rect.bottom / 2;

// Координаты прямоугольника и эллипса

switch (shapeData.id_shape) { case ID_RECTANGLE:

Rectangle(hDC, x1, y1, x2, y2); break;

case ID_RHOMB: Polygon(hDC, pt, 4); break;

case ID_ELLIPSE:

Ellipse(hDC, x1, y1, x2, y2); break;

}

DeleteObject(SelectObject(hDC, hOldBrush));

}

EndPaint(hWnd, &ps); break;

case WM_DESTROY: PostQuitMessage(0); break;

default:

return DefWindowProc(hWnd, uMsg, wParam, lParam);

}

return 0;

}

//////////////////////////////////////////////////////////////////////

Обратите внимание на некоторые детали реализации в программном коде. Так, меню, определенное в файле ресурсов MenuDemo1.rc с идентификатором IDR_MENU1, подключается к окну приложения при объявлении объекта mainWnd класса KWnd:

KWnd mainWnd("MenuDemo1", hInstance, nCmdShow, WndProc,MAKEINTRESOURCE(IDR_MENU1),, 100, 100, 400, 300);

Текущие параметры рисуемой фигуры хранятся в переменной shapeData струк турного типа ShapeData.

В блоке обработки сообщения WM_CREATE сначала определяется значение дес криптора hMenu главного меню, а затем вызывается функция SetMenuDefaultItem

для установки атрибута «применяемый по умолчанию» пункту Open подменю File. Дескриптор подменю File, передаваемый первому параметру данной функ ции, получен вызовом функции GetSubMenu(hMenu, 0).

Далее трижды вызывается функция CheckMenuRadioItem для установки исход ных отметок в группах пунктов, интерпретируемых как переключатели:

Отметки ставятся на пунктах, заданных четвертым параметром функции CheckMenuRadioItem. Следует отметить, что эти пункты соответствуют началь ным значениям переменных bShow, shapeData.id_shape и shapeData.id_bright. В дальнейшем при обработке соответствующих сообщений отметки переходят на другие пункты внутри каждой группы.

Пункты другой группы подменю, Color, интерпретируемые как флажки, полу чают свои отметки при помощи функции CheckMenuItem, когда обрабатывается сообщение WM_COMMAND с параметром wParam, младшее слово которого равно

IDM_RED, IDM_GREEN или IDM_BLUE.

Пункт главного меню Increase! c идентификатором IDM_RESIZE используется как флажок, переводящий переменную shapeSize из значения MIN в значение MAX и обратно.

Но пункты главного меню не могут получать отметку взведенного флажка. Поэтому, обрабатывая сообщение WM_COMMAND с параметром wParam, равным IDM_RESIZE, программа изменяет имя пункта от Increase к Decrease и обратно. Эта смена имени обеспечивается вызовом функции ModifyMenu. Символьная строка, назначаемая пункту, извлекается из массива itemResizeName. После возврата из ModifyMenu вызывается функция DrawMenuBar, чтобы немедленно отобразить из менения в полосе главного меню.

Когда изображение скрыто после выполнения команды Hide shape из подменю View, действия по изменению размеров фигуры теряют смысл. Интерфейс про граммы только выиграет, если в этой ситуации пункт меню IDM_RESIZE сделать недоступным. При обработке сообщения WM_COMMAND с параметром wParam, рав ным IDM_HIDE_SHAPE, вызывается функция EnableMenuItem, которой передается флаг MFS_GRAYED. В результате этого указанный пункт меню становится недоступ ным. При обработке сообщения WM_COMMAND с параметром wParam, равным

IDM_SHOW_SHAPE, вызывается функция EnableMenuItem с флагом MFS_ENABLED, и пункт меню IDM_RESIZE снова становится доступным для пользователя.

При обработке сообщения WM_COMMANDс параметром wParam, равным IDM_ABOUT, вызывается функция MessageBox, которая выводит окно сообщений с информаци ей о программе и ее разработчиках.

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

Рекомендуем вам откомпилировать эту программу и посмотреть, как она ра ботает.

мыши. Вы можете организовать вызов контекстного меню, обрабатывая любое из этих сообщений, при помощи функции TrackPopupMenuEx:

LPTPMPARAMS lptpm // область экрана, которую меню не должно перекрывать

);

Второй параметр функции может содержать флаги, управляющие размещени ем полосы меню относительно позиции курсора мыши (x, y), и флаги, задающие некоторые другие характеристики. Обычно можно воспользоваться флагами по умолчанию, передавая этому параметру нулевое значение. По умолчанию левый верхний угол всплывающего меню привязывается к точке (x, y).

Параметрам x и y необходимо передать экранные координаты курсора мыши в момент щелчка правой кнопкой. Координаты курсора мыши можно извлечь из параметра lParam сообщения WM_RBUTTONDOWN или сообщения WM_CONTEXTMENU. Нужно только учесть, что сообщение WM_RBUTTONDOWN содержит клиентские ко ординаты, поэтому при работе с этим сообщением необходимо преобразовать кли ентские координаты в экранные координаты при помощи функции ClientToScreen.

Параметр hwnd содержит дескриптор окна, владеющего контекстным меню. Все сообщения от меню будут направляться этому окну. При помощи параметра lptpm можно определить область экрана, которую меню не должно перекрывать. Чаще всего этому параметру передается значение NULL.

Функция не возвращает управление до тех пор, пока работа пользователя с меню не будет завершена выбором пункта или отказом от выбора.

Обработка сообщений, направляемых окну владельцу от контекстного меню, не отличается от обработки сообщений, источником которых является основное меню.

Приемы работы с контекстным меню продемонстрируем на примере разработ ки конкретного приложения.

Приложение MenuDemo2

Приложение MenuDemo2 решает те же задачи, что и приложение MenuDemo1, отли чаясь от него только организацией меню. Главное меню приложения MenuDemo2 содержит те же пункты, что и приложение MenuDemo1, за вычетом пункта Draw shape. Подменю второго уровня Shape и Color для отсутствующего пункта Draw shapeдолж ны быть реализованы в виде контекстных меню.

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

Создайте новый проект с именем MenuDemo2. Скопируйте из папки проекта MenuDemo1 в папку проекта MenuDemo2 файлы с расширениями .cpp, .h и .rc, скор ректировав их имена заменой MenuDemo1 на MenuDemo2. Добавьте эти файлы в состав проекта.

Листинг 6.2 (продолжение)

//==================================================================== int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,

LPSTR lpCmdLine, int nCmdShow)

{

MSG msg;

KWnd mainWnd("MenuDemo2", hInstance, nCmdShow, WndProc, MAKEINTRESOURCE(IDR_MENU1), 100, 100, 400, 300);

while (GetMessage(&msg, NULL, 0, 0)) { TranslateMessage(&msg); DispatchMessage(&msg);

}

return msg.wParam;

}

//==================================================================== LRESULT CALLBACK WndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)

{

POINT pt[4];

static ShapeSize shapeSize = MIN; static BOOL bShow = TRUE;

static HBRUSH hBrush, hOldBrush;

char* itemResizeName[2] = { "Decrease!", "Increase!"};

int intensity[3] = { 85, 170, 255 }; // интенсивность RGB-компонентов цвета int brightness;

static ShapeData shapeData;

switch (uMsg)

{

case WM_CREATE:

hMenu = GetMenu(hWnd);

hMenuShape = LoadMenu(GetModuleHandle(NULL), MAKEINTRESOURCE(IDR_MENU_SHAPE));

hMenuShape = GetSubMenu(hMenuShape, 0);

hMenuColor = LoadMenu(GetModuleHandle(NULL),

MAKEINTRESOURCE(IDR_MENU_COLOR));

hMenuColor = GetSubMenu(hMenuColor, 0);

//IDM_OPEN - пункт меню, применяемый по умолчанию SetMenuDefaultItem(GetSubMenu(hMenu, 0), IDM_OPEN, FALSE);

//Исходные отметки пунктов меню CheckMenuRadioItem(GetSubMenu(hMenu, 1), IDM_SHOW_SHAPE,

IDM_HIDE_SHAPE, IDM_SHOW_SHAPE, MF_BYCOMMAND); CheckMenuRadioItem(hMenuShape, ID_RECTANGLE,

ID_ELLIPSE, ID_RECTANGLE, MF_BYCOMMAND); CheckMenuRadioItem(hMenuColor, ID_DARK,

ID_LIGHT, ID_DARK, MF_BYCOMMAND);

shapeData.id_shape = ID_RECTANGLE;

При обработке сообщения WM_CONTEXTMENU необходимо выяснить, в какой ча сти окна произведен щелчок правой кнопкой мыши. Для этого экранные коорди наты курсора мыши, сохраненные в переменной point, преобразуются к клиентс ким координатам, представленным переменной ptInClient. Размеры клиентской области окна определяются в переменной rect после вызова функции GetClientRect.

Если щелчок произошел в левой части окна, то функции TrackPopupMenuEx пе редается дескриптор меню hMenuShape. Если щелчок был выполнен в правой час ти окна, то функции TrackPopupMenuEx передается дескриптор меню hMenuColor.

На рис. 6.8 показан вид окна приложения с контекстным меню hMenuColor.

Быстрые клавиши

Быстрая клавиша (keyboard accelerator) — это клавиша или комбинация клавиш, которые при нажатии генерируют сообщение WM_COMMAND или WM_SYSCOMMAND.

Обычно быстрые клавиши дублируют пункты меню, предоставляя пользова телю альтернативный способ вызова команд. На рис. 6.2 мы уже видели обозначе ния быстрых клавиш на полосе подменю File в окне приложения Visual Studio. Например, команду Newпользователь может вызвать, либо выбрав пункт File New, либо нажав сочетание клавиш Ctrl+N. Очевидно, что второй способ быстрее.

Хотя традиционно быстрые клавиши являются эквивалентом пунктов команд меню, они могут генерировать и такие команды, которых нет в меню.

Для многооконных приложений с множеством оконных процедур быстрые кла виши очень важны. Как известно, Windows посылает сообщения клавиатуры окон ной процедуре того окна, которое в данный момент имеет фокус ввода. Однако при работе с быстрыми клавишами Windows посылает сообщение WM_COMMANDтой окон ной процедуре, чей дескриптор был передан функции TranslateAccelerator. Как пра вило, это будет оконная процедура главного окна приложения, то есть именно того окна, в котором расположено меню. Следовательно, нет необходимости дублиро вать логику обработки быстрых клавиш в каждой оконной процедуре.

Чтобы добавить в приложение обработку быстрых клавиш, нужно выполнить последовательность действий:

1.Модифицировать определение ресурса меню, добавив к имени каждого дуб лируемого пункта информацию о быстрой клавише.

2.Определить таблицу быстрых клавиш в файле описания ресурсов.

3.Обеспечить загрузку таблицы быстрых клавиш в память приложения.

4.Модифицировать цикл обработки сообщений в функции WinMain.

Модификация определения ресурса меню

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

Для модификации определения пункта вызовите диалоговое окно Menu Item Properties (см. рис. 6.5) и в конце имени пункта, которое указано в поле Caption, добавьте текстовую строку \t<обозначение быстрой клавиши>.

Например, если добавляется быстрая клавиша Ctrl+O для дублирования пункта &Open... из подменю File, то следует добавить к прежнему имени текстовую строку \tCtrl+O. После модификации поле Caption будет содержать строку &Open...\tCtrl+O.

Таблица быстрых клавиш

Эта таблица обычно создается при помощи редактора таблиц быстрых клавиш. Для его запуска нужно выполнить команду меню Insert Resource в главном меню приложения Visual Studio. В появившемся диалоговом окне Insert Resource следу ет указать тип ресурса Accelerator, после чего нажать кнопку New. В результате бу дет открыто окно редактора таблицы быстрых клавиш (рис. 6.9).

Рис. 6.9. Окно редактора таблицы быстрых клавиш

По умолчанию редактор присваивает таблице быстрых клавиш имя IDR_AC CELERATOR1. В файле resource.h этот идентификатор определяется как целочисленная константа. В большинстве случаев можно согласиться с этим именем по умолча нию. После двойного щелчка на пустой строке таблицы откроется диалоговое окно

Accel Properties (рис. 6.10).

Рис. 6.10. Диалоговое окно Accel Properties

В поле ID введите идентификатор быстрой клавиши. Если быстрая клавиша дублирует пункт меню, то этот идентификатор должен совпадать с идентифика тором пункта меню. Например, если определяется быстрая клавиша для пункта &Open... подменю File для приложения MenuDemo1, следует ввести идентификатор

IDM_OPEN.

Вгруппе переключателей Type оставьте включенным переключатель VirtKey, так как в поле Key будет указываться виртуальная клавиша. Коды виртуальных кла виш можно посмотреть в табл. 4.3 (глава 4).

Введите в поле Key идентификатор нужной клавиши. Для цифр и латинских букв в качестве идентификатора вводится сам символ.

Вгруппе Modifiers установите те флажки, которые соответствуют дополнитель ным клавишам, входящим в определяемую комбинацию клавиш.

Например, если определяется быстрая клавиша Ctrl+O для пункта &Open..., то следует оставить включенным флажок Ctrl, а в поле Key ввести символ O (строчная буква «O» английского алфавита).