лекции / Shchupak_Yu._Win32_API_Razrabotka_prilozheniy_dlya_Windows

СОВЕТ

Теоретически, можно определить быструю клавишу почти для каждой виртуальной или символьной клавиши в сочетании с клавишами Shift, Ctrl или Alt. Однако надо избегать использования тех быстрых клавиш, которые имеют традиционное применение во многих приложениях Windows. Например, F1 обычно используется для вызова контекстной справки, а клавиши F4, F5 и F6 — для специальных функций многооконного интерфейса приложений. Нежелательно назначать быстрыми клавишами клавиши Tab, Enter, Esc и Spacebar, поскольку они часто используются для системных функций. Например, Alt+F4 закрывает приложение или окно, Alt+Tab переключает на следующее окно, а Ctrl+Esc вызывает меню Старт.

Описанная процедура определения строки в таблице быстрых клавиш повто ряется для задания информации о каждой быстрой клавише в обрабатываемом меню. После этого определенный ресурс сохраняется в файле описания ресурсов.

Загрузка таблицы быстрых клавиш

Во время работы программы для загрузки таблицы быстрых клавиш в память и получения ее дескриптора используется функция LoadAccelerators:

Для передачи второму параметру имени таблицы IDR_ACCELERATOR1, назначен ного редактором ресурсов, необходимо использовать макрос MAKEINTRESOURCE.

В случае успешного выполнения функция возвращает дескриптор таблицы бы стрых клавиш. В случае неудачного завершения функция возвращает значение NULL.

Модификация цикла обработки сообщений

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

int TranslateAccelerator (

);

Функция преобразует сообщение WM_KEYDOWN или WM_SYSKEYDOWN1 в сообще ние WM_COMMAND или WM_SYSCOMMAND, если таблица акселераторов содержит соот ветствующий код виртуальной клавиши (с учетом состояния клавиш Ctrl, Altи Shift).

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

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

1 Сообщения клавиатуры рассматривались в главе 4.

циональных клавиш F2, F3 и им подобных в поле Key следует указывать идентифи каторы VK_F2, VK_F31 и т. д. Также следует сбросить флажок Ctrl.

Исходный код файла MenuDemo3.cpp приведен в листинге 6.3.

Листинг 6.3. Проект MenuDemo3

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

// MenuDemo3.cpp

LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM); //==================================================================== int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,

LPSTR lpCmdLine, int nCmdShow)

{

HACCEL hAccel; MSG msg;

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

// Загрузка таблицы быстрых клавиш

hAccel = LoadAccelerators(hInstance, MAKEINTRESOURCE(IDR_ACCELERATOR1));

while (GetMessage(&msg, NULL, 0, 0)) {

//Если сообщение не от быстрой клавиши,

//то выполнить стандартную обработку

if (!TranslateAccelerator(mainWnd.GetHWnd(), hAccel, &msg)) { TranslateMessage(&msg);

DispatchMessage(&msg);

}

}

return msg.wParam;

}

//====================================================================

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

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

1 Коды виртуальных клавиш приведены в табл. 4.3 (глава 4).

7Диалоговые окна

Диалоговые окна, или окна диалога (dialog box), являются одним из важнейших элементов графического интерфейса пользователя Windows приложений. Обыч но диалоговые окна используются для ввода пользователем дополнительной ин формации, а также для вывода результатов работы приложения.

Диалоговое окно имеет вид всплывающего окна с одним или несколькими эле ментами управления (controls), которые являются для него дочерними окнами. Используя элементы управления, пользователь вводит текст, выбирает указан ные опции (флажки, переключатели, элементы списка) и нажимает кнопки, вы зывающие различные действия приложения.

От обычных окон диалоговые окна отличаются тем, что они создаются на базе предопределенного в Windows класса диалоговых окон. Оконная процедура этого класса, спрятанная в недрах Windows, обеспечивает обработку сообщений, посту пающих в диалоговое окно, а также задает специфическое поведение элементов управления диалогового окна. Например, она управляет передачей фокуса ввода от одного элемента другому или переносит фокус ввода между группами элемен тов при нажатии клавиши Tab. Эту невидимую для программиста оконную проце дуру иногда называют менеджером диалогового окна (dialog box manager).

