В этой главе мы расскажем о том, как приложения Presentation Manager работают с клавиатурой. Как и следовало ожидать, методика работы с клавиатурой в прилоениях Presentation Manager полностью отличается от той, что используется в программах MS-DOS .
Напомним, что когда пользователь нажимает клавишу, генерируется аппаратное прерывание. В операционной системе MS-DOS обработчик этого прерывания записывал скан-код нажатой клавиши в специальный клавиатурный буфер, расположенный в области данных BIOS . Когда программе MS-DOS нужно было ввести код нажатой клавиши, она (прямо или косвенно) обращалась к прерыванию INT 16h , которое возвращало расширенный ASCII-код нажатой клавиши. При необходимости программа переходила в режим ожидания и находилась в нем до тех пор, пока пользователь не нажимал какую-нибудь клавишу. Способы работы с клавиатурой в среде MS-DOS мы подробно рассмотрели во втором томе "Библиотеки системного программиста", который называется "Аппаратное обеспечение IBM PC".
В среде операционной системы IBM OS/2 одновременно может работать несколько приложений, которые при этом должны пользоваться только одной клавиатурой. Очевидно, что в такой ситуации никакое приложение не может блокировать работу всей системы, ожидая ввод с клавиатуры.
Для работы с клавиатурой в приложениях Presentation Manager используется механизм сообщений. Каждый раз когда пользователь нажимает или отпускает любую клавишу, система Presentation Manager генерирует сообщение с кодом WM_CHAR . Параметры этого сообщения несут всю необходимую информацию о нажатой (или отпущенной) клавише.
В какое окно попадают клавиатурные сообщения?
В то, которое имеет фокус ввода. Если пользователь делает одно из приложений активным, выдвигая его на передний план, функция окна этого приложения будет получать клавиатурные сообщения. С помощью функции WinSetFocus приложение может передать фокус ввода любому окну. При этом сообщения от клавиатуры будут поступать в функцию этого окна.
Заметим, что в среде операционной системы IBM OS/2 могут работать приложения двух типов - приложения Presentation Manager и приложения текстового режима, напоминающие программы MS-DOS . Последние работают с клавиатурой при помощи набора функций, имеющих префикс имени Kbd, например, KbdCharIn . По своим возможностям эти функции недалеко ушли от прерывания INT 16h. Такие функции нельзя использовать в приложениях Presentation Manager, поэтому в нашей книге мы не будем их рассматривать.
Вместе с параметрами сообщения WM_CHAR передается такая информация, как скан-код клавиши, код символа (для символьных клавиш), виртуальный код клавиши и слово флагов.
Аппаратный скан-код содержится в битах 24 - 31 параметра mp1 и имеет 8 разрядов. Приложения редко используют этот код, так как он аппаратно-зависимый. Больший интерес представляет виртуальный код клавиши и код символа.
Тем не менее, при необходимости вы можете извлечь скан-код из параметра mp1 при помощи макрокоманды CHAR4FROMMP, например, так:
nScan = CHAR4FROMMP(mp1);
Виртуальный код нажатой клавиши имеет 16
разрядов и передается в битах 16 - 31 параметра mp2.
Для обычных символьных клавиш виртуальных код
равен нулю. Функциональные клавиши и клавиши
серого цвета имеют виртуальные коды, приведенные
ниже:
Клавиша |
Виртуальный код |
Значение виртуального кода |
Левая клавиша мыши |
VK_BUTTON1 |
0x01 |
Правая клавиша мыши |
VK_BUTTON2 |
0x02 |
Средняя клавиша мыши |
VK_BUTTON3 |
0x03 |
<Break> |
VK_BREAK |
0x04 |
Забой |
VK_BACKSPACE |
0x05 |
Табуляция <Tab> |
VK_TAB |
0x06 |
Обратная табуляция |
VK_BACKTAB |
0x07 |
Переход на новую строку, клавиша <Enter>
основной клавиатуры |
VK_NEWLINE |
0x08 |
Левая или правая клавиша сдвига <Shift> |
VK_SHIFT |
0x09 |
Левая или правая клавиша <Control> |
VK_CTRL |
0x0A |
Левая клавиша <Alt> |
VK_ALT |
0x0B |
Правая клавиша <Alt> |
VK_ALTGRAF |
0x0C |
<Pause> |
VK_PAUSE |
0x0D |
<Caps Lock> |
VK_CAPSLOCK |
0x0E |
<Esc> |
VK_ESC |
0x0F |
Пробел |
VK_SPACE |
0x10 |
Переход на следующую страницу <PgUp> |
VK_PAGEUP |
0x11 |
Переход на предыдущую страницу <PgUp> |
VK_PAGEDOWN |
0x12 |
<End> |
VK_END |
0x13 |
<Home> |
VK_HOME |
0x14 |
Перемещение курсора влево <Left> |
VK_LEFT |
0x15 |
Перемещение курсора вверх <Up> |
VK_UP |
0x16 |
Перемещение курсора вправо <Right> |
VK_RIGHT |
0x17 |
Перемещение курсора вниз <Down> |
VK_DOWN |
0x18 |
Печать экрана |
VK_PRINTSCRN |
0x19 |
Вставка <Insert> |
VK_INSERT |
0x1A |
Удаление <Delete> |
VK_DELETE |
0x1B |
<Scroll Lock> |
VK_SCRLLOCK |
0x1C |
<Num Lock> |
VK_NUMLOCK |
0x1D |
<Enter> на дополнительной (цифровой)
клавиатуре |
VK_ENTER |
0x1E |
Клавиша запроса системы |
VK_SYSRQ |
0x1F |
Функциональная клавиша <F1> |
V K_F1 |
0x20 |
- // - <F2> |
VK_F2 |
0x21 |
- // - <F3> |
VK_F3 |
0x22 |
- // - <F4> |
VK_F4 |
0x23 |
- // - <F5> |
VK_F5 |
0x24 |
- // - <F6> |
VK_F6 |
0x25 |
- // - <F7> |
VK_F7 |
0x26 |
- // - <F8> |
VK_F8 |
0x27 |
- // - <F9> |
VK_F9 |
0x28 |
- // - <F10> |
VK_F10 |
0x29 |
- // - <F11> |
VK_F11 |
0x2A |
- // - <F12> |
VK_F12 |
0x2B |
- // - <F13> |
VK_F13 |
0x2C |
- // - <F14> |
VK_F14 |
0x2D |
- // - <F15> |
VK_F15 |
0x2E |
- // - <F16> |
VK_F16 |
0x2F |
- // - <F17> |
VK_F17 |
0x30 |
- // - <F18> |
VK_F18 |
0x31 |
- // - <F19> |
VK_F19 |
0x32 |
- // - <F20> |
VK_F20 |
0x33 |
- // - <F21> |
VK_F21 |
0x34 |
- // - <F22> |
VK_F22 |
0x35 |
- // - <F23> |
VK_F23 |
0x36 |
- // - <F24> |
VK_F24 |
0x37 |
Завершение перемещения |
VK_ENDDRAG |
0x38 |
Вызов меню |
VK_MENU |
VK_F10 |
Заметьте, что в приведенном выше списке есть коды клавиш, которые отсутствуют на стандартной клавиатуре компьютера, совместимого с IBM PC. В этом нет ничего удивительного, так как в механизм виртуальных кодов клавиш заложена возможность работы и на других платформах.
Виртуальный код клавиши можно получить из параметра mp2 при помощи макрокоманды SHORT2FROMMP :
nVirt = SHORT2FROMMP (mp2);
Код символа, соответствующий нажатой символьной клавише, располагается в битах 0 - 15 параметра mp2 и может быть получен при помощи макрокоманды SHORT1FROMMP :
cChar = SHORT1FROMMP (mp2);
Обычные символьные клавиши могут нажиматься одновременно с клавишей сдвига. Код символа, полученный вместе с сообщением WM_CHAR , учитывает состояние клавиши <Shift> в момент, когда была нажата символьная клавиша.
Заметьте, что клавиша <Shift> сама по себе генерирует сообщение WM_CHAR . Поэтому когда вы нажимаете, а затем отпускаете, например, комбинацию клавиш <Shift + a>, в функцию окна приходит четыре сообщения WM_CHAR. Первое соответствует нажатию клавиши <Shift>, второе - нажатию клавиши <a>. Третье и четвертое соответствуют отпусканию указанных клавиш и приходят в той последоваетльности, в которой отпускаются клавиши.
Одинаковые клавиатурные сообщения могут комбинироваться системой Presentation Manager в одно клавиатурное сообщение (например, когда влключается режим автоповтора). Количество скомбинированных таким образом сообщений записывается в поле счетчика повторений, который располагается в битах 16 - 23 параметра mp1. Его можно извлечь при помощи макрокоманды CHAR3FROMMP :
nRepeatCount = CHAR3FROMMP(mp1);
Младшие 16 бит параметра mp1 сообщения WM_CHAR содержат флаги, отражающие состояние клавиш в момент генерации сообщения.
Для извлечения флагов из параметра mp1 удобно использовать макрокоманду SHORT1FROMMP :
nFs = SHORT1FROMMP (mp1);
Список отдельных флагов вместе с маской для
проверки и кратким описанием мы привели ниже:
Флаг |
Маска |
Описание |
KC_CHAR |
0x0001 |
Поле кода символа содержит правильное
значение |
KC_VIRTUALKEY |
0x0002 |
Поле виртуального кода клавиши содержит
правильное значение |
KC_SCANCODE |
0x0004 |
Поле аппаратного скан-кода клавиши
содержит правильное значение |
KC_SHIFT |
0x0008 |
Была нажата клавиша <Shift> |
KC_CTRL |
0x0010 |
Была нажата клавиша <Control> |
KC_ALT |
0x0020 |
Была нажата клавиша <Alt> |
KC_KEYUP |
0x0040 |
Сообщение было создано, когда
пользователь отпустил нажатую ранее клавишу |
KC_PREVDOWN |
0x0080 |
Ранее эта клавиша находилась в нажатом
состоянии (устанавливается при выполнении
функции автоповтора для клавиши, которую держат
в нажатом состоянии достаточно долгое время) |
KC_LONEKEY |
0x0100 |
Во время ввода комбинации клавиш
отпущена та клавиша, которая была перед этим
нажата |
KC_DEADKEY |
0x0200 |
Нажата клавиша для создания
диактрических символов ("мертвая" клавиша) |
KC_COMPOSITE |
0x0400 |
Композитная клавиша, составленная с
использованием диактрических символов |
KC_INVALIDCOMP |
0x0800 |
Неправильная композитная клавиша |
KC_TOGGLE |
0x1000 |
С помощью этого флага можно использвать
любую клавишу как переключающую |
KC_INVALIDCHAR |
0x2000 |
Неправильный код клавиши |
KC_DBCSRSRVD1 |
0x4000 |
Зарезервировано для двухсимвольных
кодов клавиш |
KC_DBCSRSRVD2 |
0x8000 |
Аналогично предыдущему |
Для извлечения отдельных компонент сообщения WM_CHAR удобно использовать макрокоманду CHARMSG , определенную следующим образом:
#define CHARMSG(pmsg) \ ((PCHRMSG)((PBYTE)pmsg + sizeof(MPARAM) ))
Эта макрокоманда пользуется структурой CHRMSG , показанной ниже:
typedef struct _CHARMSG { USHORT fs; // поле флагов UCHAR cRepeat; // счетчик повторений UCHAR scancode; // скан-код USHORT chr; // код символа USHORT vkey; // виртуальный код клавиши } CHRMSG; typedef CHRMSG *PCHRMSG;
Ниже мы показали пример использования этой макрокоманды для сохранения всех параметров сообщения WM_CHAR в структуре cm типа CHRMSG:
CHRMSG cm; cm.chr = CHARMSG(&msg) ->chr; cm.vkey = CHARMSG(&msg) ->vkey; cm.scancode = CHARMSG(&msg) ->scancode; cm.cRepeat = CHARMSG(&msg) ->cRepeat; cm.fs = CHARMSG(&msg) ->fs;
Изучение параметров сообщения WM_CHAR удобно выполнять с помощью приложения KBDMSG, которое отображает эти параметры в своем окне (рис. 5.1).
Рис. 5.1. Просмотр клавиатурных сообщений в окне приложения KBDMSG
В столбце VKEY отображается виртуальный код нажатой клавиши, в столбце SCAN - аппаратный скан-код, в столбце FS - флаги. Далее в столбце REPT отображается счетчик повторений и в столбце CHAR - символ (только для символьных клавиш).
Когда вы нажимаете очередную клавишу, текущее содержимое главного окна приложения сдвигается вверх и на экране появляется строка, соответствующая сообщению от нажатой клавиши. После отжимания клавиши появляется еще одна строка.
Исходные тексты приложения приведены в листинге 5.1.
Листинг 5.1. Файл kbdmsg\kbdmsg.c
// ================================================= // Определения // ================================================= #define INCL_WIN #define INCL_GPI #define INCL_WINDIALOGS #include <os2.h> #include <stdio.h> #include <string.h> #include "kbdmsg.h" // Прототип функции окна приложения MRESULT EXPENTRY WndProc(HWND, ULONG, MPARAM, MPARAM); // ================================================= // Глобальные переменные // ================================================= HAB hab; HWND hWndFrame; HWND hWndClient; CHAR szAppTitle[] = "Keyboard Messages"; // Размеры окна Client Window SHORT cxClient; SHORT cyClient; // Размеры символов выбранного шрифта SHORT cxChar, cyChar, cyDesc; // Заголовок столбцов CHAR szTitle[] = "VKEY SCAN FS REPT CHAR"; // ================================================= // Главная функция приложения main // ================================================= int main () { HMQ hmq; QMSG qmsg; BOOL fRc; // Флаги для создания окна Frame Window ULONG flFrameFlags = FCF_SYSMENU | FCF_TITLEBAR | FCF_MINMAX | FCF_SIZEBORDER | FCF_SHELLPOSITION | FCF_TASKLIST | FCF_ICON; // Имя класса главного окна CHAR szWndClass[] = "KBDMSG"; hab = WinInitialize (0); if(hab == NULLHANDLE) { WinMessageBox (HWND_DESKTOP, HWND_DESKTOP, "Ошибка инициализации", "Ошибка", 0, MB_ICONHAND | MB_OK); return(-1); } // Создаем очередь сообщений hmq = WinCreateMsgQueue (hab, 0); if(hmq == NULLHANDLE) { WinMessageBox (HWND_DESKTOP, HWND_DESKTOP, "Ошибка при создании очереди сообщений", "Ошибка", 0, MB_ICONHAND | MB_OK); WinTerminate (hab); return(-1); } // Регистрация главного окна приложения fRc = WinRegisterClass (hab, szWndClass, (PFNWP)WndProc, 0, 0); if(fRc == FALSE) { WinMessageBox (HWND_DESKTOP, HWND_DESKTOP, "Ошибка при регистрации класса главного окна", "Ошибка", 0, MB_ICONHAND | MB_OK); WinDestroyMsgQueue (hmq); WinTerminate (hab); return(-1); } // Создаем главное окно приложения hWndFrame = WinCreateStdWindow (HWND_DESKTOP, WS_VISIBLE , &flFrameFlags, szWndClass, szAppTitle, 0, 0, ID_APP_FRAMEWND, &hWndClient); if(hWndFrame == NULLHANDLE) { WinMessageBox (HWND_DESKTOP, HWND_DESKTOP, "Ошибка при создании главного окна", "Ошибка", 0, MB_ICONHAND | MB_OK); WinDestroyMsgQueue (hmq); WinTerminate (hab); return(-1); } while(WinGetMsg (hab, &qmsg, 0, 0, 0)) WinDispatchMsg (hab, &qmsg); WinDestroyWindow(hWndFrame); WinDestroyMsgQueue (hmq); WinTerminate (hab); return(0); } // ================================================= // Функция главного окна приложения // ================================================= MRESULT EXPENTRY WndProc(HWND hWnd, ULONG msg, MPARAM mp1, MPARAM mp2) { CHAR szMsg[100]; int nMsgSize; HPS hps; POINTL ptl; RECTL rec; CHRMSG cm; FONTMETRICS fm; switch (msg) { // При создании главного окна приложения // определяем и сохраняем метрики шрифта // с фиксированной шириной символов case WM_CREATE : { // Получаем пространство отображения hps = WinGetPS (hWnd); // Выбираем в пространство отображения шрифт // с фиксированной шириной символов SetCourierFont(hps); // Определяем метрики шрифта GpiQueryFontMetrics(hps, (LONG)sizeof(fm), &fm); cxChar = fm.lAveCharWidth; cyChar = fm.lMaxBaselineExt; cyDesc = fm.lMaxDescender; // Устанавливаем шрифт, выбранный в пространство // отображения по умолчанию ResetFont(hps); // Возвращаем пространство отображения WinReleasePS (hps); return FALSE; } // Во время перерисовки стираем содержимое // окна и выводим строку заголовка таблицы case WM_PAINT : { // Получаем пространство отображения hps = WinBeginPaint (hWnd, NULLHANDLE, &rec); // Закрашиваем область, требующую обновление WinFillRect (hps, &rec, CLR_WHITE); // Выбираем в пространство отображения шрифт // с фиксированной шириной символов SetCourierFont(hps); // Рисуем заголовок таблицы в нижней части окна ptl.x = cxChar; ptl.y = cyDesc + cyChar; GpiCharString At (hps, &ptl, strlen(szTitle), szTitle); // Устанавливаем шрифт, выбранный в пространство // отображения по умолчанию ResetFont(hps); // Возвращаем пространство отображения WinEndPaint (hps); return 0; } case WM_ERASEBACKGROUND : return(MRFROMLONG(1L)); // При изменении размеров окна сохраняем новые // размеры и перерисовываем окно case WM_SIZE : { cxClient = SHORT1FROMMP (mp2); cyClient = SHORT2FROMMP (mp2); // Все окно требует перерисовки WinInvalidateRect (hWnd, NULL, TRUE); return 0; } // Это сообщение появляется, когда пользователь // нажимает или отжимает клавишу case WM_CHAR : { // Получаем пространство отображения hps = WinGetPS (hWnd); // Выбираем в пространство отображения шрифт // с фиксированной шириной символов SetCourierFont(hps); // Выделяем параметры клавиатурного сообщения // и сохраняем их в структуре cm cm.chr = CHARMSG(&msg) ->chr; cm.vkey = CHARMSG(&msg) ->vkey; cm.scancode = CHARMSG(&msg) ->scancode; cm.cRepeat = CHARMSG(&msg) ->cRepeat; cm.fs = CHARMSG(&msg) ->fs; // Готовим строку для отображения параметров // клавиатурного сообщения sprintf (szMsg, "%04x %04x %04x %d %c", cm.vkey, cm.scancode, cm.fs, cm.cRepeat, cm.fs & KC_CHAR ? cm.chr : ' '); // Отображаем строку над заголовком таблицы // в нижней части окна ptl.x = cxChar; ptl.y = 2 * cyChar + cyDesc; nMsgSize = strlen(szMsg); GpiCharString At (hps, &ptl, nMsgSize, szMsg); // Устанавливаем шрифт, выбранный в пространство // отображения по умолчанию ResetFont(hps); // Возвращаем пространство отображения WinReleasePS (hps); // Устанавливаем границы сдвигаемой области окна WinSetRect (hab, &rec, 0, 2 * cyChar, cxClient, cyClient); // Выполняем сдвиг верхней части окна WinScrollWindow (hWnd, 0, cyChar + cyDesc, &rec, NULL, NULLHANDLE, NULL, SW_INVALIDATERGN ); return 0; } default: return(WinDefWindowProc (hWnd, msg, mp1, mp2)); } } // ================================================= // Выбор шрифта с фиксированной шириной символов // ================================================= void SetCourierFont(HPS hps) { FATTRS fat; // Заполняем структуру описанием нужного // нам шрифта // Размер структуры fat.usRecordLength = sizeof(FATTRS); // Название шрифта strcpy(fat.szFacename ,"Courier"); // Используем нормальный шрифт без выделений // наклоном, подчеркиванием и т. п. fat.fsSelection = 0; // Указываем, что система Presentation Manager должна // подобрать шрифт, подходящий к нашему описанию fat.lMatch = 0L; // Регистрационный номер, должен быть равен 0 fat.idRegistry = 0; // Кодовая страница fat.usCodePage = 850; // Высота шрифта fat.lMaxBaselineExt = 12L; // Ширина шрифта fat.lAveCharWidth = 12L; // Тип шрифта - обычный без использования кернинга, // двухбайтовых символов и т. д. fat.fsType = 0; // Использование шрифта - шрифт, который отображается // без смешивания с графикой fat.fsFontUse = FATTR_FONTUSE_NOMIX; // Создаем логический шрифт, имеющий идентификатор 1L GpiCreateLogFont(hps, NULL, 1L, &fat); // Выбираем созданный шрифт в пространство // отображения GpiSetCharSet (hps, 1L); } // ================================================= // Установка шрифта, выбранного в пространство // отображения по умолчанию // ================================================= void ResetFont(HPS hps) { // Выбираем шрифт по умолчанию GpiSetCharSet (hps, LCID_DEFAULT); // Удаляем созданный ранее шрифт // с идентификатором 1L GpiDeleteSetId(hps, 1L); }
В глобальных переменных cxClient и cyClient хранятся размеры окна Client Window (соответственно, ширина и высота). Эти размеры определяются в момент обработки сообщения WM_SIZE и используются при сдвиге (свертке) содержимого окна.
В переменные cxChar, cyChar и cyDesc записываются размеры символов для выбранного нами шрифта с фиксированной шириной символов. Подробно о метриках шрифта вы узнаете позже в одной из следующих книг "Библиотеки системного программиста", а пока можете считать, что в переменных cxChar и cyChar хранятся, соответственно, ширина и высота символов, а в переменной cyDesc - размер выступающей части символов (например, размер хвостика у буквы 'у').
В массиве szTitle записана текстовая строка, которая используется для заголовка таблицы и отображается в нижней части главного окна приложения.
Функция main не имеет никаких особенностей. Она создает главное окно приложения и очередь сообщений, а затем запускает цикл обработки сообщений.
Эта функция выполняет всю полезную работу в нашем приложении. Рассмотрим обработчики отдельных сообщений.
Задачей обработчика сообщения WM_CREATE является определение метрик шрифта с фиксированной шириной букв, удобного для отображения таблицы с параметрами сообщения WM_CHAR .
Так как перед определением метрик шрифта последний необходимо выбрать в пространство отображения, первое, что делает обработчик сообщения WM_CREATE - это получает идентификатор пространства отображения при помощи функции WinGetPS . Напомним, что обработчики любых сообщений, кроме сообщения WM_PAINT , должны получать этот идентификатор с помощью функции WinGetPS.
Далее обработчик сообщения выбирает в полученное пространство отображения шрифт с фиксированной шириной символов. Для этого он вызывает функцию SetCourierFont, определенную в нашем приложении.
После этого с помощью функции GpiQueryFontMetrics обработчик сообщения WM_CREATE записывает метрики выбранного шрифта в структуру fm типа FONTMETRICS.
Детальное описание этой структуры мы отложим до главы, посвященной шрифтам в Presentation Manager. Скажем только, что поля lAveCharWidth, lMaxBaselineExt и lMaxDescender структуры FONTMETRICS после возвращения из функции GpiQueryFontMetrics будут содержать, соответственно, ширину, высоту и размер выступающей части символов.
После определения и сохранения необходимых нам метрик шрифта обработчик выбирает в контекст отобаржения тот шрифт, который используется по умолчанию. Для этого он вызывает функцию ResetFont, определенную в нашем приложении.
Перед возвращением управления обработчик сообщения WM_CREATE освобождает пространство отображения, вызывая функцию WinReleasePS .
Сообщение WM_PAINT поступает в функцию окна после его создания, а также тогда, когда пользователь изменяет размеры окна (в последнем случае посылку этого сообщения инициирует обработчик сообщения WM_SIZE ).
Получив пространство отображения, обработчик сообщения WM_PAINT закрашивает область, требующую обновления, выбирает шрифт с фиксированной шириной букв и затем рисует заголовок таблицы в нижней части главного окна приложения. После этого он восстанавливает шрифт и освобождает пространство отображения.
Это сообщение обрабатывается как обычно. В ответ на него функция окна возвращает значение 1L, позволяя при необхоимости окну Frame Window стереть содержимое окна Client Window .
При обработке сообщения WM_SIZE функция окна определяет размеры окна, сохраняя их в переменных cxClient и cyClient, а затем инициирует перерисовку окна. С этой целью вызывается функция WinInvalidateRect , объявляющая все окно требующим перерисовки. В результате функция окна получит сообщение WM_PAINT .
Обработчик сообщения WM_CHAR получает пространство отображения и выбирает в него шрифт с фиксированной шириной символов, вызывая функцию SetCourierFont.
Далее при помощи макрокоманды CHARMSG обработчик разбирает параметры сообщения WM_CHAR и записывает их в соответствующие поля структуры cm типа CHRMSG.
Из параметров сообщения WM_CHAR формируется текстовая строка szMsg, которая затем отображается в нижней части окна приложения над заголовком таблицы. При формировании текстовой строки проверяется флаг KC_CHAR. Если сообщение соответствует символьной клавише, в строку записывается код соответствующего символа, в противном случае - код символа пробела.
После отображения отформированной текстовой строки обработчик сообщения WM_CHAR восстанавливает шрифт и возвращает пространство отображения.
Затем содержимое всего окна за исключением строки заголовка сдвигается вверх при помощи функции WinScrollWindow . Прототип этой функции приведен ниже:
LONG WinScrollWindow ( HWND hwnd, // идентификатор окна LONG lDx, // величина сдвига вправо LONG lDy, // величина сдвига вверх PRECTL prclScroll, // область сдвига PRECTL prclClip, // область ограничения HRGN hrgnUpdateRgn, // область обновления PRECTL prclUpdate, // прямоугольная область обновления ULONG flOptions); // параметры сдвига
В нашем приложении эта функция используется сделующим образом:
WinScrollWindow (hWnd, 0, cyChar + cyDesc, &rec, NULL, NULLHANDLE, NULL, SW_INVALIDATERGN );
Окно hWnd сдвигается вверх на величину высоты символов (с учетом размера выступающей части символов). Параметр SW_INVALIDATERGN указывает, что сдвинутая область должна быть обновлена, для чего функции окна будет передано сообщение WM_PAINT .
Область свертки (т. е. область, в которой будет выполняться сдвиг), определяется содержимым полей структуры rec, для заполнения которой мы использовали функцию WinSetRect :
WinSetRect (hab, &rec, 0, 2 * cyChar, cxClient, cyClient);
Прототип функции WinSetRect приведен ниже:
BOOL WinSetRect ( HAB hab, // идентификатор блока Anchor-block PRECTL prclrect, // адрес структуры RECTL LONG lLeft, // левый край LONG lBottom, // нижний край LONG lRight, // правый край LONG lTop); // верхний край
Как видно, сдвигается все окно кроме полосы, имеющей двойную высоту символов и расположенной в нижней части окна. В этой полосе отображается заголовок таблицы.
Эта функция выбирает в пространство отображения шрифт с фиксированной шириной символов. Пока мы не будем рассматривать функцию SetCourierFont подробно. Скажем только, что для выбора шрифта его описание в виде набора параметров записывается в поля структуры fat типа FATTRS . Адрес этой структуры затем передается функции GpiCreateLogFont, создающей логический шрифт с идентификатором 1L.
Далее созданный шрифт выбирается в пространство отображения при помощи функции GpiSetCharSet .
Функция ResetFont восстанавливает шрифт после функции SetCourierFont. Для этого она с помощью функции GpiSetCharSet выбирает в пространство отображения шрифт по умолчанию и затем удаляет логический шрифт, созданный в функции SetCourierFont.
Файл kbdmsg.h (листинг 5.2) содержит определение константы ID_APP_FRAMEWND, а также прототипы функций SetCourierFont и ResetFont.
Листинг 5.2. Файл kbdmsg\kbdmsg.h
#define ID_APP_FRAMEWND 1 void SetCourierFont(HPS hps); void ResetFont(HPS hps);
Файл описания ресурсов приложения KBDMSG с именем kbdmsg.rc представлен в листинге 5.3.
Листинг 5.3. Файл kbdmsg\kbdmsg.rc
#include <os2.h> #include "kbdmsg.h" ICON ID_APP_FRAMEWND KBDMSG.ICO
Файл определения модуля приложения kbdmsg.def представлен в листинге 5.4.
Листинг 5.4. Файл kbdmsg\kbdmsg.def
NAME KBDMSG WINDOWAPI DESCRIPTION 'KbdMsg Application (C) Frolov A., 1996' HEAPSIZE 4096 STACKSIZE 32768 EXPORTS WndProc