Менеджер диалогового окна передает многие сообщения в функцию, опреде ленную в вашем приложении, которая называется процедурой диалогового окна, или просто диалоговой процедурой (dialog procedure). Эта процедура похожа на обычную оконную процедуру, но все же имеет некоторые важные особенности, которые будут рассмотрены ниже.

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

Типы диалоговых окон

Диалоговые окна бывают модальные (modal) и немодальные (modeless). Они раз личаются по влиянию на дальнейшее выполнение программы.

Шаблонная система единиц

В описании шаблона диалогового окна применяется специальная шаблонная систе ма единиц. Размеры и расположение диалогового окна, задаваемые в параметрах x, y, width, height, а также всех элементов управления должны быть указаны в единицах этой системы, называемых также шаблонными единицами (dialog template units).

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

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

Среднюю ширину и высоту символов для системного шрифта можно опреде лить с помощью функции GetDialogBaseUnits. Она возвращает 32 разрядное значе ние, младшее слово которого равно средней ширине символов в пикселах (baseunitX), а старшее слово — высоте символов в пикселах (baseunitY). Таким образом, для пересчета шаблонных единиц templateunitX, templateunitY в пикселы можно вос пользоваться следующими выражениями:

pixelX = templateunitX * baseunitX / 4; pixelY = templateunitY * baseunitY / 8;

Подобная система единиц измерения позволяет операционной системе пра вильно масштабировать диалоговое окно независимо от размера шрифта, уста новленного в настройках экрана.

По умолчанию Windows использует «мелкий шрифт» (96 точек на дюйм). В этом режиме функция GetDialogBaseUnits возвращает значения baseunitX = 8, baseunitY = 16.

Но пользователь может выбрать более крупный шрифт. Для смены шрифта нужно щелкнуть правой кнопкой мыши на поверхности рабочего стола и в по явившемся диалоговом окне Свойства: Экран нажать кнопку Дополнительно…, а за тем в окне Свойства перейти на вкладку Общие. Комбинированный список Размер шрифта позволяет выбрать другой шрифт.

Если пользователь выберет «крупный шрифт» (120 точек на дюйм) и переза грузит систему, чтобы новые параметры вступили в силу, то после этого функция

GetDialogBaseUnits будет возвращать значения baseunitX = 10, baseunitY = 20. Windows автоматически увеличит размеры диалоговых окон, и поэтому все текстовые над писи по прежнему будут размещены правильно.

Применяемая шаблонная система единиц дает еще одну возможность управ ления видом и размерами диалогового окна на стадии описания шаблона. Для этого достаточно в параметрах диалога выбрать другой шрифт при помощи инст рукции FONT.

Модальный диалог

Техника добавления к приложению простейшего модального диалогового окна будет рассмотрена на примере разработки приложения DlgDemo1.

Приложение DlgDemo1 является модификацией программы MenuDemo1, кото рая была рассмотрена в предыдущей главе. Напомним, что в этой программе при выборе пункта меню About… вызывается функция MessageBox для вывода окна сообщений, содержащего информационный текст. Окно сообщений тоже являет ся модальным диалоговым окном, но всю заботу о его создании и обработке берет на себя Windows. Но есть и обратная сторона подобной простоты создания ин формационного окна. Возможности программиста повлиять на внешний вид и со держимое подобного окна очень ограничены.

В приложении DlgDemo1 при выборе пункта меню About… будет вызываться настоящее модальное диалоговое окно, вид и поведение которого полностью оп ределяются программистом. В остальном приложение DlgDemo1 должно работать так же, как и приложение MenuDemo1.

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

Откройте в окне редактирования файл recource.h и замените в его тексте стро ку комментария

// Used by MenuDemo1.rc

следующей строкой:

// Used by DlgDemo1.rc

Модификацию программы начнем с определения шаблона диалогового окна.

Вызов и использование редактора диалоговых окон

В главном меню Visual Studio выполните команду Insert Resource. В появившем ся окне Insert Resource выберите тип ресурса Dialog и нажмите кнопку New. В ре зультате будет открыто окно редактора диалоговых окон с формой нового окна (рис. 7.1). Изначально в нем есть только кнопки OK и Cancel.

Рис. 7.1. Заготовка диалогового окна в окне редактора диалоговых окон

Также в окне приложения Visual Studio справа должна появиться панель ин струментов Controls (рис. 7.2). Эта панель содержит кнопки для создания элемен тов управления всех типов, которые можно добавлять в диалоговое окно.