Text
                    BORLAND

Чарльз Калверт

вшом

мультимедиа
и компьютерные
игры,
на языке С

Создание
рабочих программ
для Windows
с первых шагов

Обучение
ЯО Конкретных
примерах,
включающих

Программирование
в Windows

в Windows
Charles Calvert teach yourself Windows Programming in 21 days S/MS PUBLISHING
Чарльз Калверт освой самостоятельно Программирование в Windows за 21 день Под общей редакцией Д. Зарецкого Жбином 'Москва 1995
УДК 681.3.06 Издание выпущено при содействии Комитета РФ по печати Перевод с английского Муравьев И.В. Выпускающий редактор Тимофеев В.В. Чарльз Калверт. Программирование в Windows: Освой самостоятельно за 21 день. — Пер. с англ.— М.: БИНОМ, 1995. — 496 с.: ил. ISBN 0-672-30344-2 ISBN 5-7503-0073-0 Книга известного американского автора — сотрудника фирмы Borland, представляет собой трехнедельный курс программирования в операционной среде Windows. Начиная с элементар- ных основ, материал постепенно усложняется от главы к главе, охватывая такие концептуаль- ные понятия Windows, как окна, диалоговые панели, ресурсы, шрифты, графические элементы управления и многое другое. Каждая тема иллюстрируется соответствующей программой на языке Си++. По замыслу автора, к концу данного курса читатель сможет самостоятельно писать довольно сложные проекты, как например, программирование мультимедиа или комью- терные игры. Книга предназначена для тех, кто твердо решил стать классным программистом. Все права защищены. Никакая часть этой книги не может быть воспроизведена в любой форме или любыми средствами, электронными или механическими, включая фотографирова- ние, магнитную запись или иные средства копирования или сохранения информации без пись- менного разрешения издательства. ISBN 0-672-30344-2 ISBN 5-7503-0073-0 Autorized translation from the English language edition. © Original copyright. Sams, 1993 © Издание на русском языке. Восточная Книжная Компания, 1995 © Художественное оформление. Н. Лозинская, 1995
ОГЛАВЛЕНИЕ День 1 НАЧАЛО............................................................. Общий обзор.................................................... Как пользоваться этой книгой................................... Ваша первая Windows-программа на языке Си++.................... Что такое WINDOWS.H?........................................... Что такое WinMain?............................................. Графический интерфейс пользователя............................. Какой вам нужен компьютер?..................................... Компилятор..................................................... Стили программирования и другие мелочи......................... Что такое Windows? ............................................ Интерфейс прикладного программирования......................... В чем суть 32-битного кода?.................................... С неба на землю................................................ Взгляд вперед.................................................. Резюме......................................................... Вопросы и ответы............................................... Вопросы для самопроверки....................................... Упражнения..................................................... День 2 ПОСТРОЕНИЕ ПРОЕКТОВ, СОЗДАНИЕ ОКОН ................................ Звук........................................................... DEF-файлы и визуализация....................................... Обзор компиляции и компоновки.................................. Проектные файлы и МАКЕ-файлы................................... МАКЕ-файл фирмы Microsoft...................................... МАКЕ-файл фирмы Borland........................................ Возвышенный язык DEF-файлов.................................... Создание окон.................................................. Резюме......................................................... Вопросы и ответы............................................... Вопросы для самопроверки....................................... Упражнения..................................................... День 3 СТАНДАРТНАЯ WINDOWS-ПРОГРАММА...................................... Первый функционирующий графический интерфейс................... О яблоках, апельсинах, Windows и DOS........................... Переходим к программе.......................................... Концептуальный обзор WinMain и WndProc......................... Вызов WinMain ................................................. WINDOWS.H ..................................................... Регистрация.................................................... Создание окна.................................................. Круговерть..................................................... Оконная процедура ............................................. Резюме......................................................... Вопросы и ответы............................................... Вопросы для самопроверки....................................... Упражнения ....................................................
День 4 СООБЩЕНИЯ, WINDOWSX И ОТОБРАЖЕНИЕ ТЕКСТА...........................65 Что такое сообщение?.............................................65 Ваша вторая полноценная Windows-программа........................66 Оператор switch, WINDOWSX и взломщики сообщений .................71 Макрос HANDLE_MSG................................................75 WINDOWSX и оконная процедура обработки сообщений по умолчанию ... 75 Подытоживая сказанное о взломщиках сообщений.....................76 Отображение текста...............................................76 BEGINPAINT, ENDPAINT и контексты устройств.......................77 TextOut и DiawText...............................................79 Резюме.......................................................... 80 Вопросы и ответы................................................ 80 Вопросы для самопроверки........................................ 81 Упражнения...................................................... 81 День 5 МЫШЬ И КЛАВИАТУРА..................................................82 Программа, сообщающая о передвижениях мыши и нажатиях клавиш ........................ 82 Вывод, минующий обработчик сообщения WM_PAINT................... 88 Определение нажатия клавиш с помощью WM KEYDOWN .................90 Системная клавиша................................................92 Сообщение WM_MOUSEMOVE...........................................93 Обработка одинарных и двойных щелчков кнопкой мыши...............95 Резюме...........................................................96 Вопросы и ответы............................................... 96 Вопросы для самопроверки.........................................97 Упражнения.......................................................97 День 6 ВВЕДЕНИЕ В РЕСУРСЫ..................................................98 Так что же такое ресурсы вообще?.................................98 Сценарии ресурсов..............................................100 Программа Emerson. Часть первая................................100 Взгляд вперед..................................................106 Использование компилятора ресурсов.............................106 Создание простого меню.........................................107 Конструирование меню ...........................................108 Добавление пиктограммы и курсора к EMERSON.CPP.................111 Ресурсы, определяемые пользователем.............................ИЗ Пользовательские ресурсы. Дополнительные мысли.................114 Резюме.........................................................115 Вопросы и ответы...............................................115 Вопросы для самопроверки.......................................116 Упражнения.....................................................116 День 7 РАСТРОВЫЕ ИЗОБРАЖЕНИЯ И ДИАЛОГОВЫЕ ПАНЕЛИ........................ 117 Emerson2.......................................................117 Что можно сделать со всеми этими файлами?......................126 Создание диалоговой панели.....................................127 Отображение диалоговой панели..................................129 Все о MakeProcInstance.........................................130 DialogBox и AboutDlgProc .......................................131 Растровые изображения. Эстетическая интерлюдия.................132
Программа Emerson рисует растровое изображение.................133 Таблицы символьных строк .................................... 136 Линейки прокрутки..............................................137 Резюме.........................................................139 Вопросы и ответы...............................................140 Вопросы для самопроверки...................................... 140 Упражнения.....................................................141 День 8 ПЕРВОЕ ЗНАКОМСТВО С ПРОГРАММОЙ SNAKO............................. 142 Обещанная премиальная программа................................142 Дочернее окно..................................................154 Модуль Grunt...................................................156 Таймер.........................................................157 Рисуем змею....................................................159 Резюме.........................................................159 Вопросы и ответы...............................................160 Вопросы для самопроверки.......,...............................160 Упражнения.....................................................160 День 9 ОСНОВЫ ШРИФТОВ................................................... 161 Шрифтовая лихорадка достигает IBM PC...........................161 Простая шрифтовая программа....................................162 Начинаем заниматься шрифтами...................................170 Раздел логических шрифтов......................................170 Вращение шрифта................................................172 Создание шрифта................................................173 Встроенные шрифты..............................................174 Сообщения WM_PAINT “заказывают музыку”.........................175 GetTextMetrics и модуль FontStr................................177 Резюме.........................................................179 Вопросы и ответы...............................................179 Вопросы для самопроверки.......................................180 Упражнения.....................................................180 День 10 ГРАФИЧЕСКИЕ ЭЛЕМЕНТЫ УПРАВЛЕНИЯ.................................. 181 Что такое графические элементы управления......................181 Демонстрация шрифтов...........................................182 Статические элементы управления................................189 Перечни........................................................192 Отмечаемые блоки...............................................193 Редактируемые поля.............................................194 Резюме.........................................................196 Вопросы и ответы...............................................197 Вопросы для самопроверки.......................................197 Упражнения ...................................................197 День 11 ВЗАИМОДЕЙСТВИЕ С ЭЛЕМЕНТАМИ УПРАВЛЕНИЯ С ПОМОЩЬЮ ОБРАБОТЧИКА ПЕРЕЧИСЛЯЕМЫХ ШРИФТОВ ФУНКЦИИ EnumFontFamilies......................................... 198 Краткая история WM_STARTFONTS..................................199 Доставка почты .............................................. 199 SendMessage и PostMessage......................................200 Перечисление системных шрифтов.................................202
Взаимодействие с перечнями......................................205 Визуальное отображение шрифта...................................207 Возврат из EnumFontFamilies.....................................208 Работа с отмечаемыми блоками....................................209 Возврат из ShowTheFont..........................................210 Резюме..........................................................211 Вопросы и ответы................................................211 Вопросы для самопроверки........................................212 Упражнения......................................................212 День 12 ЭЛЕМЕНТЫ УПРАВЛЕНИЯ И ИНТЕРФЕЙС УПРАВЛЕНИЯ СООБЩЕН ИЯМИ213 Создание оболочки Windows.......................................213 Исходный код....................................................215 Создание кнопок-селекторов......................................225 IsDialogMessage и переключение между управляющими элементами....227 Использование кнопок-селекторов для переключения режимов........228 Нажимайте правую кнопку!........................................229 Сообщения WM.PARENTNOTIFY.......................................230 Резюме..........................................................231 Вопросы и ответы................................................231 Вопросы для самопроверки........................................231 Упражнения......................................................232 День 13 СОЗДАНИЕ ПОДКЛАССОВ ОКОННЫХ ЭЛЕМЕНТОВ УПРАВЛЕНИЯ . . 233 Работа с кнопками...............................................233 Ограничение размера окна........................................235 Фокусы с каталогами.............................................236 Смена дисков и каталогов........................................239 Введение в создание подклассов оконных элементов управления.....240 Особенности создания подклассов элементов управления............241 Премиальная программа: создание подкласса рабочего стола Windows.244 Коротко о MenuAid ..............................................250 Работа с файлами инициализации..................................251 Динамические меню...............................................252 Резюме..........................................................254 Вопросы и ответы................................................254 Вопросы для самопроверки........................................254 Упражнения......................................................255 День 14 ОКНА В ЭЛЕГАНТНОМ СТИЛЕ........................................... 256 Создание стиля..................................................256 Создание дочерних окон..........................................264 Если хотите сделать что-то в хорошем стиле, понадобится много классов . . . 268 Кусочек фона....................................................269 Кисти на переправе ... меняют................................. 270 Использование поля cbWndExtra...................................272 Резюме..........................................................273 Вопросы и ответы................................................273 Вопросы для самопроверки........................................274 Упражнения......................................................274 День 15 ДИАЛОГОВЫЕ ПАНЕЛИ И РЕЖИМЫ ОТОБРАЖЕНИЯ............................ 275 Координирование координат........................................ 275
GDI и координаты устройства......................................278 Так что там с GDI?...............................................278 Более сложные концепции отображения..............................279 Прежде чем двинуться дальше......................................279 Диалоговые панели. Обзор и повторение............................291 Поонятия модального и немодального диалогов .....................292 Программирование модальных и немодальных диалогов................293 Резюме...........................................................295 Вопросы и ответы ................................................296 Вопросы для самопроверки.........................................296 Упражнения.......................................................297 День 16 СЛОЖНЫЕ ДИАЛОГИ. РАЗМЕЩЕНИЕ И ИЗВЛЕЧЕНИЕ ДАННЫХ . . . 298 Помещение данных в диалог Size...................................298 Визуализация данных .............................................300 Теория. Модальный диалог общается со своим родителем.............302 Практика. Извлечение данных из диалога Make Shape ........ . . . 302 Ответ на смену режима отображения................................304 Управление цветом диалоговой панели..............................305 Программа Mapper.................................................306 Mapper с точки зрения программиста...............................318 Кое-что новенькое. StretchBlt....................................318 Резюме...........................................................320 Вопросы и ответы.................................................320 Вопросы для самопроверки.........................................321 Упражнения.......................................................321 День 17 В ГЛУБИНЕ МЕНЮ И ПИКТОГРАММ........................................ 322 Что же у нас в меню? ............................................322 Программа MenuTest...............................................325 Еще раз о меню...................................................335 Помещение растрового изображения в меню..........................336 Модифицирование системного меню..................................339 Помещение “галочки” перед пунктом меню...........................340 Выбор нового курсора.............................................340 Более сложные пиктограммы........................................342 Коротко об ускорителях...........................................344 Резюме...........................................................345 Вопросы и ответы.................................................345 Вопросы для самопроверки.........................................346 Упражнения.......................................................346 День 18 ИНТЕРФЕЙС ГРАФИЧЕСКИХ УСТРОЙСТВ И МЕТАФАЙЛЫ.........................347 Работа с фигурами................................................347 Метафора графического редактора..................................350 Принцип резинки..................................................365 Что такое метафайлы?.............................................368 Функция PlayMetaFile.............................................369 Создание метафайлов в интерактивном режиме.......................370 От метафоры к реальности.........................................370 Чтение метафайлов с диска........................................372 Стандартные диалоги..............................................372 Резюме.......................................................... 375 Вопросы и ответы.................................................375
Вопросы для самопроверки.......................................376 Упражнения.....................................................376 День 19 МУЛЬТИДОКУМЕНТНЫЙ ИНТЕРФЕЙС (MDI)................................ 377 Что такое MDI..................................................377 Создание дочерних окон.........................................396 Изменение стиля дочерних окон MDI..............................398 Сообщения MDI, которые должны обрабатываться по умолчанию......399 Специфические сообщения для MDI-приложений.....................400 Управление меню MDI............................................402 Завершение работы..............................................403 Дополнительные байты и разделение ЦП...........................405 Isotropic и Anisotropic........................................406 Резюме.........................................................408 Вопросы и ответы...............................................408 Вопросы для самопроверки.......................................409 Упражнения.....................................................409 День 20 МУЛЬТИМЕДИА...................................................... 410 Поиск определения для мультимедиа..............................410 Сужение фокуса.................................................411 Нахождение общего языка с MCI..................................414 Программа Нагопу...............................................414 На старте .....................................................440 Общие стратегии MCI............................................441 Детали.........................................................441 Введение в DLL.................................................443 Экспорт функций из DLL.........................................443 DLL и память...................................................444 Срывая покровы с DLL...........................................445 Диалоговые окна................................................446 Резюме.........................................................447 Вопросы и ответы...............................................447 Вопросы для самопроверки.......................................447 Упражнения................................................... 448 День 21 SNAKO FOR WINDOWS ............................................... 449 Snako .........................................................449 Исходный код...................................................450 Стратегический обзор...........................................476 Использование указателей.......................................476 Ввод/вывод файлов..............................................479 Д инамические диалоги и центрирование диалоговой панели........481 Резюме.........................................................482 Вопросы и ответы...............................................482 Вопросы для самопроверки.......................................483 Упражнения.....................................................483 Приложение А ОТВЕТЫ НА ВОПРОСЫ ДЛЯ САМОПРОВЕРКИ................................. 484
День 1 НАЧАЛО В этой главе я привожу краткое введение в программирование под Windows, а затем даю два примера программ, разработанных для того, чтобы помочь вам поскорее начать работать самостоятельно. Предоставив вам шанс получить некоторый практический опыт, я перейду затем к обсуждению более общих вопросов. В частности, во второй половине этой главы рассматриваются: И Графические интерфейсы пользователя (GUI). Рекомендуемое аппаратное обеспечение. Компиляторы Windows. Стили программирования. Обзор Windows. Обзор последующих глав. Общий обзор Эта книга о программировании прикладных программ под Windows на языке Си или Си++. Я буду обсуждать с вами этот предмет, пользуясь дружественным, простым и технически грамотным языком. Уверен, что если вы имеете под собой прочный фундамент, то будете в состоянии подняться на любую высоту. Если же вы попытаетесь строить на песке, то любое сооружение, какое бы вы ни возвели, однажды рассыплется в прах. Поэтому мы будем продвигаться вперед неторопливой, но твердой поступью, всегда останавливаясь и выделяя основные положения, чтобы видеть их ясно даже издалека. Для уравновешива- ния этой, быть может, чрезмерно консервативной методики я постараюсь придержи- ваться веселого и жизнерадостного стиля. Моя цель значительно упрощается самой средой Windows, которая по самой своей природе развлекательная и азартная. Ведь с помощью всего двух строчек Windows-про- граммы можно выполнить задачу, чрезвычайно сложную для DOS. Например, трафика, звук и многозадачность — вот три проблемы, которые уже успели измучить, утомить, а подчас и вовсе доконать не одного из опытных программистов, работающих в DOS. Но вы легко можете запросить эти средства, находясь в среде Windows. Что касается трафики и воспроизведения звука, то они развились до такой степени, что теперь каждый пользователь может показывать фильмы и сочинять музыку на своем компьютере. И что еще важнее, новые усовершенствования Windows NT (Новой Технологии) позволяют программистам писать многомерные программы, которые могут использовать несколько процессоров одновременно. Кроме того, Windows NT предлагает упрощенную 32-битную схему адресации памяти и улучшенное сетевое обеспечение.
Все эти возможности весьма заманчивы. На кончиках пальцев Windows-программис- тов, занесенных над клавиатурой их персональных компьютеров, сосредоточена мощь, которая превосходит самые дикие сны вчерашних авторов научной фантастики. Десять лет назад трудно было предвидеть, что столь многое свершится так быстро и что подобная технология станет доступна почти каждому за сравнительно небольшую сумму. Полагаю, что вы не ухватились бы за эту книжку, не будь так уверены в важности Windows на сегодняшнем и завтрашнем культурном и экономическом рынках. Поэтому вам, вероятно, не терпится услышать, что же здесь содержится и как поскорее начать писать настоящие Windows-программы. Как пользоваться этой книгой Основная цель этой книги — дать вам прочное введение в основы программирования под Windows. Чтобы справиться с этой задачей, мне были необходимы два качества. Первое — твердое знание принципов построения Windows-программ, а второе — любовь к труду писателя и учителя. Каждый вечер, садясь работать над этой книгой, я стремился иметь совершенное знание материала, который мне предстояло осветить, а также сильное желание поделиться им с вами. Со своей стороны, вы должны быть готовыми проделать некоторую работу, а также хорошо знать программирование. Характер материала таков, что здесь нет места для общего введения в язык Си++ и основ пользования компьютером. Предполагается, что вы уже знаете, как пользоваться, например, диспетчерами программ и файлов и как работать с каталогами DOS. Я все же постарался сделать книгу как можно более доступной. Если вы уже имеете некоторый опыт программирования, то будете в состоянии пройти весь материал в том порядке, в котором он здесь излагается. Для этого, в частности, следует знать кое-что о структурном программировании, переменных, типах данных и о памяти компьютера. Вы также должны знать, как запускать компилятор и редактор. Кроме всего прочего, моей целью было показать, что вовсе не обязательно быть гением, чтобы стать первоклассным Windows-программистом. Самое главное — желание поэкспериментировать и получить от этого немного удовольствия. Всюду, где материал был особенно технически сложен и чувствовалось, что вам необходимо потрудиться для его понимания, я не жалел времени на объяснения. Я представляю себе идеального читателя как человека, имеющего скромные познания в языках Си или Си++, и, исходя из этого, хочу дать ему все необходимое, чтобы он стал классным программистом в области Windows. Для этого я попытался превратить первую треть книги в своего рода быстрое введение в программирование под Windows, т.е. дать вам все необходимое для того, чтобы начать делать стандартные Windows-приложения. Во второй трети книги я даю вам более глубокое знание об использовании основных средств программирования в среде Win- dows. И наконец в последней трети освещаю более совершенный материал. Надеюсь, что такой подход сделает эту книгу интересной и динамичной. В частности, я старался не идти путем погружения читателя сразу же после представления темы на такие глубины, что тот в отчаянии отбросил бы эту книгу или метался бы в поисках стаканчика виски. Напротив, все необходимые детали освещаются лишь тогда, когда вы действительно готовы продвинуться вперед. Некоторые книги по программированию претендуют на роль исчерпывающего справочника, в то время как другие являют собой шаблонный метод обучения — с началом, серединой и концом. Моей целью было найти компромисс между этими двумя подходами, но всюду, где следовало предпочесть один из них, я почти всегда отказывался от справочной модели. Большинство компиляторов и так сопровождаются хорошими справочниками, поэтому от руководства, подобного данному, требуется простой стиль изложения существенных технических моментов. Прежде чем показать первую Windows-программу, хочу обратить ваше внимание на то, что эта книга была разработана и оформлена таким образом, чтобы охватываемый ею материал можно было изучить ровно за 21 день. Однако вы вряд ли удивитесь, если
узнаете, что она была написана за более длительный срок. Так что я не буду возражать, если вы потратите более трех недель на ее чтение. Важно не то, как быстро вы прочитаете эту книгу, а как много вы из Нее извлечете. Итак, приготовьтесь к энергичному исследованию среды программирования Win- dows. Вы получите много удовольствия, узнав некоторые новые хитрости, и приятно удивитесь тому, насколько легко можно научиться новому захватывающему искусству. Ваша первая Windows-программа на языке Си++ Как только я начинаю работать с новой компьютерной программой или с новым языком, то всегда стремлюсь поскорее получить некоторый практический опыт. По- скольку вы, может быть, чувствуете в этом случае то же самое, я разработал короткую программу на языке Си++ (листинг 1.1), которую вы можете набрать и запустить всего за несколько минут. Листинг 1.1. Ваша первая Windows-программа 1: //Program SHORT.СРР 2: #include <wir>dows.h> 3: int PASCAL WinMain(HINSTANCE hinst, 4: HINSTANCE hPrevlnstance, 5: LPSTR IpszCmdParam, int ncmdShow) 6: ( 7: WinExec("NOTEPAD.EXE", SW_SHOWNORMAL) ; 6: return 1; 9: I На рис. 1.1 показан результат работы программы, приведенной в листинге 1.1. Рис. 1.1. Программа SHORT.EXE запускает редактор NOTEPAD.EXE Это вполне законная программа на языке Си++, в которой соблюдены все правила и соглашения, выработанные для программистов Windows. Единственная функция этого простого кода состоит в запуске маленького текстового редактора NOTEPAD.EXE, сопровождающего каждую копию Windows. Замечание. Если вы пользуетесь компилятором, не принадлежащем фирмам Borland или Mi- crosoft, то можете оказаться не в состоянии откомпилировать приведенную в листинге 1.1 программу без добавления файла определения модуля и МАКЕ-файла, рассматриваемых в следующей главе. Сейчас я опускаю их, чтобы дать вам возможность познакомиться с програм- мированием под Windows на наиболее простых из возможных примеров.
Для запуска программы SHORT.CPP нужно лишь стартовать вашу среду разработки, ввести исходный код, содержащийся в листинге 1.1, и откомпилировать его. Этот процесс (см. следующее описание) совсем не сложен. Так что сейчас продвигайтесь вперед, согласно намеченному плану, даже если не понимаете, как эта программа работает. Обратите лишь внимание, насколько она проста. Например, если вы пользуетесь компилятором фирмы Borland, можете ввести этот код, сохранить файл под именем SHORT.CPP и запустить его на выполнение, нажав сначала Alt-R, чтобы активизировать меню первого уровня, а затем R, чтобы стартовать программу. Вог и все! Кто теперь скажет, что программирование на Си++ под Windows должно быть трудным? Если вы пользуетесь новым элегантным пакетом фирмы Microsoft Visual C++, процесс ввода и запуска программы столь же прост. Во-первых, наберите текст програм- мы и сохраните его под именем SHORT.CPP. Затем нажмите Ctrl-F5, чтобы откомпи- лировать программу, а когда компиляция завершится, снова нажмите Ctrl-F5, чтобы запустить ее. Ну вот! Что может быть проще? Команда WinExec WinExec(progname, SW_ShowStatus); Команда WinExec содержит два параметра. Первый, progname, представляет собой имя програм- мы, которую вы хотите запустить, а второй, SWJShowStatus, — способ ее отображения на экране дисплея. Например, если задать SW_SHOWMAXIMIZED, программа Notepad должна будет сразу появиться в максимизированном окне. Вот несколько других возможностей: SW-HIDE SW_MINIMIZE SW_SHOWNORMAL SW_SHOWMAXIMIZED SW_SHOWMINIMI ZED Делает окно невидимым Минимизирует окно запускаемой программы Стартует программу и выдает в окне с текущими размером и местоположением Стартует программу в максимизированном окне Стартует программу в минимизированном окне Пример: WinExec("NOTEPAD.EXE", SW_SHOWNORMAL) ; Предыдущая программа нравится мне прежде всего тем, что она является светлым проблеском среди моря пачкотни, посвященной только тому, насколько сложны могут быть Windows и Си++, когда они соединяются вместе. Хотя во всех этих разговорах и есть некоторая доля истины, мне кажется, они уже достигли того предела, при котором риторика начинает заслонять собой реальность. Поэтому-то я и хочу, чтобы вы начали с простой программы, которая даст вам чувство владения интригующими возможностя- ми среды Windows. Разумеется, в предыдущем примере не делается ничего особо полезного, но если вы хотите увидеть программу, которая не только проста в использовании, но также ценна в практическом отношении, то вам, возможно, понравится следующая конфетка, которая запускает досовский командный файл в минимизированном окне. После того как он начнет выполняться в фоновом режиме, вы можете продолжить работу с другими задачами (например, написать программу или просто подолбить на текстовом процес- соре). Когда командный файл закончится, соответствующая ему пиктограмма исчезнет с экрана (см. рис. 1.2). Замечание. Прежде чем запустить следующую программу, удостоверьтесь, что на вашем жестком диске существует командный файл с именем UPDATE.BAT, который может выполнять несколь- ко заданий, таких, например, как копирование сотен файлов с жесткого диска на пару дискет. Впрочем, нет необходимости создавать что-нибудь столь изощренное. Достаточно, к примеру, следующего текста.
1 X,2'. XX .у. .£--. J.. . L. ..* л к.-у^.1?:г.. Fein 1еж Рис. 1.2. Работа с программой, пока командный файл выполняется а фоновом режиме (Обратите внимание на пиктограмму в нижнем левом углу экрана.) rem Back up system Illes c: cd\ if exist c:\bak\coafig.sys goto copy md bak :copy copy c:\config.sys bak copy c:autoexec.bat bak copy c:\windows\win.ini bak copy c:\window3\systcrr.ini bak exit Чтобы создать командный файл, наберите предыдущий текст с помощью программы Notepad и сохраните его под именем C:\DOS\UPDATE.BAT. Назначение данного командного файла — просто гарантировать, что важные системные файлы продублиро- ваны. Нет необходимости говорить, что на некоторых системах вам, вероятно, придется сделать небольшие изменения в этом тексте. Но сечи ваша копия Microsoft Windows установлена на диске С: в каталоге Windows, можно запустить командный файл в неизменном виде. Как только у вас будет правильный командный файл, необходимо убедиться, что файл DOSPRMT.PIF, помещенный по умолчанию в каталог Windows, модифицирован так, как показано на рис. 1.1. Впрочем, прежде чем начинать суетиться с PlF-файлом, почему бы вам не набрать текст программы, показанную в листинге 1.2? Замечание. PIF — это аббревиатура до: информационного файла программы, содержащего информацию, которую Windows использует для запуска приложений DOS В частности, PIFu позволяют определить, сколько памяти должно быть доступно для конкретного задания, как много процессорного времени должно быть распределено для него и какую конфигурацию должно иметь его окно Эти свойства детально обсуждаются ниже. В листинге 1.2 показана более существенная Windows-программа.
Листинг 1.2. Немного более значительная Windows-программа 1: // SHORTBAT.СРР 2: #include <windows.h> 3: int CALLBACK WinMain(HINSTANCE hinst, 4: HINSTANCE hPrevInstance, 5: LPSTR IpszCmdParam, int nCmdShow) 6: < 7: 8: WinExec("Dosprmpt.pif /С c:\\dosWupdate.bat", 9: SW_SHOWMINIMIZED) ; 10: return TRUE; 11: ) Результат работы программы, приведенной в листинге 1.2, показан на рис. 1.3. Рис. 1.3. Так должен выглядеть файл DOSPRMT.PIF, до того как вы запустите SHOR.TBAT.CPP. Заметьте, что здесь выбран фоновый режим. Как уже было отмечено, PIF-файлы являются частью предыдущей программы, которая выполняет только одно задание: вызывает функцию Windows с именем WinExec. Winexec достаточно гибка, чтобы запустить вторую программу, которая уже может быть как Windows’oBCKoft, так и ВОЗ’овской. SHORTBAT.CPP указывает имя программы, которая должна быть запущена и которая в данном случае есть не что иное, как PIF-файл, запускающий СОМ- MAND.COM. Параметры, передаваемые в COMMAND.COM, — /С, за которым следует имя и маршрут командного файла, подлежащего выполнению. Синтаксическая единица /С не важна для Windows, но это соглашение, требуемое командным процессором DOS. PIF-файлы являются частью стандартной среды Windows. Они используются для определения требований к окну DOS, которое будет запущено в Windows. Окна DOS открываются каждый раз, когда DOS-программа запускается из Windows. Файл DOSPRMPT.PIF сопровождает каждую копию Windows и используется по умолчанию, как только вы щелкните мышью на пиктограмме MSDOS в диспетчере программ. Если вы используете заменитель менеджера программ, например, Norton Desktop for Windows, действуют те же самые принципы. Ребята вроде меня, которые пользуются 4DOS, могут заменить DOSPRMPT.PIF на 4DOS.PIF. При использовании 4DOS синтаксическую единицу /С следует опустить. Хотя эта книга не является руководством по среде Windows, должен сказать, что самая важная часть файла PIF — это то место, где указываются требования к памяти. Помещение -1 в окне КВ Required или КВ Desired говорит Windows, что необходимо дать ОО8’овской программе столько памяти, сколько она затребует или сколько доступ- но соответственно. Ну, ладно. Надеюсь, что две предыдущие программы уже начали вашу карьеру программиста на Си++ под Windows. Я уверен, что, подключив минимум воображения, вы сможете увидеть, как можно изменить обе эти программы так, чтобы они смогли
выполнять любое из полезных заданий. (Заметьте, что ничто не мешает вам вызывать WinExec много раз внутри одной программы!) Если вам удастся соорудить что-нибудь действительно полезное, присвойте своей протрамме осмысленное имя и присоедините ее пиктограмму к одной из ваших программных групп. Что касается меня, то ничто не приносит мне большего удовлетворения, чем создание своих собственных программ. В следующих двух коротких разделах дается обзор некоторых более специальных аспектов двух предыдущих программ. Впрочем, весь материал этой главы предназначен лишь для того, чтобы дать короткий обзор тем, с которыми вы далее встретитесь на более глубоком уровне. Что такое WINDOWS.H? Здесь не место погружаться в обсуждение слишком многих технических деталей. Однако вам было бы полезно узнать кое-что об общей структуре программ, приведенных выше. Программы SHORT.CPP и SHORTBAT.CPP начинаются с включения заголовочного файла WINDOWS.H: #include <windows.h> Каждая Windows-программа содержит этот файл, поскольку он определяет очень широкий набор констант, структур, макросов и функций, которые составляют скелет всех Windows-программ. Как SHORT.CPP, так и SHORTBAT.CPP начинаются с вклю- чения файла WINDOWS.H. Все программы, содержащиеся в этой книге, используют WINDOWS.H. Эта книга, подобно большинству других книг по программированию под Windows, есть не что иное, как комментарий к этому важнейшему документу. Найдите WINDOWS.H в вашей системе. Если у вас Visual C++, то файл WINDOWS.H по умолчанию размещен в каталоге \msvc\include. Если же вы работаете с Borland C++, то этот файл по умолчанию находится в каталоге \borlandc\include. Не начинайте читать следующую главу, пока вы не обнаружите копию WINDOWS.H Что такое WinMain? Обычные программы на Си/Си++ для DOS или UNIX используют функцию main() в качестве входа в программу, а Windows-программы используют для этого WinMain. У этих двух программ довольно много общего. А именно то, что они обе служат в качестве первой функции, вызываемой из конкретной программы. Функция WinMain WINDOWS.H предусматривает следующее объявление: int PASCAL WinMain (HINSTANCE, HINSTANCE, LPSTR, int) ; Эта строчка показывает правильное объявление входа в программу. Функция WinMain имеет четыре параметра. Первый параметр представляет собой уникальное число, или дескриптор, ассоциируемый с текущей программой. Пока вы можете считать HIN- STANCE целым типом, хотя позже вы увидите, что с этим предметом не все так просто, как может показаться на первый взгляд. Второй параметр — уникальный Дескриптор, ассоциированный с другим экземпляром этого приложения, если таковой имеется. Например, если вы стартуете две копии CLOCK.EXE, то вторая из них получает в качестве этого параметра дескриптор первой программы. Если Другой копии приложения нет, то этот параметр принимает значение NULL. Третий параметр представляет собой символьную строку, содержащую любые параметры, передаваемые программе. Тип LPSTR, по терминологии Windows, обозначает длинный указатель на символьную строку. Как вы увидите в следующей главе, это просто претенциозное имя для типа char * far. Четвертый параметр показывает, в каком окне должна появиться программа: в нормальном, максимизированном или в минимизированном. Подробный пример того, как это делается, рассмат- ривается в следующей главе.
WinMain возвращает целое значение, которое Windows никогда в действительности не прове- ряет. Другими словами, ваше приложение оканчивается, как только завершается WinMain. Возвра- щаемые значения предназначаются прежде всего для того, чтобы оказывать помощь при отладке или чтобы сделать вашу программу более читабельной. Следовательно, фактически не важно, выдает ли WinMain значение TRUE или FALSE. Мне нравится выдавать FALSE при возникновении ошибки просто потому, что это помогает сделать программу понятнее для чтения. Пример: int CALLBACK WinMain (HINSTANCE hinst, HINSTANCE hfrevlnstance, LPSTR IpszCmdParam, int nCmdShow) Ну, ладно. Пока хватит и этого. Я уверен, что вы хотите узнать побольше о технических деталях, составляющих программы SHORT.CPP и SHORTBAT.CPP, но лучше отложу их обсуждение до следующей главы. А пока что не хотите ли просто поиграться с компилятором и средой Windows? Практический опыт очень важен. Так или иначе, в этой книге у нас еще будет время для подробных обсуждений. Остаток этой главы содержит несколько слов о разновидностях компиляторов и аппаратуре, которые потребуются для создания Windows-программ на языке Си++. Кроме того, я упомяну о некоторых стилистических принципах и дам общий обзор среды Windows с теоретической точки зрения. Эта глава завершается коротким обзором тем, освещенных в оставшейся части книги. Графический интерфейс пользователя Windows имеет графический интерфейс пользователя (GUI). В английском языке эта аббревиатура произносится [’gu:i:], как слово gooey (липкий) в известной надписи “gooey mass of cotton-candy flavored bubble gum” (липкая масса ароматизированной пузырящейся жевательной резинки). Вам, как представителю быстро меняющегося мира компьютерных высоких техно- логий, несомненно, доводилось слышать, что Windows работает медленно. Так вот, причина такой репутации не в том, что это мультизадачная система защищенного режима. Все дело в графическом интерфейсе. Графические интерфейсы создавались прежде всего для того, чтобы облегчить жизнь пользователям приложений. Не знаю, выполнили они эту задачу или нет, но, во всяком случае, программистам они жизнь не облегчили, это уж точно. В частности, графические интерфейсы позволяют пользователям мыслить цветами, пиктограммами и графиками. Сама идея множества изменяемых окон не принадлежит всецело создателям графических интерфейсов. Фактически многие приложения тексто- вого режима DOS блестяще использовали все эти средства и раньше. Солью графических интерфейсов являются такие их особенности, как, например, объемные полосы прокрут- ки и инструментальные меню, полные загадочных разноцветных пиктограмм. Это не просто мишура, предназначенная для придания Windows большей значительности. Графические интерфейсы были созданы для того, чтобы сделать приложения более легкими в использовании, более функциональными и более доступными. Люди, которые находятся в центре компьютерного мира, могут легко забыть, насколько ошарашивающими могут оказаться эти машины для начинающих. Среднему человеку, даже очень умному, необходимо предоставить максимум подсказок, когда он садится за компьютер. Это не просто второстепенное дело и не украшение, предназна- ченная для того, чтобы повеселиться над слабыми в коленках технофобами. Напротив, сама идея превращения компьютера в средство, дружественное пользователю, стала насущной потребностью, наукой, а может быть, искусством, которое изучается лучшими головами мира. Какой вам нужен компьютер? Графический интерфейс, висящий над Windows, подобно огромному куполу, явля- ется существенной особенностью, с которой каждому читателю этой книги рано или
поздно придется познакомиться поближе. Особенно необходимо понять, что графичес- кие интерфейсы присутствуют постоянно и занимают огромную долю системных ресур- сов. Вам от них никак не увернуться. Сама идея работы на компьютере изменилась из-за графических интерфейсов, а также из-за нынешнего устремления к 32-битным опера- ционным системам. В результате придется серьезно подумать о компьютере, который вам понадобится для программирования в среде Windows. Было время, когда 286-ая машина с парой мегабайт памяти считалась мощной. Эти дни миновали. Если вы хотите программировать в Windows, то должны приобрести самую быструю машину, какую только сможете найти. Однако это не означает, что вам следует бросаться в магазин в попытке усовершен- ствовать свой теперешний компьютер. Попытки собрать современный компьютер по кусочкам редко оказываются успешными, особенно, если вам предстоит работать на нем в течение длительного времени. Необходим компьютер, обладающий достаточно серьез- ным запасом “лошадиных сил” и состоящий из частей, которые хорошо работают вместе. Позвольте мне сделать отступление, чтобы подчеркнуть этот момент. В своей работе, мне приходится общаться с людьми, у которых возникают неприятности при использо- вании некоторых очень надежных средств программирования на их машинах. После того как туман рассеивается, наши дискуссии с этими людьми обычно фокусируются на одной из двух возможных проблем. Первая, и самая распространенная, заключается в том, что люди сварганили себе компьютер из всякой всячины, часть которой имеет возраст 4-5 лет. Другая представляет противоположную крайность — людей, которые устанавливают на средний компьютер какую-либо сверхмощную деталь, представляющую собой перед- ний край развития технологии. Приемлемая машина для программирования под Windows — это надежная 386-ая или 486-ая, по меньшей мере, с четырьмя мегабайтами памяти, монитором VGA или SVGA и, как минимум, со стомегабайтным жестким диском. Удобная конфигурация, с которой у вас не будет проблем, — это 486DX с восемью мегабайтами памяти и 200-300 мегабайтным жестким диском. Все, что меньше 386 33 МГц с 4М памяти может быть слишком серьезной угрозой для вашей психики, хотя терпеливый, вероятно, как-то управится и с 386SX. (Не думаю, чтобы мне понравилось работать на слишком близком расстоянии от такого типа.) На рис. 1.4 с помощью поставляемой с Windows программы MSD.EXE показано, какими возможностями должна обладать типичная машина для Windows. Рис. 1.4. Программа MSD.EXE показывает, какими свойствами должна обладать типичная поддерживающая Windows машина. Данные ориентировочно лета 1993. Заметьте, что я ни словом не обмолвился о том, какую машину считаю идеальной. Потому что любая машина, какую бы я не использовал в последние 4-5 лет, была немного
медленнее, чем мне хотелось. В прежние времена я был вполне удовлетворен своей XT. Но с тех пор как я положил руки на клавиатуру своей первой 286-ой, меня не оставляла невыразимая тоска по все более и более быстрой и мощной машине! С появлением Windows этот аппетит возрос раз в 10. Есть в Windows что-то такое, что заставляет меня мечтать о “пентиумах”, “септиумах” и т.д... Во всяком случае я совершенно серьезно рекомендую вам приобрести самую мощную машину, какую только сможете себе позволить. Вы не переборщите даже в том случае, если решите купить 486 50 МГц с 8-16 мегабайт памяти. Те, кто действительно понимает, что значит программировать под Windows, никогда не скажут, что такая машина — это чересчур. Компилятор Выбор компилятора так же важен, как и выбор машины. Могу гарантировать, что все программы, приведенные в этой книге, пойдут на компиляторах Microsoft Visual C++ и Borland C++ 3.1. В большинстве случаев единственное отличие в предназначенных для работы на этих компиляторах программах заключается в МАКЕ-файлах, но даже эти отличия минимальны. Любое из этих программных средств вполне адекватно тем заданиям, для выполнения которых они разработаны. В действительности на рынке есть и ряд других блестящих компиляторов. Однако у меня не было времени проверить свои программы на каждом из них. В результате использование этих программ на любом другом компиляторе может оказаться проблематичным. Хочу еще раз подчеркнуть, что не “раскручиваю” какой-то конкретный компилятор, а просто хочу написать хорошую научно-техническую книгу, которую вы нашли бы полезной. Я интересуюсь программированием, а не рекламой. Впрочем, я предпринял все возможное для того, чтобы сделать приведенные в этой книге программы более современными. Это означает, что лучше всего приобрести Borland C++ версии 3.1 или Microsoft Visual C++ версии 1, т.е. компиляторы, которые я использовал при написании своих программ. В частности, в этой книге довольно широко используются как свойства Windows 3.1. так и очень важный файл WIN- DOWSX.H. Этот файл служит для расширения и дополнения WINDOWS.H, а также для того, чтобы сделать вашу программу достаточно совместимой с новыми 32-битными операционными средами. Поэтому прежде чем двинуться дальше, убедитесь в том, что у вас есть копии WINDOWSX.H и Windows 3.1 Мне неприятно акцентировать внимание на необходимости приобретения мощного оборудования и современных компиляторов. Вообще-то говоря, я совсем не “сдвинут” на всех новомодных устремлениях. Однако Windows действительно находится на перед- нем крае существующей компьютерной технологии, так что вы должны быть готовы вложить достаточно средств, прежде чем сможете сесть за эту непростую игру. Стили программирования и другие мелочи Большинство из программ, разработанных для этой книги, написаны с использова- нием Borland C++ for Windows. Когда я создавал эти программы, то сначала разрабатывал проектные файлы и только потом превращал их в МАКЕ-файлы. Я поступал так потому, что считаю, что МАКЕ-файлы предусматривают удобный формат, который позволяет мне поделиться с вами своим программистским опытом. Впрочем, если вы захотите получить доступ к моим проектным файлам, то знайте, что я распространил исходные тексты через широкую сеть BBS, а для этой книги дополнительно продается соответст- вующая дискета. Замечание. Программы для этой книги можно получить в информационной службе CompuServe. Когда вы вводите GO SAMS, вы входите в форум компьютерного издательства Prentice Hall. Оказавшись там, войдите в библиотеку файлов и отыщите в библиотеке 7(Sams-ProgLang+DataB) ключевое слово CALVERT.
Все программы в этой книге написаны в соответствии со стандартами Си++. Это не обязательно означает, что программа не пойдет на стандартном компиляторе языка Си, а только то, что эти программы используют все преимущества строгой проверки типа, которыми обладает язык Си++. На всех этапах разработки программ я широко использовал отладчики вроде CodeView и Turbo Debugger for Windows (хотя существуют и другие мощные средства). Нет слов, насколько жизненно важным может быть отладчик для любого успешного процесса программирования. Поскольку эта книжка должна быть полезной для вас независимо от того, каким отладчиком вы пользуетесь, я не буду заострять внимание на технике, связанной с использованием конкретного отладочного средства. Однако я абсолютно уверен, что научиться пользоваться отладчиком, сопровождающим ваш компилятор, есть дело первостепенной важности и что вы обопретесь на его дружеское плечо по возможности более крепко. Научитесь пользоваться его услугами, или вы сгинете в пустыне потерянных сообщений, непроинициализированных указателей и ошарашивающих General Protection Fault (общая ошибка зашиты)! Что такое Windows? Сидя сейчас за своим столом и глядя на заголовок этого раздела, я понимаю, что снова поверг себя в тревогу, из которой нет исхода. А ведь я всего лишь написал три общеизвестных слова, с помощью которых произносится довольно простой вопрос: “Что такое Windows?” Этот вопрос легко задать, но если бы и ответ на него был хотя бы наполовину также прост. На самом деле произнести этот вопрос — все равно что открыть ящик Пандоры. В былые дни программисты могли точно так же спросить: “Что такое DOS?” В то бесхитростное время ответ был намного легче: DOS — это операционная система. Это не верно в отношении Windows. Например, 16-битная версия Windows выпол- няется над DOS, в некоторой степени завися от нее и давая возможность доступа к обслуживаниям DOS. Так может быть, на наш вопрос следует ответить отрицательно, утверждая, что Windows не является операционной системой? Единственная проблема с этим утверждением заключается в том, что Windows NT является операционной системой. Кроме того, многие считают, что DOS — не настоящая операционная система, поскольку она не предусматривает реальной поддержки много- задачности или какой-нибудь защиты от ошибок плохо себя ведущих программ. Windows NT же предусматривает все это и многое другое. В самом деле, если вы интересуетесь всякими “наворотами”, то, наверное, знаете, что Windows for Workgroops уже соединяет вместе довольно большое число компьютеров так, что можно, работая на одной машине, сообщаться с другой и получать доступ к файлам или программам на третьей, как если бы они были расположены на вашем жестком диске. Надеюсь, теперь вам ясно, почему я употребил метафору с ящиком Пандоры. Я начал этот раздел простым вопросом: “Что такое Windows?” И стоило лишь сунуть нос чуть дальше, как уже через несколько секунд этот вопрос обернулся целым рядом других, притом гораздо более сложных. Мне необходимо ответить на эти вопросы или, по крайней мере, сделать их понятными каждому, кто надеется стать настоящим Windows- программистом. Я хочу, чтобы у вас не было заблуждения относительно моих намерений. Моя цель — сделать вас с помощью этой книги настоящими Windows-программистами. Если вы надеетесь найти здесь чудодейственное средство — своего рода доселе неизвестную волшебную палочку, которая за одну ночь превратит вас в блестящего профессионала, — вы попали не по адресу. Моя задача — снабдить вас дружественным, нескучным руководством по “внутренностям” среды программирования Windows. Руководствуясь этими соображениями, я не собираюсь бросаться вперед, предлагая вам упрощенное и предельно поверхностное определение Windows. Вместо этого я намереваюсь на следующих нескольких страницах обсудить данный предмет с различных точек зрения. К концу этой главы вам станут ясны основные положения, касающиеся Windows, и вы будете иметь фундаментальное понимание этой системы.
Интерфейс прикладного программирования В последнем разделе я бился над тем парадоксальным фактом, что Windows одновре- менно является и не является операционной системой. Этот противный гордиев узел гораздо быстрее уступил бы мечу, если бы вы понимали, что Windows NT (операционная система) и Windows 3.1 (операционная среда) связаны между собой общим интерфейсом прикладного программирования (API). API представляет собой набор программ, использующихся для управления как компьютером в целом, так и отдельными его частями (например, модемом, видеокартой или мышью). Предположим, что у вас есть набор из трех программ, предоставляющих интерфейс с мышью. Назовем их InitializeMouse, SetMousePosition и GetMousePosition. Эти три подпрограммы можно назвать простейшим интерфейсом (API) между вашей программой и мышью. Они позволят вам запустить мышь, установить ее в конкретное положение и получить информацию о ее текущей позиции. Этих простейших возмож- ностей достаточно, чтобы сформировать интерфейс между вашей прикладной програм- мой и частью машины. Windows API есть не что иное, как просто набор программ, формирующих интерфейс между вашим приложением и компьютером в целом. Например, интерфейс прикладного программирования Windows позволяет задавать текущую позицию курсора мыши и получать ее координаты. Но это еще не все. Он также дает возможность создавать на экране окна, двигать и изменять их, управлять модемами, файлами, каталогами и памятью, а также многое другое. Фактически Windows — это всего лишь интерфейс прикладного программирования, но невероятно мощный. Теперь вам должно быть ясно, что Windows 3.1 и Windows NT связаны между собой, поскольку имеют общий API. Например, многие программы Windows 3.1 используют функцию MoveWindow. Естественно предположить, что эта функция может вызвать перемещение окна с одного места на другое. Следовательно, не будет сюрпризом, если вы узнаете, что такая же функция имеется в Windows NT и работает точно так же, как и соответствующая функция Windows 3.1. Разумеется, Windows 3.1 и Windows NT — не совсем одно и то же. В действительности они имеют ряд значительных отличий. Я вполне уверен, что многие программисты хотели бы научиться работать в обеих этих средах, поэтому в этой книге я использую код, который работает как в Windows 3.1, так и в Windows NT, или легко переносится из одной системы в другую. Например, я часто пользуюсь специальным файлом WINDOWSX.H, который предусматривает общий интерфейс между 16-битными про- граммами Windows 3.1 и 32-битными программами Win32 (32-битной системы). Как только вы овладеете WINDOWSX. Н, то сразу научитесь писать программы, которые без изменений идут как в Windows 3.1, так и в Windows NT. В чем суть 32-битного кода? Одна из моих задач заключается в том, чтобы избежать употребления излишне технического языка. Я не хочу написать книгу, над которой витает дух совершенного владения тайным техническим знанием и которая оставляет вас под впечатлением человека посвященного, но ничуть не поумневшего. Напротив, я стараюсь сообщить вам свои знания о Windows наиболее простым из возможных способов. Если вы хотите принять эти знания и создать с их помощью кое-что довольно сложное, то поверьте, что программирование под Windows на Си++ предоста- вит вам неисчерпаемые возможности! Я стремлюсь не водить вас по закоулкам непостижимых сложностей, а найти такие важнейшие темы, которые красной нитью проходят по всему программированию для Windows. Я хочу, чтобы вы имели очень твердое владение основами, так как знаю, что тогда вы сможете добраться до любой области, охватываемой API, пусть даже очень удаленной. Поэтому вам важно сразу овладеть понятиями, касающимися таких вещей, как 8-битные, 16-битные и 32-битные операционные системы, а также знать об ограничениях
в 64К, 640К и 4 гигабайта (гигабайт — это миллиард байт). Нравится нам или нет, но эти довольно специфические предметы составляют суть работы под Windows. Вполне возможно, что такой вещи, как Windows, и вовсе не было бы, не существуй на свете предел в 640К. Начнем с начала — с разговора о битах. Как вы, наверное, знаете, в компьютере все сводится к переключательным схемам. Переключатели представляются последователь- ностями нулей и единиц, которые называются двоичными числами. Например, числа нуль и один могут быть представлены однозначными двоичными числами. Вот число нуль в двоичном представлении: о А вот двоичное представление числа один: 1 Выглядит не слишком впечатляюще, не так ли? Когда вы видите эти крошечные числа, одиноко стоящие на сцене, вам и в голову не придет, что они могут совершить что-либо значительное. Но подождите. Вот число два в двоичном представлении: 10 А вот число три: 11 А вот, специально д ля вашего удовольствия, число 255: шиш И наконец, число 65535 (также известное под именем 64К): 1111111111111111 Это последнее число определяло предел вычислений на PC в последние 5-7 лет. Причина его важности заключается в том, что это самое большое число, которое можно представить с помощью 16-и двоичных цифр, т.е. 16-ю битами. Если вы попытаетесь продвинуться на единицу дальше, то есть представить число 65536, то получите следующее: 10000000000000000 Это число представляется с помощью 17 бит информации. К сожалению, славный процессор 80286 фирмы Intel может оперировать одновременно лишь 16-ю битами информации. И это как раз то, что имело место в жизни: 16-битовый процессор ограничивал производительность компьютеров на протяжении столь многих лет. Конечно, существует возможность работать с числами, гораздо большими чем 65536, даже на 286-ом компьютере. Проблема заключается в том, что вам приходится загружать сопроцессор несколькими различными порциями информации, прежде чем вы сможете досчитать до такого большого числа. Это нормально, когда вы занимаетесь математикой, но совсем не здорово, когда компьютер адресует память. В результате структуры данных на 8086-ых и 286-ых компьютерах вообще не могли превышать 64К, по крайней мере, без привлечения всяческих хитрых закулисных манипуляций. Каждый, кто прежде уже пользовался массивами, почти наверняка, до боли знаком с этой проблемой! Барьер 64К — не единственное ограничение, с которым все это время приходилось бороться пользователям DOS. Другой проблемой было ограничение в 640К, представля- ющего собой пространство, в пределах которого могут выполняться DOS и все програм- мы этого семейства. Сегодня довольно легко критиковать создателей DOS за то, что они ограничили свою операционную систему таким относительно небольшим пространством памяти, а не воспользовались преимуществом одного мегабайта памяти, доступного им. В конце концов DOS была операционной системой, которая изменила лицо компьютерного мира и принесла чудеса века цифровой информации почти на сто миллионов письменных столов. Учитывая столь успешный послужной список DOS, для любого из нас заявить вдруг, что это было ошибкой, было бы слишком.
Проблема заключается не столько в том, что DOS была ошибкой, сколько в том, что сейчас программисты используют компьютер для выполнения таких задач, о которых разработчики архитектуры памяти PC не имели представления. Сейчас на наших рабочих столах стоят 386-е, 486-е, “пентиумы” и разные там RISC-процессоры. 286-й компьютер может обращаться за один раз лишь к 64К, в то время как 386-й является 32-битным и может обращаться сразу к 4 гигабайтам памяти. Ниже одно за другим выписаны 16 бит и 32 бит: 16 бит: 1111111111111111 32 бит: 11111111111111111111111111111111 А вот десятичные числа, которые могут быть представлены в памяти с помощью такого количества бит информации: 16 бит; 64 536 32 бит: 4 294 967 296 Четыре миллиарда двести девяносто четыре миллиона девятьсот шестьдесят семь тысяч двести девяносто шесть. Это число просто не умещается у меня в голове. Я о нем знаю лишь то, что оно действительно очень и очень большое. Разумеется, оно достаточно велико для того, чтобы хорошо знакомое нам прежнее ограничение 16-битных машин показалось просто ничтожным. Что такое 64К в сравне- нии с 4 гигабайтами? Ничто. Такое сравнение просто неуместно. Владельцам 386 или еще лучшей модели просто смешно сидеть в рамках ограничений, налагаемых DOS. Как только вы осознаете этот глубокий момент, вам станет очевидно, что DOS обречена. Компьютерный мир непреклонно движется к 32-битному вычислению, и операционные среды, подобные Windows и OS/2, поставят нас перед великой дилеммой. Вот что вы должны понять. Это одна из основных подспудных тем этой книги. Мы изучаем способ программирования, который устремлен в будущее. Windows покрывает пропасть между 16 и 32-битным вычислением и, следовательно, это наиболее вероятный путь в будущее. Вот почему кое-кто поторопил меня выпустить эту книгу. Вот почему вы сидите над ней, готовые проделать работу, необходимую для овладения программи- рованием в Windows. Причина заключается просто в том, что Windows и ее близкая родственница OS/2 прокладывают дорогу в завтрашний день. Подобно тому как 16-битное вычисление привело ж 32-битному, последнее, в свою очередь, неизбежно ведет к 64-битному и даже 128-битному. Другими словами, в последующие пять, десять, двадцать пять лет в компьютерном мире произойдет ряд значительных изменений. Компьютеры, на которых мы будем работать через десять лет, превратят 486-ые и “пентиумы” в детские игрушки. Без некоторого понимания этих фактов вы никогда не поймете по-настоящему, зачем нужна Windows и почему она выглядит таким образом. С неба на землю После этого экскурса в будущее, трудно возвращаться назад к реальности. Но теперь я хочу сконцентрироваться на Windows 3.1 — основной операционной среде, использо- вавшейся для разработки программ, приведенных в этой книге. Win31 не является 32-битной системой. Это 16-битная среда, которая работает в защищенном режиме. Прежде чем начать заниматься защищенным режимом, хочу напомнить, что большинство программ, приведенных в этой книге, компилируются без изменений и в 16-битной Win31, и 32-битной Windows NT. Таким образом, мы пусть даже и с трудом разместились на пороге будущего. Однако прошлое в виде 16-битного программирования в защищенном режиме все еще цепляется за наши фалды, пытаясь удержать нас в себе. Два главных свойства 16-битного защищенного режима отличают его от стандартного программирования в DOS. В DOS каждый адрес состоит из двух 16-битных чисел — сегмента и смещения, которые соединяются операционной системой в форме 20-битного числа. Однако в защищенном режиме часть адреса, соответствующая сегменту, пред-
ставляет собой всего лишь индекс в таблице, содержащей 24-битные числа. Этот индекс называется селектором. Замечание. Чтобы превратить два 16-битных числа в 20-битное, используйте следующую форму- лу: 20-битовый адрес = (сегмент * 16) + смещение; Умножение на шестнадцать равносильно смещению на 4 бита влево. Нет необходимости прямо сейчас погружаться в детали работы этой схемы адресации. Лучше сконцентрируйтесь на том факте, что защищенный режим позволяет програм- мистам использовать 24-битовые числа, в то время как прежде они могли пользоваться только 16-битовыми. В результате даже самая простая 16-битовая программа может обращаться ко всем 16-и мегабайтам памяти. Другими словами, защищенный режим позволяет вашим программам использовать в 16 раз больше памяти, чем доступно приложениям DOS. Это не означает, что прежнее ограничение в 64К исчезло. Оно все еще является частью среды программирования Windows. Однако теперь вы можете комбинировать селектор и смещение так, чтобы вырваться за пределы ограничения в 640К программ реального режима DOS. Замечание. Программы реального режима называются так потому, что схема их адресации включает действительные, или “реальные”, адреса памяти. Программы защищенного режима, напротив, используют селектор вместо “реального” адреса. Кроме возможности обращения к большей части памяти, программы защищенного режима также позволяют вам использовать примитивную форму многозадачности. Ключом к этому процессу являются селекторы. Именно в тот момент, когда в игру вступают селекторы, вы и начинаете понимать значение защищенного режима. Как я уже говорил, селекторы представляют собой лишь индексы в таблице, где хранятся реальные адреса. Реализуя эту схему, операционная система может управлять использованием каждого адреса так, что защищает пользова- теля от неаккуратных или плохо написанных программ, которые пытаются записывать что-либо за пределами отведенной им памяти. Другими словами, программы защищен- ного режима не могут повредить системе, записав что-нибудь в чужую область памяти. Им запрещено это делать самой системой, которая контролирует каждый адрес в таблице дескрипторов. В то же время такая эффективная операционная среда, как Windows, может с помощью этой таблицы манипулировать памятью так, что различные программы разде- ляют соседние области, не вытесняя друг друга. Для конкретного программиста, разра- батывающего приложения, эта задача была бы слишком сложной. Поскольку программы защищенного режима используют селекторы вместо реальных адресов, фактическая реализация мультизадач ности достается операционной системе. Сейчас не время описывать этот процесс слишком детально. Вам следует усвоить только два ключевых момента. Во-первых, 16-битные прикладные программы защищен- ного режима могут обращаться не к 640К, а к 16-и мегабайтам памяти. Во-вторых, в программах защищенного режима можно использовать многозадачность, поскольку память адресуется через специальную таблицу, которой может манипулировать опера- ционная система. К настоящему времени мы рассмотрели различия между 16-битными и 32-битными программами, а также разницу между программами реального и защищенного режимов. Но на самом деле вам не обязательно знать все эти вещи, для того чтобы писать программы под Windows. Я обсуждаю с вами эти вопросы только для осознания того, что же такое вы на самом деле делаете, когда пишете программы для Windows. Если я просто покажу вам набор правил, которые необходимо запомнить, то, вероятно, смогу помочь вам стать лишь
посредственными Windows-программистами со скромными возможностями. Но если вы изучите широкие аспекты теории, лежащей в основе Windows, то справитесь с любым вызовом. Вы будете иметь не только знание, но и понимание. Взгляд вперед Первая треть этой книги должна служить введением в программирование под Windows. Она знакомит вас с основами, не погружаясь слишком глубоко в детали. Вторая часть включает глубокое обсуждение некоторых важных технических вопро- сов, таких, как полномерная Windows-программа и игра. Когда вы закончите читать вторую треть книги, то уже будете иметь ясные представления о том, как надо писать Windows-программы, адресованные широкому кругу пользователей. Последняя треть этой книги освещает более сложные предметы — программирование мультимедиа, OLE и печать. Резюме В этой главе вы прочитали короткое введение и выполнили две простые Windows- программы. Поскольку предварительного знакомства не было, вы имели шанс обратить- ся назад, чтобы бросить взгляд на Windows с теоретической точки зрения. Вы узнали, что такое Windows, почему она так важна и заглянули в ее будущее. Вы также узнали о том, какое оборудование необходимо, чтобы преуспеть в выпол- нении ваших целей. В частности, вы уже знаете, что программирование под Windows требует мощных аппаратных и программных средств. Теперь, когда фундамент положен, самое лучшее — это найти время, чтобы собраться. Загрузите компилятор, с которым вы хотите работать, и познакомьтесь с его основами. Просмотрите доступную документацию и войдите в курс дела. Поэкспериментируйте с редактором и отладчиком, которые планируете использовать. Найдите в руководстве те места, где объясняется, как пользоваться этими средствами. Для хорошего программиста отладчик так же важен, как и компилятор. Посвятите время тому, чтобы настроиться. Думаю, что программисты знают, как это делается. Лично для меня программирование — это не просто принудительная работа, работа и еще раз работа. Мне необходимо наслаждаться игрой с тем инструментарием, который я использую. Если все это хотя бы отдаленно не напоминает большую, очень сложную и очень тонко разработанную игру, то я знаю, что что-то здесь не так. Как правило, программисты работают очень и очень упорно. Это происходит только потому, что часть этой работы — развлечение. Так что найдите время, чтобы получить удоволь- ствие, ладно? Вопросы и ответы 1. Что такое вход в программу? Вход в программу — это место, где начинается программа. Когда вы щелкаете мышью на пиктограмме программы, Windows загружает эту программу в память, а потом вызывает ее функцию WinMain. Этот процесс аналогичен тому, что происходит в DOS при запуске программы. Разница заключается в том, что WinMain содержит больше параметров, чем main(). 2. Что такое WINDOWS.H? WINDOWS.H — это включаемый файл, в котором содержится множество наиболее важных констант, функций, структур и макросов, используемых Windows-программами, написанными на языках Си++ и Си. В некотором отношении, это единственное наиболее краткое доступное определение среды программирования Windows. Впрочем, для комментария оно слишком уж коротко, поэтому для того чтобы объяснить его на языке, легком для понимания, пишутся книги вроде этой.
3. Следует ли мне пытаться читать WINDOWS.H с начала до конца? Я счел бы такую попытку некоторой крайностью. Впрочем, многие из лучших Windows-программистов склонны к крайностям по природе. Разумеется, не вредно будет прочитать весь этот документ. Впрочем, не лучше ли начать с погружения в него на несколько минут, чтобы получить представление о том, что это такое. Даже если поначалу он покажется немного скучным, обещаю, что вам станет гораздо интереснее по мере того, как вы будете больше узнавать о среде Windows. 4. Смогу ли я использовать свой старенький 286-ой компьютер, чтобы программиро- вать под Windows? Среда программирования Borland позволяет вам компилировать приведенные в этой книге программы и на 286-ом компьютере. Однако я имею твердое убеждение, что такая машина просто неадекватна текущим задачам. Если вы думаете об усовершенствовании своего компьютера, вам, может быть, захочется воспользоваться этим предлогом для приобретения че/о-то действительно особенного. Если вы профессионал, а парни из отдела компьютеров спрашивают вас, какая машина вам нужна, скажите им, что вам требуется компьютер 486/66 МГц с 16-ю мегабайтами памяти и 500-мегабайтным жестким диском. Скажите им также, что это минимум. Вопросы для самопроверки 1. Что делает функция WinMain? 2. Назовите два отличия между Windows и DOS. 3. Что такое GUI? 4. Является ли Windows (которая выполняется над DOS) настоящей операционной системой? 5. Что такое PIF? 6. Как называется отладчик, сопровождающий ваш компилятор? 7. Могут ли две различные Windows-программы иметь один и тот же HINSTANCE? 8. Как называется вход в Windows-программу? 9. Каково значение второго параметра, передающегося в WinMain, если работает только одна копия программы? 10. Каково будет это значение, если выполняются две копии? Упражнения 1. Напишите программу, которая запускает с помощью WinExec две другие програм- мы? 2. Напишите программу, которая использует третий параметр WinMain, чтобы указать во время выполнения, какой из командных файлов вы хотели бы запустить. 3. Напишите командный файл, который выполняет командный файл DOS не в минимизированном, а в нормальном окне.
День 2 ПОСТРОЕНИЕ ПРОЕКТОВ, СОЗДАНИЕ ОКОН В этой главе вам представится случай выполнить еще несколько коротких программ и научиться строить проекты для Windows. В частности, мы рассмотрим следующие вопросы: И Как озвучить ваши программы, пользуясь расширениями мультимедиа или стандарт- ной функцией MessageBeep. Как добиться лучшей проверки типа, определяя STRICT. Как добавить в свою программу визуальный элемент посредством функции MessageBox. И Как использовать файл определения модуля. И Как использовать МАКЕ-файлы с программными проектами для Windows. Как использовать проектные файлы в Borland C++ и Visual C++. Как отобразить на экране традиционное окно, которое может изменять размер и превращаться в пиктограмму. Звук Windows-программы оживляют работу. Целью Windows является не просто показы- вать написанные данные строчка за строчкой, а представлять информацию в наглядном виде посредством использования картинок, графиков и звуков. В последних главах этой книги дан детальный обзор мультимедийных расширений Windows. Там вы увидите, как включать в программы голоса, музыку и другие звуковые возможности. Впрочем, если у вас есть Sound Blaster или другая звуковая карта или имеется доступ к файлу SPEAKER. DRV фирмы Microsoft, можно сразу начать пользоваться звуком мультимедиа. Достаточно лишь запустить короткую программу CHIMES.EXE. Она позволит пользоваться звуковой картой, файлом SPEAKER.DRV и проигрывать WAV- файлы (волновые файлы). Волновые файлы воспроизводят музыкальные инструменты, человеческие голоса и другие реальные звуки. Если ни одно из этих средств вам не доступно, не беспокойтесь, у меня есть другая простая программа, называемая BEEPER.EXE, которая заставит компьютер издавать короткие звуки (см. листинг 2.2). Отлично. Вот две программы, которые показывают, как озвучить компьютер. Первую версию этой программы следует использовать в том случае, если у вас есть SPEAKER. DRV или возможности мультимедиа. Вторая версия (листинг 2.2) идет на любой системе, имеющей встроенный динамик, что характерно почти для всех ПК. Если сможете, запустите обе программы, потому что вам следует знать процедуру MessageBeep.
Листинг 2.1. CHIMES.СРР позволяет воспользоваться новыми возможностями мультимедиа, предлагаемыми фирмой Microsoft. 1: //Program CHIMES.СРР 2: «define STRICT 3: «include «windows.h> 4: «include <mmsystem.h> 5: 6: int pascal WinMain(HINSTANCE hlnst, 7: HINSTANCE hPrevInstance, 8: LPSTR IpszCmdParam, int nCmdShow) 9: { 10: sndPlaySound("Chimes.Wav", SND_ASYNC); 11: return 0; 12: ) Как показано в листинге 2.1, программа Chimes проигрывает файл CHIMES.WAV. Это короткий музыкальный файл, который программа SETUP по умолчанию помещает в подкаталог Windows. Если хотите услышать другие звуки, песни или голоса, можете ввести имя другого WAV-файла. Эта программа вызывает единственную функцию sndPlaySound, которая является частью расширений мультимедиа для Windows. Ее назначение — проигрывать WAV- файл. Обратите внимание на директиву #define STRICT в строке 2. Чуть позже в этой главе вы узнаете о программах, использующих STRICT. В строке 4 первые две буквы в имени mmsystem.h означают multimedia. С тех пор как появилась Windows 3.1, файл MMSYS- ТЕМ. Н является стандартной частью среды программирования Windows. Он обсуждается на более глубоком уровне'далее в этой главе, а пока вам, наверное, следует открыть его в редакторе и бегло просмотреть. Функция sndPlaySound является частью мультимедийного расширения для Windows. Поэтому, чтобы ей пользоваться, вы должны включить в свою программу MMSYSTEM.H. sndPlaySound воспроизводит волновые файлы. Эти файлы обычно имеют расширение .WAV и содержат цифровую версию аналоговых звуков. В результате они могут содержать почти любые звуки — от голосов до музыки. Функция sndPlaySound sndPlaySound(filename, SND_FORMAT); Функция sndPlaySound — мультимедийная команда высокого уровня, предоставляющая простой способ проигрывания WAV-файлов. Первый параметр, filename, представляет собой имя WAV- файла, который вы хотите проиграть. Программа Chimes (листинг 2.1) воспроизводит CHIMES.WAV, помещаемый в вашей системе по умолчанию при установке Windows. Среди других файлов, которые вам, может быть, захочется попробовать, следует упомянуть CHORD.WAV и DING.WAV. Второй параметр, SND_FORMAT, содержит одну из следующих констант, которые передают Windows простые команды. SND_SYNC 0x0000 Играть синхронно (по умолчанию) SND_ASYNC 0x0001 Играть несинхронно SND_NODEFAULT 0x0002 Не использовать звук, предполагающийся по умолчанию SNDJMEMORY 0x0004 Первый параметр — файл памяти SND_LOOP 0x0008 Проигрывать звук в цикле до следующего обращения к sndPlaySound SND_NOSTOP 0x0010 Не прекращать проигрывать текущий звук Пример: sndPlaySound("Chord.Wav", SND_LOOP); sndPlaySound("Ding.Wav", SND_SYNC);
Листинг 2.2. Программа BEEPER. СРР выдает звук на любой ПК 1: // Program BEEPER.СРР 2: «define STRICT 3: #include <windows.h> 4: 5: int pascal WinMain(HINSTANCE hlnst, 6: HINSTANCE hPrevInstance, 7: LPSTR IpszCmdParam, int nCmdShow) 8: ( 9: MessageBeep(-1) 10: return 0; ) 11: ) Файл BEEPER.CPP выдает короткий звук с помощью встроенного в вашу систему динамика. Эта программа использует функцию MessageBeep, чтобы произвести “би-и-и-п” или другой звук, в зависимости от того, как настроена ваша система. Если звук мультимедиа вам не доступен, следует передать в функцию MessageBeep значение -1. Функция MessageBeep MessageBeep(0); Функция MessageBeep — это один из простейших вызовов во всем Windows API. Она содержит единственный параметр, который обычно полагается равным -1. По умолчанию функция MessageBeep выдает простой звук автомобильного гудка (“би-и-и-п”), очень похожий на тот, что вы так часто слышите, работая в DOS. Системы, обладающие возмож- ностями мультимедиа или оснащенные средством SPEAKER.DRV, позволяют ассоциировать другие звуки с функцией MessageBeep. Чтобы добиться этого, просто передайте MessageBeep одну из следующих констант: MBICONASTERISK MB_ICONEXCLAMATION MB_ICONHAND MBICONQUESTION МВОК Можно изменять и звуки, ассоциированные с этими константами: откройте управляющую панель и выберите пиктограмму “Sound”. Соедините предлагаемый по умолчанию звук из колонки А с требуемым WAV-файлом из колонки В (как показано на рис. 2.1). Теперь, если вы запустите программу Beeper, то услышите нечто совершенно новое. Однако помните, что эти возможности доступны только в системах, оснащенных мультимедиа. Пример: MessageBeep (0); Sound Asterisk Critical Stop Default Beep Exclamation Question Windows Exit Windows Start files: ihearit.wav iluvuman.wav itsbnfun.wav jack.wav jawharp. wav king.wav kittycry wav Iaser1.wav f ♦ M Enable System Sounds c:\sound Рис. 2.1. Ассоциирование конкретного звука с функцией MessageBeep
Замечание. Такие встроенные функции интерфейса прикладного программирования, как sndPlaySound, WinExec и MessageBeep, хранятся в DLL. Аббревиатура DLL обозначает библио- теку динамической компоновки. Позже вы увидите, как создавать свои собственные библиотеки DLL. А пока вам необходимо знать лишь то, что DLL — это библиотеки подпрограмм, которые представляют собой что-то вроде LIB-файлов. Это значит, что они являются библиотеками программ, хранящимися внутри отдельного файла. Тем не менее большая разница между LIB-файлами и DLL заключается в том, что LIB-файлы присоединяются к вашей программе во время компоновки, а библиотеки DLL — во время выполнения. Главные вызовы API, такие, как WinExec, sndPlaySound и MessageBox, находятся в DLL и компонуются динамически во время выполнения. Эти DLL имеют имена GDI.EXE и USER.EXE. Существенны также “сердцевинные” DLL, которые называются KRNL386.EXE и KRNL286.EXE. Не беспокойтеь, если вам все еще не вполне понятны DLL. Эта тема снова поднимается в последней половине этой книги. А пока необходимо знать только то, что они очень похожи на LIB-файлы. Листинги 2.1 и 2.2 содержат лишь несколько строчек простого кода. Фактически их структура идентична структуре программ, которые вы видели в предыдущей главе, если не считать того, что они определяются как STRICT. Задержимся на минутку, чтобы немного подумать об этой важной препроцессорной директиве. Препроцессорные директивы ttdefine CONSTANT value Препроцессорные директивы — это специальные сообщения, адресованные непосредственно компилятору. Если вы напишете: #define MTNBMBER 35 то это будет означать, что компилятор должен подставить 35 всюду, где увидит слово MYNUM- BER. Нечто подобное делает и директива STRICT. Это сообщение, говорящее компилятору, что он должен выполнить определенное действие. В следующих нескольких абзацах описывается это действие. STRICT-проверка типа придает специальным Windows’oecKHM целым типам совер- шенно новую мощь, помогая тем самым программистам избегать ошибок, связанных с невнимательностью. Сейчас не подходящее время обсуждать STRICT-проверку типа на глубоком уровне. Могу даже сообщить вам, что приведенные в этой книге программы пойдут, даже если STRICT не включена вовсе. Впрочем, отсюда и далее все программы будут определяться как STRICT по умолчанию. Я настоятельно рекомендую вам следо- вать этому соглашению. Ключевой момент, который необходимо помнить, состоит в том, что директива STRICT вызывает в ваших программах строгую проверку типа. Если STRICT не определена, то HINSTANCE объявляется как беззнаковое целое. Однако, если программа использует STRICT, то HINSTANCE объявляется как указатель. Это делается потому, что компилятор может выполнять аккуратную проверку типа над указателями, в то время как для него совершенно естественно рассматривать все целые как один и тот же тип. В этой книге я часто обращаюсь со специальными типами Windows, подобными HINSTANCE, как с простыми переменными (не указателями). Это помогает мне представлять материал наиболее ясным и простым языком. Другими словами, хотя я и знаю, что STRICT-проверка включена, то все равно говорю о HINSTANCE, как о простом целом значении. Это приводит нас ко второму важному моменту: в большинстве случаев вам следует всюду игнорировать присутствие директивы STRICT. Подразумевается, что она явно обнаруживает себя и поднимает голову, только когда может помочь исправить ошибку. Когда используется опция STRICT, компилятор может различать типы, к которым в нормальном состоянии он остался бы слеп. Например, компилятор обычно не отличает дескриптор окна от дескриптора картинки (или растрового изображения, как картинки
часто называются в Windows). Однако, когда вы используете директиву STRICT, ком- пилятор может предупредить вас (на этапе компиляции) о наличии “блох”, отслеживание которых в нормальном состоянии могло бы занять несколько часов, а может быть, и дней. Запомните, что директива STRICT вызывает в ваших программах строгую проверку типа. Это помогает вам избежать ошибок, связанных с невнимательностью, которые могут задержать выполнение проекта на несколько часов, дней или даже недель! DEF-файлы и визуализация До сих пор все программы, которые вы выполняли, состояли только из одного исходного файла. Однако обычно стандартные Windows-программы состоят, как мини- мум, из трех наборов файлов. Первый — это главный модуль (или модули) программы, второй — файл определения модуля и третий — проектный файл либо МАКЕ-файл. Файл определения модуля делает более или менее точно то, что он и должен делать, судя по его имени: определяет характеристики главного модуля программы. Эти харак- теристики включают: И Имя файла. Краткое описание назначения или первостепенных характеристик. И Тип файла. Имя программы-заглушки, которая появится при запуске программы из DOS. Размер стека и динамически распределяемой области (heap). И Несколько операторов, таких, как PRELOAD, DISCARDABLE или MOVEABLE, которые определяют способ управления памятью. Разумеется, МАКЕ-файл используется для осуществления процесса соединения разрозненных исходных файлов проекта в один исполняемый. Большинство читателей, возможно, знакомо с МАКЕ-файлами, но я все равно привел в этой главе их описание. Таким образом, у вас будет что-то вроде маленького справочника. Чтобы продемонстрировать вам, как следует пользоваться файлами определения модуля, я смастерил следующую небольшую программу. Она выводит на экран маленькое окно, которое называется MessageBox и содержит несколько мудрых слов внутри своей основной части в заголовке. Прежде чем вы запустите эту программу, нужно научиться компилировать с помощью Windows-проектов или МАКЕ-файлов. Я исследую эту тему, как только вы введете листинги 2.3—2.5. Листинг 2.3. Программа ВОХ1.СРР, отображающая слова из древнего китайского текста 1: // Program LAOTZU.CPP 2: #define STRICT 3: #include «windows.h> 4: 5: #pragma argsused 6: int pascal WinMain(HINSTANCE hlnst, 7: HINSTANCE hPrevlnstance, 8: LPSTR Ipsz CmdParam, int nCmdShow) 9: { 10: Message Box(0, 11: "Тот, кто знает, не говорит", 12: "Тот, кто говорит, не знает", 13: МВ-OK | MB_ICONEXCLAMATION) ; 14: return 0; 15: } 16: 17:
Листинг 2.4. DEF-файл для программы BOXI.CPP 1: 9 » ; LAOTZU.DEF z. 3: NAME 1ЛС7 XU 4: DESCRIPTION •LACaZtl Wirxlcv' Ъг EXETYtE witirows С: STUB •WtliSTUD.EXE' 7: CJT.OE ГКХГОАР MOVEABLE DISCAFDASLE II: DATA ГВКЮАГ М.Ч'ЕАЫЕ HJI.TX I’l.E 9: 10: HEAPSZF.E 4091 11: STACK5UZE 5120 Листинг 2.5. МАКЕ-файл для программы BOXI.CPP (Borland) 1: й —------------ 2: й Borlnnrl ВОХ1.МАК 3: II --------- ^==-=» 4: 5: И накроем 6: 1КСГАТ1! - C:\BC\1HCLUIP 7: LIBFAT1I • C:\BC\I.1B 8: FLAGS = -W -ml -v -«4 -КПКСЕАТИ) -L5 (LIBl'ATH) 9: 10: II кст-cnoiicпкп 11: 00X1.EXE: LOX1.CRJ ECX1. LEE 12: bee $ (FLAGS) BCXl.CBJ 13: 14; Й KOMniuiHuiiR 15: BOX1.OBJ: BOXI.CPP 16: bee -c SdLAGSI БСХ1.СРР Листинг 2.6. МАКЕ-файл для программы BOXI.CPP (Microsoft) I: Й -™—— 2: Й Microsoft BCX1.HAK 5: R компоновка 6: BCX1.EXE: BCX1.CBJ EOX1.DEF 7: link Ccxl, /align:16. KU', Znrd lliLcew llt.v, Eoxl 6: 9: й ксилиляцпл 10: BOX1.CBJ: BCX1.CBP 11: Cl -c -AL -GA -Cw -W4 -Zp BCX1.CFP Рис. 2.2. Результат работы программы BOXI.CPP Эта программа выводит на экран маленькое окно, показанное на рнс. 2.2. Нс подумайте только, что окна всегда так легко создавать. На самом деле создать настоящее окно, размер которого можно изменять, минимизировать и максимизировать, очень трудно. Впрочем, функция MessageBox служит хорошей прелюдией к тому, чтобы перейти к построению настоящих вещей. Прежде чем я расскажу о том, как скомпоновать и выполнить программу, приведен- ную в листинге 2.3, вам, наверное, будет интересно заглянуть в сердце программы ВОХ1. Она содержиттолько функцию MessageBox, которая постоянно используется в Windows- программах. 2 Чарльз Калверт
Функция MessageBox int MessageBox(HWND, LPCSTR, LPCSTR, UINT); Функция MessageBox создает окно. Она содержит следующие четыре параметра. Первый, HWND, представляет собой дескриптор (handle) основного окна программы; в листинге 2.3 он полагается равным нулю, поскольку программа ВОХ1 не имеет основного окна. Второй параметр — длинный указатель на символьную строку, которую вы хотели бы вывести в основной части окна сообщения, как показано на рис. 2.2. Третий параметр — еще один длинный указатель на символьную строку, представляющей собой заголовок окна сообщения. Четвертый параметр включает один несколько следующих флажков: //Кнопки // «define МВ ОК «define MBOKCANCEL «define MB ABORTRETRY IGNORE «define MB_YESNOCANCEL «define MBYESNO «define MB_RETRYCANCEL 0x0000 OK 0x0001 Cancel 0x0002 Abort, Retry, Ignore 0x0003 Yes, No, Cancel 0x0004 Yes, No 0x0005 Retry, Cancel // Пиктограммы «define MB ICONHAND 0x0010 Стоп «define MB ICONQUESTION 0x0020 Вопросительный знак «define MB ICONEXCLAMATION 0x0030 Восклицательный знак «define MB ICONASTERISK 0x0040 Звездочка «define MB ICONINFORMATION MB ICONASTERISK «define MB_ICONSTOP МВ_ICONHAND // Фокус и область действия «define MB APPLMODAL 0x0000 «define MB SYSTEMMODAL 0x1000 «define MB_TASKMODAL 0x2000 Если вы хотите использовать более одного из этих флажков одновременно, следует соединить их посредством логического ИЛИ, как показано в следующем примере. Чтобы увидеть, как это работает, попробуйте заменить MBJCONEXCLAMATION на MBJCONINFORMATION. Функция MessageBox возвращает целое значение, указывающее кнопку, которую пользователь выбрал в окне сообщения. Например, если пользователь нажмет кнопку ОК, функция вернет СМОК. Если пользователь нажмет кнопку CANCEL, функция вернет CMCANCEL. Ниже приве- дены возможные возвращаемые значения. IDABORT Пользователь выбрал кнопку Abort IDCANCEL Пользователь выбрал кнопку Cancel IDIGNORE Пользователь выбрал кнопку Ignore IDNO Пользователь выбрал кнопку No IDO К Пользователь выбрал кнопку ОК IDRETRY Пользователь выбрал кнопку Retry IDYES Пользователь выбрал кнопку Yes Пример: MessageBox(О, "Суть таинств бога есть любовь.", "Джалалэддин Руми сказал:", МВ_ОК I MB_ICONEXCLAMATION) ; Обзор компиляции и компоновки Программа Boxl (листинг 2.3) несколько длиннее предыдущих программ этой книги. Однако заметьте, что файл ВОХ1.СРР очень похож на остальные программы, которые вы уже видели. Добавочная длина обязана своим существованием исключительно файлу определения модуля и МАКЕ-файлам.
В программах Chimes, Beeper и Short компилятор автоматически генерировал внут- ренний файл определения модуля, очень похожий на тот, что сопровождает программу LAOTZU. Компилятор оказался способен на это, так как файлы определения модуля для самых простых Windows-программ выглядят почти идентично. Совет. Как только вы написали и поняли один файл определения модуля, потом его можно копировать предположительно неизменным из одной программы в другую! То же самое верно и для МАКЕ-файлов. Не следует пугаться наличия дополнительного программного кода. В большинстве случаев вы сможете добавлять в свои программы файлы определения модуля и МАКЕ- файлы путем простого процесса копирования и вставки с последующей быстрой процедурой поиска и замены. Проектные файлы и МАКЕ-файлы Существует два совершенно различных способа компиляции программ. Первый — с помощью МАКЕ-файлов, и второй — с помощью относительного упрощения, обеспе- чиваемого удобными проектными файлами фирм Borland и Microsoft. Если вы пользуетесь проектным файлом, нужно лишь добавить в проект файлы ВОХ1.СРР и BOX1.DEF, а затем откомпилировать и выполнить программу. Этот способ до сих пор остается самым простым. Впрочем, не каждый имеет удобство среды программирования фирм Borland и Microsoft, и многие программисты предпочитают пользоваться МАКЕ-файлами. Поэтому следующие несколько абзацев посвящаются объяснению того, как создавать и использовать МАКЕ-файлы. Вероятно, вы знакомы с МАКЕ-файлами. Если нет, то вам следует понять, что МАКЕ-файлы представляют собой описания, которые используются программой МАКЕ.ЕХЕ (Borland) или NMAKE.EXE (Microsoft). Эти описания говорят компилятору и компоновщику, как строить и компоновать программу. Для программы Boxl МАКЕ- файлы могут быть запущены из DOS посредством одной из следующих команд. make -fBoxl (Borland) ИЛИ nmake -fBoxl.так (Microsoft) После выполнения этой команды вы должны получить на диске рабочую копию BOX1.EXE. Если это не сработает, прочитайте следующий раздел, чтобы узнать, как настраивать МАКЕ-файл для вашей конкретной системы. Впрочем, если ввод кода даст результат, создание выполняемого модуля — это еще не все. Если вы будете использовать МАКЕ-файл, следует понять, как он собирается. Замечание. Следующие два раздела являются раритетами в этой книге. В первом описываются свойства МАКЕ-файлов фирмы Microsoft, а во втором — МАКЕ-файлов фирмы Borland. В общем случае я стараюсь избегать приведения специфически “компиляторной” информации. Однако МАКЕ-файлы настолько важны, что я решил сделать для них исключение. МАКЕ-файл фирмы Microsoft Если вы пользуетесь компилятором фирмы Borland, можете пропустить этот раздел и перейти к следующему. МАКЕ-файл фирмы Microsoft читается программой NMake, которая исполняет задание по компиляции и компоновке программы. Описание, или МАКЕ-файл, которое передается NMake, имеет три раздела: 1. Необязательный заголовок, который появляется в качестве комментария 2. Две строчки кода, указывающие NMake, как компоновать программу 3. Две строчки кода, указывающие NMake, как компилировать программу
Первая часть МАКЕ-файла начинается со значка фунта (#): # MakeFile for Boxl Знак фунта (#) сообщает NMake, что остальная часть строчки является комментари- ем. Первая обрабатываемая строчка в МАКЕ-файле поясняет общую цель для NMake: BOX1.EXE : BOX1.OBJ BOX1.DEF Эта строка говорит о том, что целью МАКЕ-файла является производство исполня- емого модуля по имени Boxl и что он будет сделан из (или, выражаясь более специаль- ным языком, будет зависеть от) двух исходных файлов с именами BOX1.OBJ и BOX1.DEF. В следующей строчке кода показываются фактические параметры, передаваемые компоновщику: link Boxl, /align:16, NUL, /nod llibcew libw, Boxl Если параметры, передаваемые компоновщику, вам еще не знакомы, следует обра- титься к документации по компилятору, чтобы разобраться в деталях. Впрочем, я коротко объясню, что опция /align предписывает, чтобы сегменты были выровнены на 16-бито- вые границы. Параметр NUL говорит компоновщику, чтобы тот не беспокоился о создании файла карты распределение памяти. Опция /nod указывает на отсутствие библиотек умолчания. За ней следуют имена библиотеки малой модели памяти и библиотеки libw, которая помогает Windows компоноваться с библиотеками DLL (где находится API). Прежде чем программы смогут быть скомпонованы, компилятор должен создать важные объектные файлы. Это делается с помощью последних двух строчек МАКЕ- файла: BOX1.OBJ : BOX1.CPP с! -с -AL -GA -Ow -W4 -Zp BOX1.CPP Как можно заметить, первая строчка информирует NMake о рабочей цели, которая состоит в том, чтобы откомпилировать файл с исходным кодом ВОХ1.СРР в BOX1.OBJ. Вторая строчка кода показывает NMake фактические параметры, подлежащие передаче в компилятор командной строки, который называется cl. -с говорит компилятору, что нужно компилировать без компоновки. -AL говорит компилятору, что он должен использовать большую модель памяти. И Переключатель -GA сообщает Windows о том, как экспортировать определенные функции. И Переключатель -OW позволяет избежать некоторых оптимизаций, которые плохо работают в Windows. И Переключатель -W4 заставляет компилятор выдавать полный список предупрежде- ний о потенциально опасном коде. И Переключатель -Zp говорит компилятору, что нужно размещать структуры и их элементы на однобайтных границах. Прежде чем оставить в покое МАКЕ-файлы, я сделаю одну завершающую модифи- кацию, которая позволит вновь использовать этот МАКЕ-файл при компиляции ваших программ лишь с небольшими изменениями: # ВОХ1.МАК APPNAME=Boxl # компоновка $(APPNAME).ехе : $(APPNAME).obj 4(APPNAME).def link $(APPNAME), /align:16, NUL, /nod llibcew libw, $ (APPNAME) # компиляция $ (APPNAME) .OBJ : $ (APPNAME) .cpp cl —c -AL -GA -Ow -W4 -Zp $ (APPNAME) . cpp
Этот код использует простой макрос, который автоматически подставляет слово Boxl вместо слова APPNAME, стоящее в круглых скобках и предваряемое знаком доллара ($). Вы объявляете макрос, написав его имя, за которым следует знак равенства (=) и строчка кода, соответствующая тому, что вы хотите представить с помощью этого макроса. Конечный результат состоит в том, что вы можете изменять множество строчек кода посредством изменения одной строки. Например, полагая APPNAME равным строке AnyWind, вы можете повлиять на каждое место МАКЕ-файла, в котором упоминается APPNAME. Замечание. В этом месте людям, которые уже имели опыт работы с МАКЕ-файлами, вероятно, не терпится, чтобы я упомянул о некоторых дальнейших улучшениях, которые могут быть сделаны с помощью этого описания. Впрочем, пока что мне придется попросить вас запастись терпением. Придерживаясь выбранного в этой книге стиля, я буду начинать с относительно простых и ясных примеров. После того как каждому будет предоставлен шанс уяснить основы, я перейду к более сложным темам. Таким образом, читатель сможет легко пройти важный материал. МАКЕ-файл фирмы Borland Если вы пользуетесь компилятором фирмы Microsoft, то можете пропустить этот раздел и перейти к следующему. МАКЕ-файл фирмы Borland для программы Boxl состоит из четырех частей: 1. Необязательный заголовок 2. Список макросов 3. Объяснение того, как компоновать выполняемый модуль 4. Объяснение того, как компилировать объектный файл Каждая часть начинается с комментария, служащего для объяснения цели програм- мы. Комментарии в МАКЕ-файле предваряются знаком фунта (#). # Makefile for Boxl Три макроса в МАКЕ-файле объявляют путь к включаемым и библиотечным файлам Си++, а также флажки, которые передаются компилятору: INCPATH = C:\BC\INCLUDE LIBPATH = C:\BC\LIB FLAGS = -И -ml -v -w+ -1$(INCPATH) Другими словами, макрос объявляется посредством написания его имени, за которым следуют знак равенства (=) и строчка кода, который вы хотели бы выполнить с помощью этого макроса. Конечный результат состоит в том, что вы можете сослаться на строчку кода, введя знак доллара ($), скобки () и имя макроса. Например, запись, следующая за директивой -I, вставляет макрос в четвертую строчку МАКЕ-файла. Написать - IS(INCPATH) — это то же самое, что написать -IC:\BC\INCLUDE. Смысл вставки макросов в МАКЕ-файл состоит в том, что это дает возможность менять много строчек кода посредством изменения одной строки. Например, положив INCPATH равным D:\BC\INCLUDE, можно воздействовать на каждое место в МАКЕ- файле, где упоминается INCPATH. Следовательно, вы можете приспособить этот МАКЕ-файл для вашей системы, изменив одну строчку кода так, чтобы она удовлетво- ряла конфигурации вашей системы. Замечание. Компилятору передаются четыре флажка. Первый, -W, приказывает компилятору создать приложение Windows. Второй, -ml, выбирает большую модель памяти. Третий, -v, указывает на необходимость включения отладочной информации. Четвертый, w+, обусловливает выдачу сообщений обо всех потенциальных ошибках в программе. Оставшиеся строчки файла говорят компилятору командной строки о том, как собирать основные элементы программы. Например, следующая строчка говорит ути- лите Маке, что вы хотите создать программу по имени Boxl, используя два файла: BOX1.OBJ и BOX1.DEF: ВОХ1.EXE: ВОХ1.OBJ ВОХ1.DEF
Следующая строчка кода говорит утилите Маке, какие специальные параметры следует передавать компилятору командной строки, который называется ВСС.ЕХЕ: Ьсс $ (FLAGS) BOX1.OBJ Последние две строчки программы говорят Маке, как строить объектный файл: BOX1.OBJ: ВОХ1.СРР Ьсс -с $(FLAGS) ВОХ1.СРР Заметьте, что макрос FLAGS раскрывается в двух местах, тем самым автоматически вставляя в командную строку директивы компилятора и каталог включаемых модулей, определенный ранее в МАКЕ-файле. Прежде чем оставить этот предмет, стоит сделать одно последнее изменение, которое позволит вам вновь использовать этот МАКЕ-файл лишь с небольшими модификациями при компиляции других программ: # BOX1А.МАК — альтернативная версия APPNAME *= Boxl INCPATH - C:\BC\INCLUDE LIBPATH-C:\BC\LIB FLAGS - -W -ml -v -w+ -1$ (INCPATH) $(APPNAME).exe: $(APPNAME).obj $(APPNAME).def bcc $ (FLAGS) $ (APPNAME) .obj $(APPNAME).obj: $(APPNAME).cpp bcc -c $ (FLAGS) $ (APPNAME) .cpp Заметьте, что на этот раз новый макрос APPNAME определяет имя приложения. Рассыпав этот макрос по телу МАКЕ-файла, можно сделать описание более гибким. Теперь стоит лишь изменить одно слово в МАКЕ-файле, и можно использовать его с совершенно другим приложением: APPNAME — AnyWind INCPATH = C:\BC\INCLUDE LIBPATH-C: \BC\LIB FLAGS = -W -ml -v -w+ -1$ (INCPATH) $(APPNAME).exe: $(APPNAME).Obj $(APPNAME).def bcc $ (FLAGS) $ (APPNAME) .obj $(APPNAME).obj: $(APPNAME).cpp bcc —c $ (FLAGS) $ (APPNAME) . cpp Этот модифицированный МАКЕ-файл строит приложение с именем ANY- WIND. ЕХЕ. Обращение достигается просто с помощью изменения Boxl на AnyWind. Возвышенный язык DEF-файлов Следующий вопрос повестки дня — файл определения модуля, или DEF-файл (как его все называют). Прежде чем погрузиться в детали, может быть, стоит осмыслить само звучание этого синтаксического конгломерата: “файл определения модуля”. Услышав это наименова- ние, кое-кто может предположить, что он (или она) забрел на лекцию, посвященную Кашу или Сартру. “Критика файла определения модуля” или, может быть, “Бытие, небытие и файл определения модуля”! Прежде чем вас запугает зловещий набат этих слов, не помешает узнать о том, что одним из ключевых аспектов Windows является недокументированная область памяти, называемая неким шуточным именем “Бургермастер”. Она была названа так по имени ресторана быстрого обслуживания, который находится неподалеку от штаб-квартиры фирмы Microsoft. Я полагаю, что разработчики Windows назвали именем подаваемого в забегаловке бутерброда самый таинственный и чарующий из составляющих эту систему элементов. Если честно, я считаю, что название Бургермастер гораздо более соответствует духу Windows, чем навороченные наименования вроде “файла определения модуля”. Как все по-настоящему интересные предметы, от астрономии и до Шекспира, Windows по самой
своей природе не является чем-то темным или пугающим. Она забавна. Если бы она не была такой, то ее и не стоило бы принимать всерьез. Так или иначе мне нужно вернуться к DEF-файлам. Эти маленькие очаровашки обычно исполняют некоторые функции, ассоциированные с процессом компоновки конечного выполняемого модуля. Одна из таких задач — присвоить модулю имя: NAME Boxl Другая — определить файл как Windows-приложение: EXETYPE WINDOWS Отдел DESCRIPTIONS интересен потому, что этот текст действительно вставляется в заголовок программы: DESCRIPTIONS 'Boxl example' С другой стороны, STUB представляет собой просто обрывок кода, который обычно выводит на экран хорошо известное сообщение “Этой программе требуется среда Microsoft Windows.” STUB ' WINSTUB. EXE' Если хотите, можете написать свою собственную программу-заглушку, пользуясь компилятором DOS. Последние две строчки DEF-файла определяют размеры стека и динамически распределяемой области: HEAPSIZE 4096 STACKSIZE 5120 Стек для этого приложения был положен равным рекомендованному минимуму. Возьмите за правило никогда не пытаться строить Windows-приложение с размером стека меньшим, чем 5120 байт. Естественно, эта область используется для хранения инфор- мации, когда программа вызывает локальные функции. HEAPSIZE определяет начальный размер локальной динамической области програм- мы. Если необходимо, Windows может увеличить начальный размер динамической области, а также добавить к ней памяти извне, если потребуется. Фактически DOS-npo- граммы, запущенные под Windows, имеют доступ к динамическим областям, размеры которых часто вылезают за 16 мегабайт. Чтобы выяснить, сколько памяти доступно на вашей машине, откройте окно “About” в менеджере файлов или менеджере программ. Оставшиеся две строчки DEF-файла описывают, как части программы размещаются в памяти: CODE PRELOAD MOVEABLE DISCARDABLE DATA PRELOAD MOVEABLE MULTIPLE Это несколько более сложный предмет, которому я уделю несколько абзацев, чтобы исследовать его на более глубоком уровне. Большая часть существенных вопросов вращается вокруг потаенных глубин тех способов, с помощью которых Windows реали- зует многозадачность. Например, все, что связано с PRELOAD MOVEABLE DISCARDABLE, имеет оттенок некоторой достаточно тяжеловесной кантовской риторики. Даже сами эти слова звучат как-то таинственно для программистов DOS, которые не привыкли манипулировать в памяти более чем одной программой одновременно. Ребята, которые создавали Windows, уж точно засучили рукава при написании протраммы, которая делает многозадачность возможной. Кроме всего прочего, им нужно было найти способы передвигать изрядные куски памяти туда и сюда таким образом, чтобы это было полностью незаметно для обыкновенных программистов. Поскольку они проделали такую отличную работу, протраммистам осталось лишь понять несколько относительно простых концепций. В частности, сегмент кода этой программы помечен как MOVEABLE и DIS- CARDABLE. Пометка MOVEABLE означает, что Windows может перемещать по памяти эту часть протраммы, содержащей реальный код, который выполняется в течение работы
программы. Обычно Windows делает это, чтобы освободить пространство для другой только что активизированной задачи. DISCARDABLE означает, что Windows может при необходимости удалить этот сегмент из памяти. Впрочем, если это произойдет, Windows вновь загрузит сегмент программы, когда тот потребуется опять. Вы можете думать, что это происходит следующим образом. Windows может выпол- нять несколько приложений одновременно, но нет гарантии, что в памяти найдется место для одновременного хранения кода всех этих приложений. Поэтому Windows сдвигает эти программы в памяти или даже временно стирает их. Вот так. Затруднение связано с тем фактом, что некоторые части кода абсолютно нельзя перемещать. Например, драйверы устройств, которые управляют принтерами или другими аппаратными компонентами машины, должны загружаться по специальным адресам и оставаться постоянно на одном месте. Чтобы обеспечить такую возможность, Windows позволяет вам задать способ обращения с определенными сегментами в памяти. Например, сегмент данных определяется как MOVEABLE и MULTIPLE. Это озна- чает, что этот блок памяти может быть при необходимости перемещен и что в памяти может существовать более одной его копии (см. рис. 2.3). Потребность MULTIPLE возникает из-за того, что несколько копий программы могут выполняться одновременно. Например, некоторые пользователи могут пожелать, чтобы на рабочем столе нахо- дилось одновременно несколько копий программы Notepad. Они легко могут переклю- чаться между двумя документами, что является очень мощной возможностью. Однако, чтобы можно было обеспечить эту возможность, требуется, чтобы каждая копия про- граммы имела свой собственный сегмент данных. В противном случае все копии программы Notepad должны были бы работать с одними и теми же данными. Это учит нас тому, что за возможности Windows приходится платить и часть этой платы состоит в использовании всяких неприятных слов вроде MOVEABLE, DIS- CARDABLE и MULTIPLE. Рис. 2.3. Когда в Windows одновременно выполняются несколько копий одной программы, каждая имеет свой собственный сегмент данных К этому моменту вы уже должны начать понимать, почему сегменты данных большинства Windows-программ должны объявляться как MULTIPLE. В противном случае все копии каждой программы работали бы с одними и теми же данными (см. рис. 2.4). Однако заметим, что сегмент кода программы Boxl не объявляется как MULTIPLE. Это означает, что все копии этой программы делят один и тот же сегмент кода, даже если они будут иметь свои собственные сегменты данных. Программы 16-битовой Windows традиционно работают таким образом, так как на ПК часто бывает слишком мало памяти. Когда на рабочем столе присутствует несколько копий программы, требуется только одна копия сегмента кода. Поэтому, когда бы программа не загружалась в память, используется минимальное пространство. Весь этот
процесс возможен благодаря тому, что Windows нс позволяет что-либо записывать в сегмент кола приложения. В противном случае вам пришлось бы объявлять сегмегпы кода как множественные, поскольку одна копия приложения могла бы изменить сегмент кода, в то время как остальные могли бы оставить его неприкосновенным. Замечание. Остальные многозадачные операционные системы имеют тенденцию предоставлять каждой копии программы собственный сегмент кода. Они могут позволить это. поскольку идут на машинах, имеющих солидный запас памяти. Ряс. 2.4. Экстремальный пример того, как могла бы выглядеть программа Write, если бы все копии на рабочем столе имели один сегмент данных Надеюсь, что вас не слишком смутило это длинное обсуждение DEF файла и близлежащих вопросов. Лично меня всегда утомляет необходимость работать с черным ящиком, который для меня ничего не означает Мне хочется понимать кое-что из того, что происходит на самом деле, поэтому я стараюсь, чтобы и у вас была такая информация. Если определенные места этого обсуждения вас немного смутили, нс беспокойтесь Все в порядке. В этой книге всегда можно использовать один и тот же основной DEF-файл лишь с небольшим числом изменений. Все, что вам обычно придется делать, — это изменять имя программы и ее описание. Остальное можно оставить в неприкосновенности. В действительности не обязательно быть ужасно умным, чтобы сгать Windows-npo- граммистом. Какими вы должны быть — так это гибкими и легкими на подъем. Если вы способны схватывать новые концепции, то все будет в порядке. Если же вы привыкли сопротивляться нововведениям, придется тащить вас в этот славный новый мир силком, невзирая на попытки царапаться и лягаться. Создание окон К этому времени вы уже имели случай увидеть несколько разных Windows-программ, но еще не видели ни одного настоящего окна’ Теперь пришла пора взглянуть на них. И нс то чтобы я раньше скупился, просто почти все оставшиеся в этой книге программы имеют, по крайней мере, одно окно (а чаше всего несколько). Однако задача создания настоящих окон далеко не проста, но давайте отбросим все страхи. То, что вы увидите в следующих нескольких абзацах и в следующей главе, является, возможно, самым трудным шагом из тех, что предстоит сделать на начальном и промежуточном этапах вашей карьеры Windows-программиста Если вы осилите этот предмет, все остальное уже будет в порядке.
При любых обстоятельствах, прежде чем начать беспокоиться, не лишне будет узнать, что создание окон, как и в случае с показанными ранее DEF- и МАКЕ-файлами, представляет собой трехшаговый процесс, который можно выполнить за один присест. Затем вы сможете использовать его почти без изменений в самых разных программах. Не следует думать, что Windows-программисты садятся и говорят: “Так, сейчас вызову CreateWindow. Какой там первый параметр, и что мне следует в нем задать на этот раз? Отлично. Что там у нас дальше...” Напротив, все, что они делают, — это методом “клея и ножниц” выполняют несколько маленьких изменений и потом забывают обо всем этом. Но не так страшен черт..! Сейчас вам предстоит просмотреть коротенькую (50 строк) программку, создающую реальное окно, которое ведет себя обычным для Windows образом. На этом этапе вам не нужно ничего, кроме самого приблизительного представления о том, как работает эта программа. Фактически она сшита из некоторого числа важных синтаксических элементов, которые, на мой взгляд, являются существенными для создания надежных и легко поддерживаемых программ. Я даже зашел так далеко, что опустил DEF- и МАКЕ-файлы, чтобы вы сосредоточились только на общих представ- лениях об этой программе. Не беспокойтесь ни о каких деталях. Просто запустите ее и убедитесь, что она делает все, что должна делать настоящая Windows-программа. Это значит, что вы можете ее максимизировать, минимизировать, увеличивать и уменьшать, как и любое другое профессиональное Windows-приложение. Когда закончите, вернитесь к тексту и прочитайте короткое обсуждение основных разделов программы. После этого можете считать, что вы с ней квиты на этот день. Завтра у вас будет случай продраться сквозь все мучительные детали, какие только пожелаете. Но это завтра, а пока еще сегодня. Листинг 2.7. Программа MakeWin, создающая традиционное окно с заголовком, окантовкой и системным меню 1: // Program MAKEWIN.СРР 2: ffdefine STRICT 3: #include <windows.h> 4: Sinclude <windowsx.h> 5: #include <atring.h> 6: 7: char Name[] = “MakeWin"; 8: LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM) ; 9: 10: int pascal WinMain(HINSTANCE hlnst, 11: HINSTANCE hPrevlnstance, 12; LPSTR IpszCmdParam, int nCmdShow) 13: { 14: HWND hwnd; 15: MSG Msg; 16: WNDCLASS W; 17: 18: memset(4W, 0, sizeof(WNDCLASS) ); 19: W. style = CS_HREDRAW I CS_VREDRAW; 20: W.IpfnWndProc = WndProc; 21: W.hlnstance = hlnst; 22: W.hbrBackground = GetStockBrush(WHITE_BRUSH); 23: W.IpszClassName = Name; 24: Registerclass(bW); 25: 26: hwnd = Create Window(Name, Name WSOVERLAPPEDWINDOW, 27: 10, 10, 600, 480, NULL, NULL, hlnst, NULL); 28: 29: ShowWindow(hwnd,nCmdShow); 30: UpdateWindow(hwnd); 31: 32: while (GetMessage(&Msg, NULL, 0, 0)) 33: { 34: TranslateMessage(&Msg); 35: DispatchMessage(&Msg);
36: } 37: 38: return Msg.wParam; 39: > 40: 41: LRESULT CALLBACK __export WndProc(HWND hWnd, UINT Message, 42: WPARAM wParam, LPARAM IParam) 43: { 44: if (Message == WM_DESTROY) 45: { 46: PostQuitMeSsage(O); 47: return 0; 48: } 49: return DefWindowProc(hwnd, Message, WParam, IParam); 50: } Рис. 2.5. Программа Make Win создает окно, которое можно минимизировать, максимизировать, изменять в размере и приводить в нормальное состояние! Программа MakeWin имеет две основные части. 1. Функция WinMain. 2. Функция WndProc. Функция WinMain разделяется на три секции. Первая (строчки 18-24), где регистрируется окно: 18: memset(&W, 0, sizeof(WNDCLASS)); 19: W. style = CS_HREDRAW I CS_VREDRAW; 20: W.lpfnWndProc = WndProc; 21: W.hlnstance » hinst; 22: W.hbrBackground = GetStockBrush(WHITE_BRUSH) ; 23: W.IpszClassName = Name; 24: Registerclass(SW); Процедура Register сообщает Windows характеристики класса окна. Пока не стоит беспокоиться о том, почему окно регистрируется или что этот шаг обозначает. Заметьте только, что это первое, происходящее в типичной процедуре WinMain. В последующих главах сложное действие регистрации окна будет выделено в свою собственную проце- дуру, как тому и следует быть согласно апробированным рекомендациям структурного программирования. Следующий шаг — создание окна (строчки 26-30): 26: hwnd = CreateWindow(Name, Name, WS_OVERLAPPEDWInDOW, 27: 10, 10, 600, 400, NULL, NULL, hinst, NULL); 28: 29: ShowWindow(hwnd,nCmdShow); 30: UpdateWindow(hwnd); Процесс создания окна включает два шага. Первый — вызов процедуры CreateWindow (строчки 26-27), а второй — два обращения: к ShowWindow (строчка 29) и к UpdateWin- dow (строчка 30). Как и регистрация, создание окна обычно управляется своей собст- венной процедурой. Это делается, чтобы выделить сложные части и создать хорошо
структурированную, надежную программу. Тем не менее сейчас я собрал все воедино, чтобы дать вам то, что политики называют “крупным планом”. Третья часть процедуры WinMain называется циклом сообщения (строчки 32-36): 32: While (GetMessage (bMsg, NULL, 0, 0)) 33: ( 34: TranslateMessage (ЬМзд); 35: DispatchMessage(&Msg); 36: } Когда пользователь передвигает мышь или нажимает на клавишу, сообщения посы- лаются в цикл обработки сообщений. Это “капитанский мостик” Windows-программы. Это командный центр. Это цикл, который повторяется на протяжении всей жизни программы. Не беспокойтесь, если вы что-то не уловили. Этого и не предполагалось. Цель последнего раздела — просто дать вам обзор типичной Windows-программы. Завтра вы получите все подробности, какие только можно, и даже еще больше. А сейчас вы должны думать только о таких самых общих вещах, как три шага процедуры WinMain и процедура WndProc, которая отвечает на сообщения, получаемые программой: 41: LRESULT CALLBACK ___export WndProc(HWND hwnd, UINT Message, 42: WPARAM wParam, LPARAM IParam) 43: ( 44: if (Message == WM_DESTROY) 45: ( 46: PostQuitMessage(0); 47: return 0; 48: } 49: return DefWindowProc(hwnd, Message, wParam, IParam); 50: } Программа MakeWin явно отвечает только на сообщения WM_DESTROY (строка 44). Все прочие сообщения передаются в DefWindowProc (строка 49). Процедура DefWindow- Ргос делает не что иное, как управляет поведением окна по умолчанию. Иначе говоря, когда вы максимизируете окно или минимизируете его, процедура DefWindowProc получает ваше сообщение и знает, что с ним делать. Однако процедура DefWindowProc не занимается сообщениями WM_DESTROY. Это уже ваша обязанность как программиста. Когда придет это сообщение, будет нужно лишь вызвать PostQuitMessage (строчка 46). Как только это произошло, можно выйти из WndProc с нулевым кодом возврата (строчка 47). В следующей главе вы увидите, как управляться со стандартными сообщениями Windows с помощью макросов. Так что можно вынести функцию ответа на сообщение из WndProc по той же причине, по которой выносятся функции Create и Register из процедуры WinMain. Она состоит в том, что Windows-программисты хотят иметь возможность создавать хорошо структурированные, легко отлаживаемые и поддерживае- мые программы. В данном случае я запрятал все эти процедуры обратно в функции WinMain и WndProc, чтобы вы смогли увидеть общую структуру типичной Windows-про- граммы. Это пока все, что вам нужно знать о программе MakeWin. Подведем итог. Программа состоит из двух основных частей. Первая — это процедура WinMain; вторая — процедура WndProc. Процедура WinMain состоит из трех частей. Первая регистрирует окно, вторая создает его, а третья посылает в окно сообщения через цикл. Все сообщения, посылаемые в окно, проходят через WndProc. Эта процедура окна может явно управлять сообщениями или передавать их в DefWindowProc, которая является обработчиком сообщений по умолчанию. Резюме Из этой главы вы узнали, как производить звуки с помощью Windows-программ и как выводить на экран окно сообщений. Вы также научились таким техническим
приемам, как использование директивы STRICT и создание файлов определения модуля и МАКЕ-файлов. В последнем разделе этой главы вы увидели общую схему большинства Windows-программ. После выполнения этих шагов уже можно изучать на более глубоком уровне вполне оперившуюся дельную программу. Все мучительные подробности, связанные с этим процессом, будут внимательно рассмотрены в следующей главе. Теперь можете отки- нуться на спинку кресла и расслабиться, чтобы приготовиться к грядущему. Вопросы и ответы 1. Как я моту откомпилировать Windows-программу? Существует два стандартных способа компиляции Windows-программ. Первый — через использование мощных проектных файлов фирм Borland и Microsoft. Многие программисты находят, что это идеальный способ сборки программ из разрозненных частей. Другие предпочитают использовать МАКЕ-файлы, которые можно запускать из DOS. Некоторым простым программам, которые идут на компиляторах фирм Borland и Microsoft, не нужно ни того, ни другого, однако такие программы являются аномалиями, поскольку обычно нужен МАКЕ-файл или проектный файл, чтобы откомпилировать проект. 2. Что такое файл определения модуля? Файл определения модуля указывает основные характеристики конкретного прило- жения. Например, DEF-файлы дают приложению имя, добавляют описание в заголовок выполняемого модуля и показывают, как программа обращается с памятью. Обычно вы можете просто копировать DEF-файл из одного проекта в другой лишь с небольшими изменениями. Эти вещи кажутся трудными поначалу, но через несколько дней вы обнаружите, что они имеют тенденцию отодвигаться на задний план и почти не требовать мыслительных затрат. 3. Какую модель памяти мне следует использовать? Большинство программ в этой книге разработаны для выполнения на большой модели памяти. Ваш выбор модели памяти не столь важен в первых разделах этой книги, но позже вы должны будете пользоваться большой моделью памяти. Вопросы для самопроверки 1. Каково назначение “заглушки” в Windows-программе? 2. Назовите три вещи, которые определяются в файле определения модуля. 3. Как называются две основные процедуры программы MakeWin? 4. Каковы три основные части каждой функции WinMain? 5. Каждое основное окно приложения должно отвечать на одно сообщение. Что это за сообщение? Упражнения 1. Если у вас есть мультимедиа, создайте программу, которая использует аргумент IpszCmdParam, чтобы вытащить WAV-файл из командной строки. Пусть программа проиграет этот WAV-файл. 2. Создайте программу, которая высвечивает (окно сообщения), содержащее ваше имя.
День 3 СТАНДАРТНАЯ WINDOWS-ПРОГРАММА Цель этой и следующей главы — проанализировать на глубоком уровне базовую структуру типичной Windows-программы. В частности, в этой главе рассматриваются: WinMain. RegisterCIass. В CreateWindow. В Цикл обработки сообщений. В WndProc. Однако имейте в виду, что мы снова вернемся к WndProc в следующей главе. Эти две главы — самые важные в этой книге. В них содержится информация, к которой вам придется постоянно обращаться при написании серьезных Windows-программ. Первый функционирующий графический интерфейс Windows имеет репутацию очень сложной для программирования системы. Заслужена эта репутация или нет — предмет для серьезных споров. Большинство тех, кто пытается овладеть искусством программирования в Windows, приходит в эту среду из DOS. В результате они почти всегда бывают удивлены или даже напуганы, впервые вступая в этот прекрасный новый мир. Надеюсь, что в процессе чтения вы будете встречать все новое и странное не со страхом и смущением, а с восхищением и азартом. Если программирование в Windows иногда и бывает сложным, то это только потому, что оно полно возможностей. Полагаю, что вы сконцентрируетесь не на трудностях, а на удобствах, которые Windows предостав- ляет внимательным и предприимчивым программистам. Я хочу, чтобы вы видели преимущества там, где другие видят трудности. Без дальнейших проволочек я покажу вам полную Windows-программу, разработан- ную так, чтобы быть одновременно гибкой и надежной. Все, что от вас сейчас требуется, — это ввести и запустить ее (листинг 3.1). Работая с этой программой, помните, что она состоит из нескольких модулей, которые должны быть связаны воедино с помощью МАКЕ-файла или проектного файла. Эго означает, что программа Windowl строится из всех перечисленных здесь файлов, хотя, конечно, некоторые из МАКЕ-фай- лов (или даже все они) будут необязательны, в зависимости от ваших обстоятельств. Время начинать, и вот исходный код (листинг 3.1).
Листинг 3.1. Windowl — многомодульная программа, иллюстрирующая основные компоненты стандартной Windows-программы 1: //-----======-------======-------=====---------======-------===== 2: // Наименование программы: Windowl 3: // Автор: Чарли Калверт 4: // Описание: Пример Windows-программы 5: // =---=======================---========--===========------===== б: 7: #define STRICT В: #include <windows.h> 9: ((include <windowsx.h> 10: ((pragma warning (disable: 4068) 11: ((pragma warning (disable: 4100) 12: 13: static char szAppName[] = "Windowl"; 14: static HWND MainWindow; 15: 16: LRESULT CALLBACK __export WndProc(HWND hWindow, UINT Message, 17: WPARAM wParam, LPARAM, IParam); 18: BOOL Register(HINSTANCE hlnst); 19: HWND Create(HINSTANCE hlnst, int nCmdShow); 20: 21: // ---=====================-----==========----========-----====== 22: // ИНИЦИАЛИЗАЦИЯ 23: // ==============--========-----=========-----===========--------- 24: 25: ////////////////////////////////////////////////////////////////// 26: II Функция WinMain — программная точка входа 27: // Регистрирует окно, создает его и входит в цикл сообщений. 28: // Если какой-либо из шагов не удается, программа завершается, 29: II не создавая окна 30: IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIHII 31: #pragma argsused 32: int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInstance, 33: LPSTR IpszCmdParam, intnCmdShow) 34: ( 35: MSG Msg; 36: 37: if (!hPrevInstance) 38: if (!Register(hlnst)) 39: return FALSE 40: 41: if (! (MainWindow = Create(hlnst, nCmdShow))) 42: return FALSE; 43: 44: while (GetMessage(SMsg, NULL, 0, 0)) 45: ( 46: TranslateMessage(bMsg); 47: DispatchMessage(bMsg); 48: ) 49: 50: return Msg.wParam; 51: ) 52: 53: llllllllllllllllllllllllllllllllllllllllllllllllllllll 54: // Регистрация окна 55: IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIHI hlnst) 56: BOOL Register(HINSTANCE 57: { 58: WNDCLASS WndClass; 59: 60: WndClas s.style 61: WndClass.IpfnWndProc 62: WndClass.cbClsExtra 63: WndClass.cbWndExtra 64: WndClass.hlnstance 65: WndClass.hlcon 66: WndClass.hCursor 67: WndClass.hbrBackground 68: WndClass.IpszMenuName 69: WndClass.IpszClassName 70: = CS HREDRAW I CS_VREDRAW; = WndProc; = 0; = 0; = hlnst; = Loadicon(NULL, IDI_APPLICATION) = Load Cursor(NULL, IDC_ARROW); = GetStockBrush(WHITE_BRUSH); = NULL; = szAppName; 71: return Registerclass(swndclass); 72: )
73: 74: /////////////////////////////////////////////////////// 75: // Создание окна 76: //////////////✓///////////////////////////////✓//////// 77: HWND Create(HINSTANCE hlnstance, int nCmdShow) 78: ( 79: HWND hWindow = CreateWindow(szAppName, szAppName, 80: WS_OVERLAPPEDWINDOW, 81: CW_ USEDEFAULT, CWUSEDEFAULT 82: CWUSEDEFAULT, CW_USEDEFAULT, 83: NULL, NULL, hlnstance, NULL); 84: 85: if (hWindow == NULL) 86: return hWindow; 87: 88: ShowWindow(hWindow, nCmdShow); 89: Updatewindow(hWindow); 90: 91: return hWindow; 92: ) 93: 94: /////////////////////////////////////////////// 95: // РЕАЛИЗАЦИЯ 96: /////////////////////////////////////////////// 97: ((define Windowl_DefProc DefWindowProc 98: void Windowl_OnDestroy(HWND hwnd); 99: 100: ////////////////////////////////////////////////////////////// 101: 11 Оконная процедура, обрабатывающая сообщения 102: ////////////////////////////////////////////////////////////// 103: LRESULT CALLBACK __export WndProc(HWND hWindow, UINT Message, 104: WPARAM wParam, LPARAM IParam) 105: ( 106: switch(Message) 107: ( 108: HANDLE MSG(hWindow, WM_DESTROY, WindowlJOnDestroy) ; 109: default: 110: return Windowl_DefProc(hWindow, Message, wParam, IParam); 111: ) 112: ) 113: 114: ///////////////////////////////////////////////////////// 115: // Обработка сообщения WM DESTROY 116: /////////////////////////7/////////////////////////////// 117: ((pragma argsused 118: void Windowl_OnDestroy(HWND hwnd) 119: ( 120: PostQuitMessage(O) ; 121: ) Листинг 3.1. WINDOW1.DEF 1: ; WIND0W1.DEF 2: 3: NAME Windowl 4: DESCRIPTION 'Пример традиционного окна' 5: EXETYPE WINDOWS 6: STUB 'WINSTUB.EXE' 7: CODE PRELOAD MOVEABLE DISCARDABLE 8: DATA PRELOAD MOVEABLE MULTIPLE 9: 10: HEAPSIZE 4096 11: STACKSIZE 5120 Листинг 3.3. WINDOW1.MAK (Borland) 1: # МАКЕ-файл: WINDOW1.MAK 2: 3: # Макросы 4: INCPATH = C:\BC\INCLUDE 5: LIBPATH = C:\BC\LIB 6: FLAGS = -W -ml -v -w4 -1$ (INCPATH) -L$ (LIBPATH) 7: 8: (f Компоновка
9: WIND0W1. EXE : WINDOWl.OBJ WINDOW1.DEF 10: bcc $ (FLAGS) WINDOWl.OBJ 11: 12: # Компиляция 13: WINDOWl.OBJ: WINDOW1.CPP 14: bcc —c $ (FLAGS) WINDOW1.CPP Листинг 3.4. WINDOW1.MAK (Microsoft) 1: # WINDOW1.MAK 2: 3: # Компоновка 4: WINDOW1.EXE : WINDOWl.OBJ WINDOW1.DEF 5: link /CO windowl, /align:16, NUL, /nod llibcew libw, windowl 6: 7: # Компиляция В: WINDOWl.OBJ : WINDOW1.CPP 9: cl —C -AL -GA -Ow -W4 -Zp -Zi WINDOW1.CPP Программа Windowl, которая получается в результате компиляции всех предыдущих файлов, строит обыкновенное традиционное окно, столь знакомое всем пользователям среды Windows (см. рис. 3.1). Компилируя эту программу, помните, что она состоит из нескольких различных модулей, собранных воедино. Точно так же, как коробка скорос- тей, ведущее колесо и передача, взаимодействуя с другими механизмами, вместе состав- ляют автомобиль, каждый модуль Windows-программы вносит свой собственный вклад в создание конечного ЕХЕ-файла. Рис. 3.1. Результат работы WINDOW1.CPP Если вы работаете с проектными файлами в Borland C++ или в Microsoft C++, процесс запуска и выполнения программы достаточно прост. Если нет, то первым шагом будет запуск МАКЕ-файла из командной строки DOS. Затем вы можете либо запустить программу из меню File, Run, либо поместить ее пиктограмму в одно из ваших групповых окон с последующим запуском ее оттуда. Чтобы откомпилировать Windowl из DOS с помощью Borland C++, нужно дать команду: make -f windowl Аналогичная команда для Microsoft Visual C++: nmake -fwindowl.так Запустив программу, поиграйте с ней несколько минут. Даже если вы уже знакомы со средой Windows, поэкспериментируйте, максимизируя, минимизируя и изменяя форму окна, растягивая его границы. Вы должны понимать назначение строчек исход- ного кода, которые вы только что ввели и откомпилировали.
О яблоках, апельсинах, Windows и DOS Потратив некоторое время на борьбу с кодом WINDOW1.CPP, вы могли почувство- вать себя слегка ошеломленными его размером. Можно даже затосковать по относитель- ной простоте DOS. Действительно, многое уже было написано об относительных достоинствах про- граммных сред Windows и DOS. Некоторые даже попросят вас сравнить непонятное нагромождение строк программы (вроде WINDOW1.CPP) с простым кодом с первых страниц традиционной книжки по программированию в DOS: #include <stdio.h> main() ( printf("Hello, world"),’ ) He тратьте слишком много времени на эти мысли. По-моему, это все равно, что сравнивать яблоки и апельсины. Стоит лишь заглянуть чуть глубже, чтобы понять как мало сходства между изысканным великолепием представленного выше Windows-при- ложения и восхитительной простотой досовской программы “Hello, world”. Например, изменив всего одну строчку 88 в WINDOW1.CPP, можно сначала мини- мизировать программу, превратив ее окно в маленькую пиктограмму внизу экрана. Та же самая строка может быть снова изменена для максимизации окна. С помощью других незначительных изменений можно удалить заголовок, окантовку и системное меню, а также кнопки минимизации и максимизации в правом верхнем углу (см. рис. 3.2). Внесение столь же радикальных изменений в программу “Hello, world” потребовало бы добавления в нее множества новых строчек и нескольких дней (если не недель или даже месяцев) работы. Наконец, код изменился бы так сильно, что в нем уже невозможно было бы узнать прежнюю программу. Рис 3.2. Маленькие изменения кода WINDOW1. СРР могут радикально изменить внешний вид создаваемого ею окна Не думаю, что Windows лучше DOS или DOS лучше Windows. Скорее, эти две среды совершенно различны и их нельзя сравнивать. Например, легко можно сравнить “мерседес” и фольксвагенского “жука”. Однако гораздо труднее сравнить “мерседес” с мотоциклом или парусной лодкой. Утверждение, что “мерседес” просторнее “фольксвагена”, относительно верно, чего нельзя сказать об утверждениях типа “мерседес” просторнее мотоцикла или “мерседес” быстрее парусной лодки. Я считаю, что такая же проблема встает, когда люди говорят: “DOS легче для программирования, чем Windows”. Такие утверждения необязательно правильны или неправильны, они просто не имеют смысла. Наконец, было бы глупо рассматривать Windows и DOS как конкурирующие среды. Скорее, они дополняют друг друга. Разумеется, я не возражаю, если вы предпочтете одну из них. Приверженность одному из решений в этом вопросе может вести к улучшениям в обеих этих средах, поскольку каждая сторона попытается превзойти другую. Надеюсь, что они обе выживут и я смогу пользоваться лучшими свойствами каждой из них.
В конце концов, традиционная досовская протрамма “Hello, world”, по-видимому, не лучше и не хуже Windows-программы — просто она другая. Компьютерный мир очень сложен, и было бы ошибочным противопоставлять одну его часть другой. В данном случае, например, яблоко — это одно, а апельсин — другое. Их сравнение неплодотворно. Переходим к программе Пора поговорить о том, что составляет существенную часть интереса для всех истинных программистов. Это чрезвычайно важная часть книги. То, о чем вы узнаете из следующих нескольких страниц, может показаться слегка ошеломляющим даже для опытных Windows-програм- мистов. Поэтому я хочу быть уверенным, что вы имеете представление о том, чего следует ожидать. В следующем разделе представлен детальный обзор процедур WinMain и WndProc с концептуальной точки зрения. Моя цель — дать вам общий план законченной Windows-программы, не погружаясь в слишком специальные детали. Усвоив этот материал, вы будете готовы заняться анализом действительной работы программы. Этот раздел больше апеллирует к теории. После этого мы вновь обратимся к программам WinMain и WndProc. На этот раз мы более подробно разберем процедуры WinMain, Create и Register. Эта часть главы представляет собой построчный анализ всех трех процедур и больше обращается к практике. Последний раздел посвящен деталям процедуры WndProc. Процедура WndProc управляет программой на этапе ее выполнения. Иначе говоря, процедура WinMain запускает программу, а процедура WndProc помогает ей работать. Концептуальный обзор WinMain и WndProc Ниже приводится главная функция программы Windowl. 32: int PASCAL WinMain(HINSTANCE hinst, HINSTANCE hPrevInstance, 33. LPSTR IpszCmdParam, intnCmdShow) 34: ( 35: MSG Msg; 36: 37: if (!hPrevInstance) 38: if ((Register(hinst)) 39: return FALSE 40: 41: if (!(MainWindow = Create(hinst, nCmdShow))) 42: return FALSE; 43: 44: while (GetMessage (SMsg, NULL, 0, 0)) 45: ( 46: TranslateMessage(SMsg); 47: DispatchMessage(SMsg); 48: } 49: 50: return Msg.wParam; 51: ) Как уже говорилось, функция WinMain (строчки 32-33) является тем же, что и функция main() для стандартной программы DOS. Приложения Windows, написанные на Си или Си++, почти всегда начинаются с обращения к WinMain. WinMain подразделяется на три части. Первая — обращение к Register (строчка 38), вторая — обращение к Create (строчка 41) и третья — while-цикл обработки сообщений, получаемых программой (строчки 44-47). Прежде чем я объясню все это в деталях, вам стоит повторить все эти три шага несколько раз для лучшего запоминания: регистрация, создание, цикл обработки сообщений. А теперь еще раз: регистрация, создание, цикл обработки сообщений. Отлично! Теперь рассмотрим следующую метафору.
Функция Register аналогична всей бумажной волоките, сопутствующей покупке автомобиля. Вы обсуждаете с дилером конкретный класс машины, которую желали бы купить. Вы говорите ему, что хотите “вольво” с механической коробкой передач или “мерседес” с автоматической. Это функция Register. С другой стороны, функция Create подобна встрече с конкретной машиной. Вы открываете дверь, садитесь за руль и включаете зажигание. Теперь автомобиль офици- ально ваш. Вы купили эту конкретную машину — не класс машины, а конкретный экземпляр. Для завершения этой аналогии, вы можете представить, что цикл опроса сообщений и WndProc — это что-то вроде владения машиной и ухода за ней. Эта аналогия не лишена погрешностей, но вы можете опереться на нее для понима- ния последующего материала. Акт регистрации окна совершенно незнаком большинству программистов DOS. В мире DOS нет ничего похожего на то, что происходит с Windows-программой, когда та обращается к среде, говоря при этом: “Ладно, прежде чем появится мое основное окно, я хочу зарегистрировать его так, чтобы вы знали, каков его класс и все такое”. Возвращаясь к аналогии с покупкой автомобиля, можно сказать, что процедура Register напоминает размышления о типе автомобиля, который вы желали бы купить. Вы говорите: “Я хочу купить автомобиль такого-то класса. Я хочу полноприводную “тойоту” или, например, “шевроле” с кондиционером”. Вы говорите не о конкретном экземпляре машины, а об общем ее типе и особенностях, которые хотели бы в ней иметь. Точно так же вы размышляете о том, какую пиктограмму хотите нарисовать, какое желаете иметь меню, каков будет цвет окна и как его назвать. Таким образом, процедура Register позволяет вам зарегистрировать класс окна, которым вы хотите пользоваться. Действительное же окно, которое вы создадите, указывается в процедуре CreateWindow. Замечание. Существование процедуры Register подразумевает, что окно представляет собой отдельную сущность, у которой есть попечитель (сама программа), общающийся с Windows (операционной средой). После того как окно надлежащим образом зарегистрировано, следующий шаг состоит в том, чтобы создать его, т.е. придать ему бытие. В течение этого процесса определяются форма, заголовок и стиль окна. Окно появляется на свет, и программа устанавливает над ним контроль. Это аналогично покупке автомобиля. Вы подписываете бумаги и становитесь вла- дельцем конкретной машины. Теперь вы можете сесть за руль и отогнать ее на приличное расстояние. Так и программа владеет окном и отвечает за его будущее. Вы уже говорите не о классе автомобиля вообще, а о конкретной машине. Заметьте, что программа WinMain имеет ряд условий if, которые должны быть проверены. Если некоторые из них нарушаются, то функция вернет значение FALSE и окно не будет создано. Словом, если обращение к Register или Create оказывается неудачным, функция WinMain немедленно прекращается. Это аналогично тому, что ваша сделка с продавцом автомобиля сорвалась и вы ушли без покупки. В тех редких случаях, когда это происходит, приложение быстро и без лишнего шума завершается. Операторы if также гарантируют, что если подобное приложение уже существует, то класс окна не будет зарегистрирован вторично. Другими словами, если вы идете покупать вторую машину того же самого типа, вам уже не нужно обсуждать тип автомобиля и его особенности. Вы переходите непосредственно к функции Create — этапу, на котором вы покупаете конкретное окно. Не старайтесь точно понять, как работают эти операторы if. Они будут обсуждаться на более глубоком уровне далее. Последний шаг WinMain — вход в цикл сообщения. Продолжая аналогию с автомо- билем, можно представлять себе цикл сообщения и WndProc как руль и приборный щиток вновь купленного автомрбиля. Водитель видит все входящие сообщения и соответственно выбирает курс. Чтобы полностью разобраться с циклом сообщения WndProc, следует понять, что Windows является в некоторой степени объектно-ориентированной системой. Это озна-
53 чает, что она существует сама по себе точно так же, как существует сам по себе автомобиль. Каждое окно может рассматриваться как автономный объект. Таким образом, они не управляются непосредственно главной программой или операционной системой. Операционная система может только посылать сообщение окну, а окно уже само решает, что делать с этими сообщениями. Точнее сказать, программист учит окно, как отвечать на получаемые сообщения. Может оказаться полезным следующий пример, с которым большинство читателей должно быть знакомо. В конце дня мы обычно закрываем менеджер программ или какой-либо его заменитель, как будто закрывая окна на ночь. Когда это происходит, всем окнам, находящимся на рабочем столе, посылается сообщение, как бы спрашиваю- щее их, готовы ли они закрыться. Конкретнее, сообщение посылается в цикл опроса сообщений, который затем передает его в WndProc, или поступает в процедуру WndProc непосредственно. А та уже решает, что делать с этим сообщением. Часто WndProc отвечает: “Подождите, я не готова. Один файл еще не был сохранен.” Затем WndProc высвечивает окно, спрашивая, нужно ли сохранить этот файл. Если да, то WndProc сохраняет его и сообщает операционной системе, что готова к завершению. Весь этот процесс наглядно показан на рисунке 3.3. Borland C + + ?WIND0W1.CPP has been changed. Save file before closing? Рис. 3.3. Программа обращается к пользователю с вопросом В течение этого процесса окно действует в основном как автономный объект со своей собственной жизнью. Оно знает достаточно, чтобы сообщить менеджеру программ, что что-то должно быть сделано и даже может связаться с пользователем и потребовать, чтобы какие-то концы были подобраны, прежде чем произойдет что-нибудь еще. Это суть объектно-ориентированного поведения. Не забывайте регистрировать класс окна, когда оно в первый раз появляется на экране. При регистрации окна операционная система информируется о некоторых характерных чертах соответствующего класса. Например, она узнает следующие характеристики. — имя класса окна, — пиктограмма окна, — форма курсора, ассоциированного с окном, — фоновый цвет этого окна, — имя меню, ассоциированного с этим окном. Не забывайте создавать окно, как только обращаетесь к WinMain. При вызове CreateWindow вы можете определить заголовок и размеры окна, а также выполнить другие начальные шаги. Не забывайте должным образом организовывать цикл опроса сообщений. Эго кресло водителя, с которого окно может видеть остальной мир. Окно без цикла сообщений — все равно что автомобиль без окон. Окно не узнает, что происходит вокруг, если у него нет цикла опроса сообщений. В результате оно наверняка попадет в аварию, как автомобиль, ведомый слепым водителем.
Вызов WinMain В этом разделе дается крупный план WinMain — точки входа в программу. Начнем с повторного рассмотрения заголовка функции WinMain: 32: int PASCAL WinMain (HINSTANCE hlnst, HINSTANCE hPrevInstance, 33: LPSTR IpszCmdParam, intnCmdShow) Многое еще предстоит сказать о четырех параметрах, передаваемых WinMain, хотя мы и приводили их краткий обзор в первой главе. Прежде чем перейти к деталям, вкратце повторим пройденное. Первый параметр представляет собой уникальное число, идентифицирующее про- грамму. Второй параметр — уникальное число, ассоциированное с предыдущими экземпля- рами этой программы. Если на рабочем столе таковых не имеется, этот параметр устанавливается равным NULL. Третий параметр — цепочка символов, содержащая любую информацию, передаю- щуюся из командной строки. И Четвертый параметр характеризует вид, в котором программа должна появляться на экране: минимизированной, максимизированной или подразумевающейся по умол- чанию. Первый и второй параметры, передаваемые WinMain, объявляются как тип HIN- STANCE. Тип HINSTANCE — не что иное, как дескриптор, или уникальное число, которое Windows использует для идентификации конкретного предмета на рабочем столе. То же самое происходит в DOS, когда операционная система назначает дескриптор каждому открытому файлу. Первый параметр, передаваемый приложению, идентифицирует его текущий экзем- пляр. Второй параметр идентифицирует предыдущий экземпляр, если таковой существует. Каждый из этих экземпляров — не более чем уникальное число, назначенное конкрет- ному объекту для идентификации. Дело в том, что Windows — многозадачная операционная система, которая может поддерживать более одной копии программы одновременно. Следовательно, любая Windows-программа первым делом должна назначить число, ассоциированное с ее текущим экземпляром, и наличие предыдущих копий этой программы. Если таких копий не существует, hPrevInstance полагается равным NULL. Таким образом, можно проверить, есть ли у программы какие-либо двойники. Это делается следующим способом. if(hPrevInstance) DoSomething(); Если программист хочет, чтобы выполнялась только одна копия программы, нужно исключить возможность создания другой копии с помощью следующего фрагмента: if(hPrevInstance) return FALSE; Разумеется, в этом случае может получиться так, что ваши пользователи потратят много времени, щелкая мышью на пиктограмме вашего приложения и удивляясь, что ничего не происходит. Поэтому неплохо было бы вывести окно сообщения, объясняю- щее ситуацию, прежде чем возвращать NULL: if(hPrevInstance) ( MessageBox(0, "Разрешена только одна копия", " Запомните", МВ_ОК); return FALSE; ) Ранее я упомянул, что фирма Microsoft изобрела тип HINSTANCE, чтобы способст- вовать написанию легко читаемых программ со строгой проверкой типов, помогающей избегать ошибок по невнимательности. Однако существует и другая причина создания
этого типа. Эта вторая причина касается создания легко переносимого на различные архитектуры кода. Дело в том, что фирма Microsoft хотела быть уверенной, что код WinMain будет компилироваться даже в таких операционных системах, где тип integer определяется не так, как на 16-битной машине. Поэтому были выбраны типы, которые могут быть легко переопределены в новой операционной системе. Другими словами, int — правильный тип для HINSTANCE в обычной Windows, но не в Windows NT. Поэтому создатели Windows разработали систему, достаточно гибкую для того, чтобы позволить вам использовать один и тот же код в различных системах. Прежде чем продолжать, следует сказать о причудливой форме венгерской записи. Ее причудливость заключается в обычае предварять буквой имя переменной. Это делается для облегчения идентификации типа переменных. Другими словами, “h” в hPrevInstance показывает, что эта переменная имеет тип HINSTANCE или HANDLE. Подобным образом “п” в nCmdShow определяет целое значение. Это соглашение — характерный аспект традиционной Windows, который иногда имеет место в DOS. Хотя венгерская запись подчас может смутить новичков и ее значение в какой-то степени ослаблено появлением опции STRICT, она все-таки еще может быть полезным средством в руках осмотрительных ветеранов. Замечание. Интересна история возникновения имени этой записи. Идея ее принадлежит одному из лучших программистов Microsoft Чарльзу Симонии, который родился в Венгрии. Людей, работавших под его руководством в фирме Microsoft, всегда учили использовать это соглашение. Д ля них это выглядело вполне нормально. Однако все, кому приходилось иметь дело с проектами, выполненными под руководством Симонии, отмечали странный внешний вид этих программ, на что им каждый раз невозмутимо отвечали, что программы выглядят так странно потому, что написаны по-венгерски. Я пользуюсь этим соглашением потому, что сейчас, хорошо это или плохо, оно является частью устоявшихся традиций программирования в Windows. Я оставляю на ваше усмотрение решить, какой вы ее находите. Следующая часто приводимая карта (см. табл. 3.1) поможет вам проложить путь по венгерским просторам. Таблица 3.1 Определения типов Windows из WINDOWS.H Префикс Тип Тип в Windows Ь Булевский BOOL by Однобайтовое беззнаковое целое BYTE с Символ dw Четырехбайтовое беззнаковое целое DWORD fn Функция h Целое без знака (UINT) HANDLE i Целое 1 Длинное целое LONG Ip Длинный указатель n int или short s Строка sz ASCIIZ-строка w Беззнаковое целое WORD Обратите внимание на третью колонку. Она знакомит вас с различными новыми типами, которые часто используются в Windows-программах. Они служат той же цели,
что и тип HINSTANCE. Пусть вас не смущает их присутствие в исходном коде. В них нет ничего запутанного или сложного. В своем простейшем воплощении они представ- ляют собой просто новые имена тех же самых старых типов, которые программисты на Си использовали годами. Однако, когда определяется STRICT, они часто преобразуются в указатели. WINDOWS.H Запомните, что предком всех справочных руководств является файл WINDOWS.H, который упоминается в начале каждой Windows-программы. Внутри WINDOWS.H вы найдете объявления и определения большинства функций и типов среды Windows. Ниже приводятся особенно важные фрагменты WINDOWS.H, которые содержат определения, задаваемые вручную. /** Простые типы и вспомогательные макросы **/ typedef int BOOL ; #define FALSE 0 #define TRUE 1 typedef unsigned char BYTE; typedef unsigned short WORD; typedef unsigned long DWORD; typedef unsigned int #ifdef STRICT DINT; typedef #else fldefine liendif signed long LONG long LONG; ^define LOBYTE(w) ((BYTE)(w)) #define HIBYTE(w) ( (BYTE) ( (UINT) (w) » 8) ) #define LOWORD(l) ( (WORD) (1) ) #define HIWORD(l) ( (WORD) ( (DWORD) (1) » 16) ) Изучение этого кода поможет прояснить ряд интересных аспектов программирования под Windows. WINDOWS.H — это место, где объясняются многие таинства. После изучения таблицы венгерской записи вы, наверное, почувствовали, что лучше понимаете третий параметр, передаваемый WinMain. Странный префикс перед иденти- фикатором IpszCmdParam предназначен для идентификации этого параметра как длин- ного указателя ASCIIZ-строки, в данном случае содержащей параметры, передаваемые программе на старте. Последний параметр WinMain позволяет определить, должна ли программа начи- наться в максимизированном, минимизированном или нормальном состоянии. Мы встречали эту константу при использовании WinExec в первый день. Когда ncmdShow установлено равным SW_SHOWMAXIMIZED, основное окно про- граммы появляется в максимизированном виде. SW_SHOWM1NIMIZED соответствует минимизированному виду, а по умолчанию назначается SW SHOWNORMAL. Последняя важная часть заголовка WinMain, которая еще не обсуждалась, — это использование слова CALLBACK. В былые дни вместо него использовались слова FAR PASCAL. Новое слово было выбрано, чтобы обеспечить совместимость с операционны- ми системами вроде Windows NT, где не используется слово FAR. (Не используется слово FAR! Какая замечательная славная мысль!) Все процедуры, помеченные как CALLBACK, автоматически объявляются исполь- зующими соглашение о вызовах языка PASCAL. Это означает, что когда параметры передаются в эти процедуры, они помещаются в стек, начиная с левого и кончая самым правым. В программах на традиционном Си все происходит наоборот. Но Windows использует соглашение о вызовах языка PASCAL потому, что так быстрее. В последних нескольких абзацах был рассмотрен ряд новых соглашений, но за всем этим синтаксическим сиропом лежат одни и те же, давно известные программистам на
Си, старые типы. Если хотите, то можете даже думать, что заголовок WinMain на самом деле выглядит как-то так: int WinMain(int Instance, int Prevlnstance, char far* CmdParam, int CmdShow) Если это способствует лучшему пониманию, можете представить себе, что WinMain объявляется таким простым образом. Все остальное — это просто карнавал. Удивляйте друзей, ставьте в тупик своих врагов, присоединяйтесь — это здорово. Регистрация Рассмотрим грозную функцию Register: 56: BOOL Register(HINSTANCE hlnst) 57: ( 58: WNDCLASS WndClass; 59: 60: WndClass.style 61: WndClass.IpfnWndProc 62: WndClass.cbClsExtra 63: WndClass.cbWndExtra 64: WndClass.hlnstance 65: WndClass.hlcon 66: WndClas s.hCursor 67: WndClas s.hbrBackground 68: WndClass.IpszMenuName 69: WndClass.IpszClassName 70: = CS_HREDRAW I CS_VREDRAW; = WndProc; = 0; = 0; = hlnst; = Loadicon(NULL, IDI_APPLICATION) = Load Cursor(NULL, IDC_ARROW); = GetStockBrush(WHITEBRUSH); = NULL; = szAppName; 71: return Registerclass(SWndClass); 72: ) Этот фрагмент знакомит вас с одной из великих традиций Windows, а именно с наличием структур и объявлений столь многочисленных и сложных, что они могут вызвать дрожь у всех, кроме разве что самых решительных. К счастью, эти структуры имеют тенденцию терять свои ужасы, если у вас есть хорошее справочное руководство или интерактивная система подсказок. Когда-нибудь вам, может быть, захочется запомнить все поля структуры WNDCLASS, однако нет необходимости делать это немедленно. Было бы лучше посвятить время исследованию справочных руководств или интерактивных файлов помощи, в которых есть информация об этой структуре. Полезную дополнительную информацию о струк- туре WNDCLASS можно также получить, потратив несколько минут на внимательное чтение WINDOWS.H. typedef struct ( UINT WNDPROC int int HINSTANCE HICON HCURSOR HBRUSH LPCSTR LPCSTR ) WNDCLASS; tagWNDCLASS style; IpfnWndProc; cbClsExtra; cbWndExtra; hlnstance; hlcon; hCursor; hbrBackground; IpszMenuName; IpszClassName; Структура WNDCLASS лежит в основе всех процедур Register. Как я уже говорил, выполнение процедуры Register сродни процессу выбора удобств, которые вы бы хотели иметь в своем новом автомобиле. Теперь можете посмотреть, какие именно опции доступны вам при регистрации окна. style. Изменяя это поле, вы можете радикально изменять внешний вид окна. Эта тема обсуждается в главе 14. WndProc. Используется для указания имени и адреса оконной процедуры. cbClsExtra, cbWndExtra. Существуют ли еше какие-либо другие дополнительные данные, которые должны быть ассоциированы с классом окна или копией приложе-
ния? Пока что вы можете не беспокоиться об этих двух полях, они подробно обсуждаются в главе 14. hlnstance. Уникальный дескриптор приложения. hlcon. Пиктограмма окна, если таковая существует. hCursor. Форма курсора окна, если таковой имеется. hbrBackground. Цвет окна. IpszMenuName. Меню окна. IpszClassName. Имя класса окна. В WINDOW1 .СРР поле стиля принимает значения CSHREDRAW и CS_VREDRAW (строчка 60). Эти две константы определяют, что окно перерисовывается, как только изменится его вертикальный или горизонтальный размеры. Наличие этих двух констант гарантирует, что содержимое окна всегда отчетливо видно пользователю. Применяйте правильный способ назначения окну нескольких стилей одновременно посредством объединения их с помощью логического ИЛИ, обозначающегося символом |. Не пытайтесь комбинировать два оконных стиля с помощью операторов & и +. Следующий этап — определить процедуру окна. Допустим, в неком исходном коде объявляется, что WndProc возвращает значение типа long. Если вы определите этот код как STRICT, то из-за строгой проверки типов будете вынуждены произвести приведение типа. WndClass.IpfnWndProc = (WNDPROC)WndProc; Этого можно избежать если объявить, что WndProc возвращает значение типа LRESULT: WndClass.IpfnWndProc = WndProc; Если не использовать STRICT, этот код скорее всего будет компилироваться на большинстве компиляторов стандартного Си, даже если вы объявите, что WndProc возвращает тип long. Разумеется, типичная Windows-программа не пойдет далеко, если не назначить оконную процедуру в поле IpfnWndProc. Не важно, какой путь для этого вы изберете, важно лишь, чтобы это назначение было как-нибудь организовано. Прием, которым вы пользуетесь, совсем не так значителен, как сам результат! Следующие два поля структуры WNDCLASS не представляют важности на данном этапе. CbClsExtra и cbWndExtra просто дают вам возможность зарезервировать некоторое количество памяти для хранения информации, касающейся вашего окна. Пока что нет нужды волноваться о столь таинственных тонкостях проектирования. Следующий шаг — присвоить полю hlnstance дескриптор вашего приложения. Этот процесс довольно прост; WndClass.hlnstance = hlnst; Поля hlcon, hCursor, hbrBackground, IpszMenuName описывают обычные возможнос- ти окна. Мы еще вернемся к ним позже, а теперь вам, наверное, хочется провести несколько экспериментов, просто чтобы понять, что происходит. Например, вместо назначения IDI_APPLICATION в качестве пиктограммы, попробуйте назначить IDI_EXCLAMATION или IDI_HAND: WndClass. hlcon = Loadicon (NULL, IDI__HAND) ; После того как запустите свое приложение, минимизируйте его, и вы увидите, что оно имеет другую пиктограмму. Можете проделать тот же трюк с курсором, подставляя IDC WAIT, IDC_CROSS или IDCJBEAM вместо IDCARROW: WndClass.hCursor =* LoadCursor(NULL, IDC_CROSS);
Если вы возьмете в качестве основного курсора пиктограмму IDC_WAIT, то увидите знакомый символ песочных часов (рис. 3.4). Лично я был в замешательстве, впервые столкнувшись с этой ситуацией. Обычно песочные часы появляются, только когда Windows просит пользователя подождать. В результате я всегда смущался, видя его на экране, даже когда знал, что он появляется только по моей прихоти. с Window 1 Рис. 3.4. Окно, использующее курсор в виде песочных часов Простые на вид эксперименты, подобные этому, помогают показать, насколько мощными могут быть пиктограммы и прочая символика. Человеческий мозг легко взаимодействует с символами любых типов. Научитесь использовать это преимущество. Или можете просто поиграть с пиктограммами и курсорами, чтобы увидеть, какие неожиданные эффекты можно получать. Теперь вы программист и можете заставить Windows сходить с ума, как вам вздумается. Если вы во всем похожи на меня, то, вероятно, получите удовольствие от маленького и приятного озорства. Если захотите изменить цвет фона окна, просто подставьте BLACK BRUSH или GRAY_BRUSH вместо WHITE_BRUSH. Помните, что все эти константы определяются в WINDOWS.H и детально перечисляются в любом хорошем справочнике. Еще не время заниматься меню, но поле IpszClassName требует некоторого поясне- ния. Это поле позволяет вам присвоить имя вашему окну. Это очень важное действие, поскольку под этим именем ваше окно будет регистрироваться. Имя класса чем-то напоминает ключ от автомобиля. Без него вы не сможете сесть за руль и завести двигатель. Иначе говоря, прежде чем создать окно, его нужно зарегистрировать под конкретным именем. Пожелав создать окно, вы будете беспомощны, если у вас нет ключей, то есть, если вы не знаете имени класса. На этом этапе не требуется дальнейшего обсуждения структуры WNDCLASS. Един- ственное, что осталось сделать, — сообщить эту информацию Windows, вызвав Register- Class и передав адрес структуры WNDCLASS: return Registerclass (&WndClass); Надеюсь, что вы запомните следующие два основных момента этого раздела: Процедура Register служит для определения класса окна, которое должно появиться на экране. Все окна — объекты, и каждый объект имеет набор характерных черт. Заполняя структуру WNDCLASS, программист говорит Windows, как он хочет определить конкретный объект, или класс. И Чаще всего вам вообще не нужно думать о методе регистрации. Просто скопируйте Register в вашу программу и вызывайте эту функцию, даже не думая о ее содержимом. Во многих случаях прекрасно работают показанные ранее установки по умолчанию. Функция Register не является чем-то таким, о чем следует заботиться всякий раз, когда вы программируете; это ряд доступных вам возможностей.
Создание окна Пора обсудить подпрограмму Create. Помните, что это часть программы, в которой вы определяете конкретное окно. Процедура Register определяет общий класс окна, а процедура Create — конкретный экземпляр класса окна. 77: HWND Create(HINSTANCE hlnstance, int nCmdShow) 78: { 79: HWND hWindow = CreateWindow(szAppName, szAppName, 8 0: WS_OVERLAPPEDWINDOW, 81: CW_ USEDEFAULT, CW__US EDEFAULT 82: CW_US EDEFAULT, CW_USEDEFAULT, 83: NULL, NULL, hlnstance, NULL); 84: 85: if (hWindow == NULL) 86: return hWindow; 87: 88: Showwindow(hWindow, nCmdShow); 89: UpdateWindow(hWindow); 90: 91: return hWindow; 92: ) Суть этой функции — обращение к CreateWindow, зависящей от 11 параметров, ни один из которых не следует воспринимать слишком серьезно на данном этапе: LPCSTR ipszClassName; LPCSTR IpszWindowName; (адрес зарегистрированного имени класса) (адрес текста окна) DWORD dwStyle; int x; int y; int nwidth; (стиль окна) (горизонтальные координаты окна) (вертикальные координаты окна) (ширина окна) int nHeight; HWND hwndParent; (высота окна) (дескриптор предка окна) HMENU hmenu; (дескриптор меню дочернего окна) HINSTANCE hinst; (дескриптор экземпляра приложения) void FAR* IpvParam; (адрес оконных данных) Ясно, что у этой функции достаточно аргументов — на то и щука в море, чтобы карась не дремал! Некоторые из них можно изменить, чтобы добиться относительных упроще- ний в вашей программе. Например, если вы вызовите CreateWindow (со следующими параметрами), то получите окно, показанное на рис. 3.5. HWND hWindow = CreateWindow(szAppName, "Tiny Window", WS_OVERLAPPEDWINDOW, 1, 1, 100, 100, NULL, NULL, hlnstance, NULL); EjTiny Рис. 3.5. Windowl после некоторых изменений в параметрах CreateWindow
Этот пример демонстрирует, как с помощью второго параметра, передающегося в CreateWindow, определяется заголовок окна, в то время как с четвертого по седьмой параметры задают его начальную форму. Константа CW USEDEFAULT предписывает Windows самой выбрать координаты окна. Первый параметр, передаваемый в CreateWindow, — имя класса. Помните, что каждое окно на рабочей поверхности представляет собой отдельную сущность с некоторой степенью автономности. Поэтому окна должны иметь имена, по которым их можно идентифицировать. Обычно имя основного окна программы является также и именем самого приложения, но это не обязательно. Остальные параметры CreateWindow обсуждаются в начале второй недели при детальном рассмотрении регистрации и создания окон. Замечание. Пусть вас не смущает, что я галопом пробежался по параметрам CreateWindow. Windows — не сложная среда, но она переполнена деталями. Пытаясь избежать наваливания на вас слишком большого объема материала и информации, которая пока не особенно уместна, я акцентирую лишь то, что важно на данном конкретном этапе. Прежде чем перейти к краткому обсуждению оконной процедуры и цикла опроса сообщений, рассмотрим две функции, обусловливающие появление полностью офор- мленного окна на экране: ShowWindow(hWindow, nCmdShow); UpdateWindow(hWindow); Функция ShowWindow посылает в Windows команду nCmdShow, вынуждая ее таким образом визуально отобразить окно в определенном состоянии, то есть минимизирован- ном, максимизированном или нормальном. UpdateWindow предписывает Windows по- слать сообщение WM PAINT окну, только что появившемуся на экране. Детальное объяснение этого процесса будет включено в следующую главу. Сейчас вам нужно знать только то, что и ShowWindow, и UpdateWindow имеют параметр hWindow. В данном случае hWindow фактически является дескриптором основного окна приложения. Дело в том, что на рабочем столе можно открыть несколько окон одновременно, но текущая цель — показать только что созданное окно. Следова- тельно, необходимо передать дескриптор этого окна, чтобы Windows знала, какой объект требуется показать. Круговерть Оставшаяся часть процедуры WinMain выглядит следующим образом: 44: while (GetMessage(SMsg, NULL, 0, 0)) 45: ( 46: TranslateMessage(SMsg); 47: DispatchMessage(SMsg); 48: } Вы уже достаточно знаете, чтобы понять назначение приведенных выше строк. Основной момент, о котором нужно помнить, состоит в том, что в течение жизни приложения Windows посылает ему сообщения о действиях, предпринимаемых пользо- вателем или остальными частями среды. Эти сообщения помещаются в очередь, куда функция GetMessage при желании может заглянуть. Когда сообщение выбирается из очереди, оно помещается в структуру, которая выглядит следующим образом. typedef struct tagMSG ( HWND hwnd; UINT message; WPARAM wParam; LPARAM IParam; DWORD time; POINT pt; } MSG;
Сейчас нет нужды исследовать эту структуру на глубоком уровне, хотя можете быть уверены, что я вернусь к ней снова (в следующей главе и кое-где еще). После того как сообщение взято из очереди сообщений, оно передается в Translate- Message, где соответствующая обработка помогает сделать его понятнее. Например, если нажимается функциональная клавиша, сообщение сначала помещается в очередь в довольно абстрактной форме. Функция TranslateMessage делает его гораздо легче для понимания. Затем функция DispatchMessage передает сообщение в специальную оконную проце- дуру, которой в данном случае является WndProc. После того как сообщение передано, снова вызывается функция GetMessage, чтобы взять из очереди другое сообщение, если таковое имеется. Важно понимать, что этот или подобный ему цикл постоянно выполняется в течение всей жизни приложения. Этот процесс никогда не останавливается. Он составляет суть любой Windows-программы. Таким образом, он требует глубокого анализа и поэтому, как легко заметить, рассматривается снова и снова во всей книге. Оконная процедура Цикл опроса сообщений постоянно бегает по кругу. Этот процесс без конца повто- ряется в течение большей части жизни типичной Windows-программы. Сначала сооб- щения поступают из операционной среды, а затем передаются в WndProc: #define Windowl_DefProc DefWindowProc void Windowl_OnDestroy(HWND hwnd); // Оконная процедура управляет ходом программы LRESULT CALLBACK __export WndProc(HWND hWindow, UINT Message, WPARAM wParam, LPARAM IParam) ( switch(Message) ( HANDLE MSG (hWindow, WM_DESTROY, Windowl_OnDestroy); default: return Windowl_DefProc(hWindow, Message, wParam, IParam); ) ) // Эта подпрограмма вызывается, когда окно должно закрыться #pragma argsused void Windowl_OnDestroy(HWND hwnd) ( PostQuitMessage(0); ) Обычно это означает, что сообщения переходят в оконную процедуру, где они обрабатываются индивидуально. Оттуда они могут быть переданы оконной процедуре обработки сообщений по умолчанию — DefWindowProc. DefWindowProc умеет отрабатывать по умолчанию почти все виды поведения, ассо- циированные с конкретным типом окна. Например, она знает, как обрабатывать действия мышью, минимизирующие или максимизирующие окно, равно как и действия, растягивающие или сжимающие окно. Задумайтесь на минутку над этим последним предложением. Оно говорит о том, что одна функция обрабатывает все виды движений мыши и знает, как изменять форму окна. Этот один простой вызов способен на многое: default: return Windowl_DefProc(hWindow, Message, wParam, IParam); С одной стороны, эта строчка может показаться немного длинной и запутанной. Впрочем, если вы вспомните, сколь многим ей обязана программа, она уже не покажется столь сложной. Аналогичная процедура в DOS заняла бы сотни, если не тысячи строчек кода. Windows же позволяет сделать это одной строкой. Где некоторые видят сложность, я вижу мириады возможностей.
Замечание. В этой книге DefWindowProc обычно включается в макрос, имеющий составное имя (имя основного окна программы + DefProc = Windowl_DefProc). Непосредственно перед обращением к этому макросу стоит макрос HANDLE MSG, определенный в WINDOWSX.H. HANDLE_MSG осуществляет синтаксический анализ параметров, ассоциированных с любым сообщением, и передает их в отдельную функцию вроде Window l_OnDestroy. Без макросов из WINDOWSX большинство процедур WndProc погрязло бы в трясине операторов switch. Такие чрезвычайно важные предметы, как WINDOWSX.H и взломщики сообщений детально обсуж- даются в следующей главе. Замечание. Важно, чтобы вы не боялись WINDOWS.H и WINDOWSX.H. Эти файлы представ- ляют собой библию программирования под Windows. Впрочем, WINDOWSX.H — это относи- тельно недавнее добавление. В нем содержится ряд украшений и экономящих время улучшений, не являющихся, однако, очень существенными для большинства программ. Тем не менее WINDOWSX.H может оказаться чрезвычайно важным файлом, способным спасти для вас часы, дни или даже недели работы. Как уже упоминалось, файл WINDOWSX. Н разбирается более детально в следующей главе. Будьте уверены, что вы еще не раз прочитаете о нем. И WINDOWS.H, и WINDOWSX.H — существенные части структуры этой книги. Я постоянно обсуждаю эти файлы и ссылаюсь на них почти в каждой главе. Прежде чем будет вызвана оконная процедура обработки сообщений по умолчанию, WndProc может сама ответить на большинство из них. WINDOW.CPP — пример минимальной программы для Windows, поэтому здесь необходимо ответить только на сообщение, говорящее о том, что главное окно собирается закрыться. Макрос HAN- DLE_MSG анализирует параметры, передающиеся в WndProc, и посылает лишь необ- ходимые из них в функцию Windowl OnDestroy. void Windowl_OnDestroy(HWND hwnd) { PostQuitMessage(0); ) В одно и то же время окно могут бомбардировать много различных сообщений. Например, сообщение WM_PAINT говорит окну, что ему пора перерисоваться. Другие — например, WM_MOUSEMOVE — сообщают о том, что мышь перемещается в таком-то направлении. Остальные сообщения говорят окну о происходящей минимизации, мак- симизации, изменении размеров, пульверизации и т.д. Правда, на самом деле не существует сообщения WM_PULVERIZE, хотя оно и могло бы быть — так много сообщений влетают в процедуру WndProc и вылетают обратно в течение жизни типич- ного окна. Я посвятил достаточно времени обсуждению WndProc и различным способам ее устройства. Однако теперь вы можете вновь повторить весь процесс, я только хочу познакомить вас с основными частями этой программы. Надеюсь, что вы можете воочию представить основные части программы для Windows: Во-первых, процедура WinMain, содержащая Register, Create и цикл опроса сообщений. И Далее, процедура WndProc, обрабатывающая любые сообщения, посылаемые окну. Эти две функции являются основой структуры программы. Если вы сможете понять, как работает эта система, то сможете почувствовать, как функционирует среда Windows. Резюме В этой главе мы детально рассмотрели самую суть программирования под Windows, исследовав образец приложения. WINDOW1.CPP демонстрирует многие из основных особенностей, постоянно затрагиваемых в книге. В частности, в этой главе показано, как Windows-программа начинается с вызова функций Register и Create и показа окна. В процессе этого вы прочитали о таких основных типах данных в Windows, как HINSTANCE и WORD. Кроме того, я обсудил цикл опроса сообщений и процедуру WndProc, которые обрабатывают поток сообщений, непрерывно посылаемых приложению.
Вопросы и ответы 1. Где можно прочитать о специальных типах, используемых в Windows-приложении? Существует несколько основных источников информации. Один из них — книга вроде этой. Остальные источники включают справочные книги и интерактивные систе- мы помощи. Вероятно, самым главным источником является файл WINDOWS. Н, сопровождающий ваш компилятор и включаемый в начале каждой Windows-программы. 2. Windows является ориентированной иа события (или иа сообщения) средой. Что это означает? В среде DOS пользователь обычно взаимодействует непосредственно с программой. Но в Windows действия пользователя сначала попадают в операционную систему, а затем пересылаются приложению в форме сообщений, или событий. Эта система дает Win- dows-приложениям род автономности и независимости (которого столь недоставало традиционной среде DOS). Вопросы для самопроверки 1. Что такое WNDCLASS? 2. Какова цель функции Register? 3. Какова цель функции Create? 4. Какова разница между ShowWindow и UpdateWindow? 5. Какова цель WndProc? 6. Какова цель цикла опроса сообщений? 7. Какова цель DefWindowProc? 8. Какой тип традиционного Си ассоциируется с WORD? 9. Какой тип традиционного Си ассоциируется с LONG? 10. Какой тип традиционного Си ассоциируется с LPSTR? Упражнения 1. Создайте программу, появляющуюся в максимизированном состоянии. 2. Создайте программу, использующую курсор в виде песочных часов, обычно говорящих о выполнении длительного процесса. 3. Создайте программу, обрывающуюся до обращения к функции Register. 4. Создайте программу со светло-серым фоном окна. 5. Создайте программу, отображающую ваше имя в заголовке основного окна.
День 4 СООБЩЕНИЯ, WINDOWSX И ОТОБРАЖЕНИЕ ТЕКСТА В этой главе освещаются два основных вопроса: И Как Windows обрабатывает сообщения, a WINDOWSX.H помогает облегчить этот процесс. Как отобразить текст на экране. Многие основные черты Windows обязаны своей спецификой тому факту, что она является ориентированной на события, или основанной на сообщениях системой. Если вы не разберетесь с сообщениями, то не поймете и Windows. Сегодня мы подробно рассмотрим оконную процедуру, посылаемые в нее сообщения и взломщики сообщений, которые помогут упростить Windows-программы. Представляемый материал в значитель- ной степени определяет суть Windows. В частности, в этой главе освещаются: Н Сообщения. WINDOWSX. Взломщики сообщений (message crackers). Н Обработчики сообщений. Ответы на сообщения WM PAINT. Контексты устройств. Два способа записи текста в окно. Что такое сообщение? В предыдущей главе был представлен беглый обзор стандартной Windows-программы с ее основными частями: функциями WinMain, Register, Create и WndProc, а также циклом сообщений. Следующий шаг — показать более крупным планом оконную процедуру и сообщения, посылаемые в нее. Сейчас вы должны чувствовать разницу между основанной на сообщениях (или управляемой событиями) и стандартной проце- дурной программами. В первом случае операционная система (операционная среда) сообщает программе, что произошло некоторое событие. Во втором — программа спрашивает систему, что именно произошло. М Основанная на сообщениях модель Windows. Как только программа запущена, она просто ждет, когда ей будут посланы сообщения, а затем соответственно реагирует. Со своей стороны, Windows распознает, была ли нажата клавиша или передвинута мышь. Когда события такого типа происходят, Windows посылает определенные
сообщения о том, что произошло. Программа обычно имеет опцию игнорирования • сообщения или ответа на него. М Процедурная модель DOS. Программа на Си++ обычно выполняется последовательно, то есть начинается с начала и продвигается к концу, выполняясь строчка за строчкой, с учетом циклов и ветвлений. Программа обнаруживает команды пользователя, запра- шивая систему. Это означает, что программа вызывает основанные на прерываниях подпрограммы, встроенные в операционную систему или в саму машину. Эти прерыва- ния и сообщают, была ли нажата клавиша или передвинута мышь. Если вы твердо уяснили концепцию сообщений, то не удивитесь, что на самом деле они представляют собой константы, определенные в WINDOWS.H. Например, ниже приведены объявления WINDOWS.H для сообщений, идентифицирующих движения мыши и нажатия клавиш. /* Сообщения клавиатуры */ «define ИМ KEYDOWN «define WM_KEYUP Itdefine HM_CHAR ltdefine HM_DEADCHAR «define WM_SYSKEYDOWN ltdefine HM_SYSKEYUP ltdefine WM_SYSCHAR «define WM_SYSDEADCHAR 0x0100 // Была нажата клавиша 0x0101 // Была отпущена клавиша 0x0102 // Обрабатывалось нажатие клавиши 0x0103 // Комбинированная клавиша 0x0104 // Была нажата клавиша Alt 0x0105 // Была отпущена клавиша Alt 0x0106 // Обрабатывалось нажатие системной клавиши 0x0107 // Комбинированная системная клавиша /* Сообщения мыши */ «define ИМ MOUSEMOVE «define HMJLBUTTONDOWN «define HMJLBUTTONUP «define HMJLBUTTONDBLCLK «define HM_RBUTTONDOWN «define HM_RBUTTONUP «define ИМ RBUTTONDBLCLK «define HM_MBUTTONDOWN «define ИМ MBUTTONUP «define WM MBUTTONDBLCLK 0x0200 // Была передвинута мышь 0x0201 // Была нажата левая кнопка 0x0202 // Была отпущена левая кнопка 0x0203 // Двойной щелчок левой кнопкой 0x0204 // Была нажата правая кнопка 0x0205 // Была отпущена правая кнопка 0x0206 // Двойной щелчок правой кнопкой 0x0207 // Была нажата средняя кнопка 0x0208 // Была отпущена средняя кнопка 0x0209 // Двойной щелчок средней кнопкой Не пытайтесь запомнить эти сообщения. Просто посмотрите на них и познакомьтесь с их внешним видом и назначением. Итак, ясно, что в сообщениях нет ничего особо таинственного. Эго просто константы с удобными именами, которые информируют программу о текущем состоянии системы. Когда происходит событие, сообщение связывается с другой полезной информацией и посылается в одну или сразу в несколько оконных процедур. Что конкретно должно затем быть сделано с сообщениями и есть тема данной главы. Замечание, следует заметить, что вам необязательно понимать, откуда сама Windows узнает о нажатии клавиш или о перемещениях мыши. Необходимо только помнить, что как только приходит сообщение с шестнадцатеричным номером 200, значит мышь была передвинута. Этот вид основанный на сообщениях системы дает высокую степень независимости от аппарат- ной части. Например, в архитектуре Intel обычно используется прерывание INT 33h, чтобы отметить движение мыши. Другая аппаратура может использовать совсем иные способы, но это не будет иметь значения для вас — Windows-программистов. Все, что нужно сделать, — это ответить на предварительно определенные сообщения. Ваша вторая полноценная Windows-программа Следующие несколько страниц этой главы посвящены трехшаговому процессу, показывающему, что именно WndProc делает с сообщениями. Первый шаг — запуск рабочего примера программы.- Второй шаг — обсуждение WINDOWSX и взломщиков сообщений, которое концент- рируется в основном на двух особенных сообщениях: WM DESTROY и WM CREATE. Третий шаг — беглый взгляд на то, как WINDOWSX обращается с оконной процедурой, обрабатывающей сообщения по умолчанию.
Замечание. Не беспокойтесь, если вам все еще не вполне ясно назначение WINDOWSX. Файл WINDOWSX и макросы, входящие в него, представляют очень широкую тему, которая не может быть легко усвоена всего за несколько минут. Вы должны приготовиться к тому, что ваши знания об этом сложном и чрезвычайно важном предмете будут расти постепенно. Сейчас вы должны быть довольны, если понимаете, что макросы, входящие в WINDOWSX, помогают упростить программирование в Windows и облегчить совместимость между 16-битным и 32-битным Windows-кодом. Подробности будут проясняться, по мере того как мы будем возвращаться вновь и вновь к этой интригующей теме. Некоторые из особенно важных аспектов WINDOWSX станут понятны вам уже к концу этой главы. Большая часть программы, которую я собираюсь показать вам, подобна исходному коду из предыдущей главы. Фактически большинство Windows-программ основывается на общем шаблоне, который мало меняется от программы к программе. Поэтому можно скопировать файлы, использовавшиеся при создании WINDOW1.EXE в новый подка- талог. Пройдитесь по этим файлам, изменяя слова Windowl на EasyText и переимено- вывая файлы WIND0W1.* в EASYTEXT.*. Чтобы выполнить это, дайте следующую DOS-команду: ren Windowl.* EasyText.* Используйте отлаженный исходный код в качестве основы для всех программ, которые вы пишете. Не пытайтесь начинать каждую Windows-программу с пустого места. Обозначенные выше шаги очень важны. Почти все, что вы напишете в Windows, будет основываться на компонентах, созданных в предыдущей главе. Иначе говоря, этот код очень хорошо приспособлен для повторного использования в новых программах. Как вы, возможно, знаете, идея повторно используемых фрагментов очень важна при современном подходе к программированию. При переходе от одного проекта к другому копируйте максимально возможное количество файлов. Но не пытайтесь копировать старые проектные или МАКЕ-файлы, предварительно не просмотрев их внимательно. В таких ситуациях часто возникают проблемы, потому что проект- ные и некоторые МАКЕ-файлы имеют тенденцию сохранять следы маршрутов файлов, добав- ляемых в проект. В результате, возможно, придется перестроить ваш проект при переносе его в другой подкаталог. Не совершите ошибку, перемещая файл в новый подкаталог и не измените случайно Windowl.cpp (или какую-нибудь другую часть исходной программы) просто потому, что она все еще упоминается в вашем проектном файле. Теперь, когда вы знаете, как начинать, посмотрите программу EasyText.cpp (лис- тинг 4.1) Поработайте с этой программой, чтобы быть в состоянии понять ее последую- щее обсуждение. Листинг 4.1. EASYTEXT.CPP 1: ////////////////////////////////////////////////// 2: // Наименование программы: EASYTEXT.CPP 3: // Автор: Чарли Калверт 4: // Описание: Демонстрация вывода простого текста 5: // Дата: 27 февраля 1993 г. 6: ////////////////////////////////////////////////// 7: 8: tfdefine STRICT 9: #include <windows.h> 10: tfinclude <windowsx.h> 11: tfinclude <string.h> 12: tfpragma warning (disable: 4068) 13: tfpragma warning (disable:4100) 14: 15: // ===^=====================-============ 16: // Интерфейс 17: // ========™=~=====================-===== 18: 19: // переменные 20: static char szAppName[j = "Easy Text";
68 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: 85: 86: 87: 88: 89: 90: 91: 92: 93: 94: 95: // Класс EasyText #define EasyText_DefProc DefWindowProc BOOL EasyText_OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct); void EasyText_OnDestroy(HWND hwnd); void Easy Text_OnPaint(HWND hwnd): // переменные char Directions[100]; static HWND MainWindow; static HINSTANCE hlnst; // функции LRESULT CALLBACK __export WndProc(HWND hwnd, UINT Message, WPARAM wParam, LPARAM IParam); BOOL Register(HINSTANCE hlnst); HWND Create(HINSTANCE hlnst, int nCmdShow); //--------===== 11 Инициализация //=----------=== //////////////////////////////////////////////////////////////// // Точка входа llllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllll ((pragma argsused int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrev Instance, LPSTR IpszCmdParam, int nCmdShow) ( MSG Msg; if (!hPrevInstance) if ((Register(hlnst)) return FALSE; if ((Create(hlnst, nCmdShow)) return FALSE ; while (GetMessage(SMsg, NULL, 0, 0)) ( TranslateMesSage(&Msg); DispatchMessage(&Msg); ) return Msg.wParam; ) IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIHIIHIIII II Регистрация окна //////////////////////////////////////////////////////////////// BOOL Register(HINSTANCE hlnst) ( WNDCLASS WndClass; WndClass.style WndClass.IpfnWndProc WndClass.cbClsExtra WndClass.cbWndExtra WndClass.hlnstance WndClass.hlcon WndClass.hCursor WndClass.hbrBackground WndClass.IpszMenuName WndClass.IpszClassName = CS-HREDRAW I CS_VREDRAW; = WndProc; = 0; = 0; = hlnst; = Load Icon(NULL, IDI_APPLICATION); = Load Cursor(NULL, IDC_ARROW); = Get Stock Brush (WHITE_BRUSH); = NULL; = szAppName; return Registerclass ((WndClass); ) IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIHIIIIIIIHIIIIIlllllllllllllllllll 11 Создание окна lllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllll HWND Create(HINSTANCE hlnstance, int nCmdShow) ( HWND hwnd = Create Window(szAppName, szAppName,
96: WS_OVERLAPPEDWINDOW, 97: CW_USEDEFAULT, CW—USEDEFAULT, 98: CW—USEDEFAULT, CW_USEDEFAULT, 99: NULL, NULL, hlnstance, NULL); 100: 101: if (hwnd == NULL) 102: return hwnd; 103:1 104: ShowWindow(hwnd, nCmdShow); 105: Update Window(hwnd); 106: 107: return hwnd; 108: ) 109: 110: // ---==============---=========== 111: // WndProc и реализация 112: // -----======---------============ 113: 114: /////////////////////////////////////// 115: // Оконная процедура 116: ////////,/////////////////////////////// 117: LRESULT CALLBACK __export WndProc(HWND hwnd, UINT Message, 118; WPARAM wParam, LPARAM IParam) 119: { 120: switch(Message) 121: ( 122: HANDLE_MSG(hwnd, WM_CREATE, EasyText_OnCreate); 123: HANDLE MSG (hwnd, WM_DESTROY, EasyText_OnDestroy); 124: HANDLE MSG (hwnd, WM_PAINT, EasyText_OnPaint); 125: default: 126: return EasyText—DefProc(hwnd. Message, wParam, IParam); 127: ) 128: ) 129: 130: llllllllllllllllllllllllllllllllllllllllllllllllllllllllllll 131: // Конструктор, обрабатывающий сообщение WM_CREATE 132: //////////////////////////////////////////////////////////// 133: ((pragma argsused 134: BOOL EasyText_OnCreate (HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) 135: ( 136: strcpy(Directions, "Try resizing this window."); 137: return TRUE; 138: ) 139: 140: //////////////////////////////////////////////////////////// 141: // Деструктор, обрабатывающий сообщение WM_DESTROY 142: //////////////////////////////////////////////////////////// 143: ((pragma argsused 144: void EasyText—OnDestroy(HWND hwnd) 145: ( 146: PostQuitMessage(O) ; 147: ) 148: 149: //////////////////////////////////////////////////////////// 150: // Обработчик сообщения WM_PAINT 151: // Демонстрирует использование TextOut и DrawText. 152: //////////////////////////////////////////////////////////// 153: void EasyText_OnPaint(HWND hwnd) 154: ( 155: PAINTSTRUCT PaintStruct; 156: RECT Rect; 157: 158: HDC PaintDC = BeginPaint(hwnd, «PaintStruct); 159: 160: TextOut(PaintDC, 10, 10, Directions, Istrlen(Directions)); 161: 162: GetClientRect(hwnd, SRect); 163: 164: DrawText(PaintDC, "The middle of the road", -1, SRect, 165: DT—SINGLELINE I DT_CENTER I DT_VCENTER) ; 166: 167: EndPaint(hwnd, «PaintStruct); 168: }
Листинг 4.2. EASYTEXT.DEF 1: ; EASYTEXT.DEF 2: 3: NAME EasyText 4: DESCRIPTION 'EasyText Window' 5: EXETYPE WINDOWS 6: STUB 'WINSTUB.EXE' 7: HEAPSIZE 4096 8: STACKSIZE 5120 9: CODE PRELOAD MOVEABLE DISCARDABLE 10: DATA PRELOAD MOVEABLE MULTIPLE Листинг 4.3. EASYTEXT.MAK (Borland) 1: # EASYTEXT.MAK 2: 3: # Макросы 4: APPNAME = EasyText 5: INCPATH = C:\BC\INCLUDE 6: LIBPATH = C:\BC\LIB 7: FLAGS = -H -ml -W -v -w4 -1$ (INCPATH) -L$ (LIBPATH) 8: 9: # Компоновка 10: $ (APPNAME) .exe: $ (APPNAME). obj $ (APPNAME) .def 11: bcc $ (FLAGS) $ (APPNAME). obj 12: 13: # Компиляция 14: $ (APPNAME) . obj : $ (APPNAME) . cpp 15: bcc —c $ (FLAGS) $ (APPNAME). cpp Листинг 4.4. EASYTEXT.MAK (Microsoft) 1: # EASYTEXT.MAK 2: 3: APPNAME = EasyText 4: 5: # linking 6: $ (APPNAME) .exe : $ (APPNAME) .obj $ (APPNAME) .def 7: link /CO S (APPNAME), /align: 16, NUL, /nod llibcew libw, $ (APPNAME) 8: 9: # compiling 10: $(APPNAME).obj : $(APPNAME).cpp 11: cl —c -AL -GA -OW -W4 -Zp -Zi $ (APPNAME). cpp Рис. 4.1. EASYTEXT.EXE отображает два текста: один в верхнем левом углу и второй в центре окна Вы могли заметить, что я добавляю различные псевдокомментарии в свои программы. Псевдокомментарии содержат специфическую компиляторную информацию. Напри- мер, я часто включаю следующую строчку: ttpragma argsused
Это говорит компилятору Borland, что нужно подавлять любые ошибочные сообще- ния о неиспользованных аргументах, передающихся в конкретную функцию. Другой часто используемый псевдокомментарий: #pragma warning (disable: 4068) Этот псевдокомментарий предписывает компилятору фирмы Microsoft игнорировать любые псевдокомментарии, которые он не понимает. Обычно, когда компилятор фирмы Microsoft встречает неизвестный псевдокомментарий, он информирует об этом пользо- вателя. Поскольку я предпочитаю не видеть этих предупреждений, то выключаю их с помощь вышеуказанной строчки. Третий псевдокомментарий, который можно иногда увидеть в моих программах, выглядит следующим образом: #pragma hdrstop Этот псевдокомментарий предписывает компилятору фирмы Borland прерывать перечень файлов, использовавшихся в заголовках. Например, WINDOWS.H и WIN- DOWSX. Н используется в прекомпилированном заголовке, a string.h и stdlib.h — нет. # include <windows.h> # include <windowsx.h> # pragma hdrstop # include <string.h> ttinclude <stdlib.h> Чаще всего вам не придется иметь дело с псевдокомментариями, включенными в эту программу. Все примеры этой книги будут компилироваться в один и тот же результи- рующий код независимо от того, включаются ли в них мои псевдокомментарий или нет. Единственная их цель — оптимизировать или сгладить ход компиляции. Они не оказывают абсолютно никакого эффекта на конечный сгенерированный код. Оператор switch, WINDOWSX и взломщики сообщений Самой очевидной новой особенностью этой программы является присутствие текста в рабочей части окна (client area). Прежде чем рассмотреть, каким образом текст рисуется на экране, важно понять механизмы, которые действуют в функции WndProc. 117: LRESULT CALLBACK_export WndProc(HWND hwnd, UINT Message, 118: WPARAM wParam, LPARAM IParam) 119: . ( 120: switch(Message) 121: { 122: HANDLE_MSG (hwnd, WM_CREATE, EasyText_OnCreate) ; 123: HANDLE_MSG(hwnd, WM_DESTROY, EasyText_OnDestroy) ; 124: HANDLE_MSG(hwnd, WM_PAINT, EasyText_OnPaint) ; 125: default: 126: return EasyText_DefProc(hwnd. Message, wParam, IParam); 127: ) 128: ) В прежние мрачные дни, до появления WINDOWSX. Н, оконная процедура могла превратиться в чрезвычайно грозного врага, с которым Windows-программисты должны были бороться изо дня в день. Источником неприятности был пресловутый оператор switch, который даже в программах средней сложности имел тенденцию разворачиваться на несколько страниц зубодробительного кода. Теперь, когда есть WINDOWSX. Н, оператор switch (строчка 120) все еще существует, но упрощается рядом взломщиков сообщений, которые эффективно нейтрализуют змею, затаившуюся в каждой оконной процедуре. Взломщики сообщений делают это, находя простой путь перемещения тела вашего ответа на сообщения из WndProc в функции, которые подчиняются основным правилам структурного программирования. Конечно, использование взломщиков сообщений не совсем тривиальный процесс, но я надеюсь, что вы найдете их гораздо более легкими в использовании, чем длинный оператор switch.
Замечание. Поскольку все еще существует множество старых программ, важно показать вам, как следует обращаться с оконными процедурами, которые состоят из единственного длинного оператора switch. Решение получается в форме диалоговых процедур, которые являются для диалоговых панелей тем же, чем оконная процедура для окна. По различным причинам (которые не стоит обсуждать именно сейчас) в этой книге вы не увидите, чтобы WINDOWSX.Н исполь- зовался в диалоговых процедурах. Большая побочная польза заключается в том, что диалоговые процедуры дают вам возможность изучить операторы switch старого стиля. Хотя в этой главе не представлена ни одна из этих диалоговых процедур, они часто появляются в последующих главах. При написании программы нужно найти время, чтобы сосредоточиться на сообще- ниях, которые явно обрабатываются внутри WndProc. EasyText содержит три таких сообщения: handle_MSG(hwnd, wm_CREATE, EasyText_OnCreate) ; HANDLE_MSG(hwnd, WM_DESTROY, EasyText_OnDestroy); HANDLE_MSG(hwnd, WM_PAINT, EasyText_OnPaint); Как легко заметить, это сообщения WM CREATE, WM DESTROY и WM PAINT. Скоро вы увидите, как взломщики сообщений обрабатывают не только эти, но и все стандартные сообщения интерфейса приложений. Читая это обсуждение, помните, что WINDOWSX помогает избавить вас от слож- ностей. К сожалению, чтобы объяснить, как работают взломщики сообщений, я должен погрузиться в самое сердце этих сложностей. Но после того как несколько основных идей прояснятся в вашем сознании, вы обнаружите, что взломщики сообщений облег- чают ваш труд. Замечание. Взломщики сообщений помогают вам использовать в WndProc стандартные приемы структурного программирования. Когда я впервые познакомился с этой техникой, она показалась мне немного сложной, однако с годами она избавила меня от многих утомительных дней болезненной отладки. То же самое верно в отношении взломщиков сообщений по многим подобным причинам. Прекрасно. Пора затянуть пояса и сконцентрировать внимание. В следующих не- скольких абзацах содержится добрая толика важной информации. Для начала вам необходимо знать, что сообщения WM_DESTROY посылаются в окно, когда оно собирается закрыться. Важно, чтобы вы не забывали обращаться в главном окне приложения к PostQuitMessage в ответ на сообщение WM_DESTROY. Если вы этого не сделаете, вы немедленно утонете в массе мелочей, из которой вам никогда не выбраться, пока наконец вы не проясните себе природу ошибки. Словом, если вы забудете вызвать PostQuitMessage, ваше приложение превратится в кашу. Предупреждение. Как правило, каждой программе в каком-то месте требуется обратиться к PostQuitMessage. Эта функция посылает в Windows сообщение WM QUIT, которое представляет собой сигнал прервать цикл сообщений и вернуться в WinMain. Другими словами, если не обратиться к PostQuitMessage, цикл сообщений будет продолжаться неопределенно долго. Следовательно, это обращение чрезвычайно важно для правильного завершения приложения. В EasyText вызов PostQuitMessage выполняется в функции EasyText_OnDestroy: 144: void EasyText_OnDestroy (HWND hwnd) 145: ( 146: PostQuitMessage(0); 147: } Если бы не использовался WINDOWSX, весь этот процесс выполнялся бы в WndProc с помощью операторов switch стандартного стиля: switch (Message) ( case WM_DESTROY: PostQuitMessage(0); break; case WM_PAINT: и т.д... )
Однако благодаря WINDOWSX программисты имеют возможность обработки сооб- щений WM_DESTROY в отдельной функции. Как я уже упоминал, весь этот процесс устраняет употребление бесконечных операторов switch, которые могут быть губитель- ными даже для лучших программ. Другое важное преимущество этого стиля можно увидеть, обратившись к самому WTNDOWSX.H. Там есть макросы взломщиков сообщений, которые служат для того, чтобы выбрать самые важные из многих параметров WndProc и передать их в функцию обработки сообщения. Суть в том, что каждое сообщение, посылаемое в окно, может сопровождаться дополнительной информацией, которая обычно заключается в форму параметров hwnd, wParam и IParam. В результате передачи сообщений с этими параметрами возникают две проблемы: 1. Не каждое сообщение использует все три эти параметра. Поэтому программистам постоянно приходится заглядывать в свои справочники, чтобы определить, какие именно из этих параметров используются конкретным сообщением. 2. Различные куски информации часто пакуются в один конкретный параметр. Например, программисту может понадобиться заглянуть в первое слово IParam, чтобы достать один кусок информации, и в первые два байта wParam, чтобы достать другие. После этого часто бывает нужно выполнить приведение типов, прежде чем данные можно будет использовать. WINDOWSX устраняет этот чреватый ошибками процесс с помощью механизма взломщиков сообщений. Очень важно, чтобы вы понимали, что делают для вас взлом- щики сообщений и почему они так полезны. Поэтому не спешите. Уделите время усвоению информации, представленной в нескольких последних абзацах. Вы узнали, что взломщики сообщений — это фактически ряд макросов, разработан- ных для разделения различных параметров, передаваемых в WndProc. Обычно взломщик состоит из двух частей. Первая часть обрабатывает само сообщение, а вторая может передавать его в DefWindowProc. Например, так выглядят макросы WINDOWSX для сообщений WM_DESTROY: /* void Cls_OnDestroy(HWND hwnd); */ «define HANDLE_WM DESTROY(hwnd, wParam, IParam, fn) \ ((fn)(hwnd), «define FORWARD_WM_DESTROY(hwnd, fn) \ (void)(fn)((hwnd), WM_DESTROY, 0, 0L) Объявление функций, связанных с сообщениями С la ss name_OnMess<a депате Комментарий в верхней части предыдущего фрагмента WINDOWSX показывает, как объявлять функцию, отвечающую на сообщения WM_DESTROY. Эти функции называются функциями-об- работчиками сообщения или иногда функциями отклика на сообщение. Соглашение об именовании функции-обработчика сообщения требует начинать с имени класса, затем вводить слово “on” и имя сообщения. Пример В EasyText имя функции отклика на WM_DESTROY выглядит следующим образом. EasyText_OnDestroy Определение макроса HANDLE_WM_DESTROY, вероятно, важнейшая часть этого фрагмента WINDOWSX. Здесь просеиваются передаваемые в WndProc параметры, и выбирается hwnd как самый важный в этом случае: ((fn)(hwnd), 0L) Цель этого макроса — обнулять важнейший параметр, передаваемый в WndProc. В данном случае ни IParam, ни wParam не содержат никакой полезной информации. В результате единственная полезная часть — это параметр hwnd, который передается взломщиком сообщения WM DESTROY.
Вторая половина взломщика сообщения называется FORWARD WM_DESTROY. Этот макрос используется, только если требуется передать сообщение в другую функцию, .такую, как оконная процедура, действующая по умолчанию, после того как вы уже обработали его. Чтобы эта часть процесса работала правильно, вставьте “умолчательную” оконную процедуру в макрос, содержащий имя класса, как объяснялось выше. Взломщик сообщения WM DESTROY хорошо подходит для начала исследования взломщиков сообщений, потому что он прост. Однако будет полезно взглянуть и на какой-нибудь более сложный макрос. К счастью, взломщик сообщения WMCREATE хорошо иллюстрирует, как можно использовать WINDOWSX для отбора более сложных макросов. Замечание. Сообщение WM CREATE является дополнением сообщения WM JDESTROY. Это сообщение посылается в основную оконную процедуру во время обращения к CreateWindow. В EasyText окликом на сообщение WMCREATE является инициализация символьной строки. Очевидно, я мог бы объявить эту строку как константу, избежав таким образом необходимости отвечать на сообщение WM CREATE. Однако я решил сделать это по-другому, чтобы показать, как работают сообщения WM_CREATE. Явно обрабатывая сообщения WM_CREATE или WM DESTROY, я всегда стараюсь сделать это в самом начале оконной процедуры. Таким образом, читатели моей программы могут легко обнаружить место, где выполняется инициализация (WM CREATE) и завершение (WM_DE- STROY). Из последующих примеров станет ясно, почему эти два процесса так важны. А пока вам необходимо запомнить, что я предпочитаю обрабатывать сначала эти две вещи, а затем все остальные сообщения в алфавитном порядке. Ниже приводится взломщик сообщения WM_CREATE из WINDOWSX: /* BOOL Cls_OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) ♦/ #define HANDLE_WM_CREATE (hwnd, wParam, IParam, fn) \ ((fn)((hwnd), (CREATESTRUCT FAR*)(IParam)) ? OL : (LRESULT) -IL) tide fine FORWARD_WM_CREATE(hwnd, IpCreateStruct, fn) \ (BOOL) (DWORD) (fn) ( (hwnd) , WM_CREATE, 0, (LPARAM) (CREATESTRUCT FAR*) (IpCreateStruct) ) Как видите, HANDLE_WM_CREATE явно преобразует IParam в указатель на CREATESTRUCT, а затем удостоверяет, что этот параметр, введенный правильно, передается в функцию EasyText_OnCreate: BOOL EasyText-OnCreate (HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) На данном этапе вам не нужно думать о множестве полей CREATESTRUCT, поэтому я не буду их здесь перечислять. Впрочем, если интересуетесь, найдите их в WINDOWS.H. Если бы не взломщик сообщения, вам пришлось бы выполнять приведение типов самостоятельно: IpCreateStruct = (CREATESTRUCT FAR*) IParam; Это нежелательно, поскольку является чреватым ошибками процессом, который может оказаться особенно головоломным и запутанным для начинающих работать в Windows. Как легко заметить, этот макрос возвращает 0 или -1. Если программа отвечает на сообщение WM_CREATE, возвращая 0, то она продолжается, как обычно, однако, если она возвращает -1, окно будет уничтожено. То есть, функция CreateWindow возвратит NULL. Временами детали такого рода могут оказаться смущающими, поэтому WINDOWSX проясняет все одним махом, объявляя Cls_OnCreate как BOOL. В результате все, что вам нужно сделать, — это возвратить TRUE или FALSE, в зависимости от того, можно или нет проинициализировать области памяти, доступ к которым требуется вашей програм- ме. Если вы возвращаете FALSE, окно уничтожается и приложение заканчивается.
Макрос HANDLE_MSG Надеюсь, что из предыдущего раздела вам стало ясно, для устранения какого рода сложностей разрабатываются взломщики сообщений. Однако вся прелесть заключается в последнем макросе, который еще больше упрощает вашу программу. Это макрос HANDLE_MSG, который объявляется в WINDOWSX.H следующим образом: ftdefine HANDLE_MSG(hwnd, message, fn) \ case (message): return HANDLE_##message((hwnd), (wParam), (IParam), (fn)) Цель этого макроса — освободить вас от необходимости передачи значения, возвра- щаемого вашим обработчиком сообщения (функцией, которую вы объявляете, используя шаблон Cls_OnXXXX). Это большая ответственность, поскольку вы должны передавать это значение, даже если ваш обработчик сообщения объявляется как void. В таких случаях макрос всегда возвращает 0L. Если вы используете макрос HANDLE_MSG, вам вообще не нужно беспокоиться об этом возвращаемом значении. Если вы не используете HANDLE_MSG, вы должны быть уверены, что ваш макрос возвращает значение. Точнее говоря, в случае сообщения WMCREATE вам пришлось бы при каждом использовании функции-обработчика сообщения писать в WndProc следующий фрагмент: switch(Message) ( case WM_CREATE: return HANDLE_WM_CREATE(hwnd, wParam, Cls_OnCreate); И T.Д... } HANDLE_MSG освобождает вас от этой необходимости, позволяя вам написать следующее: switch(Message) ( HANDLE_MSG(hwnd, WM_CREATE, Cls_OnCreate) I и т.д. . . Похоже, что почти у каждого программиста есть собственный набор предпочтений при разработке исходного кода. Я, со своей стороны, очень высоко ценю технику, которая позволяет писать ясный, легко читаемый код, поэтому меня привлекает макрос HANDLE_MSG. Он позволяет мне писать максимально простые и понятные программы. WINDOWSX и оконная процедура обработки сообщений по умолчанию Как уже говорилось в предыдущей главе, в течение всей жизни приложения функция WndProc бомбардируется множеством сообщений. Во многих приложениях большая часть этих сообщений обрабатывается “умолчательной” оконной процедурой. Цель этого раздела — показать, как WINDOWSX управляется с DefWindowProc. В приложениях, которые используют WINDOWSX, обычным является включение следующего макроса для стандартной функции интерфейса прикладного программиро- вания Windows, именуемой DefWindowProc: ttdefine EasyText_DefProc DefWindowProc В первую очередь, эго предохраняет вас от ошибок, связанных с невнимательностью. Чтобы понять, как это достигается, нужно знать, что в некоторых случаях оконный класс может передавать свои сообщения не в DefWindowProc, а в функции типа DefDlgProc или DefMDIChildProc. (Не думайте пока о том, когда и зачем вам могут пригодиться эти функции). Суть в том, что Windows-программисты всегда переносят фрагменты своего кода из одной программы в другую. В результате довольно легко допустить ошибку вроде вызова DefMDICjiildProc вместо DefWindowProc. Чтобы избежать этого, программисты ветра-
ивают имя класса окна прямо в обращение к макросу DefWindowProc. Это помогает сконцентрировать внимание на главном — нахождении правильной “умолчательной” оконной процедуры для этого конкретного класса. Другое большое преимущество стиля программирования с использованием WIN- DOWSX то, что он довольно объектно-ориентированный. Например, обращение к “умолчательной” оконной процедуре явным образом помечается, как принадлежащие к оконному классу EasyText: return EasyText_DefProc(hwnd. Message, wParam, IParam); Такого рода правила неоценимы, когда программисты стараются писать ясные и понятные программы. Они полностью удовлетворяют философии современной практи- ки программирования — практики, которая была выработана большой ценой и после многочисленных дебатов в течение последних 10—20 лет. Подытоживая сказанное о взломщиках сообщений Прежде чем перейти к обсуждению важного сообщения WM_PAINT, стоит коротко повторить последние несколько разделов. Взломщики сообщений помогают упростить Windows-программы и избежать оши- бок, связанных с невнимательностью. Они делают это с помощью трех средств: Прерывают бесконечные операторы case и приводят вашу программу в согласие с практикой структурного программирования. И Анализируют параметры hwnd, IParam и wParam, выделяя самые важные из них и обеспечивая правильное приведение типов. Унифицируют вер функции, относящиеся к оконному классу под одним заголовком, следуя соглашению об именовании по принципу MyClass OnXXX. Надеюсь, что это усвоено. Далее взломщики сообщений будут рассматриваться, как единственно разумный способ обработки сообщений в оконных процедурах. Большинство вопросов, затронутых в настоящем обсуждении WINDOWSX, можно свести воедино, показав вам один крошечный фрагмент кода EASYTEXT.CPP: 23: ((define EasyText_DefProc DefWindowProc 24: BOOL EasyText_OnCreate(HWND hwnd, 25: CREATESTRUCT FAR* IpCreateStruct); 26: void EasyText_OnDestroy(HWND hwnd); 27: void EasyText_OnPaint(HWND hwnd); Эти пять строчек охватывают все функции оконного класса EasyText. Изучите их при первом знакомстве с EasyText.СРР. Вы сразу же будете знать, на что обратить внимание. Если бы в этом модуле было три различных класса, вы могли бы посмотреть определение каждого из них и немедленно узнать, для чего они нужны, и чем они отличаются друг от друга. Такая сжатость текста поможет вам быстро организовать и отладить ваш код, в то время как другие программисты будут продолжать барахтаться в пустоте! WINDOWSX привносит в программы структурность и ясность, которых им так долго не доставало. Конечно, он все еще имеет некоторые недостатки, но в общем окажет вам весомое содействие при конструировании свободного от ошибок легко читаемого и понимаемого кода. Замечание. Больше об взломщиках сообщений можно узнать, подключившись к текстовым файлам, сопровождающим ваш компилятор. Пользователям компилятора Microsoft следует отыскать файл под именем WINDOWSX.TXT, а пользователям компилятора Borland — файл WIN31.TXT. Отображение текста Каждое сообщение, посылаемое в оконную процедуру, является важным. Но сооб- щение WMPAINT представляется мне одним из наиболее важных, если даже не самым
важным сообщением. Определенно никто не может отрицать, что WMPAINT жизненно важно почти для всех Windows приложений. Сообщение WM_PAINT посылается в окно всякий раз, когда требуется изменить содержание рабочей области (client area). Когда программисты говорят о рабочей области окна, они обычно имеют ввиду область внутри рамки и полосу заголовка (см. рис. 4.2). Рабочая область — это пространство, которое программист обычно заполняет самостоятельно, в то время как Windows заботится об остальной части приложения. Ila i.isyifxi Client Area Рис. 4.2. Рабочая область окна ограничивается сверху полоской заголовка, а со всех остальных сторон — рамкой Если вы не контролируете какую-то часть рабочей области, Windows закрашивает ее определенным цветом. Например, так будет, если вы не препятствуете получению ею требуемых сообщений из “умолчательной" оконной процедуры. В частности, неприят- ность возникает, если вы не передаете в DefWndProc сообщение, которое требует дополнительной обработки системой. К этому вопросу я еще вернусь в следующей главе. Итак, сообщения WM PAINT посылаются в окно всякий раз, когда его необходимо перерисовать. Задумаемся на минутку, что это означает. Если окно было скрыто под другим окном и внезапно открывается, то оно получает сообщение WM PAINT, потому что необходимо перерисовать область, скрытую под другим окном. Если окно было минимизировано или максимизировано, то оно получает сообщение WM_PAINT при восстановлении до нормального размера. Если пользователь возвращается в Windows из полноэкранного окна DOS, то все видимые окна на рабочем столе получают сообщение WM PAINT. Словом, сообщения WM PAINT жизненно важны д ля окон. Замечание. Windows обеспечивает программистов бесконечным числом услуг, недоступных для пользователей DOS. Рамка, фон, заголовок окна — все это обрабатывается по умолчанию. Windows стоит на страже, чтобы при необходимости напомнить каждому окну, что ему надо обновиться. Так что, хотя порой и верно, что Windows действительно кое-что требует от программистов, она возвращает гораздо больше в форме услуг, выполняющихся по умолчанию. BEGINPAINT, ENDPAINT и контексты устройств Теперь вы должны быть готовы просмотреть крупным планом обработчик сообщения WM PAINT для EasyText: 153: void EasyText_OnPaint(HWND hwnd) 154: ( 155: PAINTSTRUCT PaintStruct; 156: RECT Rect; 157: 158: HDC PaintDC = BeginPaint(hwnd, SPaintStruct); 159: 160: TextOut(PaintDC, 10, 10, Directions, Istrlen(Directions)); 161: 162: GetClientRect(hwnd SRect); 163: 164: DrawText(PaintDC, "The middle of the road", -1, SRect, 165: DT_SINGLELINE I DT_CENTER I DTVCENTER); 166: 167: EndPaint(hwnd, SPaintStruct); 168: ) Возможно, вам будет легче понять, что здесь происходит, если я уберу из этой функции все, кроме самого главного:
void EasyText-OnPaint(HWND hwnd) ( PAINTSTRUCT PaintStruct; HDC PaintDC = BeginPaint(hwnd, SPaintStruct); EndPaint(hwnd, SPaintStruct); ) Этот пример может служить шаблоном, на основе которого вы можете строить все свои рисующие программы. Основные элементы — это обращения к BEGINPAINT (строка 158) и ENDPAINT (строка 167), атакже относящиеся к ним переменные, которые в данном примере носят имена PaintDC и PaintStruct. Основное назначение функции BEGINPAINT — обеспечивать доступ к контексту устройства для окна. Контекст устройства представляет собой совершенно новое понятие для людей, приходящих из DOS, поэтому, несомненно, стоит уделить здесь особое внимание этой ключевой концепции программирования под Windows. Контексты устройств представляют собой соединительное звено между вашей про- граммой и некоторыми внешними устройствами вывода, которые могут быть подклю- чены к компьютеру. В частности, контексты устройств формируют интерфейс между вашим приложением и принтером или видеокартой. Вполне можно сказать, что если бы контексты устройств не существовали, их следовало бы выдумать. Иначе говоря, они представляют собой существенную часть любой надежной среды программирования. Пока не было Windows, все программисты DOS сознательно или подсознательно чувствовали их недостаток. Важность контекстов устройств обусловлена существованием множества различных типов видеокарт и принтеров. Например, есть EGA, VGA, CGA, Hercules, и кто знает, сколько еще разных SVGA-карт ждут неосторожных программистов. Число и разнооб- разие типов принтеров еще больше. В прошлом каждое отдельное приложение нуждалось в своих собственных драйверах устройств. Например, WordPerfect был знаменит своими прекрасными драйверами принтера. Их существование придавало этому продукту гибкость, которая так нравилась пользователям. Но, конечно, не каждая маленькая компания может позволить себе разработку собственного набора драйверов. И даже если бы это было возможно, подобные излишние усилия могли бы оказаться бессмысленными. Windows позволяет производителям устройств вывода выпускать драйверы, совмес- тимые с любой Windows-программой. Это оказывается возможным благодаря разработке контекстов устройств, которые формируют соединительное звено между вашим прило- жением и драйвером устройства (см. рис. 4.3). Рис. 4.3. Устройство управляется соответствующим драйвером. Приложение взаимодействует с драйвером через контекст устройства
В Windows вполне допустимо написать один код, который будет одинаково хорошо выполняться с CGA-, VGA- или EGA-монитором. Это можно сделать, даже если вы никогда не писали ориентированного на устройства кода. Любой программист DOS, проделавший серьезную работу в мире графики, сразу поймет, что это очень большое достижение, даже если оно связано с несколькими затруднениями, которые с различных точек зрения освещаются в этой книге. Теперь вы понимаете, почему так важно начинать каждую процедуру рисования с обращения к BeginPaint? BeginPaint устанавливает контекст устройства для конкретного окна, а без него вы немногого добьетесь при выводе графики. Предупреждение. Существует несколько различных способов получения контекстов устройства от системы. Один из наиболее удобных называется GetDC. С моей точки зрения, функция GetDC так удачно названа и так проста в использовании, что существует соблазн использовать ее вместо BeginPaint. Не делайте этого. Это является причиной всякого рода неявного и неопределенного поведения! BeginPaint разработана специально для использования вместе с сообщениями WM PAINT. Если вы попробуете работать без нее, могут быть проблемы при вытаскивании вашего окна из-под другого или при перерисовке. Используйте BeginPaint для получения контекста устройства для обработчика сообщения WM PAINT. Не вызывайте GetDC из обработчика сообщения WM_PAIN'T. Используйте GetDC, только когда вы не отвечаете на сообщение WM PAINT, но все же нуждаетесь в доступе к текущему контексту устройства. EndPaint представляет собой столь же удобный способ завершения функции рисова- ния, как BeginPaint начала ее. Сердцевина каждого вашего ответа на сообщение WM PAINT должна быть заключена внутри этих двух процедур. Параметрами BeginPaint и EndPaint являются HWND и адрес PAINTSTRUCT. Структура PAINTSTRUCT имеет следующие поля: typedef struct tagPAINTSTRUCT ( HDC hdc BOOL fErase RECT rePaint BOOL fRestore BOOL flncUpdate BYTE rgbReserved[16]; ) PAINTSTRUCT; /* ps */ Первое поле — это просто копия контекста устройства для окна. Второе указывает, должен или нет перерисовываться фон. Третье определяет прямоугольник, в котором происходит рисование. Важно понимать, что этот прямоугольник не то же самое, что и рабочая область. Суть в том, что Windows достаточно “умна”, чтобы определять, какая именно часть окна должна быть перерисована. Это может быть важным в случаях, когда окно наполовину закрыто другим окном. В этом случае поле RCPAINT как бы говорит: “Не стоит перерисовывать весь ваш экран. Просто перерисуйте этот маленький участок, видимый пользователю.” Оставшиеся три поля PAINTSTRUCT резервируются Windows и не должны вас касаться. TextOut и DrawText Функции BeginPaint и EndPaint формируют своего рода оболочку для ядра программы рисования: TextOut(PaintDC, 10, 10, Direction, Istrlen(Direction)); GetClientRect(hwnd, SRect); DrawText(PaintDC, “The middle of the road", -1, SRect, DT_SINGLELINE I DT_CENTER I DT_VCENTER) ; С помощью программы EasyText вы можете проверить два основных способа вывода текста в Windows-программе. Первый — TextOut (строка 160), а второй — DrawText (строка 164).
Функция TextOut наиболее проста в обращении. Ей требуются лишь контекст устройства, некоторые начальные координаты, строка и ее длина. Наиболее общий способ определения длины строки — это обращение к одной из встроенных функций языка Си, например, strlen или к функции Windows Istrlen. Функция более высокого уровня, DrawText, использует в качестве параметров кон- текст устройства, строку, длину строки, RECT и некоторые флажки. Если вы передадите в DrawText ASCIIZ-строку, то достаточно будет передать -1 в качестве третьего парамет- ра, чтобы заставить Windows вычислить длину этой строки. Параметр RECT определяет область, внутри которой будет выведена строка. В данном случае я использовал функцию GetClientRect, чтобы установить область всего рабочего окна, а затем передал три флажка, которые приказывают Windows центрировать строку относительно RECT. На рис. 4.4 показано, как Windows центрирует строку независимо от того, какую форму примет окно. Заметьте, что строка, отображенная с помощью TextOut, решительно остается на месте независимо от формы и размера окна. Рис. 4.4. Выводимая посредством DrawText символьная строка всегда располагается в центре рабочей области окна независимо от размера последнего Резюме В этой главе вы имели случай познакомиться с обзором сообщений, взломщиками сообщений и с обработчиком сообщения WM_PAINT. Одно из важнейших мест этой главы было посвящено обсуждению того, как WINDOWSX использует макросы для анализа головоломных параметров, передаваемых в WndProc. Взломщики сообщений также важны, поскольку они помогают придать процедурам WndProc структурированную форму, относительно простую для отладки и понимания. Вы также узнали о необходи- мости обработки сообщений WM_DESTROY и немного о сообщении WM CREATE и его важной роли для вашего приложения. Последние разделы этой главы были сосредо- точены на контекстах устройства и функциях BeginPaint и EndPaint. Вы видели, что текст может быть выведен в окно с помощью функций TextOut или DrawText. Вопросы и ответы 1. Как мне запомнить параметры, передаваемые обработчику сообщения? Раньше можно было запомнить почти все важные аспекты языков программирова- ния. Однако теперь надо быть настоящим вундеркиндом даже для того, чтобы только
начать такую геркулесову работу. Мой совет — даже не пытаться запомнить параметры более чем некоторых очень немногих функций. Вместо этого просто держите открытой на вашем рабочем столе копию WINDOWSX.H и копируйте из нее соответствующие шапки, как только они вам понадобятся. Например, если я хочу узнать, как определять функцию Cls_OnCreate, то открываю WINDOWSX и произвожу глобальный поиск WM_CREATE. Это приводит меня прямо к искомому коду. 2. Меня все еще смущают сообщения WM_CREATE. Когда и как часто они посылаются? Сообщения WM_CREATE обычно всплывают только один раз в течение жизни основного окна программы. В частности, они посылаются всякий раз, когда Вы вызываете CreateWindow. Как вы видели в последней главе, обращение к CreateWindow происходит на ранних этапах работы WinMain, прежде чем программа войдет в цикл сообщения. Сообщение посылается в окно, так что вы получаете возможность проделать любую инициализацию, какую захотите, прежде чем окно станет видимым. В этой книге у вас еще будет много возможностей увидеть, как надо обращаться с сообщениями WM_CREATE. 3. Вы сказали, что DrawText — функция более высокого уровня, чем TextOut. Что это означает? Возможности у DrawText более широки, чем у TextOut. DrawText знает как форма- тировать текст, в то время как TextOut обычно только печатает текст очень простым образом. В частности, DrawText знает как центрировать текст, как расширять знаки табуляции, и как форматировать текст в заранее определенном прямоугольнике. Если вы интересуетесь расширением возможностей TextOut без использования DrawText, можете изучить функцию SetTextAlign. Вопросы для самопроверки 1. Каково назначение макроса HANDLE_MSG? 2. Большинство сообщений имеют дело с двумя макросами. Первый вызывает обработчик сообщения. Что делает второй? 3. Назовите две функции, которые можно использовать для вывода текста. 4. Кроме BeginPaint был описан еще один метод осуществления управления контекс- том устройства. Какую функцию вы вызываете, используя этот метод? 5. Если вы не пользуетесь взломщиками сообщений, как вы узнаете об информации, ассоциированной с сообщением? Иначе говоря, какие параметры вы проверите? 6. В этой главе слово “устройство” применялось в основном для обозначения видеоэкрана или видеокарты. Какие другие виды устройств могут быть важны при ответе на сообщения WM_PAINT. 7. Что происходит если вы не отвечаете явно на сообщение внутри оконной процедуры? 8. Сообщения — это в действительности просто константы. Как определить значение константы, ассоциированной с сообщениями WM CREATE? 9. -Каковы основные шаги при написании новой Windows-программы? Всегда ли вам необходимо вводить новую программу “с нуля”? 10. Опишите несколько различий между традиционной DOS-программой и ориен- тированной на события программой Windows. Упражнения 1. Напишите программу, печатающую ваше имя и адрес в левом верхнем углу окна. 2. Напишите программу, печатающую ваше имя и адрес так, что они всегда остаются центрированными посередине окна, даже если его размер меняется. 3. Напишите программу, которая использует SetTextAlign и TextOut. 4. Перепишите программу EasyText, не прибегая к взломщикам сообщений. 5. С помощью отладчика поместите прерывание в начале обработчика сообщения WM_CREATE. Пройдите его по шагам, когда он будет вызван.
День 5 МЫШЬ И КЛАВИАТУРА В этой главе вы узнаете, как управлять мышью и клавиатурой. В частности, вы увидите: Как определить нажатие клавиши Как распознать, какая клавиша была нажата Как узнать, что была нажата комбинация Alt+клавиша Как определить позицию мыши Как определить нажатие кнопки мыши Как распознать двойной щелчок Вдобавок вы получите несколько советов относительно отображения текста на экране, которые дополнят то, что вы узнали в последней главе. Другой кратко освещаемый предмет касается техники передачи сообщений из обработчика в текущую оконную процедуру. Программа, сообщающая о передвижениях мыши и нажатиях клавиш Теперь, когда вы изучили оконную процедуру и основы вывода текста, приступим к знакомству с более сложными темами, такими, как мышь и клавиатура. С помощью системы сообщений можно установить немедленный и относительно полный контроль над этими двумя устройствами. Для начала наберите и запустите программу, приведен- ную в листинге 5.1. Листинг 5.1. KEYMOUSE.CPP 1: ///////////////////////////////////////////////////////////// 2: // Программа: KEYMOUSE.CPP 3: // Автор: Чарли Калверт 4: // Описание: Показывает, как перехватить ввод с клавиатуры 5: // и манипуляции с мышью 6: IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII 1-. «define STRICT В: «include «windows.h> 9: «include «windows.h> 10: «include «string.h> 11: «include <stdio.h> 12: «pragma warning (disable: 4068) 13: «pragma warning (disable: 4100) 14: 15: ///////////////////////////////////////////////////////////// 16: // Интерфейс 17: ///////////////////////////////////////////////////////////// 18:
19: // Переменные 20: static int XVal = 10; 21: static int YVal = 30; 22: static char szAppName[] = "KeyMouse 23: static HWND MainWindow; 24: 25: // Процедуры 26: LRESULT CALLBACK __export WndProc (HWND hWindow, UINT Message, 27: WPARAM wParam, LPARAM IParam); 28: BOOL Register(HINSTANCE hlnst); 29: HWND Create(HINSTANCE hlnst, int nCmdShow); 30: 31: ((define KeyMouse_Defproc DefWindowProc 32: void KeyMouse_OnDestroy(HWND hwnd); 33: void KeyMouse_OnChar(HWND hwnd, UINT ch, int cRepeat); 34: void KeyMouse_OnKey (HWND hwnd, UINT vk, BOOL fDown, 35: int CRepeat, UINT flags); 36: void KeyMouse_OnLButtonDown(HWND hwnd, BOOL fDoubleClick, 37: int x, int y, UINT keyFlags); 38: void KeyMouse_OnLButtonUp(HWND hwnd, int x, int y, 39: UINT keyFlags); 40: void KeyMouse_OnMouseMove (HWND hwnd, int x, 41: int y, UINT keyFlags); 42: void KeyMouse_OnPaint(HWND hwnd); 43: void KeyMouse_OnSysKey(HWND hwnd, UINT vk, 44: BOOL fDown, int cRepeat, UINT flags); 45: 46: 47: //=====--============= ===================================== 48: // Инициализация 49: //=========------------===============---===================== 50: 51: ////////////////////////////////////////////////////////////// 52: // Точка входа в программу 53: //////////////Z/////////////////////////////////////////////// 54: 55: ((pragma argsused 56: int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInstance, 57: LPSTR IpszCmdParam, int nCmdShow) 58: ( 59: MSG Msg; 60: 61: if (!hPrevInstance) 62: if ('Register(hlnst)) 63: return FALSE; 64: 65: if (((MainWindow = Create(hlnst, nCmdShow))) 66: return FALSE; 67: 68: while (GetMessage(SMsg, NULL, 0, 0) 69: ( 70: Translate Message(SMsg); 71: Dispatch Message(SMsg); 72: ) 73: 74: return Msg.wParam; 75: ) 76: 77: //////////7/////////////////////////////////////////////// 78: // Регистрация окна 79: ////////////////////////////////////////////////////////// 80: BOOL Register(HINSTANCE hlnst) 81: ( 82: WNDCLASS WndClass; 83: 84: WndClass.style 85: WndClass.IpfnWndProc 8 6: WndClass.cbClsExtra 8 7: WndClass.cbWndExtra 88: WndClass.hlnstance 89: WndClass.hlcon 90: WndClass.hCursor 91: WndClass.hbrBackground 92: WndClass. IpszMenuName 93: WndClass.IpszClassName = CSHREDRAW I CS_VREDRAW | CSDBLCLKS; = WndProc; = 0; = 0; = hlnst; = Loadicon(NULL, IDI_APPLICATION); = LoadCursor(NULL, IDC_ARROW); = GetStockBrush(WHITE_BRUSH); = NULL; = szAppName;
94: 95: return Registerclass. (SWndClass) ; 96: ) 97: 98: ///////Z///////////////////////////////////////////////////// 99: // Создание окна 100: ///////////////////////////////////////////////////////////// 101: HWND Create(HINSTANCE hlnstance, int nCmdShow) 102: ( 103: 104: HWND hwnd = CreateWindow(szAppName, szAppName, 105: WS_OVERLAPPEDWINDOW, 106: CW_USEDEFAULT, CW_USEDEFAULT, 107: CW_USEDEFAULT, CW_USEDEFAULT, 108: NULL, NULL, hlnstance, NULL); 109: 110: if (hwnd == NULL) 111: return hwnd : 112: 113: ShowWindow(hwnd, ncmdShow); 114: UpdateWindow(hwnd); 115: 116: return hwnd ; 117: ) 118: 119: //==================================================== 120: // WndProc и реализация 121: / /=======-===-===============---====================== 122: 123: /////////////////////////////////////////////////////// 124: // Оконная процедура 125: /////////////////////////////////////////////////////// 126: LRESULT CALLBACK __export WndProc(HWND hwnd, UINT Message, WPARAM 127: wParam, LPARAM IParam) 128: ( 129: switch(Message) 130: ( 131: HANDLE_MSG(hwnd, WM_DESTROY, KeyMouse_OnDestroy); 132: HANDLE__MSG (hwnd, WM_CHAR, KeyMouse_OnChar) ; 133: HANDLE_MSG(hwnd, WM_KEYDOWN, KeyMouse_OnKey) ; 134: HANDLE_MSG(hwnd, WM_KEYUP, KeyMouse_OnKey); 135: HANDLE_MSG(hwnd, WM_MOUSEMOVE, KeyMouse_OnMouseMove); 136: HANDLE_MSG(hwnd, WMJLBUTTONDBLCLK, KeyMouse_OnLButtonDoWn); 137: HANDLE_MSG(hwnd, WM_LBUTTONDOWN, KeyMouse_OnLButtonDown); 138: HANDLE_MSG(hwnd, WM_LBUTTONUP, KeyMouse_OnLButtonUp); 139: HANDLE_MSG(hwnd, WM_PAINT, KeyMouse_OnPaint); 140: HANDLE_MSG(hwnd, WMJSYSKEYUP, KeyMouse_OnSysKey); 141: HANDLE MSG(hwnd, WM_SYSKEYDOWN, KeyMouse_OnSysKey); 142: default: 143: return KeyMouse_DefProc(hwnd. Message, wParam, IParam); 144: ) 145: ) 146: 147: /////////////////////////////////////////////////////// 148: // Обработка сообщения WM DESTROY 149: /////////////////////////7///////////////////////////// 150: #pragma argsused 151: void KeyMouse_OnDestroy(HWND hwnd) 152: ( 153: PostQuitMessage(0); 154: ) 155: 156: //////////////////////////////////////////////////////// 157: // Обработка нажатий обычных клавиш 158: // Используется для перехвата букв и цифр 159: //////////////////////////////////////////////////////// 160: ((pragma argsused 161: void KeyMouse_OnChar(HWND hwnd, UINT ch, int cRepeat) 162: { 163: char S[100); 164: 165: HDC DC = Get DC(hwnd); 166: 167: sprintf(S, 168: "WM_CHAR ==> Ch = %c cRepeat = %d ", ch, cRepeat);
169: TextOutlDC, XVal, YVal + 20, S, strlen(S)); 170: 171: ReleaseDC(hwnd, DC); 172: ) 173: 174: //////////////////////////////////////////////////////// 175: // Обработка нажатия произвольной клавиши 176: // Не обрабатывайте буквы и цифры здесь 177: // Для этого существует сообщение WM CHAR 178: ////////////////////////////////////7/////////////////// 179: ftpragma argsused 180: void KeyMouse_OnKey (HWND hwnd, UINT vk, 181; BOOL fDown, int cRepeat, UINT flags) 182: ( 183: char S[100]; 184: 185: HDC DC = GetDC(hwnd); 186: 187: if ( fDown ) 188: sprintf(S, "WM_KEYDOWN == > vk = »d fDown = Sd cRepeat = %d" 189: “ flags = %d ", vk, fDown, cRepeat, flags); 190: else 191: sprintf(S, "WM_KEYUP == > vk = Sd fDown = %d cRepeat = %d " 192: "flags = %d ", vk, fDown, cRepeat, flags); 193: TextOutlDC, XVal, YVal + 40, S, strlen(S)); 194: 195: ReleaseDC(hwnd, DC); 196: ) 197: 198: ////////////////////////////////////////////////////////////// 199: // Эта функция вызывается при однократном или двойном нажатии 200: // левой кнопки мыши 201: ////////////////////////////////////////////////////////////// 202: void KeyMouse_OnLButtonDown(HWND hwnd, BOOL fDoubleClick, int x, 203: int y, UINT keyFlags) 204: ( 205: char S[100); 206: HDC PaintDC = GetDC(hwnd); 207: 208: if (fDoubleClick) 209: sprintf(S, 210: "WM_LBUTTONDBLCLK ==> Db = 4d x = %d у = %d Flags = Id ", 211: fDoubleClick, x, y, keyFlags); 212: else 213: sprintffS, 214: "WM_LBUTTONDOWN ==> Db = !d x = «d у = Sd Flags = Id ", 215: fDoubleClick, x, y, keyFlags); 216: TextOut(Paint DC, XVal, YVal + 100, S, strlen(S)); 217: 218: ReleaseDC(hwnd, PaintDC); 219: ) 220: 221: ////////////////////////////////////////////////////////////// 222: // Эта функция вызывается, когда кнопка мыши отпускается 223: ////////////////////////////////////////////////////////////// 224: void KeyMouse_OnLButtonUp(HWND hwnd, int x, int y, UINT keyFlags) 225: { 226: char S[100] ; 227: HDC PaintDC = GetDC(hwnd); 228: 229: sprintf(S, "WM LBUTTONUP ==> x = %d у = %d F = %d 230: x, y, key Flags); 231: TextOut(PaintDC, XVal, YVal + 120, S, strlen(S)); 232: 233: ReleaseDC(hwnd, PaintDC); 234: ) 235: 236: ////////////////////////////////////////////////////////////// 237: // Эта функция вызывается при любом перемещении мыши 238: ////////////////////////////////////////////////////////////// 239: void KeyMouse_OnMouseMove(HWND hwnd, int x, int y, UINT keyFlags) 240: ( 241: char S[100]; 242: HDC PaintDC = GetDC(hwnd); 243: 244: sprintffS, "WM_MOUSEMOVE ==> x = Id у = Sd keyFlags = «d ",
245: х, у, keyFlags); 246: Text Out(PaintDC, XVal, YVal + 80, S, strlen(S)); 247: 248: ReleaseDC(hwnd, Paint DC); 249: ) 250: 251: ////////////////////////////////////////////////////////////// 252: // Обработка сообщение WM PAINT 253: ////////////////////////77//////////////////////////////////// 254: void Key Mouse On Paint(HWND hwnd) 255: ( 256: PAINTSTRUCT PaintStruct; 257: RECT Rect; 258: static char ‘Message[] = 259: { 260: "WM_CHAR " , 261: "WM_ KEY " , 262: "WMJSYSKEY " , 263: "WM_MOUSEMOVE ” , 264: "WM_MOUSEDOWN ” , 265: "WM_MOUSEUP " 266: ); 267: 268: HDC PaintDC = BeginPaint(hwnd, SPaintStruct); 269: HFONT OldFont = SelectFont(Paint DC, 270; GetStockObject(OEM_FIXED_FONT)) ; 271: 272: GetClientRect(hwnd, SRect); 273: DrawText (Paint DC, "ДЕМО-ПРОГРАММА ДЛЯ МЫШИ И КЛАВИАТУРЫ ", -1, 274: SRect, DT_CENTER); 275: Rect.top = 20; 276: Rect.bottom = 40; 277: DrawText(Paint DC, 278: "(Поэкспериментируйте с мышью и клавиатурой) ", 279: -1, SRect, DTCENTER); 280: 281: Select Font(PaintDC, OldFont); 282: 283: for (int i = m; i < 6; i++) 284: TextOut(PaintDC, XVal, YVal + (2m * (i + 1)), 285: Message[i], strlen(Message[i])); 286: 287: EndPaint(hwnd, SPaintStruct); 288: ) 289: 290: //////////////////////////////////////////////////////////// 291: // Эта функция вызывается при нажатии клавиши ALT 292: llllllllllllltllllllllllllllllllllllllllllllllllllllllllllll 293: void KeyMouse_OnSysKey(HWND hwnd, UINT vk, BOOL fDown, 294: int cRepeat, UINT flags) 295: ( 296: char S[1001; 297: 298: HDC DC = GetDC(hwnd); 299: 300: if (fDown) 301: { 302: sprintf(S, "WM_SYSKEYDOWN ==> " 303: "vk = %d fDown =%d cRepeat =%d flags = %d ", 304: vk, fDown, cRepeat, flags); 305: TextOut(DC, XVal, YVal + 60, S, strlen(S)); 306: FORWARD WM_SYSKEYDOWN(hwnd, vk, cRepeat, flags, 307: KeyMouse_DefProc); 308: ) 309: else 310: ( 311: sprintf(S, "WMJSYSKEYUP == > " 312: " vk = %d fDown = %d cRepeat = Id flags = %d " 313: vk, fDown, cRepeat, flags); 314: TextOut(DC, XVal, YVal + 60, S, strlen(S)); 315: FORWARD_WM_SYSKEYUP(hwnd, vk, cRepeat, flags, 316: KeyMouse_DefProc); 317: ) // end if 318: ReleaseDC(hwnd, DC); 319: )
Листинг 5.2. KEYMOUSE.DEF 1: 2: 3: 4: 5: 6: 7: 8: 9: ; KEYMOUSE.DEF NAME < KeyMouse DESCRIPTION 'KeyMouse Window' EXETYPE WINDOWS STUB 'WINSTUB.EXE' CODE PRELOAD MOVEABLE DISCARDABLE DATA PRELOAD MOVEABLE MULTIPLE HEAPSIZE 4096 STACKSIZE 5120 Листинг 5.3. KEYMOUSE.MAK (Borland) 1: # KEYMOUSE.MAK 2: 3: # макросы 4: APPNAME = KeyMouse 5: INCPATH = C:\BC\INCLUDE 6: LIBPATH = C:\BC\LIB 7: FLAGS = -H -ml -W -v -w4 -1$ (INCPATH) -L(LIBPATH) 8: 9: # компоновка 10: $ (APPNAME) .exe: $ (APPNAME) . obj $ (APPNAME) .def 11: bcc $ (FLAGS) $ (APPNAME) . obj 12: 13: # компиляция 14 : $ (APPNAME) . obj : $ (APPNAME) . Cpp 15: bcc -C $(FLAGS) $(APPNAME).Cpp Листинг 5.4. KEYMOUSE.MAK (Microsoft) 1: # KEYMOUSE.MAK 2: 3: APPNAME = KeyMouse 4: 5: # компоновка 6: $(APPNAME).exe : $(APPNAME).obj $(APPNAME).def 7: link /CO $(APPNAME), /align:16, NUL, /nod llibcew libw, $(APPNAME) 8: 9: # компиляция 10: $ (APPNAME) .obj : $ (APPNAME) .cpp 11: cl —c -AL -Ow -W4 -Zp -Zi; $ (APPNAME) . cpp Эта программа показывает, как распознавать нажатие той или иной клавиши и манипуляции с мышью. В частности, будучи в фокусе, она по очереди выводит на экран отчет о любой активизации мыши или клавиатуры. Программа KeyMouse отображает 9 сообщений Windows, связанных с мышью и клавиатурой. Сообщение Результат WM_CHAR WM_KEYDOWN WM_KEYUP WM_LBUTTONDOWN WM_LBUTTONUP WM_LBUTTONDBLCLK WM_MOUSEMOVE WM_SYSKEYDOWN WM_SYSKEYUP Нажата цифровая или буквенная клавиша Была нажата клавиша Была отпущена клавиша Нажата левая кнопка мыши Отпущена левая кнопка мыши Двойной щелчок левой кнопкой мыши Была передвинута мышь Нажата комбинация Alt+клавиша Отпущена комбинация Alt+клавиша
Результат работы KEYMOUSE.CPP изображен на рис. 5.1. KeyMo use <Try experimenting with the mouse and keyboard) WMCHAR ==> Ch = c cRepeat = 1 WM_KEYUP == > vk = 67 (Down = 0 cRepeat = 1 flags = -16338 WM_SYSKEYUP == > vk = 18 fDown = 0 cRepeat = 1 flags = -16328 WM_MOUSEMOVE ==> x = 322 у = 47 keyFlags = 00 WM_LBUTTONDOWN ==> Db = 0 x = 377 у = 114 Flags = 1 WM.LBUTTONUP ==>x = 378у = 113 F = 0 Рис. 5.1. KEYMOUSE.CPP отображает информацию, передаваемую с наиболее важными сообщениями мыши и клавиатуры Поиграйте с этой программой несколько минут. Будьте внимательны, отмечая, как программа реагирует на движение мыши и на нажатие клавиши или комбинации клавиш. Запомните, как только вы нажимаете Alt, активизируется системное меню в левом верхнем углу полосы заголовка. Клавиатура не будет реагировать, пока вы снова не нажмете Alt или не предпримите каких-либо других действий, изменяющих фокус. Замечание. Понятие фокуса является чрезвычайно важным для программирования в Windows. Находящиеся в фокусе окна реагируют на мышь и клавиатуру, а не имеющие фокуса — не реагируют. Например, если менеджер файлов или менеджер программ находятся в фокусе, то они реагируют на комбинации Alt-F высвечиванием меню File. Однако, если вы поместите программу KeyMouse на передний план вашего рабочего стола, менеджер программ или менеджер файлов больше не будут отвечать на нажатие клавиш. Это происходит потому, что теперь в фокусе находится программа KeyMouse. Наличие у конкретной программы фокуса всегда можно определить по более яркому заголовку ее окна. Важно понимать, что только одно окно в данный момент времени может находиться в фокусе. Например, если вы высвечиваете меню File, выскочившее меню будет в фокусе, а главное окно программы перестанет быть активным. То же самое происходит, когда вы высвечиваете диалоговую панель Run из меню File менеджера программ. Когда Run в фокусе, остальная часть менеджера программ неактивна. Вывод, минующий обработчик сообщения WM_PAINT Прежде чем начинать обсуждение сообщений мыши и клавиатуры, перечисленных выше, стоит сделать обзор двух различных способов вывода, использующихся в этой программе. Первый из них можно увидеть в функции KeyMouse_OnPaint, которая реагирует на сообщения WM PAINT. Этот способ детально разбирался в предыдущей главе и не требует дальнейших комментариев. Однако другой способ, использующийся в функции KeyMouse_OnChar, заслуживает некоторого внимания: 161: void KeyMouse_onChar(HWND hwnd, UINT ch, int cRepeat) 162: { 163: char S[100); 164: 165: HDC DC = GetDC(hwnd); 166: 167: sprintf(S, 168: "WM_CHAR ==> Ch = Ic cRepeat = Sd ", ch, cRepeat); 169: TextOut(DC, XVal, YVal + 20, S, strlen(S)); 170: 171: ReleaseDC(hwnd, DC); 172: ) Буквально через минуту я расскажу о действительной цели функции KeyMouse_On- Char и о том, как она обрабатывает сообщения WM CHAR. Однако, прежде чем перейти
к этому предмету, я хочу убедиться, что вы понимаете существенную разницу в способах обработки контекста устройства функциями KeyMouse_OnChar и KeyMouse_OnPaint. Этот момент должен быть совершенно ясен, или вы никогда не добьетесь, чтобы ваши программы работали правильно. В первую очередь функция KeyMouse_OnChar получает контекст устройства. Она делает это не путем вызова BeginPaint или EndPaint, а с помощью GetDC (строчка 168) и ReleaseDC. Вывод с помощью TextOut (строчка 172) использует контекст устройства точно так же, как это делала программа EasyText в предыдущей главе. Для того чтобы понять разницу между вызовами GetDC и BeginPaint, вам нужно только перетащить окно другой программы поверх окна KeyMouse. Если, например, левая половина окна KeyMouse была временно невидима, то когда вы вновь перенесете окно KeyMouse на передний план, ваши глаза порадует следующая картина (рис. 5.2). KeyMouse <Try experimenting with the mouse and keyboard) WMCHAR WM_ KEY : 1 flags = -16352 WM_SYSKEYDOWN ==> vk = 18 fDown =1 cRepeat =1 flags = 24632 WMMOUSEMOVE = 000 WM_MOUSEDOWN 3 Flags = 1 WM_MOUSEUP Рис. 5.2. В окне KeyMouse стерты некоторые области текста, после того как оно было временно закрыто другим окном Если вы понимаете, что здесь произошло, то вы прочувствовали механизмы, задей- ствованные в системе сообщений Windows. Сообщение WM_PAINT посылается в окно всякий раз, когда открывается его часть, временно закрытая другим окном. Таким образом, заголовок и слова в левой части программы KeyMouse видимы, когда видимо окно. Однако любой текст, выводимый, скажем, функцией KeyMouse_OnChar, не будет перерисовываться вновь. Причина этого в том, что в метод KeyMouse_OnChar посыла- ются только сообщения WM CHAR. Он ничего не знает о сообщении WM_PAINT и не обращает на него внимания. Замечание. В DOS-программах содержимое окон часто сохраняется в буфере целиком, а затем восстанавливается, как только окно снова выдвигается на передний план. Windows работает иначе. Содержимое окна восстанавливается с помощью сообщения WM PAINT, в ответ на которое окно явным образом исполняет действия, необходимые для его повторного изображения. В механизмах, которые я здесь описываю, нет ничего особенно сложного. Однако они настолько важны для понимания техники программирования под Windows, что почти невозможно обозреть их на слишком глубоком уровне. Важно понимать, что вывод, сделанный в ответ на сообщение WM_PAINT, всегда виден, когда видимо окно просто потому, что Windows гарантирует посылку сообщения WM_PAINT в нужный момент. Отвечая на сообщения WM PAINT, вы должны использовать BeginPaint и EndPaint. Во всех остальных случаях следует использовать GetDC и ReleaseDC. Теперь, когда вы ощущаете разницу между BeginPaint и GetDC, можно заняться сообщением WM CHAR. Сообщения WM CHAR посылаются в программу, как только пользователь нажимает одну из стандартных клавиш. То есть, если пользователь нажи- мает клавиши А или В, посылается сообщение WM CHAR. Заметьте, что сообщения WM CHAR не посылаются, когда пользователь нажимает функциональные клавиши или стрелки на цифровой части клавиатуры.
Значение, ассоциированное с нажатием клавиши, посылается в функцию Кеу- Mouse OnChar в переменной ch, которая объявляется как беззнаковое целое. Иначе говоря, если пользователь нажимает клавишу A, ch устанавливается равным ASCII-зна- чению 97, соответствующему букве “а”. Если пользователь во время нажатия клавиши А держит клавишу Shift, то в переменную ch посылается ASCII-значение 65 (буква “А”). Если между обращениями к WMCHAR клавиша нажимается повторно, то число нажатий клавиши посылается в переменную cRepeat. Хотя эта информация обычно не очень важна, Windows все-таки передает ее вам на всякий случай. Функция KeyMouseOnChar служит прекрасной иллюстрацией достоинств WIN- DOWSX. Если бы KeyMouse не использовала преимущества WINDOWSX, она должна была бы производить анализ переменных wParam и IParam, посылаемых в оконную процедуру программы, чтобы определить правильное значение нажатой клавиши и число повторений. Например, информация о числе повторений хранится в младшем слове IParam. Старшее слово содержит информацию, которая обычно бесполезна для прило- жений. Поэтому старшее слово не передается в KeyMouse_OnChar. Пока не появился файл WINDOWSX, программисты добывали всю эту информацию сами, читая справочные руководства и расшифровывая биты в wParam и IParam. Этот процесс пожирал много времени, был чреват ошибками и мог оказаться особенно утомительным для начинающих. Используйте сообщения WM CHAR для чтения алфавитно-цифровых клавиш. Нажатия этих клавиш правильно транслируются в Windows, перед тем как посылается сообщение WM CHAR. Таким образом, сообщения WM CHAR — это идеальный способ определить, что пользователем выбрана цифра или буква. Не используйте WM CHAR для определения нажатия функциональной клавиши или клавиши- стрелки. Для этого существует сообщение WMKEYDOWN. Не используйте сообщение WM KEYDOWN для чтения алфавитно-цифровых клавиш. Когда посылаются сообщения WM KEYDOWN, цифровые и буквенные клавиши еще не оттрансли- рованы должным образом, поэтому вы легко можете неправильно интерпретировать значение нажатой клавиши, ассоциированное с сообщением WM KEYDOWN В следующем разделе будет представлено больше информации о сообщениях WM KEYDOWN. Определение нажатия клавиш с помощью WM.KEYDOWN Как вы видели ранее, сообщение WM CHAR, с точки зрения программиста DOS, представляет собой одно из простейших и наиболее доступных сообщений, посылаемых в оконную процедуру. Параметр ch, который передается в обработчик сообщения KeyMouse_OnChar, содержит значение нажатой клавиши, если эта клавиша является буквой или цифрой. В других параметрах отмечается, сколько раз эта клавиша была нажата с момента последней посылки сообщения WM CHAR. Для обработки нажатия таких клавиш, как левая и правая стрелки или функциональные клавиши, необходимо сообщение WM KEYDOWN. 180: void KeyMouseOnKey(HWND hwnd, UINT vk, 181: BOOL fDown, int cRepeat, UINT flags) 182: { 183: char S[100); 184: 185: HDC DC = GetDC(hwnd); 186: 187: if (fDown) 188: sprintf(S, "WM_KEYDOWN == > vk = %d fDown = id cRepeat =ld" 189: " flags = id ", vk, fDown, cRepeat, flags); 190: else 191: sprintf(S, "WM_KEYUP == > vk = id fDown = id cRepeat = id" 192: " flags = id ", vk, fDown, cRepeat, flags); 193: TextOutfDC, XVal, YVal + 40, S, strlen(S)); 194: 195: ReleaseDC(hwnd, DC); 196: )
Замечание. Подпрограмма KeyMouse_OnKey представляет собой один из редких случаев, когда один обработчик занимается более чем одним сообщением. Параметр fDown говорит, было ли посланное сообщение нажатием или отпуском клавиши, а из приведенного кода видно, как легко различить эти два случая, проверив значение fDown (TRUE или FALSE). Windows позволяет очень легко определять, когда была нажата функциональная клавиша или левая или правая стрелки. Эта информация содержится в параметре vk обработчика сообщения в виде одной или нескольких констант, определенных в WIN- DOWS.H. Параметр vk является для функции KeyMouse_ОпКеу тем же самым, что и параметр ch для функции KeyMouse_OnChar. Иначе говоря, если пользователь нажимает клавишу А, то соответствующее значение передается в функцию KeyMouse_OnChar в переменной ch. Однако, если пользователь нажимает, скажем, левую стрелку, то в KeyMouse_OnKey передается константа VK.LEFT посредством параметра vk. Константа VK LEFT — одна из нескольких предопределенных констант, объявляю- щихся в WINDOWS.H. Вот фрагмент этого перечня: «define VK END 0x23 «define VK_HOME 0x24 «define VK_LEFT 0x25 «define VK_UP 0x26 «define VK RIGHT 0x27 «define VK_DOWN 0x28 «define VK SELECT 0x29 «define VK_PRINT 0x2A «define VK EXECUTE 0x2B «define VKSNAPSHOT 0x2C «define VK INSERT 0x2D «define VK_DELETE 0x2E «define VK_HELP 0x2 F «define VK_NUMPAD0 0x60 «define VK_NUMPAD1 0x61 «define VK_NUMPAD2 0x62 «define VK_NUMPAD3 0x63 Следующая модифицированная версия функции KeyMouse OnKey показывает, как определять некоторые из этих клавиш: void KeyMouse_OnKey(HWND hwnd, UINT vk, BOOL fDown, int cRepeat, UINT flags) ( char S[100]; HDC DC = GetDC(hwnd); switch (vk) ( case VK_LEFT: strcpytS, "Нажала левая стрелка. "); break; case VK_RIGHT: strcpytS, "Нажата правая стрелка. "); break; case VK_F1: strcpytS, "Нажата клавиша Fl. "); break; case VK_F12: strcpytS, "Нажата клавиша F12. "); break; case VK_CLEAR: strcpy(S, "Цифровая клавиша 5, Numlock выключен"); break; case VK_NUMPAD5: strcpytS, "Цифровая клавиша 5, Numlock включен "); break; default: strcpytS, "Пошел на ланч, вернусь в пять! "); ) TextOut(DC, XVal, YVal + 40, S, strlen(S)); ReleaseDC(hwnd, DC); )
Проверяя эту процедуру, следует обратить внимание на константы VK_CLEAR и VKJF12. Перехват нажатий соответствующих клавиш может оказаться немного сложным для программистов DOS, работающих с обычными компиляторами. Но в Windows информация этого рода легко доступна. Системная клавиша Системной клавишей в Windows является Alt. Windows часто дает пользователю больше информации, чем ему когда-либо потребуется. Например, программа KeyMouse ловит сообщения WM_SYSKEYDOWN и WM SYSKEYUP, которые обычно должны передаваться непосредственно в DefWindowProc. Причина того, что эти сообщения должны быть переданы транзитом заключаются в том, что обработка системной клавиши во многом определяет поведение клавиатуры в Windows по умолчанию, как знаменитая комбинация Alt-Tab, которая осуществляет переключение между приложениями. В таких случаях очень важно вызывать макрос FORWARD_WM_XXX, объявленный в WIN- DOWSX. Это показано в следующей выдержке из KeyMouse_OnSysKey: 300: if (fDown) 301: ( 302: sprintf(S,"WM_SYSKEYDOWN == > ” 303: "vk = %d fDown - %d cRepeat = %d flags = %d 304: vk, fDown cRepeat, flags); 305: TextOut(DC, XVal, YVal + 60, S, strlen(S)); 306: FORWARD_WM_SYSKEYDOWN(hwnd, vk, cRepeat, flags, 307: KeyMouse_defProc); 308: ) Хотя я уже упоминал об этом в предыдущей главе, стоит посмотреть, как взломщик сообщения WM_SYSKEYDOWN объявляется в WINDOWSX. Н: /* void ClsOnSysKey(HWND hwnd, UINT vk, BOOL fDown, int cRepeat, UINT flags); */ ((define HANDLE_WM_SYSKEYDOWN(hwnd, wParam, IParam, fn) \ ((fn)((hwnd), (UINT)(wParam), TRUE, (int) (LOWORD(IParam), (UINT)HIWORD(IParam)), 0L) ((define FORWARD_WM_SYSKEYDOWN(hwnd, vk, cRepeat, flags, fn) \ (void)) ( (hwnd), WMSYSKEYDOWN, (WPARAM), (UINT), (vk) , MAKELPARAMf(UINT)(cRepeat), (Uint)(flags))) Главное, на что следует обратить внимание — это объявление макроса FOR- WARD_WM_SYSKEYDOWN. Это макрос, который отвечает за передачу сообщения WMJSYSKEYDOWN в оконную процедуру обработки сообщений по умолчанию. Думаю, что новички в Windows когда-нибудь неизбежно забудут передать это сообщение для дальнейшей обработки. Чтобы не забыть о возможной ошибке, попы- тайтесь “закомментировать” макрос FORWARD_WM_SYSKEYDOWN в KeyMouse_On- SysKey. Затем вновь откомпилируйте и запустите программу. А теперь попробуйте нажать Alt-Tab. Заметьте, что поведение по умолчанию, ассоциированное с этой комбинацией, отсутствует. Удалите комментарий, снова перекомпилируйте, и вы увидите, что стан- дартное поведение возвратилось. Замечание. Помните, что большая часть сообщений, обрабатываемых вами явно, никогда не передается в DefWindowProc. Иначе говоря, чаще всего вы выходите из WndProc, возвращаясь непосредственно из обработчика сообщения, и затем сразу перескакивая в конец этой функции. Разумеется, сообщения, которые вы не обрабатываете сами, всегда передаются в DefWindowProc по умолчанию. Однако в функции KeyMouse OnSysKeyDown желательно явно обрабатывать сообщение, а также передавать его для дальнейшей обработки в KeyMouse DefProc. Это понятие довольно тонкое, поэтому стоит задержаться, чтобы сделать шаблон функции WndProc и мысленно проследить обычный маршрут передачи сообщения. LRESULT CALLBACK_export WndProc(HWND hwnd, UINT Message, WPARAM wParam, LPARAM IParam) ( switch(Message) ( HANDLE_MSG(hwnd, WM_DESTROY, KeyMouse_OnDestroy);
HANDLE_MSG(hwnd, WM_CHAR, KeyMouse_OnChar) ; HANDLE_MSG(hwnd, WM_KEYDOWN, KeyMouse_OnKey); HANDLE_MSG(hwnd, WMKEYUP, KeyMouseOnKey); HANDLE_MSG(hwnd, WM_MOUSEMOVE, KeyMouse_OnMouseMove); HANDLE_MSG(hwnd, WM_LBUTTONDBLCLK, KeyMouse_OnLButtonDown); HANDLE_MSG(hwnd, WM_LBUTTONDOWN, KeyMouseOnLButtonDown); HANDLE_MSG(hwnd, WM_LBUTTONUP, KeyMouseOnLButtonUp) ; HANDLE_MSG(hwnd, WM_PAINT, KeyMouse_OnPaint); HANDLEMSG(hwnd, WMSYSKEYUP, KeyMouseOnSysKey); HANDLE_MSG(hwnd, WM_SYSKEYDOWN, KeyMouse_OnSysKey); default: return KeyMouse_DefProc(hwnd. Message, wParam, IParam); } } Запомните, что KeyMouse_DefProc всего лишь вызывает DefWindowProc! Словом, важно помнить, что странное и необъяснимое поведение приложения может происходить по причине пропущенных обращений к “умолчательной” оконной проце- дуре. Если однажды вы обнаружите, что застряли где-то в середине длинной, нудной и утомительной отладки, вспомните о том, что вы могли забыть передать какое-то сообщение “умолчательной” оконной процедуре для дальнейшей обработки. Сообщение WM_MOUSEMOVE Есть что-то поистине замечательное в системе сообщений Windows. Даже простое передвижение мыши в окне выглядит здесь как развлечение. Особенно, когда коорди- наты, посланные в окно, становятся видимыми, как в приложении KeyMouse. Задержитесь на минутку и рассмотрите функцию отклика на сообщение WM_MOUSEMOVE. 236: IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII 237: // Эта функция вызывается, когда передвигается мышь. 238: IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII 239: void KeyMouse_OnMouseMove(HWND hwnd, int x, int у UINT keyFlags) 240: ( 241: char S[100]; 242: HDC PaintDC = GetDC(hwnd); 243: 244: sprintf(S, "WM_M0USEM0VE ==> x = Sd у = %d keyFlags = %d", 245: x, y, keyFlags); 246: TextOut(PaintDC, XVal, YVal + 80, S, strlen(S)); 247: 248: ReleaseDC(hwnd, PaintDC); 249: ) В первую очередь следует обратить внимание на то, какую огромную работу выпол- няет взломщик сообщения из WINDOWSX, передавая необходимую информацию функ- ции KeyMouse_OnMouseMove. Если вы загляните в справочник, то увидите, что когда окно получает сообщение WM_MOUSEMOVE, информация прячется в параметры hwnd, wParam и IParam. Последний из этих параметров в своем младшем слове несет информацию о столбце, на котором находится курсор мыши, а в старшем — информацию о строке. Но благодаря взломщикам сообщений эта запутанная информация переводится в координаты х и у, видимые в заголовке KeyMouse_OnMouseMove. Функция KeyMouse_OnMouseMove делает параметры х, у и keyFlags видимыми на экране, сначала транслируя их посредством функции sprintf в символьную строку, а затем визуально отображая их с помощью функции TextOut. Это та же самая система, с которой вы уже встречались при изучении отклика на нажатие клавиши. Иногда мне кажется, что функция WndProc попадает в шквал сообщений, которые летят с такой скоростью, что от них буквально может помутиться рассудок. Вы можете почувствовать, как много сообщений WM_MOUSEMOVE посылается в программу, изучив функцию KeyMouse_OnMouseMove в действии. Помните, что всякий раз, когда на экране появляется новый набор координат мыши, очередное сообщение было обработано WndProc. Это все равно, как если бы оконная процедура пробиралась сквозь метель сообщений, обрушивающихся на нее со страшной силой.
Помимо координат мыши, с каждым сообщением WM_MOUSEMOVE посылается и другая информация, содержащаяся в аргументе keyFlags. Этот параметр может иметь одно из следующих значений: Константа Значение MK_CONTROL Нажата клавиша Control MK_LBUTTON Нажата левая кнопка мыши MK_RBUTTON Нажата правая кнопка мыши MK_MBUTTON Нажата средняя кнопка мыши MK_SHIFT Нажата клавиша Shift Эти константы являются битовыми флажками. Следовательно, вы должны исполь- зовать битовые операторы, чтобы проверить, установлены они или нет. Сделать это очень просто. Например, если вы хотите узнать, нажата ли клавиша Control во время движения мыши, то достаточно соединить keyFlags и MK_CONTROL логическим “И”, а затем проверить результат: if ((keyFlags & MK_CONTROL) == MK_CONTROL) DoSomething Чтобы увидеть, как именно происходит этот процесс, можно модифицировать функцию KeyMouse_OnMouseMove, чтобы выводимый текст изменял цвет в зависимос- ти от того, какие клавиши нажимаются: void KeyMouse_OnMouseMove(HWND hwnd, int x, int y, UINT keyFlags) ( char S[1OOJ; HDC PaintDC = GetDC(hwnd); sprintf(S, "WM_MOUSEMOVE ==> x = %d у = %d keyFlags = %d ", x, y, keyFlags); if ((keyFlags & MK_CONTROL) == MK_CONTROL) SetTextColor(PaintDC, RGB(O, 0, 255)); if ((keyFlags & MK_LBUTTON) == MK_LBUTTON) SetTextColor(PaintDC, RGB(0, 255, 0)); if ((keyFlags & MK_RBUTTON) == MK_RBUTTON) SetTextColor(PaintDC, RGB(255, 0, 0)); if ((keyFlags & MK_SHIFT) == HK_SHIFT) SetTextColor(PaintDC, RGB(255, 0, 255)); TextOut(PaintDC, XVal, YVal + B0, S, strlen(S)); ReleaseDC(hwnd, PaintDC); ) Модифицированная функция K.eyMouse_OnMouseMove способна реально продемон- стрировать всю мощь, присущую системе сообщений Windows. Строчка, ассоциирован- ная с WM_MOUSEMOVE, плавно изменяет цвета при нажатии клавиш Control и Shift. В процессе модификации функции KeyMouse_OnMouseMove я ввел вызовы Set- TextColor и RGB. Эти два вызова постоянно используются в Windows-программах. Поэтому стоит задержаться на несколько минут, чтобы ощутить, как они работают. Макрос RGB возвращает 4-байтное значение, определяющее цвет. Возвращаемый цвет определяется тремя параметрами, передаваемыми в макрос, каждый из которых может принимать значение от 0 до 255. Если третий параметр устанавливается равным 255, а остальные нулю, результирую- щий цвет будет темно-синим. Если первый параметр равен 255, а остальные нулю, то цвет будет красным. Средний параметр управляет интенсивностью зеленого в цвете, возвращаемом макросом RGB. В четвертом примере предыдущей функции синий и красный смешиваются в темно-бордовый. Если бы вы захотели получить серый цвет, то могли бы установить все значения, равными 127. Установка их всех в 0 дает густой черный, а в 255 — белый. Если вы одновременно включите зеленый и красный, то получите ярко-желтый. Поэкспери- ментировав всего несколько минут, вы нащупаете все интересные комбинации, которые могут быть получены с помощью этого мощного макроса.
Функция SetTextColor легче для понимания, нежели макрос RGB, поскольку она делает не более того, что означает ее имя. То есть устанавливает цвет текста, который выводится в передаваемый ей контекст устройства. Иначе говоря, она “копирует” результат функции RGB в контекст устройства. Обработка одинарных и двойных щелчков кнопкой мыши Программа KeyMouse использует функции KeyMouse_OnLButtonDown и Кеу- Mouse_OnLButtonUp для записи случаев нажатия кнопки. Работа этих функций очень похожа на работу всех остальных программ, представленных в этой главе, так что вы не должны сильно волноваться на этот счет. Легче понять, что происходит, когда кнопку отпускают, нежели когда ее нажимают. Поэтому начнем с функции KeyMouse OnLButtonUp. 224: void KeyMouse OnButtonUp(HWND hwnd, int x, int y, UINT keyFlags) 225: ( 226: char S[100]; 227 HDC PaintDC = GetDC(hwnd); 228: 229: sprintf(S, ”WM_BUTTONUP ==> x = %d у = %d keyFlags = %d ", 230: x, y, keyFlags); 231: TextOut(PaintDC, XVal, YVal + 120, S, strlen(S)); 232: 233: ReleaseDC(hwnd, PaintDC); 234: ) Нет ничего проще этого маленького помощника. Его цель — просто извещать пользователя, где находилась мышь, когда ее левую кнопку отпустили. Это достигается с помощью овладения контекстом устройства, а затем использования его для вывода информации на экран. Обработка нажатий кнопок немного сложнее, поскольку необходимо отличать оди- нарные щелчки от двойных. К счастью, д ля этого в Windows предусмотрена относительно простая система. Если вы хотите обрабатывать двойные щелчки левой или правой кнопками мыши, то должны начать с установки стиля окна в CS_DBLCLKS. Это делается в методе Register 84: win.style = CSHREDRAW | CS_VREDRAW I CS DBLCLKS; В данном случае вы видите, что стиль, ассоциированный с оконным классом, содержит три флажка, последний из которых говорит Windows о том, что этот класс хочет получать соответствующую информацию, когда пользователь дважды щелкает мышью в рабочей области окна. Сообщение, посылаемое при двойном щелчке левой кнопкой мыши, называется WM_LBUTTONDBLCLK, но соответствующий взломщик сообщения из WINDOWSX направляет эту информацию в ту же функцию, которая обрабатывает сообщения WM_LBUTTONDOWN. Замечание. Как правило, взломщики сообщений позволяют каждому отдельному сообщению иметь свой собственный обработчик. Но иногда, например, в случае WMJLBUTTONDBLCLK, WINDOWSX посылает несколько сообщений в одну функцию. Этот процесс иллюстрируется в нескольких местах предыдущей программы, в частности, в обработчиках сообщений WM KEY- DOWN (строчки 188 и 191) и WM_LBUTTONDOWN (строчки 210 и 214). Тем не менее следует помнить, что обработчики, которые получают более одного сообщения, являются очень редким исключением из правила. Чаще всего каждое сообщение имеет свой собственный обработчик. Изучите, как именно работает функция KeyMouse_OnLButtonDown. 202: void KeyMouse_OnLButtonDown(HWND hwnd, BOOL fDoubleClick, int 203: x, int у UINT keyFlags) 204: { 205: char S[100); 206: HDC PaintDC - GetDC(hwnd); 207:
208: if (fDoubleClick) 209: sprintf(S, 210: "WMBUTTONDBLCLK ==> Db - %d x = %d у = %d Flags = %d", 211: fDoubleClick, x, y, keyFlags); 212: else 213: sprintf(S, 214: "WM_BUTTOHDOWN ==> Db = %d x = %d у = %d Flags = %d", 215: fDoubleClick, x, y, keyFlags); 216: TextOut(PaintDC, XVal, YVal + 100, S, strlen(S)); 217: 218: ReleaseDC(hwnd, PaintDC); 219: ) Завладев контекстом устройства, функция проверяет, был ли сделан двойной щелчок или одинарный. В первом случае параметр fDoubleClick будет равен TRUE. При этом функция печатает строку, сигнализирующую, что было послано сообщение WM_LBUT- TONDBLCLK. Кроме того, функция информирует пользователя о текущем состоянии координат и об установках флажков. Разумеется, если двойного щелчка не было, пользователь извещается о приходе сообщения WM_LBUTTONDOWN. Тогда функция отображает текущее состояние всех параметров, включая координаты мыши в момент нажатия левой кнопки. Как я уже заметил, Windows-программы реагируют на изменение в их окружении подобно тому, как умело управляемая машина реагирует на дорожные знаки или повороты. Иначе говоря, Windows гарантирует, что программе посылается достаточно информации о ее окружении. Программист должен научить программу отвечать на эти сообщения. В этой главе вы видели, что Windows-программа может обработать целую лавину сообщений клавиатуры и мыши и не сбиться с пути. Резюме В этой главе вы проникли под поверхность Windows-программы с целью увидеть, как обрабатываются сообщения клавиатуры и мыши. В частности, вы изучили функции GetDC, ReleaseDC, RGB и SetTextColor. Вы также познакомились со способами обра- щения с такими константами Windows, как WK_CLEAR, WM_LBUTTONDBLCLK и MK_CONTROL. Очевидно, большинство читателей никогда не сможет запомнить все эти идентификаторы, поэтому вы должны научиться пользоваться справочником и доступной вам интерактивной помощью. Не пытайтесь заучить эти константы, лучше запомните места, где вы можете их найти. Разумеется, некоторые сообщения настолько важны, что вам всегда следует держать их в голове. Это относится, например, к WM_PAINT, WM_KEYDOWN, WM CHAR, WM MOUSEMOVE и WM LBUTTONDOWN. Эти сравнительно легкие для понимания сообщения снова и снова доказывают свою полезность при программировании прило- жений под Windows. Не нужно быть гением, чтобы понять, как работает система сообщений Windows. Она дает программистам тот род контроля над аппаратной частью компьютера, о котором так долго мечтали пользователи DOS. Поэтому задержитесь немного на материале этой главы. Но не переусердствуйте, поскольку этот материал несравним по своей важности и увлекательности со специальными графическими программами, которые вы увидите в следующей главе. Вопросы и ответы 1. Мне все еще не совсем ясна разница между сообщениями WMJKEYDOWN и WM_CHAR. Зачем последнее вообще нужно? Следует помнить, что сообщение WM KEYDOWN появляется, когда нажимается любая клавиша. Однако, когда это сообщение посылается в оконную процедуру, Windows еще не оттранслировала нажатйе клавиши. Поэтому легко запутаться при определении, какая именно клавиша была нажата. Сообщения WM CHAR идеальны для определения того, какая буквенно-цифровая клавиша была нажата пользователем.
2. В чем различие функций BeginPaint и GetDC? Функции BeginPaint и EndPaint используются только при ответе на сообщения WM PAINT. Поскольку сообщения WM PAINT посылаются в окно, когда его требуется обновить, все нарисованное на экране (в дисплейном контексте, взятым с помощью BeginPaint) видно всегда, пока видимо окно. Однако функция GetDC может быть вызвана фактически в любой момент в течение всей жизни приложения. Поэтому она дает вам значительно большую гибкость, чем функция BeginPaint. Но все нарисованное на экране в дисплейном контексте, полученном GetDC, сохраняется только до тех пор, пока окно не будет закрыто каким-либо другим объектом (например, другим окном или диалоговой панелью). Вопросы для самопроверки 1. Назовите два сообщения, посылаемых функции KeyMouse_OnLButtonDown. 2. Что представляют собой константы VK? 3. Что такое стиль CS DBLCLKS и когда он используется? 4. Какой цвет получается в результате обнуления всех трех параметров RGB? 5. Как проверить был ли установлен в параметре keyFlags бит MK_CONTROL? 6. Как по-другому называется системная клавиша? 7. Как передать сообщение из обработчика в DefWindowProc? 8. Куда переместится фокус, когда вы нажмете системную клавишу при программиро- вании KeyMouse? 9. Какая функция, на ваш взгляд, вызывается чаще: KeyMouse OnKey или Кеу- Mouse_OnChar? 10. Что произойдет, если вы забудете вызвать ReleaseDC после GetDC в функции KeyMouse_OnMouseMove? Упражнения 1. Используя sprintf, создайте программу, которая выписывает координаты мыши в момент выполнения щелчков левой и правой кнопками мыши и печатает координаты мыши в момент нажатия кнопки. 2. Воспользуйтесь функцией SetTextColor и макросом RGB, чтобы напечатать слово “красный” красным, “зеленый” — зеленым, а “синий” — синим цветом. 4 Чарльз Калверт
День 6 ВВЕДЕНИЕ В РЕСУРСЫ Эта глава представляет собой введение в ресурсы. Ресурсы позволяют размещать видимые и логические элементы программ, такие, как меню, таблицы строк и растровые изображения (bitmap) в специальных файлах, которые затем могут быть присоединены к программе. В конечном итоге получается простой и гибкий способ обогащения вашего кода новыми мощными возможностями. В этой главе обсуждается ряд специфических приемов, включающих: Создание сценариев ресурсов. Использование компилятора ресурсов. Создание меню. Создание пиктограмм. Создание пользовательских курсоров. В Создание определяемых пользователем ресурсов. К концу этого дня вы должны примерно представлять, что такое ресурсы и как их можно использовать для усиления ваших программ. Однако сегодня мы рассмотрим только первую часть темы. Вторая часть, представленная в следующей главе, сильно расширит ваше знание о ресурсах, показав, как использовать растровые изображения, диалоговые панели и таблицы строк. Ради приобретения вами практического опыта я включил в эту главу программу EMERSON.CPP, которая использует меню, диалоговую панель, растровое изображение, таблицу строк, определяемые пользователем ресурсы, специальную пиктотрамму и специальный курсор. Эта программа постепенно разрабатывается на протяжении двух глав. Сегодня мы начнем с простого, а более сложный предмет исследуем завтра. К концу этого двухэтапного процесса вы почувствуете, что можете создавать мощные и гибкие программы, которыми знаменита Windows. Иначе говоря, эти две главы помогут вам перейти из начального в средний класс. Так что же такое ресурсы вообще? Ресурсы представляют собой один из важнейших аспектов программирования в Windows. Эти особые файлы позволяют вам легко добавлять в свою программу новые свойства, почти также, как вы устанавливаете в новом автомобиле часы, стереоприемник или вешаете пару плюшевых игральных косточек. Дело в том, что эта деталь разработана “под ключ”. Нельзя сказать, чтобы ресурсы совсем не требовали никакой работы с вашей стороны. Купив новый стереофонический радиоприемник для своего автомобиля, вы должны пройти через процесс его установки. Точно так же, когда вы добавляете в свою программу
растровое изображение или пиктограмму, то должны установить эту новую деталь. Это требует некоторой работы, но не такой, как если бы вы начинали с нуля. Число различных типов ресурсов, которые могут быть добавлены в программу, не ограничено, однако на данном этапе истории Windows к ресурсам обычно относят меню, диалоговые панели, растровые изображения, пиктограммы, таблицы строк, шрифты, курсоры и, возможно, пару других инструментов. Поскольку существует устоявшаяся терминология, задержимся на минутку, чтобы дать определения каждого из главных ресурсов, используемых в Windows-программах. Меню обычно располагаются в верхней части основного окна; они предлагают пользователю словесные или символические опции, дающие возможность манипу- лировать особенностями программы. В последнее время возрастает популярность выскакивающих меню, которые располагаются в любом месте рабочего стола. И Диалоговые панели — это особые окна, которые обычно содержат редактируемые поля (edit controls), кнопки (push buttons), кнопки-селекторы (radio buttons), отмечаемые блоки (check boxes) и другие элементы управления, которые позволяют пользователю вводить данные или выбирать что-то из предложенного. Растровые изображения — это графические объекты, такие, как фотографии, картин- ки, рисунки, которые могут отображаться в окне или в диалоговой панели. Эти файлы имеют свой определенный формат и обычно расширение BMP. В Пиктограммы очень похожи на растровые изображения, но всегда имеют определен- ный размер. Когда программа минимизируется, ее пиктограмма появляется обычно в нижней части экрана. ъ И Таблица символьных строк — это список строк, хранимых в удобном формате. Хотя у них довольно много применений, Windows-программы часто используют таблицы строк для запоминания списка сообщений об ошибках. 1 Шрифты — это множество символов, использующихся для изображения текста или знаков на экране. Сложный мир шрифтов исследуется на следующей неделе в главах 9, Юи 11. В Курсор показывает расположение мыши на экране. Чаще всего в Windows использу- ется курсор в виде стрелки, песочных часов или балансира, но вы можете создать курсор любого типа, какого захотите, и отображать его в течение всей жизни вашей программы. Выше перечислены только самые общие типы ресурсов. Уже создано множество других типов, еще больше их будет создано в будущем. Некоторые компании продают фактически целые библиотеки пользовательских ресурсов. Ведь ресурсы в Windows конструируются таким образом, чтобы допускать возможность наращивания. Они огра- ничены только воображением Windows-программистов. В этой книге отводится не очень много времени на изучение пользовательских ресурсов, поскольку этот предмет может оказаться весьма сложным. Однако программа Emerson показывает, как создать очень простой пользовательский ресурс, состоящий всего из одной-единственной длинной строки, отображаемой на экране в виде стихо- творения. Хотя это и элементарный пример, он демонстрирует возможности, которыми не преминут воспользоваться изобретательные программисты. Большинство Windows-программистов обожают ресурсы. Если этот предмет нов для вас, то вас ждет приятный сюрприз. Ресурсы придают приложениям солидную мощь, требуя минимальных усилий с вашей стороны. Этот обзор ресурсов знаменует собой начало вольного исследования множества специальных свойств, доступных программистам в Windows. В эту систему было зало- жено много творческих идей, равно как и в программное наследие, на котором она возникла. Приготовьтесь собрать урожай!
Сценарии ресурсов Существует несколько путей создания ресурсов. Вероятно, наиболее простой и эффек- тивный способ заключается в использовании Resource Workshop (WORKSHOP.EXE) фирмы Borland и Арр Studio (APSTUDIO.EXE) фирмы Microsoft. Оба программных продукта являются прекрасными инструментами, позволяющими создавать меню, диа- логовые панели и растровые изображения, просто рисуя их на экране с помощью мыши. Тем не менее мы, как правило, будем иметь дело со сценариями ресурсов, известными также как RC- или DLG-файлы, поскольку они больше подходят для книги. После того как эти сценарии созданы, их можно пропустить через специальный компилятор (фирм Borland или Microsoft) и создать двоичные ресурсные файлы, имею- щие расширения RES. Оба средства визуального программирования (Borland или Mi- crosoft) могут создавать как RES-, так и RC-файлы. Поэтому я порой меняю свои предпочтения, переключаясь с визуального редактирования ресурсов с помощью Re- source Workshop на ручное редактирование текстового RC-файла. Проверьте, какая техника вам больше подходит. Чтобы сравнить результаты ваших экспериментов по визуальному проектированию с представленными здесь образцами, просто просмотрите текстовые файлы с расширением RC и DLG, которые вы создали. Программа Emerson. Часть первая Думаю, что теперь вы готовы познакомиться с исходным кодом программы Emerson. Поэтому перейдем прямо к делу. Начиная работать с этой программой, не забудьте скопировать файлы, использовавшиеся при создании WINDOW1.EXE в новый подка- талог. Пройдитесь по этим файлам, изменяя Windowl на Emerson, и переименуйте файлы WINDOW1.* в EMERSON.*. Эти шаги сэкономят массу времени и приучат вас к правильным приемам Windows- программирования. Иначе говоря, предполагается, что вы будете копировать блоки кода из одной программы в другую, а не начинать все “с нуля”. Не подумайте, что это жульничество. Это обычная нормальная техника Windows-программирования! В листинге 6.1 представлена первая версия программы Emerson. В следующей главе программа будет показана в завершенном виде. Листинг 6.1. Программа Emerson демонстрирует использование ресурсов 1: И----------------------------------------------------------- 2: II Программа: EMERSON 3: II Автор: Чарли Калверт 4: // Описание: Первая часть исследования ресурсов 5: //------------------------------==-------------------------- 6: 7: Sdefine STRICT 8: #include <windows.h> 9: #include <windowsx.h> 10: #pragma hdrstop 11: #include "Emerson, h" 12: #pragma warning (disable : 4068) 13: #pragma warning (disable : 4100) 14: 15: static char szAppName[] = "Emerson"; 16: static HINSTANCE hlnstance; 17: static HANDLE hResource; 18: 19: int Scrollwidth; 20: int MaxLineS ='21; 21: int Start = 33; 22: int TextHeight; 23: int PageSize; 24: int nPosition = 0; 25: 26: 11------------------------------------------------------------ 27: 11 ИНИЦИАЛИЗАЦИЯ 28: // ----------------------------------------------------------- 29:
30: llllllllllllllllllllllllllllllllllllllirilllllllllllllllllll 31: // Функция WinMain является точкой входа в программу. 32: // Регистрирует окно, создает его и входит в цикл сообщений. 33: // Прекращается при неудачном первом или втором шаге. 34: //////////////////////////////////////////////////////////// 35: ((pragma argsused 36: int PASCAL WinMain(HINSTANCE hinst, HINSTANCE hPrevInstance, 37: LPSTR IpszCmdParam, int nCmdShow) 38: { 39: MSG Msg; 40: 41: if ((hPrevInstance) 42: if ((Register(hinst)) 43: return FALSE; 44: 45: if ((Create(hinst, ncmdShow)) 46: return FALSE; 47: 48: while (GetMessage(SMsg, NULL, 0, 0)) 49: { 50: TranslateMessage(SMsg); 51: DispatchMessage(SMsg); 52: ) 53: 54: return Msg.wParam; 55: ) 56: 57: 58: ///////////////////////////////////////////////////////////// 59: // Регистрация окна 60: ///////////////////////////////////////////////////////////// 61: BOOL Register(HINSTANCE hinst) 62: { 63: WNDCLASS WndClass; 64: 65: WndClass.style = 66: WndClass.IpfnWndProc = 67: WndClass.cbClsExtra = 68: WndClass.cbWndExtra = 69: WndClass.hlnstance = 70: WndClass.hlcon = 71: WndClass.hCursor = 72: WndClass.hbrBackground = 73: WndClass.IpszMenuName = 74: WndClass.IpszClassName = 75: CS_HREDRAW I CS_VREDRAW; WndProc; 0; 0; hinst; Loadicon(hinst, "Icon"); Loadcursor(hinst, "Cursor"; GetStockBrush(WHITE_BRUSH); "Menu"; szAppName; 76: return Registerclass (sWndClass); 77: ) 78: 79: //////////////////////////////////////////////////////////// 80: // Создать и показать окно 81: //////////////////////////////////////////////////////////// 82: BOOL Create(HINSTANCE hinst, int nCmdShow) 83: ( 84: 85: hlnstance = hinst; 86: 87: HWND hwnd = CreateWindow(szAppName, szAppName, 8 8: WS_OVERLAPPEDWINDOW, 89: CW_USEDEFAULT, CW_USEDEFAULT; 90: CW_USEDEFAULT, CW_USEDEFAULT, 91: NULL, NULL, hinst, NULL); 92: 93: if (hwnd =•= NULL) 94: return FALSE ; 95: 96: ShowWindow(hwnd, ncmdShow); 97: UpdateWindow(hwnd); 98: 99: return TRUE; 100: ) 101: 102: //=======-====-=======—===========»-=============-=====«===== 103: // РЕАЛИЗАЦИЯ 104: //====================»===-===================================
105: 106: ///////////////////////////////////////////////////////////// 107: // Оконная процедура помогает управлять выполнением программы 108: ///////////////////////////////////////////////////////////// 109:_____________________LRESULT CALLBACK ____export WndProc(HWND hwnd, UINT Message, 110: WPARAM wParam, LPARAM IParam) 111: ( 112: switch(Message) 113: { 114: HANDLE MSG(hwnd, WM_CREATE, Emerson_OnCreate); 115: HANDLE MSG(hwnd, WM_DESTROY, Emerson_OnDestroy); 116: HANDLE MSG(hwnd, WM_COMMAND, Emerson_OnCommand); 117: HANDLE MSG(hwnd, WM_PAINT, Emerson_OnPaint); 118: default: return Emerson_Defproc(hwnd, Message, wParamlParam); 119: ) 120: ) 121: 122: //////////////////////////////////////////////////////////// 123: // Создание окна. 124: // Загрузка растрового изображения из файла ресурсов. 125: //////////////////////////////////////////////////////////// 126: ftpragma argsused 127: BOOL Emerson_OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) 128: { 129: hResource = LoadResource(hlnstance, 130: FindResource(hlnstance, "Brahma", "TEXT")); 131: return TRUE ; 132: } 133: 134: //////////////////////////////////////////////////////////// 135: // Деструктор 136: // Удалить растровое изображение из памяти 137: //////////////////////////////////////////////////////////// 138: ttpragma argsused 139: void Emerson_OnDestroy(HWND hwnd) 140: { 141: FreeResource(hResource); 142: PostQuitMessage(0); 143: } 144: 145: 146: /////////////////7///////////////////////////////////////// 147: // Процедура для управления диалоговой панелью 148://////////////////////////////////////////////////////////// 149: ftpragma argsused 150: void Emerson_OnCommand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify) 151: { 152: switch(id) 153: ( 154: case CM_ABOUT: 155: NotYetAvailable(hwnd); 156: break; 157: 158: case CM_BITMAP: 159: NotYetAvailable(hwnd); 160: break; 167: 162: case CM_BRAHMIN: 163: NotYetAvailable(hwnd); 164: brea k; 165: 166: case CM_WOODNOTES: 167: NotYetAvailable(hwnd); 168: break; 169: 170: case CM_SEASHORE: 171: NotYetAvailable(hwnd); 172: break; 173: ) 174: ) 175: 176: /////////////////////////////////////////////////////////// 177: // Обработчик сообщения WM_PAINT. 178: // Рисует несколько копий растрового изображения 179: ///////////////////////////////////////////////////////////
180: void Emerson_OnPaint(HWND hwnd) 181: ( 182: PAINTSTRUCT PaintStruct; 183: char far *Poem; 184: RECT Rect; 185: 186: HDC PaintDC = BeginPaint(hwnd, SPaint Struct); 187: 188: Poem = (char far *)LockResource(hResource); 189: GetClientRect(hwnd, SRect); 190: Rect.left += 10 191: Rect.top +“ 10; 192: DrawText(PaintDC, Poem, -1, SRect, DT_EXTERNALLEADING); 193: GlobalUnlock(hResource); 194: 195: Endpaint(hwnd, spaintStruct); 196: ) 197: 198: lllllllllllllllllllllllllllllllllllllllllllllllllllllllllll 199: // Печать сообщения "Пока недоступно" 200: /////////////////////////////////////////////////////////// 201: void NotYetAvailable(HWND hwnd) 202: ( 203: MessageBox(hwnd, "Not yet available", "Under Construction", MB_OK); 204: } Листинг 6.2. EMERSON.H 1: //=================.=======---:====»==.=====Я=М=========== 2: // Программа: EMERSON.H 3: // Автор: Чарли Калверт 4: // Описание: Заголовочный файл для EMERSON.СРР 5: Н=---=====================.==============>======.=.=====»» 6: «define CM_ABOUT 101 7: «define CMJBITMAP 201 8: «define CMJBRAHMIN 202 9: «define CMWOODNOTES 203 10: «define CM_SEASHORE 204 11: 12: II Макросы 13: «define max(a,b) (((a) > (b)) ? (a) : (b)) 14: «define min(a,b) (((a) < (b)) ? (a) : (b)) 15: 16: II Класс Emerson 17: «define Emerson_DefProc DefWindowProc 18: BOOL Emersоn_OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct); 19: void Emerson_OnDestroy(HWND hwnd); 20: void Emerson_OnCoiranand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify); 21: void Emerson_OnPaint(HWND hwnd); 22: 23: И Процедуры 24: BOOL Register(HINSTANCE hlnstance); f 25: BOOL Create(HINSTANCE hlnstance, int nCmdShow); 26: LRESULT CALLBACK __export WndProc(HWND hWindow, UINT Message, 27: WPARAM wParam, LPARAM IParam); 28: void NotYetAvailable(HWND hwnd); Листинг 6.3. EMERSON.RC 1: «include <windows.h> 2: «include "Emerson.h" 3: 4: /* Меню приложения Emerson */ 5: Menu MENU 6: BEGIN 7: POPUP " Poems " 8: BEGIN 9: MENUITEM "Bitmap", CM_BITMAP 10: MENUITEM "Brahmin", CM_BRAHMIN 11: MENUITEM "Woodnotes", CM_WOODNOTES 12: MENUITEM "Sea Shore", CM_SEASHORE 13: END 14: MENUITEM " SAbout " , CA_KBKKST 15: END
16: 17: 18: /* Пиктограмма */ 19: Icon ICON "Emerson.lco~ 28: 21: /* Стихотворение */ 22: Brahma TEXT Brahma.txt 23: 24: /* Курсор */ 25: Cursor CURSOR "emerson.cur" EMERSON.ICO (32x32) EMERSON.CUR (32x32) Листинг 6.4. Текст стихотворения Ральфа Эмерсона 1: Brahma 2: by Ralph Waldo Emerson 3: 4: If the red slayer think he slays 5: Or if the slain think he is slain. 6: They know not well the subtle ways 7: I keep and pass and turn again. 8: 9: Far or forget to me Is near; 10: Shadow and sunlight are the same; 11: The vanished gods to me appear; 12: And one to me are shame and fame. 13: 14: They reckon ill who leave me out 15: When me they fly, I am the wings; 16: I am the doubter and the doubt, 17: And I the hymn the Brahmin sings. 18: 19: The strong gods pine for my abode, 20: And pine in vain the sacred Seven; 21: But thou, meek lover of the good! 22: Find me, and turn thy back on heaven. Листинг 6.5. EMERSON.DEF 1: EMERSON. EEF 2: NAME Enerson 3: DESCRIPTION 'Emerson example' 4: EXETYPE WINDOWS 5: STUB 'WINSTUB.EXE* 6: CODE PRELOAD MOVEABLE DISCARDABLE 7: DATA PRELOAD MOVEABLE MULTIPLE 8: HEAPSIZE 4096 9: STACKSIZE 8192 Листинг 6.6. EMERSON.MAK (Borland) 1; « EMERSON.MAK 2: 3: APPNAME ~ Emerson 4: INCPATH - C:\BC\INCLUDE 5: LIBPATH - C:\BC\LIB 6: CFLAGS = -H -ml -W -v -w4 -IS(INCPA1H) -L$(LIBPATH) 7: 8: tt компоновка
9: $ (APPNAME) .ехе: $ (APPNAME). Obj $ (APPNAME) . Def $ (APPNAME) .Res 10: bcc $ (CFLAGS) $ (APPNAME) .obj 11: brc $(APPNAME).res 12: 13: # компиляция 14: $ (APPNAME) . ob j : $ (APPNAME) . cpp 15: bcc —c $ (CFLAGS) $ (APPNAME) .cpp 16: 17: # компиляция ресурсов 18: $ (APPNAME) . res: $ (APPNAME) . rc 19: brc —r -i$ (INCPATH) $ (APPNAME) .rc Листинг 6.7. EMERSON.MAK (Microsoft) 1: #====»=»:=«===«==»==»==»==»=:= 2: # EMERSON.MAK 3: #===«»===.====== 4: 5: APPNAME = Emerson 6: 7: 8: # компоновка 9: #=.»========.=.====.===== 10: $(APPNAME).exe : $(APPNAME).obj $(APPNAME).def $(APPNAME).res 11: link /CO $(APPNAME), /align:16, NUL, /nod llibcew libw, $(APPNAME) 12: rc $(APPNAME).res 13: 14: #================== 15: # компиляция 16: #================= 17: $(APPNAME).obj : $(APPNAME).cpp 18: cl —C -AL -GA -Ow -W4 -Zp -Zi $ (APPNAME) . cpp 19: 20: #=====«-=== 21: # компиляция ресурсов 22: #==================== 23: $ (APPNAME) .res: $ (APPNAME) .rc 24: rc —r $ (APPNAME) . rc 25: В этой версии основное окно программы Emerson имеет собственный специальный курсор и содержит одно стихотворение ,(см. рис. 6.1). В верхней части окна располагается простейшее меню. Если вы выберите любой пункт этого меню, то будете информированы о том, что программа еще не доделана. Если вы минимизируете программу Emerson, то она покажет специально разработанную для нее пиктограмму. I inerson Poems About Рис. 6.1. Окно приложения EMERSON.EXE. Книга в правом верхнем углу окна — курсор данной программы Brahma (~Г~ by Ralph Waldo Emerson If the red slayer think he slays Or If the slain think he Is slain. They know not well the subtle ways I keep and pass and turn again. Far or forget to me Is near: Shadow and sunlight are the same: The vanished gods to me appear: And ane to me are shame and fame. They reckon III who leave me out When me they fly, I am the wings; I am the doubter and the doubt And I the hymn the Brahmin sings. The strong gods pine for my abode. And pine In vain the sacred Seven: But thou, meek lover of the good) Find me, and turn thy back on heoven.
Взгляд вперед > RC-файл, показанный в предыдущих листингах во всей своей полноте, является ключом к пониманию ресурсов. Оставшаяся часть этой главы в основном посвящена анализу этого файла и тому, как можно использовать его фрагменты в своих программах* В частности, я строю изложение материала следующим образом: И Описываю компиляторы ресурсов. Привожу детальный обзор меню. Посвящаю несколько абзацев пиктограмме. Чуть дольше задерживаюсь на курсоре. Заканчиваю главу обсуждением способов отображения пользовательского ресурса на экране. В следующую главу включено исследование диалоговых панелей, растровых изобра- жений и строковых ресурсов. Данный материал вряд ли можно назвать исчерпывающим Исследованием ресурсов, но его будет достаточно, чтобы начать работать с этими полезными средствами. В дальнейшем все другие не менее важные факты, касающиеся ресурсов, будут объясняться по ходу дела. Использование компилятора ресурсов Прежде чем приступать к обсуждению ресурсов, необходимо сказать несколько слов о компиляторе, который можно использовать для трансляции RC-сценариев. Разумеется, если вы пользуетесь продукцией фирм Borland и Microsoft, то нет нужды выходить в DOS и явным образом запускать компилятор ресурсов. Все это сделает за вас интегрированная среда. Однако все-таки важно, чтобы вы понимали, что такая возможность существует И знали, как выполнить это задание в случае необходимости или особого желания. Помните, что после завершения формирования RC-файла вы можете компилировать его из командной строки, используя Microsoft Resource Compiler (RC.EXE) или Borland Resource Compiler (BRC.EXE). Команды для запуска обоих компиляторов по существу идентичны, но я выбрал для примера продукт фирмы Microsoft. Приверженцы фирмы Borland могут следовать ему, подставляя букву b перед буквами гс. Следующая строчка позволяет откомпилировать RC-файл в RES-файл. гс -г -ic: \bc\include enter son. г с Если все в порядке, у вас должен получиться файл EMERSON.RES. Но если задание завершилось кучей сообщений об ошибках, снова сравните свою работу с листингом, показанным выше. Пока не закончено обсуждение этого предмета, перечислю самые важные опции, доступные при использовании компилятора ресурсов. Предположим, у вас есть предва- рительно откомпилированный, исполняемый файл EMERSON.EXE, в который вы хотите добавить ресурс. Чтобы сделать это, нужно выдать следующую команду из DOS: г с EMERSON. НС EMERSON.EXE Или, если RES-файл уже существует, можете ввести гс EMERSON.RES EMERSON.EXE Получается, что в обоих этих примерах нет необходимости вводить имя исполняемого файла, потому что оно такое же, как и имя ресурса. Поэтому вы можете набрать в командной строке гс EMERSON.RC ИЛИ гс EMERSON.RES вместо команд из первых двух примеров.
Конечно, в большинстве случаев вы, вероятно, не будете запускать компилятор ресурсов непосредственно из командной строки, а обратитесь к нему либо из интегри- рованной среды, либо из проектного файла, либо из МАКЕ-файла (такого, как текстовый файл EMERSON.MAK (Microsoft), использовавшийся при генерации EMERSON.EXE). Беглого взгляда на этот МАКЕ-файл достаточно, чтобы заметить наличие синтаксичес- кого фрагмента, отсутствующего в МАКЕ-файл из главы 2. Еще более важными являются правила компиляции самого ресурса. Заметьте, что в. нижней части МАКЕ-файла я передал компилятору ресурсов параметр -г, дав таким образом инструкцию строить RES-файл, не объединяя его с EXE-файлом. Противопо- ложный подход наблюдается на этапе компоновки, когда файлы EMERSON.EXE EMERSON.RC объединяются. В этом случае вы опускаете параметр -г. Замечание. Пользователи Borland используют точно такой же подход при добавлении ресурсов в их МАКЕ-файлы. Иначе говоря, быстрое сравнение МАКЕ-файлов фирм Borland и Microsoft обнаруживает, что обе эти компании используют одну и ту же грамматику. Ура! Прежде чем потрузиться в описание меню, я, вероятно, должен дать коротенькую справку об операторах #include в верхней части RC-файла: 1: «include <windows.h> 2: ((Include "Emerson.h" Заголовок EMERSON.H в верхней части EMERSON.RC присутствует только потому, что содержит среди всего прочего следующую константу: «define CM_AB0UT 101 Эта константа присоединяется в качестве нового пункта к меню программы Emerson, при выборе которого появляется диалоговая панель. В этом случае собственно константа (Число) посылается в составе сообщения в основную оконную процедуру программы. Ваша задача как программиста состоит в том, чтобы научить программу Emerson правильно отреагировать на это число, когда оно достигнет WndProc. Следует также знать, что часто необходимо включать WINDOWS.H в верхнюю часть сценария ресурса. Эго делается из-за того, что компилятор ресурсов должен иметь доступ к различным константам. Например, если вы не включите в сценарий файл WIN- DOWS.H, то компилятор ресурсов фирмы Microsoft выдаст вам следующее сообщение:' ABOUT.RC(18); error RW2001: undefined keyword: DS_MODALFRAME Эта ошибка не произошла бы при использовании BRC, так как продукт фирмы Borland уже знает об определениях в WINDOWS.H. Поэтому пользователям Borland не требуется включать этот файл в свои сценарии и всякий раз ждать, пока он откомпили- руется. Создание простого меню Вот код, создающий меню для программы Emerson: 5: Menu MENU 6: BEGIN 7: POPUP "Poems" 8: BEGIN 9: MENUITEM "Bitmap", CM_BITMAP 10: MENUITEM "Brahmin", CMBRAHMIN 11: MENUITEM "Woodnotes", CM WOODNOTES 12: MENUITEM "Seashore", CM_SEASHORE 13: END 14: MENUITEM "SAbout", CM_ABOUT 15: END Очевидно, что код EMERSON.RC не будет понят компилятором Си, но может быть откомпилирован RC.EXE и BRC.EXE. Хотя все написано на языке, который вы не видели ранее, код для EMERSON.RC достаточно прост, чтобы не вызвать никаких серьезных проблем. Сценарий начинается с определения имени и типа ресурса, который предстоит использовать (строка 5). Эта
строка говорит, что ресурс является меню и носит имя Menu. Меню может иметь почти любое имя. Например, следующая строчка также верна: ABOUT_MENU MENU В функции Register имя меню передается структуре WndClass. Это имя является идентификатором данного ресурса: WndClass.IpszMenuName = "Menu"; Эта строка связывает меню с основным окном программы. Вам больше ничего не нужно делать, чтобы меню появилось. Все остальное возьмет на себя Windows без какого-либо участия с вашей стороны. Иногда программисты предпочитают экономить память, назначая для меню число вместо имени: 125 MENU BEGIN MENUITEM "Emerson", CM_ABOUT END Такие действия требуют немного другого подхода к функции Register. Например, если вы ассоциировали с вашим меню число 125, то можете загрузить его следующим образом. WndClass.IpszMenuName = "#125"; Иногда программисты случайно ассоциируют с ресурсом числовой идентификатор, даже если имеют в виду строку. Иначе говоря, они делают в своих сценариях что-то вроде следующего: «define MYMENU 125 MYMENU MENU BEGIN MENUITEM "Emerson", CM_ABOUT END Затем они пытаются ассоциировать строку MYMENU с соответствующим полем структуры WndClass: WndClass.IpszMenuName = "MYMENU"; Это не будет работать потому, что такая строка не ассоциирована с меню в файле ресурсов, чтобы исправить это вы должны написать WndClass.IpszMenuName = MAKEINTRESOURCE (MYMENU); Макрос MAKEINTRESOURCE преобразует числовые идентификаторы в нечто более удобное и понятное. Если вы хотите узнать больше о MAKEINTRESOURCE можете поискать его в WINDOWS.H. Присвоение имени меню представляет собой одну из тех ситуаций, когда количество вариантов, предоставляемых вам со стороны Windows, может превратить относительно простую операцию в сложную. Запомните, для того чтобы создать меню, вам нужно сделать следующее: Я Дать имя ресурсу меню. Передать это имя в соответствующее поле структуры WndClass. Вообще-то все эти штуки с числовыми идентификаторами и MAKEINTRESOURCE — просто излишество. Вы не должны использовать ничего такого, пока вам отчаянно не потребуется экономить память. Мой совет, даже в этой ситуации подумать дважды или даже трижды, прежде чем отойти от ясной технологии именования меню, основан- ной на строках. Конструирование меню Вы уже видели, как присваивать имя меню и как заставлять его появляться на экране. Следующий шаг — рассмотреть как сконструировать тело меню. Я расскажу о том, что находится в теле определения меню между операторами Begin и End.
Меню для программы Emerson состоит из двух отдельных частей: нормального элемента и выскакивающего меню. Если бы выскакивающее меню было удалено из программы Emerson, ресурсный файл для этого меню был бы очень простым: Menu MENU BEGIN MENUITEM "About", CM ABOUT END Эти несколько строчек создают меню показанное на рис. 6.2. csa ▼ 1 A About Brahma by Ralph Waldo Emerson If the red slayer think he slays Or if the slain think he Is slain. They know not well the subtle ways I keep and pass and turn again. Рис. 6.2. Фрагмент окна приложения EMERSON с упрощенной версией меню MENUITEM — это единичный элемент в меню, в то время как POPUP — это целое окно (например, выскакивающий перечень, который появляется, когда вы открываете меню File во многих основных приложениях). После объявления MENUITEM, в кавычках записывается символьная строка, которая должна быть показана в меню. Наконец, объявляется константа, которая должна быть ассоциирована с пунктом меню. Это очень простой язык. Например, если нужны дополнительные пункты меню, то можете вставить добавочные строчки, между Begin и End и определить константы, которые должны быть ассоциированы с каждым новым пунктом меню: /* EMERSON1.RC */ «define CM_DIALOG1 101; «define CM_DIALOG2 102; «define CMDIALOG3 103; BEGIN MENUITEM "Dialogl", CM_DIALOG1 MENUITEM "Dialog2", CM_DIAL0G2 MENUITEM "Dialog3", CM_DIALOG3 END Этот новый файл ресурсов создаст меню, подобное изображенному на рис. 6.3. Dialogl DialogZ Dlalog3 Brahma by Ralph Waldo Emerson if the red slayer think he slays Or if the slain think he is slain. They know not weil the subtle ways I keep and pass and turn again. Рис. 6.3. Меню, созданное с помощью модифицированной версии EMERSON.RC
Обратите внимание на порядок констант, определенных в предыдущем примере. Первый пункт определен как 101, но он также мог бы быть любым положительным беззнаковым целым. Я выбрал 101 лишь в силу привычки. Выбирайте для констант, использующихся в ваших меню, целые значения от 1 до 64К. Лучше избегать чисел, меньших 256 (0x100), поскольку иногда они могут обозначать в Windows-про- граммах что-то иное. Ассоциируйте идентификатор с каждым пунктом меню. Например, я ассоциировал CM DIA- LOG1, CMJD1ALOG2 и CM_DIALOG3 с пунктами меню предыдущего примера. Эти имена помогут упростить код, сделать его более читабельным и тем самым избежать ошибок. Не используйте одно и то же имя дважды, если не вполне уверены в том, что делаете. Если вы используете одно имя для двух различных пунктов меню, неприятности гарантированы. Когда пользователь выбирает конкретный пункт меню, соответствующая константа посылается в процедуру WndProc этой программы. И пункт меню, и ассоциированная с ним константа упаковываются в форме сообщения WM_COMMAND. В результате они обрабатываются функцией Emerson_OnCommand: 150: 151: void Emerson OnCommand:(HWND hwnd, int id, HWND hwndctl, UINT codeNotify) { 152: 153: 154: 155: 156: 157: 158: 159: 160: 161: 162: 163: 164: 165: , 166: ! 167: « 168: 169: ’• 170: ' 171: 172: 173: j 174: switch (id) { case CM_ABOUT: NotYetAvailable(hwnd); break; case CM-ABOUT: - . NotYetAvailable(hwnd); break; case CM—ABOUT: NotYetAvailable(hwnd); break; case CM_ABOUT: NotYetAvailable(hwnd); break; case CM__ABOUT: NotYetAvailable(hwnd); break; - . ) ) Как видите, каждый пункт меню обрабатывается в программе Emerson простым оператором case. На данном этапе разработки программы, ответом на выбор любого, пункта меню будет появление сообщения о том, что действия по этому пункту еще не реализованы. Дальнейшая разработка будет выполнена в следующей главе. Замечание. Если вы не используете WINDOWSX, то для того чтобы определить идентификатор выбранного пункта меню, вы можете посмотреть аргумент wParam, посылаемый в WndProc. Эго то же самое значение, которое передается в параметре id функции Cls OnCommand. Выскакивающее меню — это стандартное выпадающее меню, которое вы видите в верхней части окон большинства программ, таких, как меню File наверху окна вашего компилятора. Следующий фрагмент создает выскакивающее меню, показанное на рис. 6.4: POPUP "Роете" BEGIN MENUITEM "Bitmap", CM_BITMAP MENUITEM "Brahmin", CM_BRAHMIN MENUITEM "Woodnotes", CM_WOODNOTES MENUITEM "Seashore", CM_SEASHORE END
I IIII’C.OII 'ociris Bitmap About Brahmin Woodnotes SeaShore о Emerson г think he slays Or If the slain think he is slain. They know not well the subtle ways 1 keep and pass and turn again. Рис. 6.4. Выскакивающее меню активизируется при выборе его мышью. Оно фактически является окном, содержащим некоторый текст Как видите, выскакивающее меню состоит из заголовка, который виден в полоске меню И множества пунктов меню, заключенных между операторами begin и end. Пункты меню — это то, что вы видите, когда активизируется выскакивающее меню. Заметьте, что каждый пункт меню ассоциируется с константой, определенной в EMERSON.H. Эта константа посылается в процедуру WndProc программы, когда пользователь выбирает данный пункт меню. Сейчас я не собираюсь погружаться в этот предмет. Но если вы хотите получить более детальное описание, можете перейти прямо к главе 10. Добавление пиктограммы и курсора к EMERSON.СРР Единственный разумный способ создать пиктограмму состоит в том, чтобы восполь- зоваться программным средством, подобным Resource Workshop или Арр Studio. При работе с любым из этих инструментов акт создания пиктограммы сводится к приятной работе, заключающейся в рисовании картинки при помощи мыши. Замечание. Будем откровенны: рисование пиктограммы не требует той степени интеллектуаль- ного внимания, которое присуще даже относительно простому программированию. Поэтому я йе собираюсь объяснять здесь, как пользоваться Resource Workshop или Арр Studio для этой цели. Чтобы понять это, большинству читателей будет достаточно заглянуть в свои справочные руководства. Впрочем, это не означает, что не стоит уделять время созданию эффектных пиктограмм. Даже если вы не маниакальный трудоголик, который каждый день дорабатывается до грани серьезного помешательства, а просто обычный программист, вам следует найти время, чтобы насладиться неотъемлемой частью общей работы — созданием пиктограмм. Если вы этого не сделаете, люди не будут уважать ваши приложения. Пользователи обращают удивительно много внимания на кажущиеся тривиальными детали, такие, например, как внешний вид пиктограмм. После того как вы создадите пиктограмму, ее можно встроить в проект в два действия. Добавить следующую строчку в RC-файл: Emerson ICON "Emerson.ico" В методе Register поместите свою пиктограмму в поле WndClass.hIcon с помощью следующей строчки: WndClass.hlcon - Loadicon(hlnst, "Emerson"); Сравните предыдущую строчку Register со строчкой, использовавшейся в главах 3, 4 и 5: WndClass.hIcon - Loadicon(NULL, IDI_APPLICATION); Различия возникают здесь из-за того, .что в последнем примере загружается предва- рительно определенный ресурс Windows, а в предпоследнем — специально созданный ресурс.
При загрузке специально разработанной пиктограммы поместите в первый параметр Loadicon дескриптор программы, содержащей ресурс пиктограммы, а во второй — имя пиктограммы. В большинстве случаев таковой программой является текущая, так что фактически следует передавать дескриптор типа HINSTANCE вашего приложения. Загружая предварительно определенный ресурс Windows, поместите в первый пара- метр Loadicon NULL, а затем укажите идентификатор требуемого ресурса во втором параметре. Как уже говорилось, предварительно определенные ресурсы Windows пере- числены в WINDOWS.H: «define IDI_APPLICATION «define IDI_HAND «define IDI_QUESTION «define IDI_EXCLAMATION «define IDI_ASTERISK MAKEINTRESOURCE(32512) MAKEINTRESOURCE(32513) MAKEINTRESOURCE(32514) MAKEINTRESOURCE (32515) MAKEINTRESOURCE(32516) Если вдуматься, то эти два подхода различаются не так сильно, как может показаться. Обычно вы должны указывать дескриптор приложения, в котором располагается ресурс пиктограммы. Однако встроенные в Windows ресурсы не принадлежат ни одному приложению. Они просто являются частью системы. Поэтому вместо дескриптора типа HINSTANCE можете указать NULL! После рассмотрения способов создания пиктограмм легко перейти к объяснению курсоров. Здесь опять вы должны начать с внимательного определения курсора в Resource Workshop. Замечание. Я “позаимствовал” свой курсор в виде книги из шрифта WingDings, содержащемся в Windows. Воспользовавшись программой Charmap из подкаталога Windows, я скопировал выбранный символ в редактор Write, увеличил его до желаемого размера, а затем нажал кнопку Print Screen, чтобы скопировать текущий экран в системный буфер (clipboard). Следующие шаги состояли в том, чтобы передать содержимое этого буфера в программу Paintbrush, вырезать там исходный символ и вновь поместить его в системный буфер, но в формате растрового изобра- жения. Наконец, осталось лишь передать это изображение в инструментарий для разработки курсоров Resource Workshop и сохранить результат. Уфф! Выглядит довольно сложным, когда описываешь все таким образом. Тем не менее весь процесс занял у меня лишь несколько минут, хотя, несомненно, мог бы занять несколько часов, если бы я создавал эту картинку сам. Я рассказываю вам все это для того, чтобы показать, как приложения Windows могут взаимодей- ствовать при создании нового средства, превосходящего по своим возможностям любое из этих приложений. После того как вы создадите свой курсор, можете присоединить его к своему приложению с помощью функции Register следующим образом. WndClass.hCursor = Loadcursor(hinst, "Cursor"); Снова следует сравнить эту строчку с методами, показанными ранее: WndClass.hCursor = Loadcursor(NULL, IDC_ARROW); Ясно, что при загрузке курсоров, применяются те же самые правила, что и при загрузке пиктограмм. Если вы загружаете специальный курсор или особую пиктограмму, передавайте дескриптор программы в качестве первого параметра LoadCursor или Loadicon. Не передавайте дескриптор типа HINSTANCE программы в LoadCursor или Loadicon, если вы загружаете системный ресурс, определенный с помощью одной из констант в WINDOWS.H. Вот и все об этом. С технической точки зрения, добавить курсор или пиктограмму к вашей программе довольно просто. Впрочем, курсоры и пиктограммы имеют некоторые немного более сложные особенности. Речь идет о помещении пиктограмм в диалоговые панели и окна, а также о переключении курсоров во время выполнения программы. Поскольку эти вещи сложнее и реже используются, я опишу их в главе 10.
Ресурсы, определяемые пользователем Ранее я говорил, что вы можете создавать свои типы ресурсов. В программе Emerson этот прием используется, чтобы сделать ресурс вне текстового файла. Такой трюк возможен благодаря тому, что Windows позволяет хранить исходные данные в ресурсных файлах. Эти данные могут быть в любом формате, который вы сочтете пригодным. При загрузке ресурса в свою программу, требуется лишь установить указатель на эти данные с помощью функции LoadResource. После этого Windows умывает руки и позволяет делать все, что угодно с двоичными данными, которые она вам дала. В итоге все, что можно хранить в памяти, может быть помещено в ресурсный файл и выбрано оттуда с помощью LoadResource. Очевидно, это открывает невероятный простор для творчества программистов. В этом частном случае я не хочу связываться с чем-то очень вычурным, поэтому Emerson использует простой текстовый ресурс, содержащий стихотворение, который можно легко загрузить с диска и показать на экране. Теперь вы не удивитесь, услышав, что весь этот процесс начинается с определения ресурса в RC-файле. Чтобы определить этот ресурс, просто наберите текстовой файл и запишите его на диск. После создания файла можете дать Windows инструкцию сохранить его в RFS- файле, напечатав следующую строчку в EMERSON.RC: Brhhma TEXT Brahma.txt Эта строчка имеет тот же формат, что вы уже видели при определении курсора, растрового изображения и пиктограммы в ресурсном файле. Иначе говоря, определяются следующие элементы: В Имя ресурса (в данном случае Brahma). В Тип ресурса. В данном случае взято наименование TEXT, потому что оно объясняет, какой тип ресурса я создал. Впрочем, с таким же успехом можно было бы использо- вать слово РОЕМ или слово FOOBAR. Важно лишь то, что этот тип является уникальным идентификатором, на который я могу ссылаться внутри моей программы. В Имя файла, который я хочу включить в свою программу. Очевидно, Windows считает этот файл ни чем иным, как массивом двоичных данных. Ей все равно, что находиться внутри этого файла. Эти шаги гарантируют, что после компиляции программы Emerson, результирующий EXE-файл будет содержать копию стихотворения. Остается лишь загрузить ресурс с диска в память. Это делается с помощью обращения к LoadResource и FindResource в ответ на сообщение WM_CREATE: hResource = LoadResource(hlnstance, FindResource(hlnstance, "Brahma", "TEXT")); Теперь предыдущая строчка должна быть вполне понятна. Программа просто пере- дает дескриптор EXE-файла, содержащего ресурс, а затем сообщает FindResource его имя и тип. FindResource сканирует исполняемый файл в поисках ресурса. После нахождения ресурса FindResource передает его идентификатор в функцию LoadResource, которая затем физически перемещает объект в память. Замечание. Фирма Microsoft в своей литературе констатирует, что Loadicon и LoadCursor вызывают LoadResource и FindResource. Иначе говоря, описанный выше процесс более явным образом выполняет то, что обычно скрыто в функциях более высокого уровня. После загрузки ресурса требуется заблокировать используемую память, перед тем как с ним работать: Poem = (char far *)LockResource(hResource); Как видите, программа Emerson выполняет приведение типа указателя, возвращаемого LockResource. Теперь программа непосредственно адресует возвращенные LockResource бинарные данные как символьную строку, что, собственно говоря, и есть на самом деле.
Теперь программа Emerson может вывести эту символьную цепочку на экран, чтобы пользователь смог прочесть стихотворение. Для этого следует, во-первых, получить размеры основного окна, а затем отобразить в нем текст стихотворения с помощью вызова DrawText. После того как текст выведен на экран, программа может разблокировать данные и продолжить свое дело: GLobalUnLock(hResource); Разблокирование памяти не означает, что объект уничтожен. Это означает только то, что память больше не заперта. Чтобы полностью освободить ресурс, требуется явно вызвать FreeResource, как и в случае ответа на сообщение WM DESTROY: FreeResource(hResource) Впрочем, это не является абсолютно необходимым, так как память будет автомати- чески освобождена после завершения программы. Пользовательские ресурсы. Дополнительные мысли Этот последний раздел есть не что иное, как пятиминутное введение в довольно сложный предмет. Я собираюсь добавить к нему несколько комментариев, но если вам не интересно, то можете не вникать слишком глубоко в этот материал. Я привожу его на случай, если среди читателей найдутся любопытные. Когда программа впервые загружается в память, ее ресурсы необязательно загружа- ются вместе с ней. Это оказывается возможным потому, что формат исполняемых модулей очень сильно отличается от того, который господствовал в эпоху царствования DOS. Сейчас эти файлы основываются на так называемом новом исполняемом (NE) формате. Одним из свойств этого нового типа файла является способность сосущество- вать с ресурсами и оказывать им поддержку. Если по каким-либо причинам вы не хотите, чтобы текст оставался на диске, после того как загружен исполняемый модуль, то должны пометить его как PRELOAD: Brahma TEXT PRELOAD FIXED Brahma.txt В результате, стихотворение будет загружаться в память вместе с программой, то есть перед обращением к LoadResource. Впрочем, соображения экономии памяти чаще всего заставляют программистов до поры до времени держать ресурсы на диске. Программа Emerson загружает ресурсы в память с помощью вызова сначала FindResource, а затем LoadResource. Однако это не означает, что ресурсы сразу же располагаются в памяти. Windows рассматривает ресурсы как DISCARDABLE, если только Они не помечены явно как FIXED (см. предыдущий пример). DI SCARDAB LE-объекты могут быть сброшены на жесткий диск, если Windows чувствует, что какие-то другие динамические объекты имеют большее значение. Если ресурс Brahma вытесняется на диск, то при обращении к LockResource он должен быть снова загружен в память. Соответствующий механизм встроен в LockResource, и резуль- тат этой функции гарантирует, что ресурс Brahma не будет передвинут или удален до тех пор, пока не вызвана функция UnlockResource или функция GlobalUnlock. Иначе говоря, если вызывается LoadResource и при этом обнаруживается, что ресурс Brahma был удален, программа сначала перезагружает ресурс Brahma с диска, а затем блокирует его в памяти. Будучи заблокированным, ресурс не может быть перемещен или сброшен обратно на диск. Это удобное состояние, но не для длительного периода времени. Поэтому важно вызвать GlobalUnlock как можно скорее после блокирования ресурса и показа его на экране. Надеюсь, что это обсуждение прояснило разницу между обращением к GlobalUnlock и FreeResource. Первое может только дать Windows разрешение передвинуть или удалить из памяти, в то время как второе явным образом предписывает Windows освободить память ресурса.
•’ Есть еще один, последний сюжетный поворот этого повествования, которого следует коснуться, коль скоро уж я зашел так далеко. Как вы знаете, Windows может загружать несколько копий программы в память. Однако обычно она не загружает в память несколько копий ресурсов. Иначе говоря, если в памяти существуют три копии програм- мы ‘Emerson, то все они будут пользоваться одной и той же копией пользовательского ресурса Brahma. Чтобы приспособиться к этой ситуации Windows устанавливает флажок, когда вызывается LoadResource и сбрасывает его, когда вызывается FreeResource. Ника- кой конкретный ресурс не будет действительно удален из памяти до тех пор, пока обращение к FreeResource не сбросит этот флажок. Таким образом, ресурс доступен, пока копия программы Emerson находиться в Памяти. Очевидно, что многое из происходящего за кулисами не вошло в мое пятиминутное введение в предмет пользовательских ресурсов. Впрочем, хочу отметить, что для того чтобы просто пользоваться пользовательским ресурсом TEXT, не обязательно все это понимать. Я привел эту дополнительную информацию по двум причинам: 1. Некоторых не удовлетворяет чисто механическое заучивание предмета. Чтобы чувствовать себя комфортно в некоторой технологии, им требуется понимать ее. 2. Для того чтобы дать настоящее введение в ресурсы, нужно было приоткрыть занавес настолько, чтобы вы могли увидеть за кулисами маленького человечка, который трогает рычаги и нажимает кнопки. Вы не сможете понять всей кухни, не познакомившись с ним. Резюме В этой главе было представлено введение в ресурсы. Вы увидели, что ресурсы являются логическими или визуальными элементами, которые могут быть довольно просто встроены в программу. Вы также узнали, что ресурсы определяются в RC-файле, который компилируется в RES-файл и в конце концов сливается с исполняемым файлом программы. Среди ресурсов особенно подробно были рассмотрены меню. Вы узнали, как при- писывать константы конкретным пунктам меню, и поняли, что при выборе пункта меню эти константы посылаются в WndProc в форме сообщения WM_COMMAND. Вы увидели, что функция Emerson_OnCommand реагирует на каждую из этих констант. Во время обсуждения пиктограмм и курсоров вы узнали о различии между ресурсами, принадлежащими системе, и ресурсами, загружаемыми с диска. Вы видели, что в первом случае можно указать NULL в качестве первого параметра LoadResource и Loadicon, а в последнем случае — дескриптор программы (тип HINSTANCE). Последние два раздела этой главы были посвящены пользовательским ресурсам. Это обсуждение было закончено обзором того, как Windows обращается с памятью, ассоци- ированной с ресурсом. Следующая глава, “Сложные ресурсы: растровые изображения и диалоговые панели” продолжает это обсуждение, исследуя растровые изображения, диалоговые панели и строковые ресурсы. До завтра! Вопросы и ответы 1. Меня смущает все это разнообразие компиляторов. В чем точно состоит разница между RC.EXE, BRC.EXE, WORKSHOP.EXE, APPSTUDIO.EXE и моим компилятором? Вначале существовал только один компилятор, который использовался только для компиляции исходного кода языка Си. Когда появилась идея добавления ресурсов, Microsoft разработала RC.EXE, который может компилировать RC-файлы и добавлять их в файл нового исполняемого формата. BRC — просто аналог этой программы, разработанный в фирме Borland. После того как люди немного поработали с ресурсами, стало ясно, что их создание могло бы сильно упроститься, если бы программистам было позволено просто рисовать необходимые им элементы на экране. Так родились средства, подобные Resource Workshop и Арр Studio. Чтобы сделать эти средства более мощными, разработчики компиляторов придали им способность либо обращаться к RC.EXE, либо
делать все то же самое, что и RC.EXE. Чтобы подвести черту, мне, вероятно, следует добавить, что все касающееся ресурсов стоит в стороне от того, что делают компиляторы базового Си и Си++. 2. В чем состоит разница между UnlockResource я GlobalUnlock? UnlockResource — это просто макрос, который вызывает GlobalUnlock для выполне- ния всей работы. GlobalUnlock чаще всего применяется с функциями GlobalAlloc, Global Lock и GlobalFree. Эти функции используются для распределения памяти, подобно тому, как функция malloc используется для этой цели DOS’obckhm компилятором языка Си. В случае GlobalAlloc, как правило, было необходимо блокировать память перед ее использованием. Аналогично необходимо блокировать пользовательский ресурс, прежде чем работать с ним. 3. А все-таки, кто же такой этот Эмерсон, а? Ральф Уолдо Эмерсон, житель Новой Англии, родился в 1803 и умер в 1882 г. В начальный период своей жизни он был священником Унитарианской церкви, но затем стал одним из видных сторонников трансцендентализма. Он чаще всего упоминается как автор философских эссе, но некоторые люди также ценят его поэзию. Уолт Уитмен считал влияние Эмерсона определяющим для своего творчества. Вопросы для самопроверки 1. Как заставить компилятор ресурсов (RC.EXE) преобразовать файл EMERSON.RC в RES-файл? 2. Как заставить компилятор ресурсов объединить EMERSON.RES и EMERSON.EXE в один файл. 3. Каково значение CM ABOUT в следующем операторе? MENUITEM "About", CM_ABOUT 4. В чем разница между выскакивающим меню и пунктом меню? 5. Какой первый параметр передается в Loadicon? 6. Когда после выбора меню сообщение WM COMMAND передается в окно, то какой из параметров WndProc содержит идентификатор пункта меню? 7. Чем отличаются FindResource и LoadResource? 8. Чем отличаются GlobalUnlock и FreeResource? 9. Что такое файл нового исполняемого формата? 10. Могут ли ресурсы храниться в DLL? Упражнения 1. Используя пользовательские ресурсы для хранения текста, напишите программу, показывающую в своем основном окне текст своей процедуры WinMain. 2. Напишите программу, которая может использовать пользовательские ресурсы для показа двух различных кусков текста. Дайте пользователю возможность переключаться с одного из этих текстов на другой и обратно посредством выбора различных пунктов меню.
День 7 РАСТРОВЫЕ ИЗОБРАЖЕНИЯ И ДИАЛОГОВЫЕ ПАНЕЛИ Эта глава представляет собой обзор трех довольно хитрых ресурсов: диалоговых панелей (или просто диалогов), растровых изображений и таблиц символьных строк. Таблицы символьных строк достаточно просты в использовании, а вот рассмотрение диалоговых панелей и растровых изображений может оказаться преждевременным, поскольку они связаны с управлением памятью для относительно сложных системных ресурсов. В частности, в этой главе рассматриваются: Создание и использование диалоговых панелей. Создание и использование растровых изображений. И Создание и использование таблиц строк. Создание и использование линеек прокрутки. Обзор внутренних процессов программы Emerson. Я ввожу линейки прокрутки в этой главе прежде всего потому, что они требуются для программы Emerson. Однако должен заметить, что линейки прокрутки — это не ресурсы, а элементы управления. В целом элементы управления будут подробно обсуж- даться на следующей неделе. В центре этой главы находятся растровые изображения и диалоговые панели. Оба эти предмета достаточно сложны, чтобы занять собой несколько глав. Моя цель — дать вам базовые знания, необходимые для того, чтобы визуально отображать диалоговые панели и растровые изображения. В следующих нескольких главах у вас будет достаточно возможностей попрактиковаться в этой технике. В начале третьей недели наметятся более глубокие аспекты этих двух предметов. Emerson2 Первым делом вынесем на всеобщее обозрение программу Emerson2. Она представ- ляет собой продолжение и завершение программы, начатой в предыдущей главе. Большая разница заключается в том, что Emerson2 использует для хранения текста строковые таблицы, в то время как первая версия — Emerson — использовала специаль- ные нестандартные ресурсы. Познакомьтесь с исходным кодом (листинг 7.1). Листинг 7.1. EMERSON2.CPP 1: // =====-=======-======-=============-=======-========= 2: // Программа: EMERSON2 3: // Автор: Чарли Калверт
4: // Описание: Пример программы, содержащей таблицы символьных строк 5: // диалоговые панели и растровые изображения 7: 8: #define STRICT 9: ((include <windows. h> 10: ((include <windowsx.h> 11: ((pragma hdrstop 12: ((include <string.h> 13: ((include "Emerson2.h" 14: ((pragma warning (disable : 4100) 15: ((pragma warning (disable : 4068) 16: static char szAppName[] “ ”Emerson2"; 17: static HINSTANCE hlnstance; 18: 19: int MaxLlnes = 21; 20: int Start = 32; 21: int TextHeight; 22: int PageSize = 10; 23: int nPosition = 0; 24: BOOL DrawBitmaps = TRUE; 25: 26: / 27: // ИНИЦИАЛИЗАЦИЯ 28: //======================================-===----=-=—--------- 29: 30: //////////////////////////////////////////////////////////// 31: // Функция WinMain — точка входа в программу 32: //////////////////////////////////////////////////////////// 33: ((pragma argsused 34: int PASCAL WinMain(HINSTANCE hinst, HINSTANCE hPrevInstance, 35: LPSTR IpSzCmdParam, int nCmdShow) 36: ( 37: MSG Msg; 38: 39: if ((hPrevInstance) 40: if ((Register(hinst)) 41: return FALSE; 42: 43: if ((Create(hinst, nCmdShow)) 44: return FALSE; 45: 46: while (GetMessage(SMsg, NULL, 0, 0)) 47: ( 48: TranslateMessage(SMsg); 49: DispatchMessage(SMsg); 50: ) 51: 52: return Msg.wParam; 53: ) 54: 55: 56: ////////////////////////////////////////////////////////// 57: // Регистрация окна 58: ////////////////////////////////////////////////////////// 59: BOOL Register(HINSTANCE hinst) 60: ( 61: WNDCLASS WndClass; 62: 63: WndClass.style 64: WndClass.IpfnWndProc 65: WndClass.cbClsExtra 66: WndClass.cbWndExtra 67: WndClass.hlns tance 68: WndClass.hlcon 69: WndClass.hCursor 70: WndClass.hbrBackground 71: WndClass.IpszMenuName 72: WndClass.IpszClaSSName 73: = CS HREDRAW I CS_VREDRAW; = WndProc; “ 0; = 0; = hinst; • Loadicon(hinst, "Emerson2") = LoadCursor(NULL, IDC_ARROW) = GetStockBrush(WHITE_BRUSH); = "MENU_1"; = SzAppName; 74: return Registerclass (sWndClass); 75: ) 76: . 77: //////////////////////////////////////////////////////////// 78: // Создать и показать окно
79: //////////////////////////////////////////////////////////// 80: 81: 82:. 83: 84: 85: 86: 87: 88: 89: 90: 91: 92: 93: 94: 95: 96: 97: 98: 99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 135: 136: 137: 138: 139: 140: 141: 142: 143: 144: 145: 146: 147: 148: 149: 150: 151: 152: BOOL Create(HINSTANCE hlnst, int nCmdShow) { hlnstance = hlnst; HWND hwnd = CreateWindow(szAppName, szAppName, WSOVERLAPPEDWINDOW 1 WSVSCROLL, CWUSEDEFAULT, CW_USEDEFAULT, CW USEDEFAULT, CW_USEDEFAULT, NULL, NULL, hlnst, NULL); if (hwnd == NULL) return FALSE ; ShowWlndow(hwnd, nCmdShow); UpdateWindow(hwnd); return TRUE; ) /////////////////////////////////////////////// // РЕАЛИЗАЦИЯ /////////////////////////////////////////////// /////////////////////////////////////////////// // Оконная процедура помогает управлять // выполнением программы /////////////////////////////////////////////// LRESULT CALLBACK export WndProc(HWND hwnd, UINT Message, WPARAM wParam, LPARAM IParam) < switch(Message) ( HANDLE_MSG(hwnd, WM_CREATE, Emerson_OnCreate); HANDLE_MSG(hwnd, WM_DESTROY, Emerson_OnDestroy); HANDLE_MSG(hwnd, WM_COMMAND, Emerson_OnCommand); HANDLE_MSG(hwnd, WM_KEYDOWN, Emerson_OnKey); HANDLE MSG(hwnd, WMPAINT, Emerson_OnPaint); HANDLE MSG(hwnd, WM_VSCROLL, Emerson_OnVScroll); default: return Emerson DefProc(hwnd. Message, wParam, IParam); ) ) ////////////////////////////////////////////////////////////////// // Создание окна. // Загрузка растрового изображения из ресурса IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII #pragma argsused BOOL Emerson OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) { TEXTMETRIC TextMetrics; TheBitmap = LoadBitmap(hlnstance, "Bitmap"); if (!TheBitmap) ( Message box(hwnd, "No Bitmap", "Fatal Error", МВ_Ок); return FALSE; ) HDC PaintDC = GetDC(hwnd); GetTextMetries(PaintDC, STextMetrics); ReleaseDC(hwnd, PaintDC); TextHeight - TextMetrics.tmHeight + TextMetrics.tmExternalLeading; SetScrollRange(hwnd, SB_VERT, 0, MaxLines - Start, FALSE); return TRUE; ) ////////////////////////////////////////////////////// 153: // Деструктор. Удаляет растровое изображение из памяти
154: lllllllllllllllllllllllllllllltlllllllllllllllllllllll 155: #pragma argsused 156: void Emerson_OnDestroy(HWND hwnd) 157: { 158: DeleteBitmap(TheBitmap); 159: PostQuitMessage(m); 160: ) 161: 162: ///////////////////////////////////////////////////// 163: // Процедура управления диалоговой панелью 164: ///////////////////////////////////////////////////// 165: #pragma argsused 166: void Emerson_OnCommand(HWND hwnd, int id, 167: HWND hwndCtl, UINT codeNotify) 168: ( 169: switch(id) 170: ( 171: case CM_AB0UT: 172: ( 173: FARPROC AboutBox = 174: MakeProcInstance((FARPROC)AboutDlgProc, hlnstance); 175: DialogBox(hlnstance, "About", 176: hwnd, (DLGPROC) AboutBox),- 177: FreeProcInstance(AboutBox); 178: break; 179: ) 180: 181: case CM_BRAHMIN: 182: Start = 32; 183: MaxLines = 22; i84: InvalidateRect(hwnd, NULL, TRUE); 185: DrawBitmaps = FALSE; 186: break; 187: 188: case CM_W00DN0TES: 189: Start = 0; 190: MaxLines = 32; 191: InvalidateRect(hwnd, NULL, TRUE); 192: DrawBitmaps = FALSE; 193: break; 194: 195: case CMJSEASHORE: 196: Start = 64; 197: MaxLines = 37; 198: InvalidateRect(hwnd, NULL, TRUE); 199: DrawBitmaps = FALSE; 200: break; 201: 202: case CM_DRAWBITMAPS: 203: DrawBitmaps = TRUE; 204: InvalidateRect(hwnd, NULL, TRUE); 205: break; 206: ) 207: ) 208: 209: ///////////////////////////////////////////////////// 210: // Обработка сообщения WM KEYDOWN. Прокрутка текста 211: //////////////////////111111111111/////////////////// 212: #pragma argsused 213: void EmersonjOnKey(HWND hwnd, UINT vk, BOOL fDown, int CRepeat, UINT flags) 214: ( 215: switch(vk) 216: ( 217: case VK_H0ME: 218: SendMessage(hwnd, WM_VSCROLL, SB_TOP, 0L); 219: break; 220: 221: case VK_DOWN: 222: SendMessage(hwnd, WM_VSCROLL, SB_LINEDOWN, 0L); 223: break; 224: 225: case VK_UP: 226: Send Message(hwnd, WM_VSCROLL, SB_LINEUP, 0L); 227: break; 228: }
229: } 230: 231: ////////////////////////////////////////////////////////////////// 232: // Обработка ИМ PAINT. Отображение текста стихотворения и картинки 233: 11111-1111111111111111111111111111111111111111111111111111111111111 234: void Emerson OnPaint(HWND hwnd) 235: ( 236: PAINTSTRUCT PaintStruct; 237: SIZE L ; 238: int Numlmages " 15; 239: char S[101]; 240: int Y = 0; 241: 242: HDC PaintDC = BeginPaint(hwnd, SPaint Struct); 243: 244: 245: if (DrawBitmaps) 246: ( 247: HDC BitmapDC « CreateCompatibleDC(PaintDC); 248: HBITMAP OldBitmap - SelectBitmap(BitmapDC, TheBitmap); 249: for (int i “ 0; i < Numlmages; i++) 250: for (int j - 0; j > Numlmages; j++) 251: BitBlt(PaintDC, i * 66, j * 66, 64, 64, 252: BitmapDC, 0, 0, SRCCOPY); 253: SelectBitmap(BitmapDC, OldBitmap); 254: DeleteDC(BitmapDC); 255: ) 256: else 257: ( 258: HPEN APen - CreatePen(PS NULL, 0, 0); 259: HPEN SavePen = SelectPen(PaintDC, APen); 260: for (int i " nPosition; i < MaxLines; i++) 261: ( 262: Loadstring(hlnstance, i + Start, S, 180); 263: TextOut(PaintDC, 1, Y, S, strlen(S)); 264: GetTextExtentPoint(PaintDC, S, strlen(S), SL); 265: if (L.cx — 0) 266: Rectangle(PaintDC, 1, Y, 400, Y t 1 + TextHeight); 267: else 268: Rectangle(PaintDC, L.cx, Y, 269: L.cx + 200, Y + 1 + TextHeight); 270: Y += TextHeight; 271: ) 272: Rectangle(PaintDC, 1, Y, 400, Y + 1 + 400); 273: SelectPen(PaintDC, SavePen); 274: DeleteObject(APen); 275: ) 276: EndPaint(hwnd, SPaintStruct); 277: ) 278: 279: /////////////////////////////////////////////// 280: // Обработка ИМ VSCROL. Прокрутка текста 281: IIIIIIIIIIIIIIlllIIIIHIIIIIIIIIIIIIIIIIItlllll 282: ((pragma argsused 283: void Emerson_OnVScroll(HWND hwnd, HWND hwnd Ctl, UINT code, int pos) 284: ( 285: switch(code) 286; ( 287: case SB_TOP: 288: nPosition 0; 289: break; 290: 291; case SB_BOTTOM: 292: nPosition •> MaxLines; 293: break ; 294: 295: case SB_LINEUP: 296: if (nPosition > m) nPosition — 1 ; 297: break ; 298: 299: case SBLINEDOWN: 300: if (nPosition < MaxLines) nPosition +“ 1 ; 301: break ; 302: 303: case SB_PAGEUP:
304: nPosition -= Page Size; 305: break ; 306: 307: case SB_PAGEDOWN: 308: nPosition += Page Size; 309: break ; 310: 311: case SB_THUMBPOSITION: 312: nPosition = pos; 313: break; 314: } 315: nPosition = max(B, min (nPosition, MaxLines -1)) ; 316: SetScrollPos (hwnd, SB_VERT, nPosition, TRUE) ; 317: InvalidateRect (hwnd, NULL, FALSE); 318: ) 319: lllllllllllllllllllllllllllllllllllllllllllll 320: // Диалоговая панель 321: ///////////////////////////////////////////// 322: 323: ///////////////////////////////////////////// 324: // Процедура управления диалоговой панелью 325: ///////////////////////////////////////////// 326: «pragma argsused 327: BOOL CALLBACK export AboutDlgProc(HWND hDlg, UINT Message, 328: WPARAM wParam, LPARAM IParam) 329: ( 330: switch(Message) 331: ( 332: case WM_INITDIALOG: 333: return TRUE ; 334: 335: case WM_COMMAND: 336: if (LOWORD(wParam) == IDOK I I 337: LOWORD(wParam) == IDCANCEL) 338: ( 339: EndDialog(hDlg, IDOK); 340: return TRUE ; 341: } 342: break; 343: ) 344: return FALSE; 345: ) Листинг 7.2. EMERSON2.H 1: //-------—------------------------------------ 2: // Программа: EMERSON2.H 3: // Автор: Чарли Калверт 4: // Описание: Заголовочный файл для EMERSON2.CPP 5: // ----===------=-=-=-------------— 6: «define CM_ABOUT 101 7: «define CMDRAWBITMAPS 201 8: «define CMBRAHMIN 202 9: «define CM_WOODNOTES 203 10: «define CM_SEASHORE 204 11: // Макросы 12: «define max (a, b) (((a) > (b)) ? (a) : (b)) 13: «define min (a, b) (((a) < (b)) ? (a) : (b)) 14: // Класс Emerson 15: «define Emerson^DefProc DefWindowProc 16: BOOL Emerson_OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct); 17: void Emerson_OnDestroy(HWND hwnd); 18: void Emerson_OnCommand(HWND hwnd, int id, HWND hwnd Ctl, UINT codeNotify); 19: void EmersonjOnKey(HWND hwnd, UINT vk, BOOL fDown, int cRepeat, UINT flags); 20: void Emerson_OnPaint(HWND hwnd); 21: void Emerson_OnVScroll(HWND hwnd, HWND hwndCtl, UINT code, int pos); 22: // Переменные 23: HBITMAP TheBitmap; 24: // Процедуры 25: BOOL Register(HINSTANCE hlnstance); 26: BOOL Create(HINSTANCE hlnstance, int nCmdShow); 27: LRESULT CALLBACK _export WndProc(HWND hWindow, 28: UINT Message, WPARAM wParam, LPARAM IParam); 29: BOOL CALLBACK _export AboutDlgProc(HWND hDlg, UINT Message, 30: WPARAM wParam, LPARAM IParam);
Листинг 7.3. EMERSON2.RC 1: /* RC-файл для программы Emerson? */ 2: #include <windows.h> 3: # include "Emerson2.h" 4: 5: /* Файл растрового изображения */ 6: Bitmap BITMAP "Bitmap.bmp" 7: 8: /* Меню Emerson2 */ 9: MENU_1 MENU 10: BEGIN 11: POPUP "Poems" 12: BEGIN 13: MENUITEM "Bitmaps", CM_DRAWBITMAPS 14: MENUITEM "Brahmin", CMJBRAHMIN 15: MENUITEM "Woodnotes", CM_WOODNOTES 16; MENUITEM "SeaShore", CM_SEASHORE 17: END 18: 19: MENUITEM "4About", CM_ABOUT 20: END 21: 22: 23: /* Диалоговая панель About */ 24: About DIALOG 18, IB, 141, 58 25: STYLE DS_MODALFRAME I WS_POPUP I WS_CAPTION I WS_SYSMENU 26: CAPTION "About Dialog" 27: BEGIN 28: PUSHBUTTON "Ok", IDOK, 5, 39, 132, 12, 29: 30: 31: 32: 33: 34: 35: 36: END CTEXT CTEXT WS_CHILD I WS_VISIBLE I WS_TABSTOP "Emerson Example", -1, 1, 9, 140, 8, WS CHILD I WS_VISIBLE I WS_GROUP "Copyright (c) World Community, Inc.", -1, 1, 23, 140, 10, WS_CHILD 1 WS_VISIBLE 1 WS_GROUP 37: /* Пиктограмма Emers о n2 */ 38: About ICON "Emerson2.ico" 39: 40: /* Таблица символьных строк */ 41: STRINGTABLE 42: BEGIN 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 0, "Woodnotes (Part 1)" 1, "by Ralph Waldo Emerson" 2, "" 3, "When the pine tosses its cones" 4, "To the song of its waterfall tones," 5, "Who speeds to the woodland walks?" 6, "To birds and trees who talks?" 7, "Caesar of his leafy Rome," 8, "There the poet is at home." 9, "He goes to the river-side,— 10, "Not hook nor line hath he;" 11, "He stands in the meadows wide,— 12, "Nor gun nor scythe to see." 13, "Sure some god his eye enchants:" 14, "What he knows nobody wants," 15, "In the wood he travels glad," 16, "Without better fortune had," 17, "Melancholy without bad." 18, "Knowledge this man prizes best" 19, "Seems fantastic to the rest:" 20, "Pondering shadows, colors, clouds," 21, "Grass-buds and caterpillar-shrouds," 22, "Boughs on which the wild bees settle," 23, "Tints that spot the violet's petal," 24, "Why nature loves the number five," 25, "And why the star-form she repeats:" 26, "Lover of all things alive," 27, "Wonderer at all he meets," 28, "Wonderer chiefly at himself," 29, "Who can tell him what he is?" 30, "Or how meet in human elf"
74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: 85: 86: 87: 88: В9: 90: 91: 92: 93: 94: 95: 96: 97: 98: 99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 31, "Coming «nd past eternities?" 32, " Brahma *' 33, "by Ralph Waldo Emerson" 34, "" 35, "If the red slayer think he slays" 36, " Or if the slain think he is slain," 37, "They know not well the subtle ways" 38, " I keep and pass and turn again." 39, "" 40, "Ear or forget to me is near;" 41, “ Shadow and sunlight ar'e the same,-" 42, "The vanished gods to mo appear;" 43, " And one to me are shame and fame." 44, 45, "They reckon ill who leave me out" 46, " When me they fly, 1 am the wings;" 47, "I am the doubter and the doubt," 46, " And I the hymn the Brahmin sings." 49, »" 50, "The strong gods pine for my abode," 51, " And pine in vain the sacred Seven;" 52, "But thou, meek lover of the good!" 53, " Find me, and turn thy back on heaven." 64, "SeaShore" 65, " by Ralph Waldo Emerson" 66, "" 67, "I heard or seemed to hear the chiding Sea" 68, "Say, Pilgrim, why so late and slow to come?" 69, "Am I not always here, thy summer home?" 70, "Is not my voice thy music, morn and eve?" 71, "Ky breath thy healthful climate in the heats," 72, "My trouch thy antidote, my bay thy bath?" 73, "Was ever couch magnificent as mine?" 74, "hie on the warm rock-ledges, and there learn" 75, "A little hut sufiices like a town." 76, ”1 make your sculptured arch tecture vain," 77, "Vain beside mine. I drive my wedges home," 78, "And carve the coastwise mountain into caves." 79, "Lo! here is Rome and Nineveh and Thebes," 80, "Karnak and Pyramid and Giant's Stairs" 81, "Half piled or prostrate; and my newest slab" 82, "Older than all thy race." 83, "" 84, "Behold the Sea," 85, "The opaline, the plentiful and strong," 86, "Yet beautiful as is the rose in June," 87, "Fresh as the trickling rainbow of July;" 86, “Sea full of food, the nourlsher of kinds," 89 “Pur er of earth, and medicine of men;" 90, "Creating a sweet climate by my breath " 91, "Washing cut harms and griefs from memory," 92, "And, in my mathematic ebb and flew," 93, "Giving a hint cf that which changes not." 94, "Rich are the sea-gods: — who gives gifts but they? 95, "They grope the sea for pearls, but more than pearls:" 96, "They pluck Force thence, and give it to the wise." 97, "For every wave is wealth to Daedalus," 98, "Wealth to the cunning artist who can work" 99, "This matchless strength Where shall he find, О waves!" 100, "A load your Atlas shoulders cannot lift?" END EMERSON2.ICO (32x32) BITMAP.BMP (64x64)
Листинг 7.4. EMERSON2.DEF 1: ; EMERSON2.DEF 2: NAME Emerson2 3: DESCRIPTION 'Emerson2 example' 4: EXETYPE WINDOWS 5: STUB 'WINSTUB.EXE' 6: CODE PRELOAD MOVEABLE DISCARDABLE 7: DATA PRELOAD MOVEABLE MULTIPLE 8: HEAPSIZE 4096 9: STACKSIZE 8192 Листинг 7.5. EMERSON2.MAK (Borland) 1: # EMERS0N2.MAK 2: 3: APPNAME = Emerson2 4: INCPATH - C:\BC\INCLUDE 5: LIBPATH - C:\BG\LIB 6: CFLAGS = -H -ml -W -V -w4 -1$ (INCPATH) -L$ (LIBPATH) 7: 8: # компоновка 9: $(APPNAME).exe: $(APPNAME). Ob] $(APPNAME). Def $(APPNAME).Res 10: bcc $ (CFLAGS) $ (APPNAME) . obj 11: brc $(APPNAME).res 12: 13: # компиляция 14: $(APPNAME).obj: $(APPNAME).cpp 15: bcc —c $(CFLAGS) $ (APPNAME) .epp 16: 17: * компиляция ресурсов 18: $(APPNAME).res: $(APPNAME).rc 19: brc —r -i$(APPNAME).rc Листинг 7.6. EMERSON2.MAK (Microsoft) 1: 2: # EMERSON2.MAK для компилятора Microsoft 3: #===============-===-=-========== 4: 5: APPNAME - Emerson2 6: 7: #==“=“»====““’=’------- 8: # компоновка 9: #================»-====== 10: $(APPNAME).exe : $(APPNAME).obj $(APPNAME).def $(APPNAME).res 11: link /CO $(APPNAME), /align:16, NUL, /nod llibcew libw, $(APPNAME) 12: rc $(APPNAME).res 13: 14: <==---=---=========== 15: # компиляция 16: #=--================== 17: $ (APPNAME) .obj : $ (APPNAME) .cpp 18: cl —c -AL -Gsw GA -Ow -W4 -Zp -Zi $ (APPNAME). cpp 19: 2 0: #=======——==— 21: # компиляция ресурсов 22: #================= 23: $(APPNAME).res: $(APPNAME).rc 24: . rc —r $(APPNAME).rc Вначале фон программы Emerson2 состоит из единственного растрового изображе- ния, размноженного в окне, как показано на рис. 7.1. В верхней части программы располагается простейшее меню. Если вы выберете элемент About, на экране появится диалоговая панель, содержащая информацию о программе. Элемент Роет позволяет вывести либо экранные “обои”, либо одно из трех стихотворений Ральфа Эмерсона. Когда вы минимизируете протрамму, на экране появится специальная пользовательская пиктотрамма.
Рис. 7.1. Основное окно программы EMERSON.EXE Что можно сделать со всеми этими файлами? Вероятно, вы заметили, что исходный код проекта Emerson разросся до 8 файлов: EMERSON.CPP. EMERSON.BMP, EMERSON.H, EMERSON.RC, F.MERSON.DEF, EMERSON.1CO, EMERSON.CUR, EMERSON.MAK. Устал даже перечислять! Мысль о том, что одному проекту принадлежит так много различных файлов, вызывает неприятные ощущения. Успокойтесь и воспринимайте все постепенно Нет ничего необычного в таком разнообразии файлов для одной Windows-програм- мы. Чтобы помочь вам разобраться с этим пестрым собранием, я сделал копию часто показываемой схематической диаграммы, изображающей различные файлы, которые используются при построении исполняемого файла Windows. Эта диаграмма показана на рис. 7.2. Рис. 7.2. Составляющие элементы исполняемого файла ГИлЛиз
Эта картинка сама по себе не несет много новой информации. Воспользуйтесь ею, чтобы привести в порядок свои мысли. Если хотите, можете сначала бегло взглянуть на эту диаграмму, а затем вернуться к ней снова, когда лучше поймете, как происходит программирование под Windows. Используйте абстракции для приведения в порядок ваших мыслей. Мыслите объектами, струк- турированными программами и модулями. Когда вы хотите представить себе целый объект, думайте о проектном файле или МАКЕ-файле. Возможность обращаться к абстрактным поня- тиям — не простой дар. Используйте его преимущество! Конечно, если ваш начальник, мама, жена (муж), друг или кто-нибудь еще подойдет посмотреть, что вы делаете, вы легко можете переключиться иа другой режим. Тогда вы можете выложить перед ними все целиком и предоставить им охать и ахать над вашей работой. Вы вовсе не обязаны говорить нм, что на самом деле все не так сложно, как кажется! Не смущайтесь только лишь от присутствия такого количества файлов. Большая часть сложности есть вопрос количества, а не качества. Иначе говоря, если рассматривать их по одному, все перечисленные выше файлы не сложны для понимания. Впрочем, если вы попытаетесь сразу поднять в воздух всю эскадрилью, задание начнет казаться устрашающим. Решение состоит в том, чтобы разделять и властвовать! Это не просто клише, а лозунг жизни! Создание диалоговой панели В последней главе вы видели, как создать меню, пиктограммы и курсор, которые будут использоваться в EMERSON2.CPP. Следующий шаг — создание диалоговой панели — представляет собой более сложную операцию. Я собираюсь потратить на этот материал несколько страниц, поскольку чувствую, что хорошему программисту под Windows необходимо в совершенстве понимать этот процесс. Использование диалоговой панели включает три шага. 1) Определить диалоговую панель в ресурсном файле. 2) Создать код, выводящий диалоговую панель на экран. 3) Создать диалоговую процедуру, которая обрабатывает пользовательский ввод в течение диалога. Вы можете представлять себе диалоговую процедуру как оконную процедуру для диалоговых панелей, хотя на самом деле это разные вещи. Будучи добавленным к EMERSON2.RC, определение диалога выглядит следующим образом: 23: /* Диалоговая панель About */ 24i About DIALOG 18, 18, 141, 58 25: STYLE DC_MODALFRAME I WS_₽O₽UP I WS_CAPTION I WS_SYSMENU 26: CAPTION "About Dialog" 27: BEGIN 28: PUSHBUTTON "Ok", IDOK, 5, 39, 132, 12, 29: WS_CHILD I WS_VISIBLE | WS_TABSTOP 30; CTEXT "Emerson Example", -1, 1, 9, 140, 8, 31: WS CHILD I WS VISIBLE t WS_GROUP 32: CTEXT "CopyrigHt (c) WorlH Community, Inc.", 33: -1, 1, 23, 140, 10, 34: WS_CHILD I WS_VISIBLE I WS_GROUP 35: END Если вы хотите создать диалоговую панель, используя визуальные средства, вам следует ориентироваться на что-то вроде изображенного на рис. 7.3. Помните, что диалоговая панель About — это просто еще один ресурс, добавленный к EMERSON2.RC. Не нужно начинать еще один проект, чтобы создать диалоговую панель. Она может быть частью исходного файла ресурсов. Если когда-нибудь у вас возникнет необходимость повторного создания изображения с помощью визуальных средств, отредактируйте описание диалоговой панели как текст и скопируйте его на место предыдущего кода. Исследуя исходный код диалога About, вы должны заметить, что первая строчка содержит имя диалоговой панели, за которым следует объявление ее типа и размеров. Следующая строчка соединяет посредством логического ИЛИ четыре константы, опре- деленные в Windows.H.
About Dialog Emerson Example Copyright (c) World Community, Inc. ' iOki Рис. 7.3. Диалоговая панель About содержит кнопку с идентификаторм 1 (IDOK) и два статических поля DS_MODALFRAME. Создает диалоговую панель, хорошо работающую со стилями WS_CAPTION и WS_SYSMENU. WS_POPUP. Фирма Microsoft определяет стиль WS_POPUP как создающий выска- кивающее окно. Кроме того, следует понимать, что окно стиля WS POPUP может перемещаться по всему рабочему столу и может принадлежать любому окну на рабочем столе. WS_CAPTION. Создает диалоговую панель с титульной линейкой в верхней части. WS_SYSMENU. Создает диалог с пиктограммой системного меню в левом верхнем углу титульной линейки. Эти константы будут обсуждаться более подробно на второй неделе обучения. Пока можете поэкспериментировать с ними, удаляя их одну задругой из описания диалоговой панели программы Emerson и наблюдая результат на экране. Замечание.. Диалоговая панель About работает в модальном состоянии. Чтобы понять, что это означает, просто запустите программу Emerson, отобразите диалоговую панель, а затем попро- буйте выбрать основное окно или один из пунктов меню основного окна. Вы обнаружите, что не можете этого сделать, потому что диалоговая панель блокирует фокус. Эго типичное модальное поведение. Диалоговая панель как бы говорит пользователю: “Разберись со мной, прежде чем делать что-нибудь еще со своей программой.” Вы должны закрыть диалоговую панель, прежде чем сможете продолжить работу со своей программой. Противоположностью модальной диалоговой панели является реже используемая немодальная диалоговая панель. Когда она появляется на экране, вы имеете доступ и к ней, и к главному окну программы. У вас будет возможность поработать с этим видом диалоговых панелей на следующей неделе, когда мы будем рассматривать программу WinSize. После того как объявлен стиль диалоговой панели About, объявляется ее заголовок. CAPTION "About Dialog" Заголовок появляется в титульной линейке, или полосе заголовка, в верхней части диалоговой панели. Если вы пропустите оператор заголовка, то полоска останется пустой. Разумеется, если вы не используете при определении диалоговой панели стиль WS_CAPTION, то не появится вообще никакого текста. Описание диалога заканчивается несколькими строчками, заключенными между begin и end. Они определяют кнопку и две строчки текста. Вы не вникните в смысл этих строчек, пока не поймете, что кнопка и оба текстовых элемента управления также являются окнами. Иначе говоря, диалоговая панель имеет три подчиненных окна, размещающихся внутри нее: кнопку и два статических элемента управления. Строчка, определяющая кнопку, имеет 7 параметров. Первый — текст, ассоциирую- щийся с элементом управления, с последующими за ним идентификатором, сектором размещения и стилем. Сектор размещения определяется четырьмя числами: коорди- натами (X,Y), шириной и высотой.
И Так как статические элементы управления, содержащие текст, также являются окнами, неудивительно, что они имеют такие же параметры, что и кнопка. По умолчанию статические элементы управления не имеют рамок. Замечание. Для того чтобы свыкнуться с мыслью, что кнопка и статические элементы управления являются окнами, может потребоваться время. Когда я впервые познакомился со средой программирования Windows, то полагал, что она получила свое название от большого окна на экране, в котором выполняются программы. Я воспринимал менеджер программ как одно окно, а свой компилятор как другое. Мне потребовалось время для осознания того, что любая программа может состоять из множества окон. Например, сложные визуальные средства, подобные Арр Studio или Resourse Workshop, могут иметь 20, 30 или даже более окон, видимые одновременно. Урок, который можно извлечь отсюда, заключается в том, что можно не бояться добавлять подчиненные окна в свои программы, чтобы сделать последние более удобными. Создание нескольких окон на рабочем столе не особенно затруднительно для среды. Если они нужны вам, используйте их. Меню в файле EMERSON2.RC использует константу CM_ABOUT, которая опреде- ляется в EMERSON2.H. Однако идентификатор IDOK, ассоциированный с кнопкой на этой диалоговой панели, определяется в WINDOWS.H, который включается в начало RC файла. Следующая выдержка из WINDOWS.H показывает объявление IDOK, а также родственных констант, часто ассоциируемых с кнопками на диалоговых панелях: /* Идентификаторы стандартных кнопок на диалоговых панелях */ «define IDOK 1 «define IDCANCEL 2 «define IDABORT 3 «define IDRETRY 4 «define IDIGNORE 5 «define IDYES 6 «define IDNO 7 Пользователи продукции фирмы Borland должны заметить, что как BRC, так и Workshop, уже знают о WINDOWS.H, и поэтому не требуется включать его в начало текстового файла EMERSON.RC. Однако читатели, которые используют другие компиляторы, могут оказаться не в состоянии откомпилировать ресурс, пока WINDOWS.H не будет включен. Остается добавить, что элементам статического текста обычно присваиваются иден- тификаторы -1, поскольку первые обычно существуют как инертные объекты на рабочем столе. Учитывая тот факт, что потребность общаться с ними возникает редко, нет нужды иметь для них специальный идентификатор. Отображение диалоговой панели Когда диалоговая панель построена, требуется обеспечить ее появление на рабочем столе. Это еще один “магический” процесс программирования в Windows, включающий ряд шагов, которые поначалу могут оказаться не вполне понятными для вас. Я разбил обсуждение отображения диалоговой панели на три раздела. Первый, это тот который вы читаете в настоящий момент. Он дает короткий обзор кода, который делает диалоговые ресурсы видимыми для пользователя. Второй раздел — это медитация над функцией MakeProcInstance. В третьем разделе описываются функции DialogBox и AboutDialogProc. Последняя подобна функции WndProc, за исключением того, что она ассоциируется с диалогом, а не с окном. Как я упомянул в последней главе, когда пользователь выбирает в меню пункт About, в оконную процедуру программы посылается сообщение WM_COMMAND. После того как взломщики сообщений проанализируют параметры процедуры WndProc, в функцию About_OnCommand посылается идентификатор, ассоциированный с выбранным пунк- том меню: 5 Чарльз Калверт
void Abou t_OnCommand (HWND hwnd, int id, HWND hwndCtl, UINT codeNotify)' ( switch(id) ( case CM_AB0UT: < FARPROC AboutBox = MakeProcInstance((FARPROC)AboutDlgProc hlnstance); DialogBox(hlnstance, "ABOUT", hwnd, (DLGPROC)AboutBox); FreeProcInstance(AboutBox); break; case CM_DRAWBITMAPS: и т.д... ) ) } Все выборы меню в программе ассоциируются с WM_COMMAND. Поэтому CIs_On- Command может оказаться очень длинной и сложной функцией, управляемой очень длинным и лохматым оператором switch. В суровые дни, до появления WINDOWSX, программисты вынуждены были вставлять эти длинные операторы switch в середину еще более длинных операторов switch, охватывающих тело процедуры WndProc. Какая неразбериха! К настоящему моменту должно быть ясно, что идентификатор CM ABOUT, привя- занный к сообщению WM COMMAND, всплывает всякий раз, когда пользователь выбирает в меню пункт About. Программа отвечает на это сообщение появлением диалога About. Как видите, первое действие для появления диалоговой панели заключается в обращении к MakeProcInstance. Этот предмет достаточно сложен, и я решил отвести для него специальный раздел. Все о MakeProcInstance MakeProcInstance нужна, чтобы передаваемая в нее функция могла получить доступ к данным вашего приложения. Это делается с помощью маленького фрагмента кода, связывающего сегмент данных программы с диалоговой процедурой. Это довольно легко сказать и намного труднее сделать. На самом деле все, что касается действий MakeProcInstance, может вызвать замешательство. Поэтому полезно будет начать с рассказа небольшой аллегорической (и довольно причудливой) научно- фантастической истории. Ранее я уже упоминал, что Windows состоит из ряда примитивных объектов. Можете поупражнять ваше воображение, представив себе на минуту эти объекты как планетные системы некой удаленной галактики. В этом случае одна планета, называемая Windows, является главой одной очень мощной империи. Другая планета, называемая Emerson, является маленькой колонией империи Windows. Иногда Windows требуется послать на Emerson эмиссара или курьера с важным донесением. Когда курьер попадает на Emerson, он ничего не знает о культуре и языке этой планеты. В результате возникает проблема, общения. Решение заключается в том, чтобы позвать мудрого старого хакера MakeProcInstance, известного в кругу друзей как Главный Рукопожатель. Он знает, как врубиться в сегмент данных планеты Emerson, который представляет собой компьютеризованную библиоте- ку, полную культурологической информации об этой колонии. Его рукопожатие дает эмиссару связь с сегментом данных. Как только курьер соединяется с сегментом данных, он преодолевает культурные различия между империей Windows и колонией Emerson. Теперь его сообщение будет понятным. Суть этого маленького странного рассказа в том, что Windows и приложение Emerson существуют в двух различных областях памяти, которые должны быть согласованы. MakeProcInstance сообщает, где располагается сегмент данных программы Emerson. Когда Windows вызывает диалоговую процедуру, последняя уже имеет возможность получить доступ к сегменту данных программы Emerson, который обеспечивает связь между этими двумя объектами.
Рассмотрим эти же самые вещи с технической точки зрения. Процедура диалога ассоциируется с диалоговой панелью About точно так же, как оконная процедура ассоциируется с главным окном. Вы знаете, что оконные процедуры вызываются самой Windows. Иначе говоря, WndProc вызывается не вашей программой, а из Windows. Аналогично процедура диалога About вызывается не вашей программой, а самой Windows. Следует уловить главное: в действительности диалоговая процедура “принадлежит” Windows, будучи вызванной Windows. Однако Windows и ваша программа не разделяют один и тот же сегмент данных. Пока функция MakeProcInstance не даст доступ к сегменту данных приложения Emerson, диалоговая процедура не будет иметь доступа к перемен- ным, функциям и константам, ассоциированным с вашей программой. Работа, выполняемая MakeProcInstance, представляет собой рукопожатие. Процедура рукопожатия создает маленький фрагмент кода для диалоговой процедуры вашей про- граммы, который знакомит Windows с сегментом данных приложения. Они пожимают друг другу руки и начинают разговор. Замечание. Программисты, работающие с обработчиками прерываний, знакомы с описанным выше явлением. DOS вызывает обслуживание прерывания, но пока вы не предпримете специ- альных действий, оно не будет иметь доступа к сегменту данных вашей программы. Чтобы разрешить эту проблему, программисты часто располагают сегменты данных внутри кодовых сегментов. Поскольку обработчик прерывания также располагается в сегменте кода вашей программы, он имеет возможность получить доступ к данным. Хотя Windows решает эти проблемы иным способом, возникающие при этом трудности те же самые. Прежде чем оставить этот предмет, следует указать, что каждое обращение к MakeProcInstance должно быть уравновешено обращением к FreeProcInstance. Функция FreeProcInstance освобождает диалоговую процедуру от сегмента данных и убирает из памяти ресурсы, использованные MakeProcInstance. DialogBox и AboutDIgProc После того, как MakeProcInstance закончит свое рукопожатие, требуется вызвать DialogBox. Этот вызов аналогичен обращению к процедуре CreateWindow в программе инициализации. Продолжая эту идею, вы также можете провести очень расплывчатую и сугубо теоретическую параллель между функцией RegisterClass и описанием диалоговой панели в RC-файле. Беглый взгляд на диалоговую процедуру программы Emerson2, помогает подчеркнуть очень близкую аналогию между функциями WndProc и AboutDIgProc: 327: BOOL CALLBACK __export AboutDIgProc (HWND hDlg, UINT Message, 328: WPARAM wParam, LPARAM IParam) 329: ( 330: switch(Message) 331: ( 332: case WMINITDIALOG: 333: return TRUE; 334: 335: case WM_COMMAND: 336: if (LOWORD(wParam) — IDOK II 337: LOWORD(wParam) == IDCANCEL 338: ( 339: EndDialog(hDlg, TRUE); 340: return TRUE; 341: ) 342: break; 343: ) 344: return FALSE; 345: ) Обе эти функции никогда не вызываются вашей программой непосредственно. Им посылает сообщения система, и обе они используют оператор switch, чтобы обработать эти сообщения.
Следует уловить, что во время выполнения AboutDlgProc, цикл сообщения, ассоци- ированный с вашим основным окном, заменяется другим циклом, внутренним по отношению к Windows. Пока активна диалоговая панель About, программа, ассоцииро- ванная с вашим основным окном, фактически пребывает в подвешенном состоянии. Можете вообразить себе что-то вроде мертвой зоны между вызовами DialogBox и FreeProcInstance, которая отделяет диалоговую процедуру от Windows: DialogBox(hlnstance, "ABOUT", hwnd, (DLGPROC)AboutBox); // Мертвая зона, пустующая во время выполнения // // другого цикла сообщений // FreeProcInstance(AboutBox); Как я уже упомянул ранее, процедуры диалогов в этой книге не прибегают к взломщикам сообщений. Поэтому AboutDlgProc сильно напоминает старомодную WndProc, существовавшую до WINDOWSX и переполненную потенциально бесконеч- ными операторами switch. К счастью, оператор switch в AboutDlgProc программы Emerson, очень близок к минимальной диалоговой процедуре. Большая его часть состоит из ответов на сообщения IDOK или IDCANCEL. Сообщение IDOK, посланное в диалог, порождает кнопку ОК, определенную в файле EMERSON2.RC. Сообщения IDCANCEL посылаются, когда пользователь дважды щелкает мышью по пиктограмме системного меню, расположенной в левом верхнем углу диалоговой панели. Вы видели лишь грубый набросок способов обработки диалоговых панелей в Win- dows-программе. Как обычно, в этой книжке я сначала познакомлю вас с предметом вообще, а затем вернусь к нему на более детальном уровне. Это делается, чтобы не завалить вас слишком сложной для первого прочтения информацией. Я знаю, что диалоги могут оказаться трудноватыми для понимания даже в таком упрощенном обзоре. Поэтому полезно будет еще раз вспомнить основные моменты. В первую очередь определите диалог в RC-файле, редактируя текст или используя средства вроде АРР Studio или Resource Workshop. Вызовите MakeProcInstance, чтобы связать сегмент данных программы с диалоговой процедурой. Вызовите DialogBox, чтобы создать диалоговую панель как “физическую сущность” среды Windows. И Ответьте на сообщение, посылаемое процедуре диалогового окна из Windows. Вызовите FreeProcInstance, чтобы вернуть Windows в то состояние, в котором она была до обращения к MakeProcInstance. Этот перечень может служить рецептом для создания диалогов. Растровые изображения. Эстетическая интерлюдия Следующий ресурс, который нам предстоит исследовать, — растровое изображение, показанное под листингом 7.3. Эту картинку можно сделать, используя программу Windows Paintbrush или любое другое средство, которое создает BMP-файлы. Точная имитация необязательна, хотя, возможно, вы захотите, чтобы ваш рисунок имел такой же размер (64x64 точки). Впрочем, в данном случае вы вольны поступать, как хотите: либо скопируйте предыдущий ресурс, либо напрягите вашу фантазию и разработайте что-нибудь новое. Если вы редактируете RC-файл как текст, вам потребуется добавить только одну строчку в начало файла EMERSON.RC: Bitmap BITMAP "Bitmap.bmp" Вот и все, что нужно для создания растрового изображения. Как и создание пиктограмм, с чисто интеллектуальной точки зрения, это очень простой шаг. Однако с эстетической точки зрения, создание растрового изображения может оказаться весьма
затруднительным. Многие программисты поступают мудро, приглашая для этой работы таланты со стороны. В любом случае, когда у вас уже есть некоторый набросок, требуется предпринять некоторые шаги, чтобы показать его на экране. Как и создание диалоговой панели, процесс может оказаться непростым. Поэтому я отвожу данному предмету специальный раздел. Программа Emerson рисует растровое изображение Загрузка растрового изображения в память сильно напоминает загрузку пиктограм- мы, курсора или специального пользовательского ресурса. Следующий фрагмент кода из Emerson_OnCreate показывает весь этот процесс, включая проверку ошибок: 133: TheBitmap = LoadBitmap(hlnstance, "Bitmap"); 134: if ((TheBitmap) 135: { 136: MessageBox(hwnd, "No Bitmap", "Fatal Error", MB_OK); 137: return FALSE; 138: } Функция интерфейса приложений LoadBitmap требует два параметра. Первый — дескриптор EXE-файла или DLL, где содержится растровое изображение, подлежащее загрузке. Помните, что переменная hlnstance объявляется в программе Emerson как глобальная. Она принимает значение во время выполнения функции Create. Второй параметр LoadBitmap — имя растрового изображения. Поскольку LoadBitmap может не сработать, важно убедиться, что идентификатор растрового изображения, объявленный в файле EMERJSON.H, не равен нулю. Если идентификатор ресурса равен нулю, то Emerson_OnCreate выдает FALSE, что вызывает останов программы. Если вы хотите посмотреть, как это работает, можете изменить второй параметр LoadBitmap, написав его, например, Batmap или что-нибудь в этом роде. В этом случае изображение не будет загружено и программа остановится. Не забывайте вызывать LoadBitmap, прежде чем попытаетесь использовать в своей программе растровое изображение. Простого включения последнего в RC-файл недостаточно. Помните, что каждый вызов LoadBitmap должен быть уравновешен вызовом DeleteObject или DeleteBitmap. В приложении Emerson вызов DeleteBitmap происходит в ответ на сообщение WM_DESTROY. DeleteBitmap представляет собой совместимый по типу макрос из WINDOWSX, включающий в себя функцию DeleteObject. После загрузки растрового изображения EMERSON2.CPP показывает его несколько раз в ответ на сообщение WM_PAINT: 247: 248: 249: 250: 251: 252: 253: 254: HDC BitmapDC = CreateCompatibleDC(PaintDC); HBITMAP OldBitmap = SelectBitmap(BitmapDC, TheBitmap); for (int i = 0; i < Numimages; i++) for (int j = 0; j < Numimages; j++) BitBlt(PaintDC, i * 66, j * 66, 64, 64, BitmapDC, 0, 0, SRCCOPY); SelectBitmap(BitmapDC, OldBitmap); DeleteDC(BitmapDC); Чтобы вы лучше поняли происходящее здесь, я покажу вам, как выглядела бы сердцевина этой функции, если бы растровое изображение требовалось показать только один раз: HDC BitmapDC = CreateCompatibleDC(PaintDC) ; HBITMAP OldBitmap = SelectBitmap(BitmapDC, TheBitmap); BitBlt(PaintDC, 0, 0, 64, 64, BitmapDC, 0, 0, SRCCOPY); SelectBitmap(BitmapDC, OldBitmap); DeleteDC(BitmapDC); Этот код создает еще один контекст устройства, совместимый с контекстом устрой- ства окна. Прежде чем растровое изображение сможет быть выведено на экран, оно сначала должно быть выбрано в этот второй контекст устройства. Экран, со своей стороны, представляется контекстом устройства, именуемым PaintDC.
Функция SelectObject выбирает объект в данный контекст устройства. SelectObject всегда возвращает объект, который перед этим был в контексте устройства. В этом примере я скопировал TheBitmap в BitmapDC, а затем предусмотрительно сохранил OldBitmap в переменной, созданной специально для этой цели. После того как растровое изображение было показано, я аккуратно скопировал OldBitmap обратно в контекст устройства, а затем удалил весь этот контекст. Не забывайте копировать растровое изображение в его собственный, специально созданный контекст устройства. Не забывайте запоминать старое растровое изображение в переменной. Не забывайте копировать это старое растровое изображение обратно в контекст устройства. Было бы полезно еще раз вернуться к контекстам устройства, введенным в главе 4. Иногда я представляю себе контекст устройства, как озеро с плавающими в нем различными объектами. Каждый объект, погруженный в озеро, принимает особый вид, соответствующий контексту и зависящий от рефракторных свойств воды. Представьте себе свою руку, погруженную в горное озеро. Поскольку ваша рука теперь видится в новом контексте, она становится больше и слегка искривляется. Предположим, что в этом озере есть место только для определенного числа объектов. Если вы хотите вставить новый объект, то должны сначала удалить какой-нибудь из старых. Когда закончите, не забудьте вернуть старый объект на место. Это важно для экологии озера. Еще раз объясню, как работает эта аналогия: Растровое изображение, скопированное в контекст устройства для стандартного VGA-экрана, видится таким, как его может показать 16-цветный, 640x480 VGA-экран. На экране CGA он выглядел бы по-другому. Когда вы копируете растровое изображение на экран VGA, то видите его в новом контексте точно так же, как видите в новом контексте свою руку, когда погружаете ее в горное озеро. Вызывая SelectObject, вы вводите новый элемент в контекст устройства, т.е. в озеро. Поскольку в контексте устройства есть место только для определенного числа объектов, то прежде чем можно будет скопировать в него какой-то новый объект, вы должны удалить один из старых. Когда вы закончите работать с этим новым объектом, снова замените его старым. Замечание. Копирование объектов в контекст устройства и обратно выполняется функцией SelectObject. WINDOWSX поддерживает однотипные альтернативные SelectObject функции с именами SelectBitmap и SelectPen. С их помощью вы избегаете выполнения утомительных преобразований типов. Впрочем, вы свободны в выборе любой функции по своему вкусу. Теперь вы готовы приступить к изучению функции BitBlt (произносится “бит блит”), которая фактически показывает растровое изображение на экране. Мне нравиться думать, что BitBlt означает “bit blast”. Однако авторитеты из фирмы Microsoft утверждают, что оно означает bit block transfer. К счастью, функция BitBlt имеет не более девяти параметров. Первый — это контекст устройства, представляющий экран (см. следующие объяс- нения). Следующие 4 параметра определяют место растрового изображения в рабочей области окна. Следующий параметр — совместимый контекст устройства, содержащий копию растрового изображения в памяти. Этот контекст устройства есть то, что выбрасы- вается на экран или точнее в контекст устройства, который представляет экран. Следующие параметры определяют координаты (X, Y) внутри исходного растрового изображения. Иначе говоря, если исходное изображение имеет размер 128x128 пикселов и вы хотите показать только секцию размером 64x64 пиксела, вы должны использовать эти параметры, чтобы указать, где начинается блок, размером 64x64.
И Последний параметр определяет логическую операцию, которая должна быть выпол- нена, когда растровое изображение передается на экран. На самом деле существует, цо крайней мере, 15 различных операций, которые могут быть выбраны с помощью последнего параметра функции BitBlt. Чаще всего вы просто используете SRCCOPY, которые отображают картинку на экране или ином контексте устройства. В следующей главе и других местах в этой книге вы увидите, что могут быть выбраны следующие опции: BLACKNESS производит вывод в черном цвете DSTINVERT инвертирует изображение-приемник MERGECOPY использует оператор AND для пересечения изображения-источника с маской MERGEPAINT . использует оператор OR для объединения инвертированного изображения-источника с изображением-приемником . NOTSRCCOPY инвертирует изображение-источник перед копированием notsrcerase инвертирует результат объединения изображения-источника с изображением-приемником PATCOPY копирует маску в изображение-приемник PATINVERT использует оператор XOR для объединения изображения-источника и маски PATPAINT использует оператор OR для объединения инвертированного изображения-источника и маски SRCAND использует оператор AND для пересечения изображения-источника и маски SRCCOPY копирует изображение-источник в изображение-приемник SRCERASE инвертирует изображение-приемник и пересекает его с изображением-источником посредством оператора AND SRCINVERT использует оператор XOR для объединения изображения-источника с изображением-приемником SRCPAINT использует оператор OR для объединения изображения-источника с изображением-приемником WHITENESS производит вывод в белом цвете Если эти опции мало что говорят вам, не смущайтесь. Я привожу их в основном для того, чтобы жокеи графики из мира DOS увидели, какой богатый набор альтернатив доступен программистам Windows. Возможно, здесь будет уместно признаться, что когда я впервые начинал писать программы под Windows, вывод растровых изображений на экран поставил меня в тупик. Ведь полный жизненный цикл растрового изображения включает в себя 7 отдельных шагов: 1) загрузить растровое изображение; 2) создать совместимый контекст устройства; 3) выбрать растровое изображение в контекст устройства; 4) передать с помощью BitBlt совместимый контекст устройства в контекст устройства окна; 5) выбрать старое растровое изображение в совместимый контекст устройства; 6) удалить совместимый контекст устройства; 7) удалить растровое изображение. Важно понимать, что эти 7 шагов не просто “предполагаемый образ действия”. На самом деле даже маленькая ошибка хотя бы в одном из перечисленных пунктов, может привести в движение медленный, но верный процесс, который лишит Windows необхо- димых для ее выполнения ресурсов. В частности, очень важно, чтобы вы не забывали вызывать SelectObject или удалять контекст устройства. Если вы действительно забудете произвести чистку после использования растрового изображения, системные ресурсы компьютера будут истощены. Когда это происходит,
Windows начинает разваливаться по кусочкам, как компьютер HAL в конце “Космичес- кой одиссеи 2001 года”. В частности, можно заметить, что растровые изображения теряют свои цвета, меню и тексты исчезают и в конце концов вся машина зависает. Чтобы узнать, сколько системных ресурсов осталось, посмотрите диалоговую панель About из меню менеджера программ. Замечание. Каким-то образом мне удалось проскочить через описание растровых изображений, даже не упомянув об интерфейсе графических устройств Windows (GDI). GDI — это подмноже- ство Windows, разработанное для поддержки графического программирования. Все функции GDI содержатся в специальной DLL, называемой GDI.EXE. Если хотите показать на экране растровое изображение, используйте такие функции GDI, как BitBlt. Когда вы используете контекст устройства, то фактически используете функцию из GDI. В мире Windows интерфейс графичес- ких устройств представляет собой ворота в графику (см. гл. 18). Таблицы символьных строк Таблицы символьных строк — один из самых простых в использовании ресурсов. Они очень ценны потому, что эффективно используют память. Следует помнить, что строковые ресурсы загружаются блоками по 16 строк. Если у вас есть ресурс, содержащий сотни строчек текста, а вам нужен доступ только к одному его подмножеству, то нет необходимости загружать весь ресурс в память. Чтобы создать строковый ресурс, достаточно добавить в ваш RC-файл следующее описание: STRINGTABLE BEGIN О, "Woodnotes (Part 1)" 1, "by Ralph Waldo Emerson" END Каждый исполняемый файл может содержать только одну таблицу символьных строк, поэтому присваивать ей имя не нужно. Вы можете просто объявить тип ресурса, а затем непосредственно определить сами строки. Каждой символьной строке присваивается уникальный номер, и все они заключаются между операторами BEGIN и END. Посколь- ку строки загружаются в память по 16 штук, вы должны начинать каждый блок со строк с соответствующими номерами. Например, первый набор строк может расположиться в диапазоне номеров 0—15 или 0—31. Следующий набор будет начинаться со строки 16, 32 или 48. Загрузка строк в память проста: требуется лишь вызвать функцию LoadString, имеющую 4 параметра. Н Первый — дескриптор исполняемого файла или DLL, который содержит строковый ресурс. Второй — уникальный номер, ассоциируемый со строкой. Третий — буфер, в котором должно храниться содержимое загружаемой символьной строки. Четвертый параметр определяет длину буфера символьной строки, определяемого третим параметром. Замечание. Относительно второго и третьего параметров функции LoadString следует упомянуть две веши. а) С помощью второго идентификатора можно объявить постоянный параметр. Например, я мог бы объявить константу CN_WOODNOTES_TITLE, положить ее равной нулю, а затем исполь- зовать этот идентификатор вместо нуля для выборки заголовка стихотворения. б) Обычно не принято хранить в памяти копию всей строковой таблицы. Весь смысл этого ресурса в том, чтобы хранить его по возможности не в оперативной памяти, а на диске. Поэтому приложение Emerson загружает* строки в маленький буфер, гарантируя их вывод на экран со скоростью поиска. Схема отображения на экране стихотворений из приложения Emerson реализуется обработчиками сообщений WM_COMMAND и WM_PAINT. В ответ на первое сообще-
ние программа Emerson узнает, какое из стихотворений пользователь желает видеть. В ответ на второе сообщение соответствующие строки выводятся на экран. Вот выдержка из функции Emerson_OnCommand: 181: case CM_BRAHMIN: 182: Start = 32; 183: MaxLines = 22; 184: InvalidateRect(hwnd, NULL, TRUE); 185: DrawBitmaps = FALSE; 186: break; Если пользователь хочет увидеть стихотворение Brahma, то сообщению WM COM- MAND пригодится идентификатор CM_BRAHMIN. В ответ программа Emerson при- сваивает двум целым переменным значение, соответствующее началу и концу этого стихотворения в таблице строк: Start = 32; MaxLines = 22; Следующий шаг заставит Windows послать сообщение WM_PAINT программе Emer- son. Это делается с помощью вызова очень ценной функции InvalidateRect. Обработка сообщения WMPAINT в данном случае сводится к загрузке строк с помощью функции LongString, а затем вывода их на экран с помощью функции TextOut. Emerson делает это посредством цикла for, начиная со строки с номером Start и кончая номером (Start+Maxlines). Однако в действительности дело усложняется наличием линеек прокрутки, которые объясняются в следующем разделе. Подводя черту, можно сказать, что таблицы строк являются простым и очень мощным средством, которое позволяет выводить на экран огромные куски текста с минимальными затратами памяти. Многие программисты используют таблицы строк для хранения сообщений об ошибках. Линейки прокрутки Линейки прокрутки программы Emerson позволяют пользователю просматривать целую поэму, которая не помещается полностью в окне. Чтобы понять, как работают линейки прокрутки программы Emerson?, вам нужно сконцентрироваться на переменной nPosition, которая хранит порядковый номер строки прокручиваемого текста, являющейся в данный момент самой верхней на экране. Например, если стихотворение состоит из 50 строчек и пользователь прокрутил первые 20, то nPosition будет присвоено значение 20. Если в начале экрана располагается первая строчка стихотворения, nPosition будет равна нулю. Значение nPosition меняется, как только пользователь нажимает стрелку на клавиа- туре или щелкает мышью на линейке прокрутки. Для того чтобы встроить в окно линейки прокрутки, следует выполнить следующие несложные действия. 1. Создать линейку прокрутки, используя стиль WS_VSCROLL, функции Create программы: HWND hwnd = CreateWindow(szAppName, szAppName, WS_OVERLAPPEDWINDOW I WS_VSCROLL CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CWUSEDEFAULT, NULL, NULL, hlnst, NULL); 2. Вызвать SetScrollRange с флажками SB_CTL и SB_VERT. Третий и четвертый параметры этой функции определяют размер, который програм- ма должна быть в состоянии прокрутить: SetScrollRange(hwnd, SB_CTL I SB_VERT, 0, MaxLines - Start, FALSE); 3. Ответить на сообщение WM_VSCROLL, которое посылается, как только пользо- ватель щелкает мышью на линейке прокрутки.
Вот сильно упрощенная функция Emerson_OnVScroll: void Emerson_OnVScroll(HWND hwnd, HWND hwndCtl, UINT code, int pos) ( switch(code) ( case SB_LINEU₽: if (nPosition > 0) nPosition -= 1 ; break ; case SB_LINEDOWN: if (nPosition < MaxLines) nPosition += 1 ; break ; case SB_THUMBPOSITION: nPosition = pos; break ; ) nPosition = max(0, min (nPosition, MaxLines)) ; SetScrollPos (hwnd, SB_CTL I SBVERT, nPosition, TRUE) ; InvalidateRect (hwnd, NULL, FALSE) ; ) Если пользователь щелкает по верхней стрелке линейки прокрутки, то вместе с сообщением WM_VSCROL посылается флаг SBLINEUP. В ответ приложение Emerson уменьшает nPosition на 1, а затем устанавливает ползунок линейки прокрутки (маленький квадратик, показанный на рис. 7.4), обращаясь к SetScrollPos. Наконец, вызывается InvalidateRect для отображения на экране текущего фрагмента текста. Те же самые действия повторяются с небольшими изменениями, если пользователь щелкает мышью по нижней стрелке линейки прокрутки (SB_LINEDOWN) или передви- гает ползунок (SB_THUMBPOSITION). Таким образом, линейка прокрутки позволяет дать пользователю способ управления выводом программы. Poems About Sure some god his eye enchants: What he knows nobody wants. In the wood he travels glad. Without better fortune had. Melancholy without bad. Knowledge this man prizes best Seems fantastic to the rest: Pondering shadows, colors, clouds. Grass-buds and caterpillar-shrouds. Boughs on which the wild bees settle. Tints thst spot the violets petal. Why nature lovea the number five. And why the star-form she repeats: Lover of all things alive, Ползунок линейки прокрутки Рис. 7.4. Ползунок линейки прокрутки В ответ на сообщения WM_VSCROLL приложение Emerson вызывает InvalidateRect. При этом оно передает значение FALSE в качестве третьего параметра, который определяет необходимость перерисовки содержимого основного окна. Если бы переда- валось значение TRUE, то окно перерисовывалось бы всякий раз при любой манипуля- ции с линейкой прокрутки. В результате получается отвратительное мигание картинки на экране, что раздражает пользователя и унижает программиста. Чтобы избежать этого, программе Emerson приходится пройти довольно извилистый путь, отвечая на сообщение WM_PAINT. Подобная гимнастика должна гарантировать, что после обращения к Emerson OnVscroll будет перерисована лишь сравнительно малая часть экрана. Таким образом, текст будет прокручиваться вверх и вниз достаточно мягко и быстро, чтобы удовлетворить большинство пользователей. Превосходную альтернативу использованному здесь методу представляет собой функция Scrollwindow. Программа, которую я привел, рисует поверх старого текста ряд прямоугольников, так что старый текст не появляется, когда прокручивается стихотворение. Чтобы
добиться этого, я стараюсь сделать каждый прямоугольник достаточно маленьким. Поскольку по умолчанию функция Rectangle выдает прямоугольник с черным контуром, необходимо заменить перо, которым она рисует: HPEN APen = CreatePen(PS_NULL, 0, 0); HPEN SavePen = SelectPen(PaintDC, APen); // Нарисовать текст и прямоугольник, закрывающий старый текст SelectPen(PaintDC, SavePen); DeleteObject(APen); Когда пользователь щелкает мышью по линейке прокрутки, в основное окно направ- ляется сообщение WM_VSCROLL. Но что происходит, когда пользователь нажимает на клавиатуре верхнюю или нижнюю стрелки? Программа Emerson может отреагировать на это, обрабатывая сообщение WM_KEY- DOWN. Например, нажатие нижней стрелки влечет за собой сообщение WM KEY- DOWN с установленным флажком ‘VK DOWN. Приложение Emerson отвечает на это созданием своего собственного сообщения WM_VSCROLL. 221: case VK_DOWN: 222: SendMessage(hwnd, WM_VSCROLL, SB_LINEDOWN, 0L) ; 223: break; Функция SendMessage повторно вызывает WndProc, на этот раз сообщением WM_VSCROLL, сопровождаемым флажком SB_LINEDOWN. Теперь программа может обработать это сообщение так же, как если бы она обрабатывала щелчок мышки на стрелке внизу линейки прокрутки! И последнее, что осталось сказать об использовании линеек прокрутки. Когда основное окно получает сообщение WM_CREATE, переменной TextHeight должно быть присвоено определенное значение: 140: HDC PaintDC = GetDC(hwnd); 141: GetTextMetrics(PaintDC, STextMetrics); 142: ReleaseDC(hwnd, PaintDC); 143: TextHeight = TextMetrics.tmHeight + 144: TextMetrics.tmExternalLeading; Этот фрагмент кода начинается с обращения к GetDC, чтобы получить контекст устройства для основного окна. Идентификатор контекста устройства (тип HDC) нужен при обращении к функции GetTextMetrics, которая ищет структуру типа TEXTMETRIC, содержащую информацию о шрифте, используемом по умолчанию в основном окне. Два поля структуры TEXTMETRIC используются для расчета высоты шрифта выводимого текста. Эта высота используется в обработчике сообщения WM_PAINT при вычислении местоположения на экране каждой строчки выводимого текста. В частности, она используется чтобы вычислить коорд инату Y, передаваемую в TextOut в качестве третьего параметра. О’кей. На этом завершается обсуждение линеек прокрутки, а вместе с ним и программы Emerson, которое заняло целых две главы. Резюме Сегодня вы познакомились с диалоговыми панелями, растровыми изображениями, таблицами символьных строк и линейками прокрутки. В частности, вы изучили И Способы создания диалогов с помощью сценариев ресурсов. И Использование функции MakeProcInstance для связи сегмента данных программы с диалоговой процедурой. Вызов DialogBox для создания диалоговой панели. Вызов FreeProcInstance для отсоединения сегмента данных от диалоговой процедуры. Создание растровых изображений. Копирование растровых изображений в совместимый контекст устройства.
Передачу растрового изображения из одного контекста устройства в другой для показа на экране. Сохранение исходного состояния контекста устройства и удаление растрового изо- бражения из памяти. Создание таблиц символьных строк. Загрузку и чтении таблиц строк. Управление строковыми ресурсами. Создание линеек прокрутки. Отклик на сообщения WM_VSCROLL. Помните, что в этой главе приводится только введение в диалоги и растровые изображения. Оба эти понятия снова освещаются в других местах этой книги. В частности, в главе 16 приводится обсуждение диалоговых панелей на более глубоком уровне. В главе 18 подробно исследуются растровые изображения. Хотя уже дано достаточно полное введение в ресурсы, я снова вернусь к этому предмету в главе 17. Там вы сможете повторно обозреть более сложные аспекты этого обширного предмета. Вопросы и ответы 1. Я все еще не понимаю как связаны GDI и растровые изображения. Не могли бы вы снова пробежаться по этому предмету? Люди, создававшие Windows, старались мыслить дискретными модулями, или “объ- ектами”. В конечном итоге стало ясно, что все, касающееся графики, требует своей собственной категории, которую программисты назвали интерфейсом графических устройств (GDI). Конкретней, все вызовы, использующие контекст устройства по умолчанию, являются частью GDI. Если вы заглянете в подкаталог ..Windows\System, то обнаружите файл GDI.EXE. Это динамически присоединяемая библиотека (DLL), содержащая все функции интерфейса графических устройств. 2. Расскажите мне еще о диалоговых панелях. Диалоговые панели (или просто диалоги) используются как для вывода информации (как диалоговая панель About в нашей программе), так и для получения информации от пользователя. Многие программы содержат диалоговые панели, которые появляются только для того, чтобы получить имя пользователя или попросить его что-нибудь выбрать. Большинство из этих последних видов диалогов являются модальными, по- скольку часто программе нужно что-нибудь получить от пользователя, прежде чем продолжить работу. Например, когда вы сохраняете часть исходного кода, появляется диалоговая панель, запрашивающая имя файла, в который должен быть записан ваш модуль. Обычно это модальный диалог, поскольку программа не сможет выполняться далее, пока вы не укажете имя или не отмените запись файла. Модальные диалоги создаются вызовом DialogBox, а немодальные — CreateDialog. Вопросы для самопроверки 1. Какая функция используется для запуска модального диалога? 2. Вопрос на засыпку. Какие сообщения посылаются в главное окно программы, когда на экране диалоговая панель About? 3. Какое сообщение посылается в WndProc, когда выбирается пункт меню? 4. Каждый вызов MakeProcInstance должен быть уравновешен вызовом 1 5. Каждый вызов LoadBitMap должен быть уравновешен вызовом_______? 6. Если у вас есть таблица символьных строк, как выбрать строки для показа на экране?
7. Какое сообщение посылается, когда пользователь щелкает мышью на линейке прокрутки? 8. Что представляет собой структура TEXTMETRIC, и где она определяется? 9. Какое сообщение генерируется, когда вы щелкаете по кнопке ОК на диалоговой панели About? Куда оно посылается? 10. Почему программа Emerson должна вызвать MakeProcInstance? Упражнения 1. Программа Emerson создает графические “обои”, копируя одно растровое изобра- жение 15 раз в вертикальном и горизонтальном направлениях. Оптимизируйте програм- му так, чтобы она рисовала только минимальное число растровых изображений, необходимое для заполнения основного окна, независимо от размеров последнего. 2. Добавьте в программу Emerson линейку прокрутки, которая работает в горизон- тальном направлении.
День 8 ПЕРВОЕ ЗНАКОМСТВО С ПРОГРАММОЙ SNAKO Теперь, после нескольких экскурсий в предметную область, отделяющую мир DOS от мира Windows, вы заслужили небольшой отдых и можете познакомиться с первой версией программы Snake (“Змея”). Это графическая программа, составленная на основе известной игры, появившейся еще до выхода первых ПК. Приведенная здесь программа вновь появляется под несколько другим углом зрения в главе 21. Там она развивается до уровня, который может привлечь своим богатством внимание современных создателей компьютерных игр. Эта глава представляет собой повторение первой недели обучения и вознаграждение за ваш упорный труд. Кроме того, я ввожу несколько новых понятий. В частности, мы рассмотрим следующие предметы. Создание и использование таймеров. И Создание дочерних окон. Анимация. И Использование операции XOR при выводе на экран растровых изображений. Разбиение программы на модули. К этому материалу можно подойти менее строго, чем к какому-либо другому. Тем не менее многие понятия вроде дочерних окон или модуляризации очень важны. Полезен будет также некоторый дополнительный опыт работы с растровыми изображениями. Так что приготовьтесь немного поразвлечься, повторить кое-какие старые идеи и встретиться с новыми. Поехали! Обещанная премиальная программа Первая версия программы Snake (Snakel) разработана таким образом, чтобы стиму- лировать воображение людей, которым нравятся игры. Моя цель — снабдить вас действенным набором средств, с помощью которых вы сможете разработать свою собственную игру. В то же время я хочу дать вам игрушку, которая может быть интересной и сама по себе. Надеюсь, что программа Snake спровоцирует вас на самостоятельное программиро- вание. Многое еще можно усовершенствовать в этой программе, и никто не сделает это лучше, чем вы сами. Если этот код заинтригует вас, можете с ним немного поиграть. Добавьте несколько новых свойств, оптимизируйте что-нибудь. Нет лучшего способа научиться программировать, чем начать делать это своими руками!
Замечание. Тот факт, что игры носят развлекательный характер, не означает, что они тривиальны с точки зрения программиста. На самом деле лучшие игры разработаны высококлассными специалистами, чью технику сейчас изучают программисты в таких местах, как NASA. Програм- мирование игр использует достижения переднего края соответствующей технологии и требует чрезвычайно тонкого мастерства. Начну с показа исходного текста первой версии программы Snake. (См. листинг 8.1). Помните, что смысл этого упражнения не только в том, чтобы научить вас чему-то новому, но и потренировать те муя^улы, которые вы уже накачали, путешествуя по различным ландшафтам страны Windows. Листинг 8.1. SNAKE1.CPP 1 И ========----====================---================-----======= 2: // Программа: SNAKE1.CPP 3: // Автор: Чарли Калверт 4: // Описание: Игрушка, демонстрирующая растровые изображения, 5: // обработку нажатий клавиш и применение таймеров 6: // -------------------------------------------========---====== 7: «define STRICT 8; «include <windows.h> 9: «include <windowsx.h> 10: «pragma hdrstop 11: «include <stdlib.h> 12: «pragma warning (disable : 4100) 13: «pragma warning (disable : 4068) 14: «include "snakel.h" 15: «include "grunt.h" 16: 17: // Статические переменные 18: static char szAppName[] = "Snake"; 19: static char szGameNamel) = "Game Window"; 20: static HWND MainWindow; 21: static HWND hGameWindow; 22: 23: // Разделяемые переменные 24: int Size = 32; 25: int Start Col; 26: int Start Row; 27: int MaxCols; 28: int MaxRows; 29: div_t NumXSects, NumYSects; 30: 31: // Переменные 32: HINSTANCE hlnstance; 33: HBITMAP Head, Body, OneHundred; 34: 35: ////////////////////////////////////////////////////////////// 36: // Начальная установка 37: ////////////////////////////////////////////////////////////// 38: 39: ////////////////////////////////////////////////////////////// 40: // WinMain 41: ////////////////////////////////////////////////////////////// 42: «pragma argsused 43: int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInstance, 44: LPSTR IpszCmdParam, int nCmdShow) 45: ( 46: MSG Msg ; 47: 48: if ((hPrevInstance) 49: if (!Register(hlnst)) 50: return FALSE ; 51: 52: if (((MainWindow = Create(hlnst, nCmdShow))) 53: return FALSE ; 54: 55: while (GetMessage(SMsg, NULL, 0, 0)) 56: ( 57: TranslateMessage(SMsg); 58: DispatchMessage (SMsg);
59: } 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: 85: 86: 87: 88: 89: 90: 91: 92: 93: 94: 95: 96: 97: 98: 99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: return Msg.wParam; } ///////////////////////////////////////////////////////// // Сохранить дескриптор, показать максимизированное окно ///////////////////////////////////////////////////////// HWND Create(HINSTANCE hlnst, int nCmdShow) ( hlnstance = hlnst; HWND hwindow = CreateWindow(szAppName, "A Snake and its Tail", WS_OVERLAPPEDW INDOW, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW USEDEFAULT, NULL, NULL, hlnst, NULL); if (hwindow == NULL) return hwindow; nCmdShow = SW_SHOWMAXIMIZED; Showwindow(hwindow, nCmdShow); Update Window(hwindow); return hwindow; } ///////////////////////////////////////////////////////////////// // Зарегистрировать окно ///////////////////////////////////////////////////////////////// ATOM Register(HINSTANCE hlnst) ( WNDCLASS WndClass; WndClass. style = CS_HREDRAW I CS_VREDRAW; WndClass.IpfnWndProc = WndProc; WndClass.cbClsExtra = 0; WndClass.cbWndExtra =0; WndClass.hlnstance = hlnst; WndClass.hlcon = Loadicon(NULL, IDI_APPLICATION); WndClass.hCursor = Loadcursor(NULL, IDC_ARROW); WndClass.hbrBackground = GetStockBrush(GRAY_BRUSH); WndClass.IpszMenuName = NULL; WndClass.IpszClassName = szAppName; Registerclass ((WndClass); WndClass. style = CS_HREDRAW I CS_VREDRAW; WndClass.IpfnWndProc = GaraewndProc; WndClass.hlcon =0; WndClass.hCursor = Loadcursor(NULL, IDC_ARROW); WndClass.hbrBackground = GetStockBrush(WHITE_BRUSH); WndClass.IpszClassName = szGameName; return Registerclass ((WndClass); ) //= ============ ======== // Реализация //=== ======== ===== ============ ===== /////////////////////////////////////////////////////// // WndProc /////////////////////////////////////////////////////// LRESULT CALLBACK export WndProc (HWND hwindow, UINT Message, WPARAM wParam, LPARAM IParam) ( switch(Message) ( HANDLEJMSG (hwindow, WM_CREATE, Snake_OnCreate) ; HANDLEJMSG (hwindow, WMJDESTROY, Snake_OnDestroy) ; default: return SnakeJDefProc(hwindow, Message, wParam, IParam);
134: ) 135: | 136: 137: /////////////////////////////////////////////////////////// 138: // WM CREATE 139: Z////7///////////////////////////////////////////////////// 140: #pragma argsused 141: BOOL Snake_OnCreate (HWND hwnd, CREATESTRUCT FAR* 142: IpCreateStruct) 143: ( 144: Head - LoadBitmap(hInstance, "Head"); 145: if (!Head } 146: { 147: MessageBox(hwnd, "No head", "Fatal Error", MB_OK) 148: return FALSE; 149: } 150: 151: Body = LoadBitmap(hlnstance, "Body"); 152: if ((Body ) 153: ( 154: MessageBox(hwnd, "No body", "Fatal Error", MB_OK) 155: return FALSE; 156: ) 157: 158: OneHundred = LoadBitmap(hlnstance, "Hundred"); 159: if (!OneHundred) 160: ( 161: MessageBox(hwnd, "No OneHundred", "Fatal Error", MB_OK); 162: return FALSE; 163: ) 164: 165: int CXFull = GetSystemMetrics(SM_CXSCREEN); 166: NumXSects = div(CXFull, Size); 167: MaxCols = (NumXSects.quot - 1) * Size; 168: intBordWidth = CXFull - MaxCols; 169: div_t StartC = div(Bordwidth, 2); 170: StartCol = StartC.quot; 171: 172: int CYFull = GetSystemMetrics(SM_CYFULLSCREEN); 173: NumYSects = div(CYFull, Size); 174: MaxRows - (NumYSects.quot - 1) * Size; 175: Bordwidth = CYFull - MaxRows; 176: StartC = div(Bordwidth, 2); 177: StartRow = StartC.quot; 178: 179: 180: hGameWindow = CreateWindow("Gamewindow", "A", 181: WS_CHILD I WS_VISIBLE, 182: StartCol, BORDERSIZE, MaxCols, MaxRows, 183: hwnd, NULL, hlnstance, NULL); 184: 185: return TRUE ; 186: ) 187: 188: /////////////////////////////////////////////////////////////////// 189: // WM DESTROY 190: /////7///////////////////////////////////////////////////////////// 191: ((pragma argsused 192: void Snake_OnDestroy(HWNd hWindow) 193: ( 194: if (Head) DeleteObject(Head); 195: if (Body) DeleteObject(Body); 196: if (OneHundred) DeleteObject(OneHundred); 197: PostQuitMessage(O) ; 198: } Листинг 8.2. SNAKE1.H 1: ///////////////////////////////////////// 2: // Модуль: Snakel.h 3: // Автор: Чарли Калверт 4: // Описание: Заголовочный файл с процедурами 5: ////////////////1//////////////////!!/// 6: 7: // Класс Snake
8: kdefine SnakeDefProc DefWindowProc 9: BOOL Snake_OnCreate(HWND hWindow, CREATESTRUCT FAR* IpCreateStruct); 10: void Snake OnDestroy(HWND hWindow); 11: 12: 13: // Процедуры 14: HWND Create(HINSTANCE hlnst, int nCmdShow); 15: ATOM Register(HINSTANCE hlnst); 16: BOOL Setupwindow(HWND hWindow); 17: LRESULT CALLBACK _export WndProc (HWND, UINT, 18: WPARAM, LPARAM) ; Листинг 8.3. GRUNT.CPP 1: и ==================-----=========---========== 2: II Модуль: GRUNT.CPP 3: // Автор: Чарли Калверт 4: // Описание: Обеспечивает движение змеи 5: // ========================================================= 6: 7: ((define STRICT 8: ((include <windowsx.h> 9: ((define hdrstop 10: ((include <string.h> 11: ((include <stdlib.h> 12: ((include "grunt.h" 13: ((pragma warning (disable : 4100) 14: ((pragma warning (disable : 4068) 15: 16: // Локальные переменные 17: BOOL NewSect-; 18: static int VK_p = 112; 19: static int SnakeTimer = 1; 20: static long Totalclicks = 0; 21: static int Sections; 22: static int NumPrizes; 23: static TPrize Prizes[MAXPRIZES]; 24: static TSectlnfo Sectinfo[MAXSECTIONS]; 25: TTurn TurnList[25]; 26: int NumTurns; 27: 28: Il Глобальные переменные 29: extern div_t NumXSects; 30: extern div_t NumYSects; 31: extern int Size; 32: extern int MaxCols; 33: extern int MaxRows; 34: extern HBITMAP Head, Body, One Hundred; 35: 36: /////////////////////////////////////////////////////////////// 37: // GameWndProc 38: //////////////////////////////////////////////////////////////// 39: LRESULT CALLBACK __export GameWndProc (HWND hWindow, UINT Message, 40: WPARAM wParam, LPARAM) 41: ( 42: switch(Message) 43: ( 44: HANDLE_MSG(hWindow WMCREATE, Garae_OnCreate); 45: HANDLE_MSG(hWindow WM_CHAR, Game_OnChar); 46: HANDLE MSG(hWindow, WM_KEYDOWN, Game_OnKey); 47: HANDLE MSG (hWindow, WM_PAINT, Game_OnPaint); 48: HANDLE MSG (hWindow, WMJTIMER, Garae_OnTimer) ; 49: default: 50: return Game_DefProc(hWindow, Message, wParam,IParam); 51: ) 52: ) 53: 54: IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIHIIIH 55: // WM CREATE 56: /////7//////////////////////////////////////////////////////Z 57: ((pragma argsused 58: BOOL Game_OnCreate (HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) 59: { 60: if ((SetTimer(hwnd, SnakeTimer, 125, NULL)) 61-
62: MessageBox(hwnd, "No Timers Available", "Snake Info", MBOK); 63: return FALSE; 64: } 65: 66: NumPrizes = 0; 67: InitializeSections(); 68: 69: return TRUE; 70: ) 71: 72: //////////////////////////////////////////////////////////// 73: //ИМ DESTROY 74: //////////////////////////////////////////////////////////// 75: void GameOnDestroy(HWND hWindow) 76: ( 77: KillTimer(hwindow, SnakeTimer); 78: ) 79: 80: //////////////////////////////////////////////////////////// 81: // WM CHAR 82: //////////////////////////////////////////////////////////// 83: «pragma argsused 84: void GameOnChar(HWND hwindow, UINT ch, int CRepeat) 85: ( 86: if (ch -= VK_p) 87: KillTimer(hwindow, SnakeTimer); 88: ) 89: 90: /////////////////////////////////./////////////////////////// 91: // WM KEYDOWN 92: ////////////////////////////////////////////////W///////// 93: «pragma argsused 94: void Game_OnKey(HWND hwindow, UINT vk, 95: BOOL fDown, int cRepeat, UINT flags) 96: ( 97: switch(vk) 98: ( 99: case VK_DOWN: GetOldDir(Down); break; 100: case VK_UP: GetOldDir(Up); break; 101: case VK_LEFT: GetOldDir(Left); break; 102: case VK_RIGHT: GetOldDir(Right); break; 103: ) 104: MoveBitmap(hwindow); 105: ) 106: 107: ////////////////////////////////////////////////////////////// 108: // WM PAINT 109: /////7//////////////////////////////////////////////////////// 110: void GameOnPaint(HWND hwindow) 111: ( 112: PAINTSTRUCT Paint Struct; 113: 114: HDC DC = BeginPaint(hwindow, SPaintStruct); 115: 116: HDC PicDC = CreateCompatibleDC(DC); 117: 118: // Нарисовать голову 119: HBITMAP OldBmp = SelectBitmap (PicDC, Head); 120: BitBlt(DC, Sectinfo[0].Col, Sectinfo[0].Row, 121; Size, Size, PicDC, 0, 0, SRCINVERT); 122: SelectObject(PicDC, OldBmp); 123: 124: // Нарисовать тело 125: OldBmp = SelectBitmap(PicDC, Body); 126: for (int i = 1; i <= Sections; i++) 127: BitBlt(DC, Sectinfo[i].Col, Sectinfo[i]-Row, 128: Size, Size, PicDC, 0, 0, SRCINVERT); 129: 130: SelectObject(PicDC, OldBmp); 131: DeleteDC(PicDC); 132: 133: EndPaint(hwindow, SPaintStruct); 134: = FALSE ; 135: Sectlnfо[0].DirChange 136: )
137: 138: 139: 140: 141: 142: 143: 144: 145: 146: 147: 148: 149: 150: 151: 152: 153: 154: 155: 156: 157: 158: 159: 160: 161: 162: 163: 164: 165: 166: 167: 168: 169: 170: 171: 172: 173: 174: 175: 176: 177: 178: 179: 180: 181: 182: 183: 184: 185: 186: 187: 168: 189: 190: 191: 192: 193: 194: 195: 196: 197: 198: 199: 200: 201: 202: 203: 204: 205: 206: 207: 208: 209: 210: //////////////////////////////////////////////////////// // WM TIMER /////7////////////////////////////////////////////////// ♦(pragma argsused void Game_OnTimer(HWND hwnd, UINT id} { HBITMAP SaveBmp; SetFocus(hwnd); if (id == SnakeTimer) ( MoveBitmap(hwnd); TotalClicks++; if ((Totalclicks % 10} == m) ( SetSections(}; SetPrizes (}; HDC PaintDC = GetDC(hwnd); HDC PicDC = CreateCompatibleDC(PaintDC); NewSect = TRUE; // Нарисовать новый приз SaveBmp = SelectBitmap(PicDC, OneHundred}; BitBlt(PaintDC, Prizes[NumPrizes]. Col, Prizes[NumPrizes].Row, 32, 32, PicDC, 0, 0, SRCINVERT); Selectobject(PicDC, SaveBmp); DeleteDC(PicDC); ReleaseDC(hwnd, PaintDC); ) ) } //=---============================------- // Реализация //==========---========================== ///////////////////////////////////////// // Вызывается функцией MoveBitmap // Отслеживает номера столбца и строки // для каждой секции змеи ///////////////////////////////////////// void SetColRow(void) ( int i; for (i = 0; i <= Sections; i++) { SectInfо[i].oldCoL = Sectinfo[i].Col; Sectinfo[i]-OldRow = Sectlnfo(i).Row; switch(Sectinfo[i].Dir) { case Up: Sectlnfofi].Row -= Size; break; case Down: Sectlnfo[i].Row += Size; break; case Left: Sectlnfo[i].Col -= Size; break case Right: Sectlnfo(i).Col += Size; break; } ) for (i = Sections; i > 0; i- ) { if (Sectlnfo[i - 1). DirChange) { Sectinfo[i].DirChange = TRUE; Sectlnfofi].Dir = Sectlnfofi - IJ.Dir; Sectlnfoii - 1].DirChange = FALSE; ) }
211: ) 212: 213: / / / / / / / / / / / / / / / / / / / / / / / //////////////////////////////// 214: // Вызывается функцией MoveBitmap 215: // Следит за тем, какая секция змеи 216: // будет поворачиваться в следующий раз 217: /////////////////////////////////////////////////////// 218: void SetNewTurnSection(void) 219: { 220: for (int i = 1; i <= Sections; i++) 221: { 222: if (TurnList[NumTurns].SectChangeDir[i] == TRUE) 223: break; 224: } 225: TurnList[NumTurns].SectChangeDir[i] = FALSE; 226: i++; 227: TurnList[NumTurns].SectChangeDir[i] = TRUE; 228: } 229: 230: ///////////////////////////////////////////////////// 231: // Производит шум и устанавливает соответствующие 232: // константы, когда происходят столкновения 233: ///////////////////////////////////////////////////// 234: void Boom(HWND hwnd) 235: ( 236: memset(Sectinfo, 0, sizeof(Sectinfo)); 237: Sections = 0; 238: NumPrizes = 0; 239: for (int i = 0; i < 10; i++) 240: MessageBeep(-1); 241: InitializeSections(); 242: InvalidateRect(hwnd, NULL, TRUE); 243: ) 244: 245: ////////////////////////////////////////////////////// 246: // Удалить призы 247: ////////////////////////////////////////////////////// 248: void WhiteOut(HWND hwnd, int i) 249: ( 250: HDC PaintDC = GetDC(hwnd); 251: HDC MemDC - CreateCompatibleDC(PaintDC); 252: 253: HBITMAP SaveBmp = SelectBitmap(MemDC, OneHundred); 254: BitBlt(PaintDC, Prizes[i].Col, 255: Prizes[i].Row, 32, 32, MemDC, 0, 0, SRCINVERT); 256: Selectobject(MemDC, SaveBmp); 257: 258: DeleteDC(MemDC); 259: ReleaseDC(hwnd, PaintDC); 260: } 261: 262: ///////////////////////////////////////// 263: // 264: ///////////////////////////////////////// 265: 266: void CheckForCollision(HWND hwnd) ( 267: 268: if (Sectinfo[0]-Col < 0) Boom(hwnd); 269: if (Sectinfo [0].Row < 0) Boora(hwnd); 270: if (Sectinfo[0].Col + Size > MaxCols) Boom(hwnd); 271: if (Sectinfo[m].Row + Size > MaxRows) Boom(hwnd); 272: 273: // Проверить, укусила ли змея себя за хвост 274: for (int i = 1; i <= Sections; i++) 275: if (Sectlnfo[i].Col == Sectinfo[0].Col && 276: Sectinfo[i].Row == Sectinfo[0]. Row) 277: Boom(hwnd); 278: 279: // Удалить съеденый приз 280: for (i = 0; i <= NumPrizes; i++) 281: ( 282: if (Prizes[i]-Exists) 283: { 284: if ( ((Sectinfo[0]-Row >= Prizes[i].Row) ss 285: (Sectinfo[0].Row <= Prizes[i].Row + (Size - 1))) st
286: ((Sectinfo[0].Col >= Prizes[i].Col) && 287: (SectlnfotO].Col <= Prizes[i].Col + (Size - 1))) ) 288: ( 289: Prizes[i].Exists = FALSE; 290: WhiteOut(hwnd, i) ; 291: ) 292: ) 293: } 294: ) 295: 296: /////////////////////////////////////////////////// 297: // Начальная процедура инициализации 298: /////////////////////////////////////////////////// 299: void InitializeSections() 300: ( 301: int i, StartCol, StartRow; 302: 303: Sections = 5; 304: StartCol = Size * 3; 305: StartRow = Size * 3; 306: 307: for (i = 0; i <= Sections; i++) 308: ( 309: Sectlnfofi].Dir = Right; 310: Sectlnfo(i].DirChange = FALSE; 311: SectlnfoU] .Col = StartCol - (Size * i); 312: Sectinfo[i].Row = StartRow; 313: Sectlnfofi].OldCol = Sectinfo[i].Col; 314: Sectinfo[i].OldRow = Sectinfo(i).Row; 315: ) 316: NewSect = FALSE; 317: } 318: 319: //////////////////////////////////////////////// 320: // 321: //////7///////////////////////////////////////// 322: void GetOldDir(TDir NewDir) 323: ( 324: TurnList(NumTurns].Dir = NewDir; 325: TurnList[NumTurns].SectChangeDir[1] = TRUE; 326: 327: Sectinfo[0].OldDir = Sectinfo[0].Dir; 328: Sectinfo[0]-Dir = NewDir; 329: Sectinfo[0].DirChange = TRUE; 330: TurnList[0]-TurnCol = Sectinfo[0].Col; 331: TurnList[0].TurnRow = Sectinfo[0].row; 332: ) 333: 334: ///////////////////////////////////////// 335: // Нарисовать змеп 336: ///////////////////////////////////////// 337: void MoveBitmap(HWND hwnd) 338: ( 339: SetColRow(); 340: 341: HDC DC = GetDC(hwnd); 342: HDC PicDC = CreateCompatibleDC(DC); 343: 344: CheckForCollision(hwnd); 345: 346: // Нарисовать голову 347: HBITMAP OldBmp = SelectBitmap(PicDC, Head); 348: BitBltfDC, SectlnfotO].OldCol, Sectinfo[0].OldRow, 349: Size, Size, PicDC, 0, 0, SRCINVERT); 350: BitBlt(DC, Sectinfo[0].Col, Sectinfo[0].Row, 351: Size, Size, PicDC, 0, 0, SRCINVERT); 352: SelectObject(PicDC, OldBmp); 353: 354: // Нарисовать тело 355: OldBmp = SelectBitmap(PicDC, Body); 356: BitBltfDC, Sectinfo[1].Col, Sectinfo[1].Row, 357: Size, Size, PicDC, 0, 0, SRCINVERT); 358: BitBlt(DC, Sectinfo[Sections].Col, Sectinfo[Sections].Row, 359: Size, Size, PicDC, 0, 0, SRCINVERT); 360:
361: II Если растет 362: if (NewSect) 363: ( 364: BitBlt(DC, Sectinfo(Sections]-Col, Sectinfo(Sections].Row, 365: Size, Size, PicDC, 0, 0, SRCINVERT); 366: NewSect = FALSE; 367: ) 368: 369: Selectobject(PicDC, OldBmp); 370: 371: Sectinfo[m].DirChange = FALSE; 372: 373: DeleteDC(PicDC); 374: ReleaseDC(hwnd, DC); 375: 376: SetNewTurnSection(); 377: ) 378: 379: lllllllllllllllllllllllllllllllllllllllllllllllll 380: II 381: lllllllllllllllllllllllllllllllllllllllllllllllll 382: void SetPrizes(void) 383: ( 384: NumPrizes++; 385: 386: Prizes[NumPrizes].Exists = TRUE; 387: Prizes[NumPrizes].Row = (rand() % NumYSects.quot) * Size; 388: Prizes[NumPrizes].Col = (rand() % NumXSects.quot) * Size; 389: ) 390: 391: lllllllllllllllllllllllllllllllllllllllllllllllll 392: // 393: ///////////////////////////////////////////////// 394: void SetSections(void) 395: ( 396: Sections++; 397: 398: Sectinfo[Sections].Dir = Sectinfo[Sections - 1] .Dir; 399: Sectlnfо[Sections].DirChange = FALSE; 400: 401: switch (Sectinfo[Sections].Dir) 402; < 403: case Left: 404: { 405: Sectinfo[Sections].Col = Sectinfo[Sections - 1].Col + Size; 406: Sectinfo[Sections].Row = Sectinfo[Sections - 1].Row; 407: break; 408: ) 409: 410: case Right: 411: ( 412: Sectinfo[Sections].Col = Sectinfo[Sections - 1].Col - Size; 413: Sectinfo[Sections].Row = Sectlnfо[Sections - 1].Row; 414: break; 415: } 416: 417: case Up : 418: < 419: Sectinfo[Sections].Col = Sectinfo[Sections - 1].Col; 420: Sectinfo[Sections].Row = Sectinfo[Sections - 1].Row + Size; 421: break; 422: ) 423; 424: case Down : 425: ( 426: Sectinfo[Sections].Col = 427: Sectinfo[Sections].Row = 428: break; 429: } 430: ) // end switch 431: ) 432: Sectinfo[Sections].OldCol 433: Sectinfo[Sections].OldRow Sectinfo [Sections - 1] .'Col; Sectinfo[Sections - 1].Row - Size: = Sectinfo[Sections - 1].Col; = Sectinfo[Sections - 1].Row;
Листинг 8.4. GRUNT.H 1: //////////////////////////////////////////////// 2: // Модуль: GRUNT.H 3: // Автор: Чарли Калверт 4: // Описание: Обеспечивает движение змеи 5: //////////////////////////////////////////////// 6: «include <windows.h> 7: #include <windowsx.h> 8: 9: «define BORDERSIZE 15 10: «define MAXSECTIONS 1024 11: «define MAXPRIZES 512 12: 13: // Определения типов 14: enum TDir {Left, Right, Up, Down}; 15: 16: struct TSectlnfo 17: { 18: BOOL Dirchange; 19: TDir Dir, OldDir; 20: int SecNum ; 21: int Row, Col; 22: int OldRow, OldCol; 23: }; 24: 25: struct TTurn 26: { 27: TDir Dir; 28: BOOL SectChangeDir[256]; 29: int TurnCol, TurnRow; 30: }; 31: 32: struct TPrize 33: { 34: BOOL Exists; 35: int Value; 36: int Col, Row; 37: }; 38: 39: 40: // Класс Game 41: «define Game_DefProc DefWindowProc 42: BOOL Game_OnCreate(HWND hWindow, 43: CREATESTRUCT FAR* IpCreateStruct); 44: void Game_OnDestroy(HWND hWindow); 45: void Game_OnChar(HWND hWindow, UINT ch, int cRepeat); 46: void Game_On Key(HWND hWindow, UINT vk, 47: BOOL fDown, int cRepeat, UINT flags}; 48: void Game_OnPaint(HWND hWindow); 49: void Game_OnTimer(HWND hWindow, UINT id); 50: 51: // Процедуры 52: LRESULT CALLBACK __export GameWndProc(HWND, UINT WPARAM, LPARAM); 53: 54: void InitializeSections(); 55: void GetOldDir(TDir NewDir); 56: void MoveBitmap(HWND hWindow); 57: void SetSections(void); 58: void SetPrizes(void); Листинг 8.5. SNAKE1.RC 1: // SNAKE1.RC 2: Body BITMAP "body.bmp " 3: Head BITMAP "head.bmp" . 4: Hundred BITMAP "hundred.bmp" Листинг 8.6. SNAKE1.DEF 1: ; SNAKE1.DEF 2: NAME SNAKE1
3: DESCRIPTION 'Snakel' 4: EXETYPE Windows 5: STUB 'WINSTUB.EXE' 6: CODE PRELOAD 7: DATA PRELOAD 8: HEAPSIZE 4096 9: STACKSIZE 5120 MOVEABLE DISCARDABLE MOVEABLE MULTIPLE Листинг 8.7. SNAKE1.MAK (Borland) 1: # SNAKE1.MAK 2: 3: APPNAME = Snakel 4: INCPATH = C:\BC\INCLUDE 5: LIBPATH = C:\BC\LIB 6: FLAGS = -H -ml -W -v -w4 -IS (INCPATH) -L$ (LIBPATH) 7: 8: # компоновка 9: $(APPNAME).exe: $(APPNAME).obj Grunt.obj $(APPNAME).def $(APPNAME).res 10: bcc S(FLAGS) $(APPNAME).obj GRUNT.OBJ 11: brc S(APPNAME).res 12: 13: # компиляция 14: $(APPNAME).obj: $(APPNAME).cpp 15: bcc -c $(FLAGS) $(APPNAME).cpp 16: 17: # компиляция IB: GRUNT.OBJ: GRUNT.CPP 19: bcc -c S(FLAGS) GRUNT.CPP 20: 21: # ресурсы 22: $(APPNAME).res: $(APPNAME).rc 23: brc —r -iS(INCPATH) S(APPNAME).rc Листинг 8.8. SNAKE1.MAK (Microsoft) 1: # SNAKE1.MAK 2: 3: APPNAME - Snakel 4: 5: # компоновка 6: $(APPNAME).exe : $(APPNAME).obj GRUNT.OBJ $(APPNAME).def 7: link $(APPNAME) Grunt, /align:16, NUL, /nod slibcew libw, $(APPNAME) 8: 9: rc S (APPNAME) 10: 11: # компиляция 12: $(APPNAME).obj : $(APPNAME).cpp 13: cl —c -AL -GA -Ow -W4 -Zp $ (APPNAME) .cpp 14: 15: # компиляция 16: GRUNT.OBJ : GRUNT.CPP 17: cl —c -AL -GA -Ow -W4 -Zp GRUNT.CPP 18: 19: # компиляция ресурсов 20: s (APPNAME)-res : $ (APPNAME) .rc 21: rc —r $(APPNAME).rc Программа начинается с отображения короткой змеи, медленно ползущей по экрану (см. рис. 8.1). Направлением движения змеи можно управлять с помощью клавиш-стре- лок. Цель игры — удержать змею в границах игрового поля и от пересечения собствен- ного тела. Для разнообразия время от времени на экране появляются особые маленькие призовые растровые картинки. Змея голодна и непрочь подкрепиться этими призами. Вы должны помогать ей в этом по мере возможности. В дополнение к исходному коду вы должны сгенерировать три растровых изображе- ния размер 32x32 пиксела, показанных сразу вслед за текстом программы.
Рис. 8.1. Змея, ползущая по игровому полю Дочернее окно Приложение Snakel имеет не одно, а два окна. Основное окно видимо лишь как маленькая серая рамка, очерченная вокруг игрового поля. Само игровое поле фактически является дочерним окном, которое называется GameWindow. Оно служит в основном для упрощения математики Snakel. Суть в том, что все три растровые картинки, использованные в этой программе, имеют размер 32x32 пиксела. Поэтому было бы неплохо, если бы размеры игрового поля были кратны 32 и не могли изменяться. Чтобы добиться этого, Snakel максимизирует свое основное окно, а затем высвечивает дочернее окно, размерность которого по осям X и Y уже кратна 32. Максимизировать окно при старте одень просто. Для этого нужно лишь присвоить переменной nCmdShow соответствующую константу, как определено в WINDOWS.H: nCmdShow = SW_SHOWMAXIMIZED; ShowWindow(hWindow, nCmdShow); После того как основное окно максимизировано, Snakel создает дочернее окно GameWindow в ответ на сообщение WM CREATE. Это происходит следующим образом. 1. Регистрируется окно. 2. Вычисляются его размеры. 3. Вызывается CreateWindow, чтобы сделать окно видимым для пользователя. В принципе создание дочернего окна ничем не отличается от создания основного окна программы. Шаги, выполняемые при этом, абсолютно идентичны: вы регистри- руете окно, а затем создаете его. Несмотря на то, что вы уже знакомы с этим предметом из пройденной части книги, мы вновь пройдем весь этот процесс, чтобы не было никаких вопросов. Идея создания дочерних окон есть одна из центральных идей Windows, и важно, чтобы вы поняли ее. Если это происходит недостаточно быстро, не беспокойтесь. Данный материал посто- янно рассматривается в этой книге с различных точек зрения. Приложение Snakel регистрирует GameWindow там же, где и основное окно. Если вы загляните в метод Register, то увидите, что сначала регистрируется класс Snakel, а затем второе окно, называемое GameWindow: 19: static char szGameName[] = "Gamewindow"; ... /* Код для определения класса основного окна Snakel */ 106: Registerclass (&WndClass); /* Регистрируем игровое окно */ 109: WndClass.IpfnWndProc = GameWndProc; 110: WndClass.hIcon — 0;
111: WndClass.hCursor = LoadCursor(NULL, IDC_ARROW); 112: WndClass.hbrBackground = GetStockBrush(WHITE_BRUSH); 113: WndClass.IpszClassName = szGameName; 114: 115: return Registerclass (iWndClass); Нет необходимости переопределять все поля структуры WndClass. Многие из них можно перенести из одного класса в другой в неизменном виде. Однако следует переопределить поле IpfnWndProc (строчка 109), указывающее на оконную процедуру. WndProc — это место, где определяется поведение, ассоциированное с окном. Поскольку GameWindow представляет собой игровое поле программы, очевидно, ему должно быть присуще довольно специфическое поведение. Это поведение определяется в своем собственном отдельном модуле, имеющем имя Grunt. Оно объясняется в следующем разделе. На рис. 8.2 показано, где размещается GameWindow. Рис. 8.2. Окно с игровым полем располагается по центру главного окна Итак, вы видели, как программа Snakel регистрирует окно GameWindow. Следующий шаг заключается в создании окна посредством вызова CreateWindow. Snakel делает это в ответ на сообщение WM CREATE. Все предыдущие программы из этой книги передавали CW_USEDEFAULT в четырех параметрах, использующихся для объявления размеров окна. Однако в данном случае Snakel вычисляет размеры, передаваемые функции CreateWindow особым образом. Вычисления необходимы, так как программа может выполняться в различных системах. Иногда экран имеет размеры 640x480, а иногда — 1024x768 или 800x600. Поскольку невозможно знать эти размеры заранее, приходится вычислять их во время выполнения. Чтобы установить текущую систему, Snakel вызывает функцию GetSystem- Metrics. Когда передаются аргументы SM_CXSCREEN и SM_CYSCREEN, то GetSys- temMetrics докладывает о размерах (в пикселах) текущего экрана. Snakel использует эту информацию для вычисления максимально удобного игрового поля, которое может быть создано на этом экране. Результаты сохраняются в глобальных переменных MaxCols, MaxRows и Started. Ниже приводится код, который вычисляет MaxCols: int CXFull = GetSystemMetrics(SM_CXSCREEN); NumXSects = div(SXFull, Size); MaxCols = (NumXSects.quot - 1) * Size; и т.д. . . Узнав оптимальные размеры окна GameWindow, приложение Snake может создать его: hGameWindow = CreateWindow("GameWindow", "А", WS_CHILD | WS_VISIBLE, Started, BORDERSIZE, MaxCols, MaxRows, hwnd, NULL, hlnstance, NULL);
Нечто подобное этому коду вы уже встречали в функции Create каждой полномас- штабной Windows-программы. Он должен быть уже хорошо вам знаком, за исключением нескольких небольших вариаций. Замечание. Третий аргумент CreateWindow содержит WS_CHILD и WS_VISIBLE, объединенных посредством логического ИЛИ. Все предыдущие программы передавали в этой позиции WSOVERLAPPEDWINDOW. В отличие от WS_OVERLAPPEDWINDOW окно WS_CHILD не имеет рамки, полосы заголовка, кнопок минимизации и максимизации и системного меню. Иначе говоря, WS_CHILD — более простой и скромный стиль, нежели WS_OVERLAPPEDWIN- DOW. Добавление стиля WS_VISIBLE позволяет создать окно без явного обращения к ShowWindow или Update Window. Программисты часто используют этот стиль с дочерними окнами, но не с основным окном программы. На данном этапе вам не нужно слишком много беспокоиться о стилях окна. Этот предмет будет исследован на более глубоком уровне в главе 12. В предыдущих нескольких абзацах была приведена последовательность действий, необходимых для создания дочернего окна. Этот предмет уже освещался достаточно глубоко в предыдущих главах. Я повторил его, чтобы помочь вам сориентироваться и выразить основные моменты простыми и ясными понятиями. Запомните, вы должны сделать лишь следующее: М Зарегистрировать окно. И Вызвать CreateWindow, чтобы создать его. Когда вы сделаете это, останется только поддерживать ваше создание, обслуживая его оконную процедуру. Приложение Snakel делает это в модуле Grunt Модуль Grunt Итак, окно GameWindow дает три больших преимущества: 1. Создает удобное симметричное игровое поле, границы которого делятся на 32. 2. Изолирует все запутанные вычисления в одном модуле. 3. Демонстрирует создание отдельного модуля, который впоследствии можно будет присоединить к большой Windows-программе. Первое преимущество детально обсуждалось в предыдущем разделе. Второе позволяет упростить программирование,' исключить ошибки и обеспечить поддержку программы. Иначе говоря, это преимущество имеет место при использовании техники хорошо структурированного программирования. Третье преимущество GRUNT.CPP заключается в том, что здесь демонстрируется способ создания многомодульной Windows-программы. Все приемы, использованные при создании модуля Grunt, могут служить руководством по организации больших Windows-приложений. Можете вернуться к исходному коду, чтобы увидеть, как объявлять внешние (external) переменные, которые могут разделяться многими модулями, и как вызвать функции, расположенные в отдельных модулях. Но гораздо важнее то, что там показан способ построения CPP-файла для отдельного окна таким образом, чтобы окно и модуль существовали как параллельные и легко идентифицируемые сущности. Это центральный принцип структурного программирования и основная идея, из которой родилось объ- ектно-ориентированное программирование. В Windows правила разбиения программы на модули не отличаются от соответству- ющих правил DOS. Основная идея — создать файлы заголовков для каждого из ваших модулей, а затем объявить разделяемые типы и функции в этих заголовочных файлах. Если вы решите, что вам необходимо объявить глобальную переменную, можете вос- пользоваться ключевым словом extern, чтобы сделать ее доступной для более чем одного модуля, как вы поступили бы в DOS.
При создании модуля, который предстоит состыковать с вашей основной программой: Создавайте заголовочный файл для каждого разделяемого модуля. Не держите в заголовочном файле ничего, кроме директив компилятора и объявлений типов или функций. Размещайте глобальные переменные, разделяемые модулями и основной программой, не в заголовочном файле, а внутри исходных СРР-файлов. Помещайте ключевое слово extern перед глобальными переменными, ссылки на которые будут встречаться вне модуля, где они определяются. Например, ссылки на переменные MaxCols и MaxRows присутствуют как в основном модуле, так и в модуле Grunt. Поэтому они определяются в файле SNAKELСРР, а затем ссылка на них организуется с помощью ключевого слова extern в файле GRUNT.CPP: extern int MaxCols; extern int MaxRows; О создании больших многомодульных программ можно еще многое рассказать. Впрочем, этот материал достаточно детально освещается в основных курсах по програм- мированию на Си++. Вместо повторения этого материала я лучше постараюсь придер- живаться нашей темы, которой является программирование под Windows. Возможно, вы заметили, что код в модуле Grunt может быть поделен на два главных раздела. Сначала GameWndProc и функции Game_OnCreate, Game_OnDestroy, Game_OnPaint, Game_OnChar, Game_OnKey и Game_OnTimer. Замечание. Ни одна из функций модуля Grunt никогда не вызывается непосредственно из SNAKE 1 .СРР. Вместо этого SNAKE1 .СРР создает GameWindow в ответ на сообщение WM_CRE- АТЕ (строчка 141). Затем функции Game_OnXXX вызываются самой Windows главным образом в ответ на сообщения WM TIMER (строчка 366) и WM KEYDOWN (строчка 318). Вторая часть модуля Grunt содержит подпрограммы, которым он обязан своим именем. Этот код выполняет черновую работу по вычислению направления движения змеи и проверке на столкновение. Эти функции не являются обработчиками сообщений, поэтому соглашение об их именовании не соответствует формату Game OnXXX. Они имеют простые и удобные имена, такие, как MoveBitmap и CheckForCollisions. Таймер Механизм выполнения программы Snakel зависит от сообщения WM_TIMER. Таймеры — это устройства, посылающие окну сообщения WM TIMER через отно- сительно равные интервалы времени. Как вы знаете, большинство посылаемых окну сообщений генерируется какими-либо действиями со стороны пользователя. Таймеры же работают сами по себе, без какого-либо участия со стороны пользователя или программиста. Замечание. Я сказал, что сообщения таймера посылаются через “относительно” равные интер- валы, поскольку среда DOS/Windows не может генерировать сообщения абсолютно регулярно! Не рассчитывайте на это и не тратьте время попусту. Если вам нужен более точный таймер, можете порыться в мультимедийных таймерах из MMSYSTEM.H. (Хотя эти таймеры и не обсуждаются непосредственно в этой книге, у вас будет возможность познакомиться с другими особенностями мультимедиа в главе 20). Поддержка таймеров обычно является относительно простой операцией, включаю- щей в себя три шага. 1. Инициализация таймера вызовом SetTimer. 2. Ответ на сообщения WM_TIMER в обработчике Cls_OnTimer. 3. Освобождение ресурсов таймера в конце работы. Выполняется вызовом KillTimer.
Snakel выполняет инициализацию таймера в функции Game_OnCreate: 284: if (!SetTimer(hwnd, SnakeTimer, 125, NULL)); 285: ( 286: MessageBox(hwnd, "No Timers Available", "Snake Info", MB_OK); 287: return FALSE; 288: ) Функция SetTimer зависит от четырех параметров. Дескриптор окна, с которым ассоциируется таймер. Уникальный идентификатор, ассоциированный с таймером. Интервал в миллисекундах между посылками сообщений в ваше окно. Имя необязательной пользовательской процедуры (callback), которую Windows может вызывать вместо посылки сообщений WM_TIMER в окно. Как видите, программа Snake выбирает в качестве четвертого параметра NULL, потому что программистам редко бывает нужно работать с пользовательскими процедурами таймера. После инициализации таймера программа Snake просто отвечает на сообщения WM_TIMER: void Snake_OnTimer(HWND hwindow, UINT id) ( MoveBitMap(hwindow); TotalClicks++; if (( Totalclicks % 10) == 0) ( Setsections(); SetPrizes(); /* Добавочный код для удлинения змеи и т.п. */ ) ) В этой программе сообщения WM TIMER поступают примерно через каждые 150 мс. Если вы хотите, чтобы змея двигалась быстрее, можете создать таймер, посылающий сообщение через каждые 75 или 25 мс. Таймеры — это системные ресурсы, подобные растровым изображениям и пикто- граммам. Поэтому вы должны внимательно проверить, что вызов SetTimer был успешен. Вы также должны уничтожить таймер, как только закончите с ним работать. Правильный способ уничтожения таймера — вызвать KillTimer, передав в качестве параметров дескриптор окна, которому принадлежит таймер и идентификатор самого таймера: KillTimer(hWindow, SnakeTimer); Если вы забудете уничтожить таймер, система может исчерпать все таймеры. В результате все приложения (ваши и остальные) станут беспомощными, и им ничего не останется, как только выдать серию сообщений о невозможности дальнейшей работы. Уравновешивайте каждое обращение к SetTimer вызовом KillTimer. Никогда не выходите из приложения, использующего таймер, предварительно не уничтожив последний. Не создавайте больше таймеров, чем вам действительно может потребоваться. Теперь, когда вы поняли, как работают таймеры, я собираюсь лишь слегка коснуться функции Snake_OnTimer. Если желаете разобраться с ней подробнее, запустите отладчик и не бойтесь испачкать руки. Основное назначение Snake_OnTimer — вызывать процедуру MoveBitMap, которая рисует на экране змею. Впрочем, как видите, Snake_OnTimer содержит сверх того логику для добавления змее новой секции через каждые 10 посылок сообщения WM_TIMER. Частично эта логика дублируется в функции Snake_OnPaint. Это сделано только из-за того, что может потребоваться перерисовать экран, если по каким-то причинам он окажется закрыт.
Рисуем змею Программа Snake всегда отображает рисунок на экране, используя константу SRCIN- VERT в качестве последнего параметра для функции BitBlt. В результате точки рисунка объединяются с точками экрана посредством исключающего ИЛИ (XOR). Это простой способ добиться своего рода анимации, когда область под перемещающимся изображе- нием остается нетронутой. Когда вы выводите рисунок на экран с помощью XOR, то можете стереть его, объединив с самим собой посредством той же операции. Иначе говоря, выполняя операцию XOR первый раз, вы делаете рисунок видимым на экране, а второй раз — невидимым. Этот процесс не затрагивает никакие другие изображения, расположенные под нашим. Суть “оживления” объекта состоит в том, чтобы отобразить его на экране, стереть, передвинуть немного вперед, показать снова, стереть, снова передвинуть и т.д. до тех пор, пока требуется иллюзия движения. Не хочу сейчас обременять вас дополнительной информацией об операции XOR над растровыми изображениями и о тонкостях функции BitBlt. Я вернусь к этой теме в главе 18. Однако вы должны заметить, что использование SRCINVERT всегда изменяет цвета любого создаваемого вами растрового изображения. Поэтому вам могут потребоваться две копии картинки, использующейся в этой программе. Первая копия должна быть желаемого цвета. Вторая копия — инвертированная версия, предназначенная для ис- пользования с RC-файлом. Когда инвертированная версия картинки отображается на экране с помощью SRCINVERT, растровое изображение появляется в том виде, как вы его изначально нарисовали. Большинство графических редакторов в Windows обладает способностью инвертирования растровых изображений. Оставшаяся часть программы написана в соответствии со стандартной практикой программирования на Си++ и касается вопросов, уже рассмотренных ранее. Если логика этой программы вызывает у вас затруднения, примите во внимание ключевой момент, состоящий в том, что каждая секция змеи является законченным объектом, знающим свое текущее и предыдущее положение и направление движения. Всякий раз, когда голова змеи поворачивается, срабатывает эффект цепочки и информация о движении передается по телу змеи от секции к секции. Иными словами, когда посылается сообщение WM_TIMER, каждая секция змеи занимает положение, в котором была предшествующая секция до посылки этого сообщения. Фактическая передача этой информации осуществляется в функции SetColRow. Таким образом, “новость” доходит от головы до хвоста. Этот алгоритм свято выполняется, даже если в итоге будут перерисовываться только первая и последняя секции змеи. Надеюсь, вы найдете программу Snake приятным и поучительным примером. Я пытался сделать ее достаточно интригующей, чтобы вы увлеклись ею и захотели извлечь некоторую пользу из представленного в этой главе материала. Самостоятельное программирование — лучший способ обучения. Хорошим началом могла бы быть попытка развития этой игры. Резюме Цель этой главы состояла в том, чтобы развлечь вас и дать некоторый практический опыт. Попутно были введены следующие новые моменты: Создание таймеров вызовом SetTimer и уничтожение их вызовом KillTimer. Реагирование на сообщения WM_TIMER. Создание дочерних окон. Помещение окна в отдельный модуль и вызов его из тела программы. Не пренебрегайте этим знанием только потому, что оно было дано вам в форме игры. Усвоив его, вы сможете превратиться из неофита в истинного гуру среды Windows!
Вопросы и ответы 1. Зачем нужно было автоматически максимизировать основное окно программы Snake? Не перечеркивает ли это преимуществ многозадачности? Это скорее философский, нежели технический вопрос. Для меня резоном для максимизации окна было просто облегчить пользователю управление змеей, снабдив его удобной картинкой. 2. Я не думал, что Windows приспособлена для игровой среды. Не противоречит ли это основ- ному духу Windows? Каждая копия Windows снабжена, по крайней мере, двумя встроенными играми. Разработчики этой среды определенно не исключали игр. Впрочем, в идее, что игры DOS ведут себя лучше игр Windows, заключена некоторая доля правды. Причина в том, что программисты DOS обладают полным контролем над машиной. Однако программа Snake показывает, что в среде Windows графика может быть значительно более быстрой. Определенно, Windows дает программистам огромное преимущество благодаря своей развитой графической поддержке. Впрочем, я убежден, что ни одно из программных средств не может рассматриваться, как панацея. Думаю, что в будущем удачная среда может быть разработана на стыке существующих. Вопросы для самопроверки 1. Какие два шага необходимы для создания дочернего окна? 2. Почему RegisterClass вызывается дважды в функции Register программы Snakel? 3. Как называется оконная процедура дочернего окна Snakel? 4. Почему функция Game_OnDestroy не вызывает PostQuitMessage? 5. Как создать таймер? 6. Как программа Snake гарантирует, что KillTimer будет вызван прежде, чем она кончится? 7. Какую константу вы используете, если хотите применить ХОКдля вывода битового образа на экран? 8. Как определить, сколько пикселов нужно для заполнения одной строки экрана компьютера? 9. Воспользуйтесь справочником или интерактивной системой помощи, чтобы найти 10 характеристик, которые можно выбрать с помощью функции GetSystemMetrics. 10. Каково назначение функции Game_OnChar? Упражнения 1. Добавьте в программу Snake то, чего, на ваш взгляд, ей не достает! 2. В следующих нескольких главах вы много узнаете о графических элементах управления. Воспользуйтесь ими, чтобы разнообразить программу Snake. Иными слова- ми, превратите ее в развивающийся проект.
День 9 ОСНОВЫ ШРИФТОВ В этой главе вы увидите, как в среде Windows создаются шрифты. В частности, освещаются следующие вопросы: Создание шрифтов с помощью вызовов функций CreateFontIndirect CreateFont и GetStockObject. Получение информации о текущем шрифте с помощью вызова GetTextMetrics и GetTextFace. Использование и анализ структуры LOGFONT. Использование и анализ структуры TEXTMETRIC. Смена шрифта. Удаление шрифта с помощью DeleteObject. Цель этой главы — дать вам твердое практическое знание шрифтов, которое приго- дится при создании большинства программных проектов. Главы 10 и 11, которые в основном посвящены исследованию графических элементов управления в Windows, в какой-то степени продолжают тему этой главы, повествуя о полном переборе шрифтов на вашей системе с помощью обработчика перечисляемых объектов (callback function). Шрифтовая лихорадка достигает IBM PC Вскоре после появления Windows 3.0 я находился на вольных хлебах, хватаясь за различные виды работы, иногда программируя, а иногда просто консультируя от нечего делать. Одна из работ, которую мне удалось тогда найти, заключалась в обслуживании дизайнера-трафика. У него был целый магазин, наполненный дорогими принтерами, сканерами и “макинтошами”. Было там и несколько IBM PC. Я выполнял для него несложные задания вроде чистки его файла WIN.INI или удаления ненужных вызовов из AUTOEXEC.BAT. Более интересная с технической точки зрения часть моей работы заключалась в удовлетворении его страстного интереса к шрифтам. Люди из мира “макинтошей” занимаются шрифтами уже много лет. Поскольку эти ресурсы представляют собой часть их бизнеса, все их компьютеры буквально перегру- жены невероятным количеством шрифтов. Его целью было уравновесить это разнооб- разие вооружением своих ПК еще большим количеством шрифтов. Не какой-нибудь там пятеркой или десяткой шрифтов, а полусотней или даже больше. Он очень серьезно относился к своему бизнесу, и люди платили ему приличные деньги. Система Windows была нова для него, а времени, чтобы овладеть всеми деталями, не было. Ему требовался некто, кто мог бы провести для него необходимую сортировку
этих шрифтов и, что еще более важно, выяснить, как можно получить доступ ко всем ним из PageMaker, CorelDraw или Worf for Windows. К сожалению, весь мой опыт работы с DOS был здесь бесполезен. Годами я работал с одним и тем же набором символов DOS. Когда дело дошло до шрифтов, я воспринимал их, как утконос. Я не мог отличить “тайме” от “курьера”, полужирное начертание от курсивного или WingDing от Symbol. Я был абсолютным пнем в области эстетических тонкостей, которые составляли суть бизнеса парня, на которого я работал. Благодаря упорной работе и доле удачи мне в конце концов удалось разобраться с большей частью этих шрифтов. Но это было трудно. Я просто не понял, с каким сложным и тонким предметом столкнулся. По прошествии многих лет я часто был благодарен этому полученному мною опыту не только потому, что многому научился, но еще и потому, что понял, какую страстную заботу могут проявлять многие люди о шрифтах. Это предмет, способный вызывать сильные чувства. Мой совет новичкам в области Windows: обратите серьезное внимание на этот предмет. Если ничего другого не получится, следует предоставить вашим пользователям доступ ко всем шрифтам системы, дав им возможность осуществить желаемый выбор в любой конкретной ситуации. Дело в том, что вы никогда не знаете заранее, когда столкнетесь с кем-то, для кого это действительно важно. Но все равно шрифты — это здорово. Они могут добавить огня даже совершенно рутинным программам. Поэтому в следующих нескольких главах я исследую этот предмет более детально. Простая шрифтовая программа Приготовьтесь исследовать первый пример использования шрифтов — программу SimpFont (см. листинг 9.1). Здесь показывается очень простой и доступный способ создания шрифта. Листинг 9.1. SIMPFONT.CPP 1: ///////////////////////////////////////////////// 2: // Программа: SIMPFONT.CPP 3: // Автор: Чарли Калверт 4: // Описание: SimpFont — программа для Windows 5: // Дата: 3/20/93 6: ///////////////////////////////////////////////// 7: 8: «define STRICT 9: «include <windows.h> 10: «include <windowsx.h> 11: «pragma hdrstop 12: «include <stdio.h> 13: «include <stdlib.h> 14: «include <string.h> 15: «include "simpfont.h" 16: «include “fontstr.h" 17: «pragma warning (disable: 4068) 18: 19: // переменные 20: static char szAppName{] •= “SimpFont"; 21: static HWND MainWindow; 22: static HINSTANCE hlnstance; 23: static LOGFONT LogFont; 24: static HFONT TheFont; 25: static char aFaceName{80]; 26: TEXTMETRIC TextMets; 27: char * Fontchoice[] = (“New Times Roman", "Arial", 28: “ Symbol" , “StockFont" ); 29: enum TChoice (Roman, Swiss, Symbol, StockFont); 30: TChoice Choice; 31: 32: // 33: // Инициализация 34: // 35: 36: ///////////////////////////////////////
37: // Точка входа в программу 38: /////////////////////////////////////// 39: ttpragma argsused 40: int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInstance, 41: LPSTR IpszCmdParam, int nCmdShow) 42: ( 43: HWND hWindow; 44: MSG Msg ; 45: 46: if ((hPrevInstance) 47: if ((Register(hlnst)) 48: return FALSE ; 49: 50: if (((MainWindow = Create(hlnst, nCmdShow))) 51: return FALSE; 52: 53: while (GetMessage(SMsg, NULL, 0, 0)) 54; { 55: TranslateMessage(SMsg); 56: DispatchMessage(SMsg); 57: ) 58: 59: return Msg.wParam; 60: ) 61: 62: ////////////////////////////////////// 63: // Регистрация окна 64: ////////////////////////////////////// 65: BOOL Register(HINSTANCE hlnst) 66: 67: WNDCLASS WndClass; 68: 69: WndCla ss.style 70: WndClass.IpfnWndProc 71: WndClass.cbClsExtra 7 2: WndCla s s.cbWndExtra 73: WndClass.hlnstance 74: WndClass.hIcon 75: WndClass.hCursor 76: WndClass.hbrBackground 77: WndClass. IpszMenuName 78 : WndClass. IpszClassName 79: = CS_HREDRAW | CS_VREDRAW; = WndProc; •= 0; = 0; » hlnst; = Loadicon (NULL, IDI_APPLICATION) = Loadcursor(NULL, IDC_ARR0W); = GetStockBrush(WHITE_BRUSH); = "Menu"; = szAppName; 80: return Registerclass (SWndClass); 81: ) 82: 83: ////////////////////////////////////// 84: // Создание окна 85: ////////////////////////////////////// 86: HWND Create (HINSTANCE hinst, int nCmdShow) 87: 88: 89: hlnstance = hlnst; 90: 91: HWND hWindow = CreateWindow(szAppName, szAppName, 92: WS_OVERLAPPEDWINDOW, 93: CWJUSEDEFAULT, CWUSEDEFAULT, 94: CW_USEDEFAULT, CW USEDEFAULT, 95: NULL, NULL, hlnstance, NULL); 96: 97: if (hWindow — NULL) 98: return hWindow; 99: 100: ShowWindow(hWindow, nCmdShow); 101: UpdateWindow(hWindow); 102: 103: return hWindow; 104: ) 105: 106: // 107: // Реализация 108: // 109: 110: //////////////////////////////////////// 111: // Оконная процедура
112: //////////////////////////////////////// 113: LRESULT CALLBACK ; export WndProc(HWND hWindow, UINT Message, 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 135: 136: 137: 138: 139: 140: 141: 142: 143: 144: 145: 146: 147: 148: 149: 150: 151: 152: 153: 154: 155: 156: 157: 158: 159: 160: 161: 162: 163: 164: 165: 166: 167: 168: 169: 170: 171: 172: 173: 174: 175: 176: 177: 178: 179: 180: 181: 182: 183: 184: 185: 186: WPARAM wParam, LPARAM IParam) ( switch(Message) ( HANDLE MSG(hWindow, WM_DESTROY, SimpFontOnDestroy) HANDLE MSG(hWindow, WM_CREATE, SimpFont_OnCreate); HANDLE MSG(hWindow, WM_COMMAND, SimpFont_OnCommand) HANDLE MSG (hWindow, WM_PAINT, SimpFont_OnPaint); default: return SimpFontDefProc(hWindow, Message, wParam, IParam); ) ) /////////////////////////////////////////////// // Получить новый шрифт, задать поле Escapement /////////////////////////////////////////////// HFONT GetFont(int Escapement, char * Name) ( memset(SLogFont, 0, sizeof(LOGFONT)); LogFont.IfHeight =37; LogFont.IfWeight = 408; LogFont.IfEscapement = Escapement; LogFont.IfItalic = 1; LogFont.IfUnderline = 1 ; LogFont.IfOutPrecision = OUT_STROKEPRECIS; LogFont. IfClipPrecision = CLIP_STROKE_PRECIS; LogFont.IfQuality = DEFAULT_QUALITY; strcpy(LogFont.IfFaceName, Name); if (TheFont != 0) DeleteObject(TheFont); TheFont = CreateFontlndirect(SLogFont); return TheFont; ) ////////////////////////////////////////////// // Обработчик сообщения WM DESTROY //////////////////////////7/////////////////// #pragma argsused void SimpFont_OnDestroy (HWND hwnd) if (TheFont != 0) DeleteObject(TheFont); PostQuitMessage(0); ) ///////////////////////////////////////////// // Обработчик сообщения WM CREATE //////////////////////////7////////////////// ftpragma argsused BOOL SimpFont OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) ( GetFont(0, "New Times Roman"); return TRUE ; ) ////////////////////////////////////////////// // Обработчик сообщения WM COMMAND //////////////////////////7/////////////////// #pragma argsused void SimpFont OnCommand(HWND hwnd, int id, HWND hwndctl, UINT codeNotify) ( char S[500J; switch (id) ( case CM_INFO: GetFontString(S, TextMets, aFaceName); MessageBox (hwnd, S, "Font Info" , MB_OK) ; break; case CM ROMAN:
187: Choice = Roman; 188: InvalidateRect(hwnd, NULL, TRUE); 189: break; 190: 191: case CMSWISS: 192: Choice = Swiss; 193: InvalidateRect(hwnd, NULL, TRUE); 194: break; 195: 196: case CM_SYMBOL: 197: Choice = Symbol; 198: InvalidateRect(hwnd, NULL, TRUE); 199: break; 200: 201: case CM_ANSI_FIXED_FONT: 202: if (TheFont != 0) DeleteObject(TheFont); 203: TheFont = GetStockFont (ANSI_FIXED_FONT) ; 204: Choice = StockFont; 205: InvalidateRect(hwnd, NULL, TRUE); 206: break; 207: 208: case CM_ANSI_VAR_FONT: 209: if (TheFont != 0) DeleteObject(TheFont); 210: TheFont = GetStockFont(ANSI_VAR_FONT); 211: Choice = StockFont; 212: InvalidateRect(hwnd, NULL, TRUE); 213: break; 214: 215: case CM_DEVICE_DEFAULT_FONT: 216: if (TheFont != 0) DeleteObject(TheFont); 217: TheFont = GetStockFont(DEVICE_DEFAULT_FONT); 218: Choice = StockFont; 219: InvalidateRect(hwnd, NULL, TRUE); 220: break; 221: 222: case CM_OEM_FIXED_FONT: 223: if (TheFont != 0) DeleteObject(TheFont); 224: TheFont = GetStockFont(OEM_FIXED_FONT); 225: Choice = StockFont; 226: InvalidateRect(hwnd, NULL, TRUE); 227: break; 228: 229: case CM_SYSTEM_FONT: 230: if (TheFont != 0) DeleteObject(TheFont); 231: TheFont = GetStockFont(SYSTEM_FONT); 232: Choice = StockFont; 233: InvalidateRect(hwnd, NULL, TRUE); 234: break; 235: 236: case CM_SYSTEM_FIXED_FONT: 237: if (TheFont != 0) DeleteObject(TheFont); 238: TheFont = GetStockFont(SYSTEM_FIXED_FONT); 239: Choice = StockFont; 240: InvalidateRect(hwnd, NULL, TRUE); 241: break; 242: ) 243: ) 244: 245: /////////////////////////////////////////////////////////////////// 246: // Обработчик сообщения ИМ PAINT. Изменение цвета и вращение шрифта 247: /////////////////////////////////////////////////////////////////// 248: void SimpFont OnPaint(HWND hwnd) 249: ( 250: PAINTSTRUCT PaintStruct; 251: HFONT OldFont; 252: 253: HDC PaintDC = BeginPaint(hwnd, SPaintStruct); 254: 255: if (Choice == StockFont) 256: 257: OldFont = SelectFont(PaintDC, TheFont); 258: GetTextFace(PaintDC, sizeof(aFaceName), 259: (LPSTR) aFaceName); 260: GetTextMetrics(PaintDC, STextMets); 261: SetTextColor(PaintDC, RGB(rand() % 255,
262: rand() % 255, rand() « 255)); 263: 264: 265: 266: 267: 268: 269: 270: 271: 272: 273: 274: 275: 276: 277: 278: 279: 280: 281: 282: 283: 284: 285: TextOut(PaintDC, 10, 10, aFaceName, strlen(aFaceName)); TextOut(PaintDC, 10, 30, "StockFonts", 11); TextOut(PaintDC, 10, 50, "Ten Letters", 11); SelectFont(PaintDC, OldFont); ) else ( for (int i = 0; i <= 3; i++) ( TheFont = GetFont(900 * i. Fontchoice[Choice]); OldFont = SelectFont(PaintDC, TheFont); SetTextColor(PaintDC, RGB(rand() % 255, rand() % 255, rand() % 255)); TextOut(PaintDC, 200, 200, "Ahoy!" , 5); GetTextFace(PaintDC, sizeof(aFaceName), (LPSTR) aFaceName); GetTextMetrics(PaintDC, STextMets); SelectFont(PaintDC, OldFont); ) TextOut(PaintDC, 10, 10, aFaceName, strlen(aFaceName)); ) EndPaint(hwnd, sPaintStruct); 286: ) Листинг 9.2. SIMPFONT.H 1: 2: 3: 4: 5: 6: 7; 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: //////////////////////////////////////////// // Программа: SIMPFONT.H // Автор: Чарли Калверт // Описание: Заголовочный файл Для SimpFont // Дата: 6/12/93 //////////////////////////////////////////// «define CM_INFO 100 «define CM_ROMAN 101 «define CM SWISS 102 «define CM_SYMBOL 103 «define CM_ANSI_FIXED_FONT 201 «define CM ANSI_VAR_FONT 202 «define CM_DEVICE_DEFAULT_FONT 203 «define CM OEM_FIXED_FONT 204 «define CM_SYSTEM_FONT 205 «define CM_SYSTEM_FIXED_FONT 206 // Объявления для класса SimpFont «define SimpFontDefProc DefWindowProc BOOL SimpFont_OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct); void SimpFont_OnDestroy(HWND hwnd); void SimpFont—OnCommand(HWND hwnd, int id, HWND hwndctl, UINT codeNotify); 25: 26: 27: 28: 29: 30: 31: 32: 33: void SimpFont_OnPaint(HWND hwnd); // процедуры LRESULT CALLBACK export WndProc(HWND hWindow, UINT Message, WPARAM wParam, LPARAM IParam); BOOL Register(HINSTANCE hlnst); HWND Create(HINSTANCE hlnst, int nCmdShow); BOOL CALLBACK InfoDlgProc(HWND hDlg, WORD Message, WPARAM wParam, LPARAM IParam); Листинг 9.3. FONTSTR.CPP 1: 2: 3: 4: 5: 6: 7: 8: 9: //////////////////////////////////////////////// // Модуль: FONTSTR.CPP // Автор: Чарли Калверт // Описание: Анализ шрифта в программе SimpFont // Date: 6/12/93 //////////////////////////////////////////////// «define STRICT «include <windows.h>
10: #include <windowsx.h> 11: 12: 13: 14: 15: 16: 17: 18; 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64:. 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: #include <string.h> #include <stdio.h> // переменные TEXTMETRIC TextMetrics; static char TheFaceName[80]; // процедуры char * GetType(char * S); char * GetFamily(char * S); char * GetCharSet (char * S); char * GetFontString(char * S, TEXTMETRIC TextMetric, char * FaceName) ( char szType[99], szFamily[99], szCharSet[99]; TextMetrics = TextMetric; strepy(TheFaceName, FaceName); GetType(szType); GetFamily(szFamily); GetCharSet(szCharSet); sprintf(S, "Font: %s \n Height: %d \n " "Ascent: %d \n Descent: %d \n " "AveCharW: %d \n MaxCharW: %d \n " "Weight: %d \n Italic: %hd \n " "Underlined: %d \n" " %s \ n %s \ n %s ", TheFaceName, TextMetrics.tmHeight, TextMetrics.tmAscent, TextMetrics.tmDescent, TextMetrics.tmAveCharWidth, TextMetrics.tmMaxCharWidth, TextMetrics.tmWeight, TextMetrics.tmltalic, TextMetrics.tmUnderlined, szType, szFamily, szCharSet); return S; ) char * GetType(char * S) ( strcpy(S, "Font Type: "); if ((TextMetrics.tmPitchAndFamily & TMPF_FIXED_PITCH)“ 0) strcat(g, "Default <> "); if ((TextMetrics.tmPitchAndFamily & TMPF_FIXED_PITCH) == TMP F_FIXED_PI TCH) strcat(S, "Fixed <> "); if ((TextMetrics.tmPitchAndFamily & TMP_VECTOR) == TMPF_VECTOR) strcat (S, "Vector <> "); if ((TextMetrics.tmPitchAndFamily & TMPF_TRUETYPE) = TMPF_TRUETYPE) strcat (S, "TrueType <> "); if ((TextMetrics.tmPitchAndFamily & TMPF_DEVICE) “ TMPF_DEVICE) strcat (S, "Device <> "); if (strlen(S) > 11) S[strlen(S) - 3] • ' \0’; return S; ) char * GetFamily(char * S) ( int R “ TextMetrics.tmPitchAndFamily & OxFO; strepy (S, "Family : "); if (R == FF_DONTCARE) strcat(S, "Don't Care or don't know"); if (R “ FF_ROMAN) strcat(S, "Roman"); if (R “ FF_SWISS) strcat(S, "Swiss");
85: if (R == FF_MODERN) strcat(S, "Modern"); 86: if (R — FFSCRIPT) strcat(S, "Script"); 87: if (R == FF_DECORATIVE) strcat(S, "Decorative"); 88: 89: return S; 90: ) 91: 92: char * GetCharSet(char * S) 93: { 94: strcpy(S, "CharSet: "); 95: 96: if (TextMetrics.tmCharSet == ANSI_CHARSET) 97: strcat(S, "Ansi"); 98: 99: if (TextMetrics.tmCharSet == DEFAULT_CHARSET) 100: strcat(S, "Default"); 101: 102: if (TextMetrics.tmCharSet == SYMBOLCHARSET) 103: strcat(S, "Symbol"); 104: 105: if (TextMetrics.tmCharSet == OEM_CHARSET) 106: strcat(S, "OEM"); 107: 108: return S; 109: ) Листинг 9.4. FONTSTR.H 1: ///////////////////////////////////////////// 2: 11 Модуль: FONTSTR.H 3; // Автор: Чарли Калверт 4: // Описание: 5: // Дата: 6/12/93 6: ///////////////////////////////////////////// 7: 8: char * Get Font String(char * S, TEXTMETRIC TextMetric, char * FaceName); Листинг 9.5. SIMPFONT.DEF 1: ; SIMPFONT.DEF 2: 3: NAME SimpFont 4: DESCRIPTION ' SimpFont Window' 5: EXETYPE WINDOWS 6: STUB 'WINSTUB.EXE' 7: HEAPSIZE 4096 8: STACKSIZE 5120 9: CODE PRELOAD MOVEABLE DISCARDABLE 10: DATA PRELOAD MOVEABLE MULTIPLE Листинг 9.6. SIMPFONT.MAK (Borland) 1: #===========--=========== 2: # SIMPFONT.MAK 3: #==============--======== 4: 5: * макросы 6: APPNAME = SimpFont 7: INCPATH = C:\BC\INCLVDE 8: LIBPATH = C:\BC\LIB 9: FLAGS = -H -ml -W -v -w4 -IS (INCPATH) -L$ (LIBPATH) 10: 11: # компоновка 12: S(APPNAME)-exe: S(APPNAME).obj $(APPNAME).def S(APPNAME).res FONTSTR.OBJ 13: bcc S(FLAGS) $(APPNAME).obj FONTSTR.OBJ 14: brc $(APPNAME).res 15: 16: # компиляция 17: S (APPNAME) . ob j : S (APPNAME) . cpp 18: bcc —c S(FLAGS) $(APPNAME).cpp 19: 20: # компиляция 21: FONTSTR.OBJ: FONTSTR.CPP
22: bcc -с $ (FLAGS) FONTSTR.CPP 23: 24: # компиляция ресурсов 25: $(APPNAME).re s: $ (APPNAME).rc 26: brc -r -1$ (INCPATH) $ (APPNAME) . rc Листинг 9.7. SIMPFONT.MAK (Microsoft) 1: #==============™==-==™======™=.====-== •> 2: # SIMPFONT.MAK makefile, 3: # Microsoft version 4: #=====•======-===•=======-================== 5: 6: APPNAME - SimpFont 7: 8: $ (APPNAME) .exe : $ (APPNAME).obj $ (APPNAME) .def fontstr.obj $ (APPNAME) .res 9: link $(APPNAME) fontstr, /align:16, NUL, /nod llibcew libw, $(APPNAME) 10: rc $(APPNAME).res 11: 12: $(APPNAME).obj : $(APPNAME).cpp 13: cl -c -AL -GA -Ow -W2 -Zp $ (APPNAME) . cpp 14: 15: FONTSTR.OBJ : FONTSTR.CPP 16: cl —c -AL -GA -Ow -W2 -Zp FONTSTR.CPP 17: 18: $(APPNAME).res : $(APPNAME).rc 19: rc -r $(APPNAME)-rc Вначале эта программа печатает одно слово четыре раза четырьмя случайно выбран- ными цветами. Каждое новое слово разворачивается относительно другого на 90 граду- сов, как показано на рис. 9.1. Меню в верхней части окна программы позволяет выбирать различные шрифты, включая три шрифта TrueType и все встроенные, т.е. заранее определенные, (stock) шрифты, имеющиеся в системе. Показ встроенных шрифтов не так интересен, поскольку их нельзя вращать. Рис. 9.1. SIMPFONT поворачивает текст на 360градусов Важность программы SimpFont в том, что она показывает, как создавать встроенные шрифты, нормальные шрифты и шрифты TrueType. Это знание, без которого не обойтись ни одному программисту. Замечание, шрифты TrueType впервые появились в Windows 3.1. Они позволяют пользователю выводить высококачественные буквы как на экран, так и на принтер. Вдобавок их можно перенаправлять из одного места в другое, например, с экрана на принтер с минимальной потерей качества. Кроме того, их можно переносить вместе с документом из одной системы в другую с помощью технологии встраивания, которая не обсуждается в этой книге.
Начинаем заниматься шрифтами Жизнь шрифтов довольно сложна и обычно проходит шесть фаз. 1. Проектирование посредством заполнения большой структуры, называемой LOG- FONT. 2. Создание посредством вызова CreateFontlndirect. 3. Копирование в контекст устройства с помощью SelectFont или SelectObject. 4. Отображение на экране с помощью TextOut или DrawText. 5. Удаление из контекста устройства. 6. Удаление из системы с помощью DeleteObject. Ясно, что это довольно сложный процесс. Моя цель — сделать его понятным, объяснив простыми словами. Кроме того, я постараюсь все проиллюстрировать с помощью программы SimpFont надостаточно глубоком уровне. К концу этой главы весь предмет будет так же хорошо знаком вам, как старая шляпа. Вы узнаете, что представляют собой шрифты Windows, и как их создавать. Так что поехали! Ключевой функцией в программе SimpFont является GetFont. Это то место, где создаются шрифты TrueType: 130: HFONT GetFont(int Escapement, char * Name) 131: ( 132: memset(&LogFont, 0, sizeof(LOGFONT)); 133: 134: LogFont.iHeight = 37; 135: LogFont.IWeight = 400; 136: LogFont.IfEscapement = Escapement; 137: LogFont.Ifltalic = 1; 138: LogFont.IfUnderline = 1; 139: LogFont.IfOutPrecision = OUT_STROKE PRECIS; 140: LogFont.IfClipPrecision = CLIP_STROKE_PRECIS; 141: LogFont.IfQuality = DEFAULT QUALITY; 142: strcpy (LogFont.IfFaceName, Name); 143: 144: if (TheFont != 0) DeleteObject(TheFont); 145: 146: TheFont = CreateFontlndirect(sLogFont); 147: 148: return TheFont; 149: } Процедура GetFont состоит из 4 частей: 1. Во-первых процедура обнуляет структуру LogFont с помощью функции memset. 2. Затем она заполняет различные поля структуры LogFont. 3. Далее она проверяет, не содержит ли переменная TheFont дескриптор какого-либо уже существующего шрифта. Если да, то этот шрифт удаляется. 4. Наконец, GetFont создает сам шрифт, вызывая CreateFontlndirect. Нечто подобное этому вам придется делать всякий раз, когда вы захотите создать шрифт. Исключением из правила являются встроенные шрифты. Их легко получить, как вы увидите чуть позже. Теперь я хотел бы сконцентрироваться на функции GetFont. Важнейшим ее местом является структура LogFont, в которой так много полей, что на них могла бы разместиться целая футбольная лига. Во всяком случае она достаточно сложна для того, чтобы отвести ей отдельный раздел. Раздел логических шрифтов Обычно при написании текста на экране Windows вы пользуетесь системным шриф- том. Это прекрасный и надежный инструмент, удовлетворяющий большую часть повсе- дневных нужд. Однако порой хочется украсить программу шрифтами, способными сделать ее более симпатичной и привлекательной. Такую возможность предоставляет следующая грозная на вид структура логического шрифта, или LogFont (как она называется в WINDOWS.H):
typedef struct tagLOGFONT { int IfHeight; int IfWidth; int ifEscapement; int IfOrientation; int IfWeight; BYTE Ifltalic; BYTE IfUnderline; BYTE IfStrikeOut BYTE IfCharSet; BYTE IfOutPrecision; BYTE IfClipPrecision; BYTE IfQuality; BYTE IfPitchAndFamily; BYTE IfFaceName[LF_FACESIZE] ; ) LOGFONT; Если вы хотите создать в Windows новый шрифт, то должны заполнить некоторые из перечисленных полей и передать всю запись в функцию CreateFontlndirect. Замечание.Те же самые поля вы можете передать в функцию CreateFont. Она имеет 14 параметров с такими же именами и значениями, как и поля структуры LogFont. Поскольку каждая из этих функций имеет свои преимущества, то довольно трудно решить, какой же из них отдать предпочтение. В принципе, существование функций CreateFont и CreateFontlndirect делает создание шрифтов очень легким. Нужно только знать, как заполнять поля структуры LogFont. Отрадным моментом является то, что при желании вы можете просто обнулить все поля, кроме первого и последнего, и тем самым предоставить Windows выбрать значения для всех остальных полей по умолчанию. Следующее обращение к CreateFont показывает, как это делается. hfont “ CreateFont(25, О, О, О, О, О, О, О, О, О, О, О, О, "Arial"); При использовании CreateFontlndirect вы можете обнулить все поля с помощью memset, как показано в процедуре GetFont. Однако проблема заключается в том, что иногда Windows заполняет недостающие поля теми значениями, которые вы вряд ли сочли бы подходящими. В результате можно обнаружить шрифт Arial там, где нужен был бы шрифт Script, и наоборот. Поэтому при создании конкретного шрифта лучше всего заполнить, по меньшей мере, 4 или 5 полей структуры LogFont определенными значениями. Чтобы помочь вам сориентироваться, я привел следующий перечень, который должен дать хотя бы мини- мальное представление о полях LogFont. Сейчас просто бегло просмотрите его. Более детально вы сможете изучить этот предмет, запустив первый пример. Отмечу еще раз, что я Привожу этот список не для заучивания наизусть, а для того чтобы вы знали о существовании и назначении этих полей. IfHight Высота шрифта. Если это число отрицательно, внутренние начальные данные игнорируются. IfWidth Ширина шрифта. Если вы хотите, чтобы Windows вычислила подходящее значение ширины, можете обнулить этот параметр. IfEscapement Угол, под которым печатается шрифт: 0 — нормально, 900 — снизу вверх, 1800 — вверх ногами и задом наперед 2700 — сверху вниз. Шрифт TrueType может попадать в эти позиции или в промежуточные (см. рис. 9.1 и 9.2). IfOrientation Пока не реализовано. Должен определять угол поворота отдельных символов. IfWeight Вес шрифта. Может принимать значения от 0 до 900 с приращением 100. Нулевое значение позволяет Windows присвоить вес по умолчанию. Число 700 обычно соответствует жирному начертанию. Ifltalic Нуль для нормального начертания и 1 (не нулевое значение) для курсивного.
IfUnderline IfStrikeOut IfCharSet IfOutPrecision IfClipPrecision IfQuality IfPitchAndFamily IfFaceName Нуль для нормального начертания и 1 (не нулевое значение) для подчеркнутого. Нуль для нормального начертания и 1 (не нулевое значение) для перечеркнутого. Символьный набор, используемый в шрифте: ANSI_CHARSET О DEFAULT.CHARSET 1 SYMBOL_CHARSET 2 SHIFTJISCHARSET 128 OEM_CHARSET 255 Наиболее распространенным значением этого поля является нуль. Хотя DEFAULT-CHARSET выглядит вполне безопасной и понятной опцией, лучше всего избегать ее употребления. Указывает, как точно планировщик шрифтов старается удовлетворить ваш запрос. Вы можете заставить систему всегда использовать шрифт TrueType, выбрав OUT_TT_ONLY_PRECIS. Определяет точность обрезки шрифта, уходящего за границу окна или частично скрытого другим окном. Обычно хорошо работает CLIPSTROKEPRECIS. Определяет точность соответствия требуемого шрифта по высоте, ширине, начертанию и т.д. Выбор DEFAULT_QUALITY заставляет Windows точно удовлетворять ваш запрос. Выбор PROOF QUALITY предоставляет Windows полную свободу для эстетических поисков. DRAFT QUALITY находится где-то между этими двумя. Определяет характеристики близкого к запрошенному шрифту, если последний недоступен. Например, если вы хотите использовать New Times Roman, а этот шрифт отсутствует в вашей системе, то выбор FF ROMAN поможет Windows подобрать подходящую замену. При необходимости вы можете объединять посредством логического ИЛИ значение семейства шрифтов с одной из следующих констант: VARIABLE-PITCH, DEFAULT PITCH или FIXED_PITCH. Имя шрифта, который вы желаете использовать. Как видите, люди, которые собирали Windows, отнеслись к шрифтам достаточно серьезно. Типографский набор — дело, освященное временем и традициями, и в наше время это искусство переходит с печатной страницы на экран компьютера. Поэкспериментируйте с некоторыми из значений, использующимися в структуре LogFont функции GetFont. Например, если вы увеличите значение поля IfWeight, то получите более жирное начертание. Увеличение значения поля IfHight сделает шрифт больше. Обнуление поля Italic превращает курсивное начертание в нормальное. Не тратьте время на поиск способов создания всех шрифтов, доступных в вашей системе. В следующих двух главах я покажу вам, как можно легко сгенерировать целый ряд шрифтов. После того как у вас появится средство автоматического создания шрифтов, вы сможете использовать отладчик или приведенную мною программу, для того чтобы определять, какие значения присваивает Windows полям конкретной структуры LogFont. Затем вы сможете скопировать эти значения в свою собственную программу и снабдить ее всеми нужными шрифтами. Вращение шрифта В программе SimpFont я заполнил поля LogFont простыми значениями, выбрав самые ходовые из них для высоты и ширины, а также включил курсив и подчеркивание, присвоив им ненулевые значения. Поле, представляющее особый интерес для программы SimpFont, называется IfEs- capement. Как уже упоминалось, это поле определяет угол, под которым текст появляется на экране. Например, значение 0 выводит текст в стандартном виде, в то время как 900, 1800 и 2700 соответствуют последовательному повороту текст на 90 градусов против часовой стрелки, как показано на рис. 9.2.
Рис. 9.2. Эта версия программы SIMPFONT иллюстрирует влияние поля IfEscapement на ориентацию текста Кстати, фирма Microsoft просто превзошла себя, найдя такое таинственное имя для этого поля. Храповик (escapement) — это часть механического устройства, например, часов или пишущей машинки. Храповик позволяет шестерне или зубчатой рейке продвигаться на шаг вперед за один раз при наличии соответствующего приказа. На рис. 9.3 показаны 9 положений “храпового колеса”. Рис. 9.3. Девятишаговый храповик Создание шрифта После того как поля структуры LogFont заполнены, вы почти готовы вызвать CreateFontlndirect. Однако прежде чем сделать этот вызов, убедитесь, не следует ли удалить старый шрифт: If (TheFont != О) DeleteObject(TheFont);
Замечяяие. Невозможно преувеличить важность вызова функции DeleteObject. Очень важно случайно не оставить в памяти такой ресурс, как шрифт или растровое изображение! Это медленно, но верно исчерпает системные ресурсы и неизбежно “подвесит” Windows! В конце концов почти любой просвещенный программист сможет начать создавать шрифты, растровые изображения и другие ресурсы. Трудность заключается в том, чтобы не забывать убирать за собой! В действительности очень сложно убедиться в том, что все системные ресурсы удалены к моменту завершения протраммы. Помните, если у вас есть SDK, то вы сможете обнаружить такие места с помощью отладочной версии Windows. Если у вас есть необходимый инструмент, то ради всего святого запустите отладочное ядро. Это великое средство обучения. В свое время я покажу, что обработчик сообщения WMJDESTROY удаляет шрифт прежде, чем закроется программа: DeleteObject (TheFont); Что бы вы ни делали, не забывайте удалить за собой ресурсы! Может быть, я начинаю напоминать заезженную пластинку, но это действительно важно. Нет, очень важно! После всего того, что было сказано о функции CreateFontlndirect, сам по себе ее вызов выглядит несколько прозаически: TheFont = CreateFontlndirect(sLogFont); Вот и все. Вы просто передаете один параметр и на выходе получаете шрифт. Так что создавать шрифты легко, не правда ли? На самом деле это не совсем так. В следующих двух главах я покажу, как сделать этот процесс более легким или, по крайней мере, более управляемым. Встроенные шрифты Теперь, когда вы знаете, как делать шрифты с помощью CreateFont и CreateFontln- direct, я немного задержусь, чтобы показать способ их создания посредством вызова функции GetStockObject или ее макроса GetStockFont из файла WINDOWSX: 201: case CM ANSI_FIXED_FONT: 202: if (TKeFont !“ 0) DeleteObject(TheFont); 203: TheFont “ GetStockFont(ANSI_FIXED_FONT); 204: Choice “ StockFont; 205: InvalidateRect(hwnd, NULL, TRUE); 206: break; 207: Этот код представляет собой цитату из функции SimpFont_OnConunand. Она вызы- вается, когда пользователь выбирает пункт меню, желая увидеть ANSI_FIXED_FONT. Как видите, SimpFont сначала проверяет, не адресует ли переменная TheFont уже существующий шрифт. Если да, то этот шрифт удаляется. Следующий шаг — вызов GetStockFont. Чтобы получить встроенный шрифт, передайте одну из двух констант ANSI_FIXED_FONT или OEM_FIXED_FONT, определенных в WINDOWS.H. В про- грамме SimpFont используются все доступные встроенные шрифты. Фактически одна из ее целей — дать возможность полюбоваться встроенными шрифтами вашей системы. Получив дескриптор встроенного шрифта, SimpFont присваивает глобальной пере- менной Choice значение StockFont. Как показано в следующей главе, функция SimpFont_OnPaint проверяет это значение, чтобы понять, какую информацию следует выводить на экран. Последний шаг — вызов функции InvalidateRect, которая просит Windows послать сообщение WM_PAINT в основное окно. Как видите, создавать шрифты очень просто. Настолько просто, что они представ- ляются программистам немного таинственными. Порой даже кажется, что встроенные шрифты взялись неизвестно откуда, словно по волшебству. Но, конечно, это не так. Встроенные шрифты представляют собой заранее определенные ресурсы, которые становятся вашими просто по запросу. Иначе говоря, вы можете создать такие же самые шрифты, обратившись к CreateFontlndirect и соответствующим образом заполнив струк-
туру LogFont. Основное достоинство встроенных шрифтов состоит в том, что их легко получить, поскольку структура LogFont уже заполнена за вас. Недостатком же является то, что вы не можете сильно повлиять на то, что выдает система. Замечание. Работая с программой SimpFont, обратите внимание, что каждый встроенный шрифт имеет конкретное имя гарнитуры, которая показывает, id какого материала Windows создает этот шрифт. Например, ANSJ I JXED FONT — это просто особая версия стандартного “курьера” (см. рис. 9 4). Если этот шрифт не вполне удовлетворяет вашим целям, используйте программу SimpFont. чтобы заполнить LogFont подходящими значениями. Затем создайте шрифт и поэкспериментируйте с Н1гм Изменяйте поля структуры LogFont до тех пор, пока не получите в точности то, что вам нужно. Рис, 9.4. Программа SIMPFONT может показать вам характеристики встроенного шрифта Сообщения WM_PAINT “заказывают музыку” Когда пользователь выбирает новый встроенный или нормальный шрифт из меню SimpFont, программа вызывает InvalidateRect, чтобы вынудить Windows послать сообще- ние WM PAINT. Ответ на это сообщение составляет существенную часть логики программы. Остановитесь на секунду и подумайте, что произошло. В предыдущем разделе вы узнали, как создавать шрифт, а в этом увидите, как отображать шрифт на экране, последовательно выполняя следующие действия. 1. Выбрать шрифт в контекст устройства и сохранить копию старого шрифта. 2. Вызвать процедуру (например, TextOut или DrawText), которая выводит шрифт на экран. 3. Предохранить системные ресурсы от истощения, скопировав старый шрифт обратно в контекст устройства. Теперь рассмотрим конкретный пример из программы SimpFont. SimpFont_OnPaint производит обычные вызовы BeginPaint и EndPaint Между ними располагается код, отображающий на экране шрифты TrueType и встроенные шрифты. Я рассматриваю их по отдельности, как если бы каждый из них содержался в собственном обработчике сообщения WM_PAINT. На самом деле программа SimpFont объединяет оба эти кода в одну функцию и проверяет переменную Choice, чтобы решить, какую из частей вызвать. Ниже приведены фрагменты программы, показывающие, как SimpFont отображает на экране шрифты TrueType:
void SimpFont_OnPaint(HWND hwnd) ( PAINTSTRUCT PaintStruct HFONT OldFont; HDC PaintDC = BeginPaint(hwnd, (.PaintStruct); for (int i = 0; i <= 3; i++) ( TheFont = GetFont(900 * i, Fontchoice[Choice]); OldFont = SelectFont(PaintDC, TheFont); SetTextColor(PaintDC, RGB(rand() % 255, rand() % 255, rand() % 255)); TextOut(PaintDC, 200, 200, "Ahoy!", 5); SelectFont)PaintDC, OldFont); ) TextOut(PaintDC, 10, 10, aFaceName, strlen(aFaceName)); EndPaint(hwnd, SPaintStruct); ) SimpFont OnPaint начинает создание шрифта с помощью вызова GetFont. При этом следует передать лишь имя шрифта и значение поля IfEscapement. Последний аргумент гарантирует, что шрифт будет печататься в нужном направлении. Обратите внимание на жизненно важные вызовы SelectFont — макроса из WIN- DOWSX, обращающегося к функции SelectObject. В начале приведенного фрагмента SelectFont копирует шрифт в контекст устройства. В конце содержимое контекста устройства восстанавливается. В данном случае контекст устройства представляет собой экран, но все сказанное касается и принтера. Чаще всего вызов SetTextColor достаточно прост. Здесь я усложнил его, ввернув функцию Rand, генерирующую случайные числа. Впрочем, если это опустить, вызов сводится к чему-то вроде следующего компактного предложения: SetTextColor(PaintDC, RGB(0, 0, 255)); Разница между этими вызовами состоит в том, что в версии из SimpFont каждое из полей макроса RGB содержит случайно сгенерированные посредством функции Rand числа, определяющие цвет шрифта. Замечание. В качестве эксперимента попробуйте несколько раз последовательно закрыть и открыть окно. Это приводит к ряду вызовов обработчика сообщения WMPAINT. Каждый вызов генерирует новый набор случайных значений, передающихся в процедуру интерфейса приклад- ного программирования SetTextColor. Если вы закроете не все окно целиком, то увидите, как функции BeginPaint и EndPaint объединяются для совместного обновления только что скрытой части экрана. Наверное, было бы нежелательно, чтобы такой эффект присутствовал в готовом программном продукте, но это идеальное средство для обучения. Если захотите исключить его, просто удалите вызовы Rand. Обращение к TextOut остается неизменным во всех четырех итерациях цикла SimpFont_OnPaint. TextOut(PaintDC, 200, 200, "Ahoy!", 5); Вращение шрифта и изменения оттенков обеспечиваются переменными, передавае- мыми CreateFontlndirect и SetTextColor. Используйте CreateFontlndirect и SetTextColor для изменения качества шрифта. Не волнуйтесь о том, как Windows на самом деле рисует шрифт. Не пытайтесь оптимизировать код, обращаясь непосредственно к видеопамяти или трогая алгоритм, использующийся д ля рисования форм на экране. Подобные приемы принад лежат миру DOS. Используйте технологию, принятую в Windows. Программисты Windows не связываются с аппаратной частью. Они имеют дело с абстрактными понятиями вроде шрифтов или контекстов устройств. Чтобы изменить внешний вид шрифта, измените ассоциированные с ним объекты. После того как вы спроектируете шрифт, он будет появляться на экране сам собой, без вашей помощи и участия. Функция SimpFont_OnPaint также управляет отображением встроенных шрифтов на экране. Вот сокращенная версия исходного кода:
OldFont = SelectFont(PaintDC, TheFont); GetTextFace(PaintDC, sizeof(aFaceName), (LPSTR) aFaceName); GetTextMetrics(PaintDC, sTextMets); TextOut(PaintDC, 10, 10, aFaceName, strlen(aFaceName)); SelectFont(PaintDC, OldFont); Как видите, встроенные шрифты изображаются на экране таким же способом, как и все остальные. Ведь на самом деле это нормальные шрифты со своей структурой LogFont, предусмотренной Windows! Кроме обращений к TextOut и стандартного двухшагового танца SelectFont, в предыдущей программе также ясно видны обращения к GetTextMetrics и GetTextFace. GetTextFace цепляет имя текущего шрифта, установленного в контексте устройства. Программа SimpFont отображает имя этого шрифта на экране, так что можете посмотреть сами, способна ли на самом деле ваша система произвести требуемый шрифт. Обращение к GetTextMetrics нельзя объяснить столь же легко, поэтому я разбираю этот вызов в отдельном разделе. GetTextMetrics и модуль FontStr Создавая шрифт, вы обычно заполняете структуру LOGFONT (или эквивалентную ей) и вызываете CreateFont. Чтобы получить эту информацию из системы, требуется выполнить обратную операцию. Подробную информацию о текущем шрифте можно получить от Windows с помощью GetTextMetrics и структуры TEXTMETRIC. Структура TEXTMETRIC говорит вам, насколько велик шрифт, является ли он подчеркнутым или курсивным, каков его горизонтальный шаг, к какому семейству он принадлежит и т.д. Не уступая структуре LOGFONT, структура TEXTMETRIC содержит ни больше ни меньше чем 20 полей! Такое изобилие мелких подробностей позволяет узнать о текущем шрифте даже больше, чем хотелось бы: typedef struct tagTEXTMETRIC ( /* tm */ int tmHeight; int tmAscent; int tmDescent; int tmlnternalLeading; int tmExternalbeading; int tmAveCharWidth; int tmMaxCharWidth; int tmWeight; BYTE tmltalic; BYTE tmUnderlined; BYTE tmStrucOut; BYTE tmFirstChar; BYTE tmLastChar; BYTE tmDefaultChar; BYTE tmBreakChar; BYTE tmPitchAndFamily; BYTE tmCharSet; ‘ int tmOverhang; int tmDigitizedAspectX; int tmDigiti zedAspectY; ) TEXTMETRIC; SimpFont разбирается co структурой TEXTMETRIC в отдельном модуле с именем FontStr. FontStr возвращает большинство полей TEXTMETRIC в единой символьной строке. Как вы увидите в следующей главе, этот модуль разработан таким образом, чтобы его можно было легко подсоединить к другой программе. Ядром FontStr является функция GetFontString. Она содержит следующие неслож- ные, но весьма длинные вызовы sprintf: sprintf(S, "Font: *s \n Height: %d \n " "Ascent: *d \n Descent: %d \n " "AveCharW: %d \n MaxCharW: %d \n " "Weight: %d \n Italic: %hd \n " "Underlined: %d \n " '4s \n «s \n $s ",
TheFaceName, TextMetrics.tmHeight, TextMetrics.tmAscent, TextMetrics.tmDescent, TextMetrics.tmAveCharWidth, TextMetrics.tmMaxCharWidth, TextMetrics.tmWeight, TextMetrics.tmltalic, TextMetrics.tmUnderlined, szType, szFamily, szCharSet); Как видно из рис. 9.5, большая часть информации структуры TEXTMETRIC преоб- разуется в одну символьную строку. Эта строка возвращается обработчику сообщений WM_COMMAND в главном модуле приложения и выводится с помощью функции MessageBox: // пользователь выбрал в меню Пункт Fontinfo, case CM_INFO: GetFontString(S, TextMets, aFaceName); MessageBox(hwnd, S, "Font Info", MB_OK); break; Font Symbol Height 56 Ascent 46 Descent 10 AveChaiW: 27 MaxChaiW 51 Weight 400 Halle: 255 Underlined: 255 Font Type: Default <> Vector <> TrueType Family: Romon CharSet Symbol Рис. 9.5. Программа SIMPFONT отображает окно сообщения с важной информацией о текущем шрифте Описанные части модуля FontStr достаточно ясны. Трудности заключаются в рас- шифровке содержимого полей tmPitchAndFamily и tmCharSet: В Четыре младших бита tmPitchAndFamily описывают тип шрифта, который может принимать следующие значения: TMPF_FIXED_PITCH МОНОШИРИННЫЙ Шрифт tmpf vecTOR Векторный или TrueType шрифт tmpf_truetype Шрифт TrueType tmpf_device Шрифт устройства Зачастую шрифты могут принимать комбинированные значения. Четыре старших бита могут быть выделены с помощью AND-маски OxFO, а затем использованы для определения текущего семейства шрифта. Общеупотребимы сле- дующие семейства: Roman, Swiss, Script и Modem. В Поле tmCharSet устанавливается равным одной из следующих переменных: ANSI_CHARSET 0 DEFAULT_CHARSET 1 SYMBOL_CHARSET 2 SHIFTJIS_CHARSET 128 OEM CHARSET 255
Выбор этой информации из структуры TEXTMETRIC производится с помощью следующих функций из модуля FontStr: char * GetTypefchar * S); char * GetFamily(char * S); char * GetCharSet(char * S); Функция GetType использует для определения типа текущего шрифта битовые операции. Функция GetFamily определяет с помощью шестнадцатеричной маски F0 семейство шрифта, а функции GetCharSet находит текущий символьный набор. Если вы хотите понять эти функции глубже, вам следует раскрутить отладчик и пройти их построчно. Замечание. Следует, вероятно, упомянуть также функцию GetDcviceCaps, которая не использу- ется в SimpFont. Она позволяет вам спросить у Windows, какие возможности имеет конкретное устройство, такое, например, как видеоэкран или принтер. С помощью этой функции можно выяснить, способно ли устройство, например, напечатать очень большой шрифт. Следует обратить внимание на функции GetDcviceCaps и GetTextMetrics, поскольку без них невозможно провести ни одной серьезной работы, связанной со шрифтами. Резюме День 9 был посвящен обсуждению шрифтов. Это весьма обширная тема, поэтому я не пытался дать исчерпывающую информацию, а постарался представить основные идеи в относительно простой и доступной манере. В частности, вы видели, что жизнь типичного шрифта делится на шесть этапов: Проектирование шрифта посредством заполнения структуры LogFont. И Создание шрифта с помощью CreateFontlndirect. Копирование в контекст устройства функцией SelectFont или SelectObject. Вывод шрифта на экран с помощью TextOut или DrawText. Восстановление старого шрифта в контексте устройства с помощью SelectFont или SelectObject. Уничтожение шрифта вызовом DeleteObject. Если когда-либо вы захотите получить информацию о текущем шрифте, то сможете сделать это с помощью вызова GetTextMetrics и последующей проверки структуры TEXTMETRIC. Хотя ни одна из следующих двух глав не посвящена исключительно шрифтам, обе они содержат полезную информацию на эту тему. Например, в следующей главе рассматривается выборка всех шрифтов системы, доступных с помощью пользователь- ской функции (callback). В главе 18 вы увидите, как использовать несложные диалоговые панели для просмотра и выборки любых шрифтов, доступных в системе. Вопросы и ответы Что такое семейство шрифтов? Windows обычно работает с одним из пяти различных семейств шрифтов: Decorative, Modem, Roman, Script или Swiss. Каждое семейство имеет свои собственные характерис- тики. Например, семейство Swiss не имеет засечек. Засечки — это маленькие черточки на концах букв F, R и Т и черточки, которые вы можете видеть на концах букв S и Z. С другой стороны, у семейства Roman засечки есть. Семейство Modem характеризуется одинаковой толщиной штриха. Толщина же штриха у Swiss и Roman может варьировать- ся. Вот и все, что я могу сказать об этом предмете в данном контексте, но если вы хотите получить больше информации, существует множество книг о шрифтах, лучшие из которых могут быть вообще не связаны с компьютерами.
2. Мне все еще ие ясны шрифты типа TrueType и встроенные шрифты. Объясните, пожалуйста. Встроенный шрифт — это просто предварительно определенный шрифт. В нем нет ничего необычного, за исключением того факта, что Windows определяет его размерность заранее. С другой стороны, шрифты типа TrueType представляют собой ответ фирмы Microsoft на шрифты PostScipt. Как правило, они лучшего качества и обладают большей степенью гибкости, чем какие-либо другие шрифты, имеющиеся в Windows. Вопросы для самопроверки 1. Какими функциями могут создаваться шрифты TrueType? 2. Какими функциями могут создаваться встроенные шрифты? 3. Что такое шрифт TrueType? 4. Что такое встроенный шрифт? 5. Как можно установить имя текущего шрифта? 6. Как можно установить размер текущего шрифта? 7. Что обозначает имя DEVICE_DEFAULT_FONT в вашей системе? 8. Что обозначает имя SYSTEM_FONT в вашей системе? 9. Как можно скопировать шрифт в контекст устройства? 10. Что содержится в четырех младших битах поля tmPitchAndFamily? Упражнения 1. Усовершенствуйте функцию GetFontString таким образом, чтобы она выдавала отчет обо всех полях структуры TEXTMETRIC. 2. Попробуйте создать шрифт Script. Подсказка: во многих системах ключ к решению этой задачи заключается в установке поля IfCharSet структуры LogFont равным OEM_CHARSET. Посмотрите, сработает ли это у вас.
День 10 ГРАФИЧЕСКИЕ ЭЛЕМЕНТЫ УПРАВЛЕНИЯ * С этой главы начинается исследование протраммы FontsExp, которая показывает на экране все шрифты, имеющиеся в системе. В FontsExp используется ряд маленьких подокон, называемых графическими элементами управления (controls). Они формируют интерфейс, позволяющий пользователю взаимодействовать с программой. Исследование FontsExp делится на два раздела. В первом разделе, составляющем эту главу, изучаются различные элементы управления, представленные в программе Font- sExp. В частности, здесь рассматриваются: Статические поля (static controls), использующиеся, как правило, для вывода текстов, которые пользователь не может редактировать. Перечни (list boxes), использующиеся для вывода списков символьных строк, которые можно прокручивать вверх и вниз. Редактируемые поля (edit controls), которые позволяют пользователю изменять их содержимое. Отмечаемые блоки (check boxes). Присутствие крестика в таком блоке означает, что он активизирован. В противном случае блок будет иметь серый или белый фон. Во втором разделе исследования приложения FontsExp, представленном в главе 11, объясняется, как взаимодействовать с графическими элементами управления и как использовать обработчик перечисляемых объектов (callback function) для выборки шриф- тов, имеющихся в системе. В частности, там рассматриваются следующие вопросы: Как использовать SendMessage и PostMessage. Как взаимодействовать с перечнями и отмечаемыми блоками. Как создавать сообщения, определяемые пользователем Как вызывать EnumFontFamilies Материал этих двух глав очень важен, поскольку графические элементы управления играют ключевую роль в операционной среде Windows. Они настолько важны в повсе- дневной практике, что я снова вернусь к ним в главах 12 и 14. Что такое графические элементы управления Графические органы управления представляют собой элементы интерфейса (или средства интерфейса), помогающие пользователю представлять информацию в ясном и легко воспринимаемом виде.
Можно провести параллель между окном (или рядом окон) и панелью управления на магнитофоне, проигрывателе или радиоприемнике. В этом случае визуальные сред- ства, такие, как кнопки или отмечаемые блоки, представляют собой аналог органов управления стереоустановкой. Подобно тому, как кнопка Включает и выключает стерео- установку, а ручка регулирует его громкость, графические органы управления руководят потоком событий внутри компьютера. Такие элементы интерфейса, как графические органы управления, оказываются очень важными, когда вы имеете дело с большими объемами информации. Например, в машине моего друга из магазина графического дизайна было очень много шрифтов. Простой перечень этих шрифтов был таким же ошеломляющим, как список полей большой структуры в Windows. Для того чтобы представить эти шрифты в доступном для понимания виде, нужен какой-нибудь визуальный интерфейс. При этом недоста- точно просто перечислить имена шрифтов. Вы должны показать своим пользователям, как эти шрифты выглядят, и дать им возможность исследовать каждый конкретный шрифт детально. Один из способов добиться этого показан в программе FontsExp. Читатели, писатели, пользователи — все мы нуждаемся в способе восприятия больших потоков информации, стремительно обрушивающихся на нас в этот суматош- ный (и чарующий) информационный век. Управляющие элементы Windows служат этой цели. Они являются одними из важнейших составляющих во всех графических интер- фейсах, подобных Windows. Демонстрация шрифтов Начнем рассматривать управляющие элементы с реального примера, показывающе- го, как ими манипулировать. На рис. 10.1 изображено окно, которое создается програм- мой FontsExp. |1Э Hnitstxp an]| Info Ряс. 10.1. Программа FontsExp позволяет просмотреть все шрифты, имеющиеся в системе Внешний интерфейс программы FontsExp слегка напоминает стандартную диалого- вую панель Fonts. (Стандартные диалоги исследуются в главе 18). Однако с точки зрения программиста, FontsExp представляет собой совершенно другой тип программы. Она вводит вас в мир шрифтов Windows, позволяя управлять степенью их детализации при просмотре. С помощью материала, представленного на следующих нескольких страницах, про- грамму FontsExp можно развить до инструмента мирового класса, который многие пользователи захотели бы иметь в своем распоряжении. Для этого, как это всегда бывает в мире программирования, есть масса возможностей. Так что, не задерживаясь более, можете перейти к изучению кода, показанного в листинге 10.1.
Листинг 10.1. FONTSEXP.CPP 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47; 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: ///////////////////////////////////////////////// // Программа: FONTSEXP.СРР // Автор: Чарли Калверт // Описание: FontsExp программа для Windows // Дата: 06/20/93 ///////////////////////////////////////////////// «define STRICT «include <windows.h> «include <windowsx.h> «pragma hdrstop «include <string.h> «include "FontsExp.h" «include "fontstr.h" «pragma warning (disable: 4068) // ----------------------------------------- // Интерфейс У У ==ти=«жша=аж==ш*:жа«===в^1=ах:хсж=:=:=£ж»:м static char szAppName[] = "FontExp"; static HWND MainWindow; static HINSTANCE hlnstance; static TEXTMETRIC TextMetrics; char aTextFace[80]; // =_=-_=-.=====.M=-====™=-=-=—m== // Инициализация // -------------------------====„_==__ /////////////////////////////////////// // Точка входа в программу /////////////////////////////////////// «pragma argsused int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInstance, LPSTR IpszCmdParam, int nCmdShow) ( MSG Msg; if (’hPrevInstance) if (!Register(hlnst)) return FALSE ; MainWindow = Create(hlnst, nCmdShow); if (MainWindow) return FALSE; while (GetMessage(SMsg, NULL, 0, 0)) ( TranslateMessage(sMsg); DispatchMessage(SMsg); ) return Msg.wParam; ) ////////////////////////////////////// // Регистрация Окна ////////////////////////////////////// BOOL Register(HINSTANCE hlnst) WNDCLASS WndClass; WndClass.style = CS_HREDRAW I CS_VREDRAW; WndClass.IpfnWndProc “ WndProc; WndClass.cbClsExtra = 0; WndClass.cbWndExtra - 0; WndClass.hlnstance “ hlnst; WndClass.hlcon - Loadicon (NULL, MISAPPLICATION) ; WndClass.hCursor - LoadCursor(NULL, IDC_ARROW); WndClass.hbrBackground - GetStockBrush(WHITE BRUSH); WndClass.IpszMenuName = "Menu"; WndClass. IpszClassName “ szAppName; return Registerclass («WndClass); }
75: 76: ///////////////////////////////////////////////////// 77: // Создание окна 78: ///////////////////////////////////////////////////// 79: HWND Create(HINSTANCE hinst, int nCmdShow) 80: ( 81: 82: hlnstance = hinst; 83: 84: HWND hwnd = CreateWindow(szAppName, szAppName, 85: WS_OVERLAPPEDWINDOW, 86: CW_USEDEFAULT, CWJUSEDEFAULT, 87: CWJUSEDEFAULT, CWJUSEDEFAULT, 88: NULL, NULL, hinst, NULL); 89: 90: if (hwnd == NULL) 91: return hwnd; 92: 93: ShowWindow(hwnd, nCmdShow); 94: UpdateWindow(hwnd); 95: 96: return hwnd; 97: ) 98: 100: // Реализация 101: // ======================================.==-==-==.==—== 102: 103: /////////////////////////////////////////////////////// 104: // Оконная процедура 105: /////////////////////////////////////////////////////// 106: LRESULT CALLBACK _export WndProc(HWND hwnd, UINT Message, 107: WPARAM wParam, LPARAM IParam) 108: ( 109: FONTENUMPROC IpfnEnumProc; 110: ENUMSTRUCT EnumStruct; 111: char S[100]; 112: 113: switch(Message) 114: ( 115: case WM_STARTFONTS: 116: ( 117: HDC DC = GetDC(hwnd); 118: IpfnEnumProc « 119: (FONTENUMPROC)MakeProcInstance((FARPROC)FontCallBack, hlnstance); 120: EnumStruct.Count = 0; 121: EnumStruct.hwindow = hFontList; 122: EnumFontFamilies(DC, NULL, IpfnEnumProc, 123: (LONG)(EnumStruct) ; 124: FreeProcInstance((FARPROC)IpfnEnumProc); 125: 126: ReleaseDC(hwnd, DC); 127: 128: wsprintf(S, "There are %d fonts available", 129: EnumStruct.Count); 130: SetWindowText(hNumFonts, S); 131: 132: SetFocus(hFontList); 133: SendMessage(hFontList, LB_SETCURSEL, 0, 0} ; 134: ShOwTheFont(hwnd); 135: return 1; 136: ) 137: 138: case WM_NEWFONT: 139: ( 140: if (TheFont != 0) 141: DeleteObject(TheFont); 142: TheLogFont = (LPLOGFONT)IParam; 143: TheFont = CreateFontlndirect(TheLogFont); 144: return 1; 145: ) 146: 147: HANDLE JMSG(hwnd, WM_COMMAND, FontsExp_OnCommand); 148: HANDLE MSG(hwnd, WM_CREATE, FontsExp_OnCreate); 149: HANDLE MSG(hwnd, WM_DESTROY, FontsExp_OnDestroy);
150: 151: 152: 153: 154: 155: 156: 157: 158: 159: 160: 161: 162: 163: 164: 165: 166: 167: 168: 169: 170: 171: 172: 173: 174: 175: 176: 177: 178: 179: 180: 181: 182: 183: 184: 185: 186: 187: 188: 189: 190: 191: 192: 193: 194: 195: 196: 197: 198: 199: 200: 201: 202: 203: 204: 205: 206: 207: 208: 209: 210: 211: 212: 213: 214: 215: 216: 217: 218: 219: 220: 221: 222: default: return FontsExp_DefProc(hwnd, Message, wParam, IParam); } } //////////////////////////////////////////////////////// // Обработчик сообщения ИМ CREATE //////////////////////////7///////////////////////////// #pragma argsused BOOL FontsExp_OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) ( static char *Titles[] = ( "True Type" , "Heavy", "Italic" }; hFontList = CreateWindow("listbox", NULL, WS_CHILD I WS VISIBLE I LBS_STANDARD 9, 30, 201, 1K0, hwnd, HMENU(ID_LISTBOX), hlnstance, NULL); hNumFonts = CreateWindow("static", NULL, WS CHILD | WSVISIBLE I WS BORDER, 10, 10, 200, 20, hwnd, HMENU(-l), hlnstance, NULL); hFontName = CreateWindow("static", NULL, WS_CHILD I WS_VISIBLE | WS_BORDER, 260, 10, 350, 70, hwnd, HMENU(-l), hlnstance, NULL); hAlphaEdit = CreateWindow("edit", NULL, WS_CHILD I WS_VISIBLE I WS_BORDER I WS_HSCROLL | ES_LEFT I ES_AUTOHSCROLL | ES_MULTILINE, 260, 90, 350, 70, hwnd, HMENU(-l), hlnstance, NULL); for (int i = 0; i < 3; i++) Button Windows [ij. = CreateWindow("button". Titles [i], WS CHILD I WS VISIBLE I BS_CHECKBOX, 260 + (i * 125), 180, 100, 35, hwnd, HMENU(-l), hlnstance, NULL); TheFont = 0; PostMessage(hwnd, WM_STARTFONTS, 0, 0} ; return TRUE; ) /////////////////////////////////////////////////////// // Обработчик сообщения WM_DESTROY /////////////////////////////////////////////////////// #pragma argsused void FontsExp_OnDestroy(HWND hwnd) ( if (TheFont != 0) DeleteObject(TheFont); PostQuitMessage(0); } //////////////////////////////////////////////////////// // Обработчик сообщения WM_COMMAND //////////////////////////////////////////////////////// #pragma argsused void FontsExp_OnCommand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify) ( char S[500] ; switch (id) ( case IDLISTBOX: if (codeNotify == LBN_SELCHANGE) ShowTheFont(hwnd); break; case CM_INFO:
223: GetFontString(S, TextMetrics, aTextFace); 224: MessageBox(hwnd, S, "Info", MB_OK); 225: break; 226: ) 227: ) 228: 229: ///////////////////////////////////////////////////////// 230: // ShowTheFont 231: ///////////////////////////////////////////////////////// 232: void ShowTheFont(HWND hwnd) 233: ( 234: FONTENUMPROC IpfnEnumProc; 235: char IpszBuffer[150]; 236: ENUMSTRUCT EnumStruct; 237: HFONT Savelt; 238: 239: char Alpha[] = ("1234567890abcdefghijklmnopqrstuvwxyz" 240: "ABCDEFGHIJKLMNOPQRSTUVWXYZ") ; 241: 242: HDC DC = GetDC(hwnd); 243: 244: int Index = SendMessage(hFontList, LB_GETCURSEL, 245: SendMessage(hFontList, LB_GETTEXT, Index, LPARAM(lpszBuffer)); 246: IpfnEnumProc = (FONTENUMPROC)MakeProcInstance( 247: (FARPROC)DescribeFontCallBack, hlnstance); 248: EnumStruct.Count = 0; 249: EnumStruct.hwindow = hwnd; 250: EnumFontFamilies(DC, IpszBuffer, IpfnEnumProc,(LONG)SEnumStruct); 251: FreeProcInstance((FARPROC)IpfnEnumProc); 252: 253: if (TheFont != 0) 254: Savelt = SelectFont(DC, TheFont); 255: GetTextMetrics(DC, STextMetrics); 256: HandleMetrics(TextMetrics); 257: GetTextFace(DC, 150, aTextFace); 258: if (TheFont != 0) 259: SelectFont(DC, Savelt); 260: 261: ReleaseDC(hwnd, DC); 262: 263: SendMessage(hFontName, WMSETTEXT, 0, LPARAM(SlpszBuffer)}; 264: SendMessage(hFontName, WM_SETFONT, WPARAM(TheFont), 0); 265: 266: SendMessage(hAlphaEdit, WM_SETTEXT, m, LPARAM(SAlpha)); 267: SendMessage (hAlphaEdit, WM_SETFONT, WPARAM(TheFont), 0); 268: ) 269: 270: ///////////////////////////////////////////////////////////// 271: // HandleMetrics 272: ///////////////////////////////////////////////////////////// 273: void HandleMetrics(TEXTMETRIC TextMetrics) 274: ( 275: 276: if ((TextMetrics.tmPitchAndFamily & TMPF_TRUETYPE) =“ TMPF_TRUETYPE) 277: SendMessage(Buttonwindows[0], BM_SETCHECK, 1, 0L); 278: else 279: SendMessage(Buttonwindows[0], BM_SETCHECK, 0, 0L); 280: 281: if ((TextMetrics.tmWeight) > 600) 282: SendMessage(Buttonwindows[1], BM_SETCHECK, 1, 0L) 283: else 284: SendMessage(Buttonwindows[1], BM_SETCHECK, 0, 0L) 285: 286: if (TextMetrics.tmltalic) 287: SendMessage(Buttonwindows[2], BM_SETCHECK, 1, 0L); 288: else 289: SendMessage(Buttonwindows[2], BM_SETCHECK, 0, 0L); 290: 291: ) 292: 293: 294: /////////////////////////////////////////////////////// 295: // FontCallBack 296: /////////////////////////////////////////////////////// 297: #pragma argsused
298: int CALLBACK FontCallBack (LPENUMLOGFONT Ipnlf, 299: LPNEWTEXTMETRIC Ipnfm, int FontType, ENUMSTRUCT FAR * IpData) 300: 301: { 302: SendMessage(lpData->hWindow, LB_ADDSTRING, 0, 303: LPARAM(lpnlf->elfLogFont.lfFaceName)) l 304: IpData->Count++ 305: return 1; 306: ) 307: 308: ////////////////////////////////////////////////////// 309: II DescribeFontCallback 310: ////////////////////////////////////////////////////// 311: «pragma argsused * 312: int CALLBACK DescribeFontCallBack (LPENUMLOGFONT Ipnlf, 313: LPNEWTEXTMETRIC Ipntm, 314: int FontType, ENUMSTRUCT FAR * IpData) 315: ( 316: SendMessage(lpData->hWindow, WM_NEWFONT, 0, LPARAM (&lpnl >elfLogFont)); 317: return 1; 318: } Листинг 10.2. FONTSEXP.H 1: llllllllllllllirillllllllllllllllllllllllllllllll 2: // Программа: FONTSEXP.H 3: // Автор: Чарли Калверт 4: // Описание: FontsExp — программа для Windows 5: // Дата: 06/20/93 6: ///////////////////////////////////////////////// 7: 8: // константы 9: «define WM_STARTFONTS (WMUSER + 0) 10: «define WM_NEWFONT (WM_USER + 1) 11: 12: «define IDLISTBOX 1 13: «define CM_INF0 101 14: 15: 16: // типы 17: typedef struct 18: 19: int Count; 20: HWND hWindow; 21: }ENUMSTRUCT; 22: 23: // объявления для класса FontsExp 24: «define FontsExp_DefProc DefWindowProc 25: BOOL FontsExp__OnCreate (HWND hwnd, CREATESTRUCT FAR* IpCreateStruct); 26: void FontsExpOnDestroy(HWND hwnd); 27: void FontsExp_OnCommand(HWND hwnd, int id, HWND hwndctl, UINT codeNotify); 28: 29: // переменные 30: HWND hFontList; 31: HWND hAlphaEdit; 32: HWND hTrueType; 33: HWND hNumFonts; 34: HWND hFontName; 35: static HFONT TheFont; 36: static LPLOGFONT TheLogFont; 37: HWND Buttonwindows[3]; 38: 39: // процедуры 40: LRESULT CALLBACK _export WndProc(HWND hwnd, UINT Message, 41: WPARAM wParam, LPARAM IParam); 42: BOOL Register(HINSTANCE hlnst); 43: HWND Create(HINSTANCE hlnst, int nCmdShow); 44: void HandleMetrics(TEXTMETRIC TextMetrics); 45: void ShowTheFont(HWND hwnd); 46: BOOL CALLBACK _export FontCallBack (LPENUMLOGFONT Ipnlf, 47: LPNEWTEXTMETRIC Ipntm,
48: 49: 50: 51: int FontType, ENUMSTRUCT FAR * IpData); int CALLBACK _export DescribeFontCallBack(LPENUMLOGFONT Ipnlf, LPNEWTEXTMETRIC Ipntm, int FontType, ENUMSTRUCT FAR * IpData); Листинг 10.3. FONTSEXP.RC. 1: ((include "fontsexp.h" 2: menu MENU 3: BEGIN 4: MENUITEM "Info", CM_INF0 5: END Листинг 10.4. FONTSEXP.DEF 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: ; FONTSEXP.DEF NAME FontsExp DESCRIPTION 'FontsExp Window' EXETYPE WINDOWS STUB ' WINSTUB. EXE ' CODE PRELOAD MOVEABLE DISCARDABLE DATA PRELOAD MOVEABLE MULTIPLE HEAPSIZE 4096 STACKSIZE 5120 Листинг 10.5. FONTSEXP.MAK (Borland) 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: IB: 19: 20: 21: 22: 23: 24: # FONTSEXP.MAK # макросы APPNAME - FontsExp INCPATH = C:\BC\INCLUDE LIBPATH = C:\BC\LIB FLAGS = -H -ml -W -V -w4 -1$ (INCPATH) -L$ (LIBPATH) * компоновка $(APPNAME).exe: $(APPNAME).obj $(APPNAME).def FONTSTR.OBJ $(APPNAME).res bcc $(FLAGS) $(APPNAME).obj FONTSTR.OBJ brc $(APPNAME).res 0 компиляция $ (APPNAME) . obj : $ (APPNAME) . cpp bcc -c $ (FLAGS) $ (APPNAME) .cpp # компиляция FONTSTR.OBJ: FONTSTR.CPP bcc —c $(FLAGS) FONTSTR.CPP # компиляция ресурсов $(APPNAME).res: $(APPNAME).rc brc -r i$ (INCPATH) $ (APPNAME) .rc Листинг 10.6. FONTSEXP.MAK (Microsoft) 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: #========„»==„„.======„eM=„ # FONTSEXP.MAK makefile, # Microsoft version # ========„=„-======—Ж—== FONTSEXP.EXE : FONTSEXP.OBJ FONTSEXP.DEF FONTSTR.OBJ FONTSEXP.RES link /CO fontsexp fontstr, /align:16, NUL, /nod llibcew libw, fontsexp rc FONTSEXP.RES FONTSEXP.OBJ : FONTSEXP.CPP cl —c -AL -GA -Ow -W2 -Zp -Zi FONTSEXP.CPP FONTSTR. OBJ : FONTSTR. CPP cl -C -AL -GA -Ow -W2 -Zp -Zi FONTSTR.CPP FONTSEXP.RES : FONTSEXP.RC rc —r FONTSEXP.RC
Программа FontsExp создает окно и заселяет его статическими и редактируемыми полями, перечнями и отмечаемыми блоками. Эти элементы управления позволяют вывести на экран целый ряд шрифтов. Меню Fontinfo дает возможность ознакомиться с информацией о текущем шрифте (см. рис. 10.2). Рис. 10.2. Программа FontsExp визуально отображает в перечне список имеющихся в системе шрифтов, а внешний вид шрифта Script — в статическом и редактируемом палях Обратите особое внимание на оставшуюся часть этой главы. Большинство Windows- программистов работает с элементами управления ежедневно. Изучите их в совершенстве и вы будете уверенно себя чувствовать при создании мощных и надежных программ, которые нравятся пользователям. Статические элементы управления Все, что вам нужно сделать для создания статических элементов — это вызвать CreateWindow. Статические поля являются наиболее простыми в использовании графи- ческими элементами управления. Процесс их создания включает в себя, как минимум, следующие действия: Вызвать CreateWindow. Задать в первом параметре CreateWindow, называемом IpszClassname, слово “static”. Указать в третьем параметре, называемом dwStyle, стиль WS_CHILD и WS_VISIBLE, а также все остальные стили, которые могут вам потребоваться, например, SS_LEFT или SS-SIMPLE. Указать размеры статического элемента. Задать в параметре hwndParent дескриптор главного окна приложения. Присвоить графическому элементу управления уникальный идентификатор, задав в параметре hMenu предварительно определенную константу. С помощью функции SetWindowText задать содержание статического поля. Это основные шаги, использующиеся при создании статических полей. Фактически их можно использовать в качестве руководства для создания любых элементов управле- ния. Иначе говоря, все управляющие элементы можно создавать с помощью вызова функции CreateWindow, обращая при этом особое внимание на перечисленные выше параметры. Учитывая их важность, обсудим эти параметры подробнее. На рис. 10.3 показана программа FontsExp с двумя статическими элементами, которые создаются следующими вызовами: 168: hNumFonts “ CreateWindow("static", NULL, 169: WSCHILD I WS VISIBLE I WSBORDER, 170: 10, 10, 200, 50, hwnd, HMENU(-l), 171: hlnstance, NULL) ;
172: 173: hNumFonts = CreateWindow("static", NULL, 174: WSCHILD I WS_VISIBLE I WS_BORDER, 175: 260, 10, 350, 70, hwnd, HMENU(-l), 176: hlnstance, NULL); Afiiil IB Balloon Bd ВТ BankGothlcMd ВТ BauerBodnl BdCn ВТ BauerBodnl BIkCn ВТ BauerBodnl ВТ Bedrock BerehardFashlon ВТ [Thore are SI fonts available [Americana ВТ I Americano XBd ВТ [Americana XBdCn ВТ | Arial 1234567890abcdefghijkh И True Type □ Heavy В Italic Рис. 10.3- Программа FontsExp ипальзует два апатических паля Как видите, этот код напоминает процедуры, использовавшиеся при создании основного окна, за исключением необходимости регистрировать класс, так как класс “static” уже зарегистрирован заранее. Замечание. Тот факт, что статическое поле является предварительно зарегистрированным окном, настолько важен, что я хочу задержаться, чтобы акцентировать этот момент. Ранее вы уже научились создавать целый ряд различных окон со своими конкретными способами поведения. Вы делали это, заполняя соответствующую структуру WNDCLASS выбранными вами значениями, а затем писали обработчики сообщений, вызывающиеся из оконной процедуры. В процессе этого вы создавали несколько классов потенциально повторно используемых окон, ведущих себя по-разному, но заранее определенным образом. Именно это уже и сделано для вас заранее в случае статических и редактируемых полей, перечней, комбинированных перечней (combo boxes), кнопок и линеек прокрутки. Фирма Microsoft уже зарегистрировала эти классы и определила, как они будут реагировать на определенные сообще- ния. Например, класс GameWindow из программы Snakel характеризуется определенным пове- дением, вытекающим из его структуры WNDCLASS и процедуры WndProc. То же самое верно и для статических классов. Начиная со второй главы, вы регулярно обращались к CreateWindow. Однако при создании дочерних окон следует иметь в виду несколько ключевых моментов. Эти моменты будут отмечены в следующих нескольких абзацах, показывающих, как создавать статические поля. Параметр dwStyle (строчка 169) функции CreateWindow объединяет посредством логического ИЛИ флажки WSCHILD, WS_VISIBLE и WS_BORDER. Первый и пос- ледний стили просто сообщают Windows, что это дочернее окно с рамкой. Благодаря флажку WS_VISIBLE вызывается функция ShowWindow. В предыдущих главах за вызо- вом CreateWindow чаще всего следовали обращения к ShowWindow и UpdateWindow: ShowWindow(hwnd, ncmdShow); UpdateWindow(hwnd); При использовании WS VISIBLE это не обязательно, поскольку в этом случае Windows делает всю черновую работу сама. Далее следуют параметры, определяющие размеры рамки статического поля. Когда CreateWindow вызывается для создания основного окна, эти параметры обычно запол- няются константами CW USEDEFAULT. Однако при создании перечня вы должны явно указать здесь его действительные размеры.
Следующим шагом является задание параметра hwndParent функции CreateWindow. Элементы управления — это дочерние окна, а детям нужны родители. В данном случае родителем является основное окно. Еще один параметр, о котором вам нужно узнать, называется hMenu и является девятым по счету (строчка 165). Обычно в нем определяется меню, соответствующее окну, но поскольку статические элементы управления не имеют меню, этот параметр можно использовать для указания числового идентификатора окна. Заданный вами числовой идентификатор может оказаться важным в дальнейшем, когда вы установите связь между элементом управления и его родительским окном. Если вы решите задать значение этого параметра, то должны будете выбрать уникальное число для каждого управляющего элемента. На это следует обратить внимание, в особенности при работе с элементами управления на диалоговых панелях. В этих случаях числовой идентификатор является единственным связующим звеном между диалогом и элементом управления. Поскольку программисты обычно вводят довольно много идентифицирующих кон- стант в своих программах, у них выработалась привычка использовать #define для их мнемонического обозначения: «define MYLISTBOX 101 «define MYBUTTON 102 «define MYWHATHAVEYOU 103 Заметьте, что вам необходимо привести тип числового идентификатора к типу HMENU до компиляции программы. Замечание. Программа FontExp обычно связывается с элементом управления через его дескрип- тор, который заботливо сохраняется после каждого обращения к CreateWindow. Этот прием удобен при работе с элементами управления, встроенными в окна. Однако для диалоговой панели проще использовать идентификатор. Для превращения статического поля в полезный объект достаточно поместить в него текст, вызвав SetWindowText: SetWindOwText (hNumFonts, S); Здесь hNumFonts представляет собой дескриптор окна, aS — символьная строка, появляющаяся в статическом поле. Статические элементы управления, по-вццимому, самые простые из тех, что вы будете использовать в Windows-программах. Разумеется, ничто в Windows не страдает синтаксическим лаконизмом. Например, в данном случае вы можете изменять рамки и цвет статических текстов и использовать их при размещении пиктограмм или растровых изображений. Ниже перечислены некоторые из стилей, которые могут быть помещены в поле dwStyle статического элемента управления и объединены посредством логического ИЛИ: SS_BLACKRECT SSJ3RAYRECT SS_WHITERECT SSJLEFT SS_CENTER SS_BLACKFRAME SS_GRAYFRAME SS_WHITEFRAME SS_RIGHT SS_ICON Можете поэкспериментировать с этими стилями. Однако обратите внимание на примеры, которые я включил в программу FontExp. Они иллюстрируют то, что лежит в основе каждого графического элемента управления: обычное окно, в котором что-то изображено. Замечание. В данном примере основные события разворачиваются в обработчике сообщения WM CREATE. Именно здесь создаются все управляющие элементы, использующиеся в про- грамме. Разумеется, только это и соответствует здравому смыслу. Фактически идея создания элементов управления в ответ на сообщения WM_CREATE определяет, для чего вообще нужны эти сообщения. Сообщение WM_CREATE посылается в окно именно для того, чтобы сказать: “Эй, там, проснитесь, пора бы вам создать дочерние окна и все прочее, что считаете необходи- мым!”
Перечни Особый интерес в контексте текущей главы представляет код, предназначенный для создания перечней: 163: hFontList = CreateWindowC'listbox", NULL, 164: WS_CHILD I WS_VISIBLE I LBS_STANDARD, 165: 9, 30, 201, 180, hwnd, HMENU(ID_LISTB0X), 166: hlnstance, NULL); Перечни — это прямоугольные окна, содержащие множество элементов, среди которых можно осуществлять выбор. Перечень и статическое поле показаны на рис. 10.4. There аге 61 fonts available Americana ВТ Americana XBd ВТ Americana XBdCn ВТ J Balloon Bd ВТ BankGothic Md ВТ BauerBodnl BdCn ВТ BauerBodnl BlkCn ВТ BauerBodnl ВТ Bedrock BemhardFashlon ВТ Рис. 10.4. Статическое пале с текстом. Сразу вслед за ним расположен перечень имен шрифтов Для перечней наиболее важную роль играет третий параметр функции CreateWindow, который определяет стиль класса. WS_CHILD I WS_VISIBLE I LBS_STANDARD, Уверен, что теперь вы не удивитесь, узнав, что флаг LBS_STANDARD является частью еще одного длинного списка опций. Так уж работает Windows. Обычно у хороших Windows-программистов в конце концов устанавливается отношение типа “любовь-не- нависть” с этими таблицами, полными опций и возможностей. Конечно, каждый такой список может вызвать небольшое замешательство, но зато он содержим массу полезных штучек, которые можно использовать для украшения ваших программ. Поскольку фирмы Borland и Microsoft уже снабдили вас несколькими копиями этого списка, я покажу вам только тот, которым программисты, как правило, пользуются регулярно: LBS_MULTIPLESEL Пользователь может выбрать более одного элемента пере- чня одновременно lbs_extendedsel Позволяет выбрать несколько элементов перечня, исполь- зуя клавишу Shift и мышь или специальную комбинацию клавиш LBS_NOTIFY Если выключено, то родительское окно не отличает оди- нарный щелчок мышью от двойного. LBS_STANDARD Стандартный перечень с рамкой и включенным LBS NO- TIFY LBS_OWNERDRAW Этот стиль необходим, если вы хотите показать в пере- чне растровые изображения или другие нестандартные элементы LBS_USETABSTOPS Используется для создания нескольких колонок в одном перечне LBS_WANTKEYBOARDINPUT Позволяет распознать ввод с клавиатуры, когда перечень находится в фокусе
Из перечисленных выше флажков наиболее важны LBS_STANDARD и LBS_MUL- TIPLESEL. Перечни со множественным выбором работают так же, как окна в файловом менеджере, позволяя выбирать несколько элементов списка одновременно. В повседневной жизни создание перечней станет для вас тривиальным занятием, которое вы сможете выполнить буквально в один присест. Просто перенесите соответ- ствующий фрагмент из другого приложения или скопируйте вызов CreateWindow из процедуры создания основного окна. Затем подправьте несколько параметров. Вот и все. Взаимодействие с перечнем может оказаться довольно сложной темой, поэтому я оставляю ее детальное рассмотрение до следующей главы. А пока достаточно будет несколько простых примеров. Если требуется создать новый элемент перечня, пошлите туда сообщение LB_ADDSTRING: char * MyString[] = "Sambo"; SendMessage (hListBox, LB_ADDSTRING, 0, LPARAM(MyString) ) ; И наоборот, чтобы выбрать строку из перечня, нужно сначала получить индекс текущего выбранного элемента с помощью сообщения LB_GETCURSEL: int Index = SendMessage(hFontList, LB_GETCURSEL, 0, 0); а затем использовать этот индекс в сообщении LB_GETTEXT: SendMessage(hFontList, LB_GETTEXT, Index, LONG(lpszBuffer)); Этот материал представляется здесь, главным образом, для справки. Пока не тратьте время на попытку понять действительный процесс взаимодействия с перечнем. Вся эта тема будет подробна объяснена в следующей главе. Отмечаемые блоки Все три отмечаемых блока, используемые в нашей программе, создаются следующи- ми вызовами: static char *Titles[] = ("TrueType" , "Heavy", "Italic"); for (int i = 0; i < 3; i++) Buttonwindows[i] = CreateWindow("button". Titles [i], WS_CHILD | WS_VISIBLE I BS_CHECKBOX, 260 + (i * 125), 180, 100, 35, hwnd, HMENU(-l), hlnstance, NULL); Чтобы создать отмечаемый блок, нужно указать класс “button” и использовать стиль BS_CHECKBOX. Приведенный выше пример показывает также, как использовать массивы констант и циклы for для создания сразу трех элементов управления — прием, который вы, вероятно, будете применять во многих случаях. Замечание. Отмечаемый блок — это маленькое квадратное окно с рамкой и присоединенным к нему именем (см. рис. 10.4). Присутствие в таком окне крестика означает, что этот блок отмечен; в противном случае — не отмечен. В большинстве случаев выбрать или отменить опцию можно одним щелчком мыши на отмечаемом блоке. Однако в программе FontExp для осуществления выбора или отмены используются сообщения, а сам пользователь никогда не взаимодействует с отмечаемым блоком напрямую. На рис. 10.5 показаны отмечаемые блоки, связанные с перечнем шрифтов программы FontExp. Если с помощью клавиши-стрелки перемещать селектор перечня, то отмечае- мые блоки будут мерцать, как елочная гирлянда. S True Туре □ Heavy СЗ Italic Рис. 10.5. Выбранный отмечаемый блок содержит внутри себя крестик, а остальные остаются пустыми 7 Чарльз Калверт
Уверен, вы уже догадались, что сталь BS_CHECKBOX не единственный из возмож- ных, который может быть ассоциирован с кнопочным управлением. Этот многообразный класс является одним из любимых Windows-программистами. Поэтому внимательно взгляните на следующие кнопочные стили: BS_CHECKBOX BSJDEFPUSHBUTTON BS_GROl'PBOX BS3STATE BS_AUTO3STATE BS_AUTOCHECKBOX BSAUTORADIOBVTTOH BS_LEFTTEXT DS OWNERDRAW BS_PUSHBUTTON BSRADTOBUTTON Создает отмечаемый блок Имеет жирную черную рамку и выбирается по умолчанию, когда пользователь нажимает клавишу Enter Объединяет элементы управления в группу Может быть отмеченным, неотмеченным или недоступным (серый полутон) Реагирует на выбор автоматически Реагирует при выборе пользователем Реагирует при выборе пользователем Текст располагается с левой, а нс с правой стороны отмечаемого блока или кнопки-селектора Позволяет программисту определить внешний вид кнопки Стандартная кнопка Кнопка-селектор Если принадлежит группе, то пользователь обычно может выбрать только одну из них Этот список показывает, что кнопки представляют собой весьма разностороннее средство. Поначалу вы можете не понять связи между стандартными кнопками ОК, отмечаемыми блоками и кнопками-селекторами. Однако все эти средства относятся к одному и тому же классу, и вам следует научиться думать о них, как о весьма близких понятиях. Взаимодействие с отмечаемыми блоками — достаточно тонкая вещь. Скажу только, что сообщение BM SETCHECK можно использовать для выполнения наиболее важных аспектов этой работы. Главное, что следует запомнить, — это то, что передача единицы в параметре WM_PARAM устанавливает отметку, в то время как передача нуля убирает ее в отмечаемом блоке: SendMessage (Buttonwindows [0] t BM_SETCHECKr lv 0L>; Если вас интересует состояние отмечаемого блока, воспользуйтесь BM_GETCHECK: SendMessage(buttonwindows(0], BMGETCHECK, 0, CL}; Чтобы не наваливать на вас слишком много материала в один день, я отложу детальное обсуждение этой темы до следующей главы. Там вы увидите, как FontExp использует сообщения для управления и опрашивания отмечаемых блоков. Редактируемые поля В программе FontExp, кроме всего прочего, используется также редактируемое поле, показанное на рис. 10.6. Редактируемые поля, как и текстовый редактор, используются для ввода информации с клавиатуры. Фактически с помощью редактируемых полей можно создавать маленькие текстовые редакторы, способные обрабатывать несколько страниц текста сразу. 1234567890abcdefghijkli Рис. 10.6. Редактируемое поле с полосой прокрутки демонстирирует символы шрифта Arial
В данной конкретной программе, вы можете ничего не печатать в редактируемом поле, а просто прокручивать его содержимое вперед и назад. Впрочем, легко догадаться, что пользователь может пожелать увидеть конкретную комбинацию букв, поэтому я разработал программу в соответствии с этим требованием. Заметьте, что это единствен- ная часть программы, требующая каких-то навыков печатания на машинке. Windows — это совсем не то, что DOS! Вызов, инициализирующий редактируемое поле, использует шесть различных стилей, объединенных посредством логического ИЛИ для формирования третьего параметра: 177: hAlphaEdit = CreateWindow("edit", NULL, 178: WS-CHILD | WSVISIBLE I WSBORDER I WSHSCROLL I 179: ESLEFT | ES_AUTOHS CROLL | ES_MULTILINE, 180: 260, 90, 350, 70, hwnd, HMENU(-1), 181: hlnstance, NULL); Используйте стиль WS BORDER, если хотите, чтобы элемент управления был обведен черным. Линейки прокрутки образуются в перечнях автоматически. В редактируемые поля их можно добавить, воспользовавшись стилем WS HSCROLL. Не путайте этот стиль со стилями ES_AUTOHSCROLL и ES_AUTOVSCROLL. Эти два стиля позволяют пользователю просматривать текст, скрытый за правой (или соответственно за нижней) границей элемента управления. Уверен, что проницательный читатель уже приготовился к еще одному длинному списку идентификаторов. Поэтому без дальнейших проволочек приведу перечень стилей редактируемых полей: ES_AUTOHSCROLL ES_AUTOVSCROLL ES_CENTER ES_LEFT ES_LOWERCASE ESJ4ULTILINE ES_NOHIDESEL Автоматически прокручивает в горизонтальном направлении Автоматически прокручивает в вертикальном направлении Центрирует текст Выравнивает текст по левому краю Преобразует прописные буквы текста в строчные Использует несколько строчек Вынуждает Windows держать текст подсвеченным, даже если вы перенесете фокус на другой элемент управления. (Если вы выделили фрагмент текста, Windows обычно не подсвечивает его, после того как элемент управления потеряет фокус.) es_oemconvert ES_PAS SWORD ES_READONLY ESRIGHT ES_UPPERCASE ‘ ES_WANTRETURN Помогает сохранять символы, не являющиеся ни буквами, ни цифрами Помогает предохранить редактируемое поле от несанкционированного доступа Использует редактируемое поле только для просмотра текста Выравнивает текст по правому краю Преобразует строчные буквы текста в прописные Воспринимает возвраты каретки (клавиша Enter) как таковые, а не как нажатие кнопки, действующей по умолчанию Этот список трудно переоценить. Бесчисленное множество Windows-программистов потратило часы на обработку возвратов каретки, перехватывая сообщения WM KEY- DOWN, или на создание редактируемых полей, подходящих для обработки паролей. Не станьте одним из этих переработавших бедняг. Лучше рассмотрите внимательно все эти стили, чтобы вам не пришлось изобретать велосипед! Взаимодействие с редактируемыми полями несложно. Чтобы вставить текст в редакти- руемое поле, вызовите SetWindowText, как вы делали это при работе со статическими полями:
SetWindowText(hAlphaEdit, S); Для выборки текста из редактируемого поля вызовите GetWindowText: GetWindowText(hAlphaEdit, S, sizeof(S)); Здесь первый параметр — дескриптор HWND редактируемого поля, второй — буфер, в котором содержится символьная строка, появляющаяся в редактируемом поле, а третий — максимальная длина этой строки. В следующей главе вы увидите, что функция SendMessage предоставляет альтернативу этому способу. Например, следующий вызов передает строку Alpha в редактируемое поле: SendMessage (hAlphaEdit, WM_SETTEXT, О, LPARAM(&Alpha)) ; Пусть этот последний вызов пока не приводит вас в замешательство. В следующей главе он объясняется детально. Кроме WMJSETTEXT, редактируемые поля реагируют еще на ряд сообщений, позволяющих непосредственно манипулировать текстом. Для понимания большей части этих сообщений требуется глубокое знание Windows, но вам следует знать, по крайней мере, об их существовании. EM_CANUNDO Проверяет, нельзя ли восстановить состояние, предшест- вующее выполнению операции EM_GETMODIFY Проверяет, не изменялось ли содержимое EM_GETRECT Получает координаты элемента управления EM_GETSEL Получает позицию текущего выбранного фрагмента EM_LIMITTEXT Ограничивает текст в редактируемом поле EM_REPLACESEL Замещает текущий выбранный фрагмент EM_SETPASSWORDCHAR Устанавливает символ пароля EM_SETREADONLY Устанавливает состояние только чтения EM_SETSEL Выбирает фрагмент текста EM_UNDO Возвращает состояние, предшествующее операции (отме- няет операцию) Резюме В данной главе вы имели случай познакомиться с графическими управляющими элементами Windows. Вы видели, что эти средства можно использовать для формирова- ния интерактивного интерфейса между вашей программой и пользователем. В этой главе освещалось создание четырех элементов управления. 1. Статических полей. 2. Перечней. 3. Отмечаемых блоков. 4. Редактируемых полей. Поскольку вы также рассматривали линейки прокрутки, то теперь уже знаете о пяти различных элементах управления. При создании оконного элемента управления самый важный шаг состоит в том, чтобы в первом параметре CreateWindow — IpszClassName — задать имя класса элемента управления. Например, если вы хотите создать редактируемое поле, скопируйте в IpszClassName слово “edit”. Остальные элементы управления создаются копированием в этот параметр одного из следующих слов: “static”, “scrollbar”, “listbox” и “button”. В этой главе также подробно обсуждались различные стили, использующиеся при определении элементов управления. Например, вы видели, что стиль ES_CENTER центрирует текст в редактируемом поле, а стиль ES_CHECKBOX превращает обычную кнопку в отмечаемый блок.
Вопросы и ответы 1. В этой главе вы показали множество оконных стилей. Как все это запомнить? Не пытайтесь запомнить все стили, рассмотренные в этой главе. Просто примите во внимание тот факт, что каждый элемент управления имеет набор стилей, которые можно использовать для улучшения или даже радикального изменения его внешнего вида и поведения. Еще один полезный момент состоит в том, что стили, ассоциированные с каждым элементом управления, начинаются с конкретного набора букв. Например, стиль редактируемого поля начинается с ES. Чтобы помочь вам понять, как это работает, я приведу ниже перечень букв, ассоциированных с каждым из основных типов элементов управления: Кнопка BS Комбинированный перечень CBS Редактируемое поле ES Перечень LBS Статическое поле SS 2. Я все еще не понимаю все эти дела по взаимодействию с управляющим элемен- том. Что нужно использовать — дескриптор или идентификатор? Windows монолитна, но в то же время чрезвычайно гибка. Элементы управления разработаны таким образом, чтобы вы могли осуществлять связь с ними либо через дескриптор, либо через числовой идентификатор. Если элемент управления встроен в окно, то проще воспользоваться дескриптором. Отношения диалоговых панелей со своими элементами управления немножко отличаются, поэтому в этом случае проще воспользоваться идентификатором управляющего элемента. Независимо от того, имеете ли вы дело с дескриптором или с идентификатором, главное, что у вас есть уникальное число, ассоциированное с элементом управления. Вопросы для самопроверки 1. С помощью какой (одной) функции можно создать все элементы управления, рассматриваемые в этой главе? 2. Почему вам не нужно регистрировать класс статического элемента управления? 3. Как определить родителя элемента управления? 4. С элементом управления можно взаимодействовать с помощью его дескриптора или его ____? 5. Как указать идентификатор элемента управления? 6. Какая логическая операция используется при указании стиля элемента управле- ния? 7. Какие две команды, отличные от PostMessage и SendMessage, можно использовать для помещения символьной строки внутрь (или выборки строки из) редактируемого или статического поля? 8. Почему перечни и отмечаемые блоки называются элементами управления? 9. С каким элементом управления ассоциируется сообщение EM SETSEL и какова его функция? 10. Как определить, что отмечаемый блок отмечен? Упражнения 1. Напишите маленькую программку с одним статическим элементом управления. Пусть текст в редактируемом поле изменяется всякий раз, когда пользователь щелкает левой кнопкой мыши. 2. Создайте программу с одним перечнем и одним редактируемым полем. Разрабо- тайте ее таким образом, чтобы текст в редактируемом поле передавался в перечень, когда пользователь щелкает левой кнопкой мыши.
День 11 ВЗАИМОДЕЙСТВИЕ С ЭЛЕМЕНТАМИ УПРАВЛЕНИЯ С ПОМОЩЬЮ ОБРАБОТЧИКА ПЕРЕЧИСЛЯЕМЫХ ШРИФТОВ ФУНКЦИИ EnumFontFamilies Сегодня мы воспользуемся отладчиком, чтобы понять, как Windows общается с перечнями, редактируемыми и статическими полями и кнопками. Кроме того, вы узнаете больше о функции SendMessage и о функции PostMessage, которая позволяет вам помещать ваши собственные сообщения (или стандартные сообщения Windows) в очередь. Третья тема, исследующаяся в этой главе, относится к полному перебору шрифтов системы. Это выполняется с помощью функции EnumFontFamilies и связанного с ней обработчика перечисляемых объектов (callback function). Учитывая важность последнего, в эту главу включен еще один краткий обзор функции MakeProcInstance. В частности, в этой главе рассматриваются: Программа FontsExp. В Создание определяемых пользователем сообщений. Функция SendMessage. Функция PostMessage. Использование обработчика перечисляемых объектов (в данном случае шрифтов) функции EnumFontFamilies. Взаимодействие с перечнями. Взаимодействие с отмечаемыми блоками. Эта глава продолжает исследование программы FontsExp, поэтому в ней не приво- дится каких-либо новых листингов. Но это вовсе не означает, что вам предстоит легкая прогулка. Я хочу, чтобы вы, не тратя времени на запуск и выполнение новой программы, сконцентрировались на изучении отладчика. Представленный в этой главе материал довольно сложен, и вы не сможете полностью в нем разобраться, пока не запустите отладчик и не посмотрите, как он работает. В этой главе я делаю несколько отступлений, касающихся отладчика и способа его использования для исследования программы. Отнеситесь к этим отступлениям серьезно. Они очень важны!
Краткая история WM_STARTFONTS В этой главе освещается достаточно сложный, с чисто понятийной точки зрения, материал. Тема этого дня — коммуникация, в частности способ, который Windows использует для взаимодействия с сообщениями и обработчиками перечисляемых объек- тов. Замечание. Я считаю информацию, представленную в этой главе, очень существенной. Передача сообщений в очередь или непосредственно в окно является одним из стандартных действий, выполняемых Windows-программистами. Книга, подобная этой, должна содержать совершенно ясное описание работы сообщений. Без детального знания всей их внутренней механики вы никогда по-настоящему не поймете, в чем собственно вообще состоит ваша работа как програм- миста. Обработчики перечисляемых объектов используются не так часто, но играют жизненно важную роль во всем, что окружает Windows. Так что запаситесь временем, читая эту главу. На повестке дня следующие вопросы: Изучить сообщение WMJSTARTFONTS, определяемое пользователем. Проследить сообщение WMSTARTFONTS от первого упоминания до момента, когда оно доходит до EmunFontFamilies, вызывая тем самым передачу сообщений, инициирующих заполнение перечней и других визуальных элементов программы FontsExp. Каждый вопрос повестки дня методично объясняется от начала до конца. Эта глава повествует об истории жизни WM_STARTFONTS. Вначале описывается объявление сообщения WM_STARTFONTS, а затем его передача и обработка. Таким образом, вы получите полный обзор этого предмета, не упустив ничего. Доставка почты Прежде чем начать обсуждение WMJSTARTFONTS, полезно будет вспомнить тему предыдущей главы. В ней была детально рассмотрена функция ответа на сообщение WM_CREATE программы FontsExp. Кроме того, вы узнали, как создавать редактируемые и статические поля, перечни и отмечаемые блоки с помощью процедуры CreateWindow. Я не упомянул об одной команде в FontsExp_OnCommand, а именно об обращении к функции PostMessage: PostMessage (hwnd, WM_STARTFONTS, 0, 0); Чтобы понять, как работает PostMessage, лучше всего начать с определения сообще- ний под новым углом зрения. WM_STARTFONTS — это определяемое пользователем сообщение, извещающее основное окно о том, что пора заполнить перечень и все прочие элементы управления именами и описаниями шрифтов системы. Между сообщениями, определяемыми пользователем, и остальными сообщениями существует два отличия: Сообщения, определяемые пользователем, объявляются программистом, в то время как обычные сообщения Windows объявляются в WINDOWS.H или в других заголо- вочных файлах, поставляющихся вместе с системой. Сообщения, определяемые пользователем, обычно имеют только локальную сферу действия. Это означает, что они могут быть определены только для одного класса. Точнее говоря, сообщения, определяемые пользователем, вычисляются на основе константы WM_USER, которая определяется в WINDOWS.H. \* Замечание: все сообщения от 0x0400 резервируются Windows *\ #define WM__USER 0x0400 Как видите, комментарий указывает, что сообщения, начиная с номера 1024 (0x400), резервируются для внутреннего использования Windows. Сообщение WM STARTFONTS определяется в FONTSEXP.H следующим образом: ttdefine WM_STARTFONTS (WM_USER + 0)
Предыдущая строчка просто говорит о том, что WM STARTFONTS должно быть назначено число, которое позволит Windows распознать его как локальное сообщение. По определению оно предназначается специально для класса FontsExp. Чтобы опреде- лить новое сообщение, просто добавьте единицу к значению WMJSTARTFONTS: #define WM_STARTFONTS «define WM_NEWFONT (WM_USER + 0) (WM_USER + 1) и т.д... Конечно, WM_STARTFONTS — не единственное сообщение системы, которому назначается шестнадцатеричное число 400. Фактически следующие сообщения из WIN- DOWS.H имеют такие же номера. «define BM_GETCHECK «define EM_GETSEL «define CB_GETEDITSEL «define DM_DM_GETDIFID «define STM_SETICON (WM_USER + 0) (WM_USER + 0) (WM_USER + 0) (WM_USER + 0) (WM_USER + 0) Дублирование констант не ведет к путанице, поскольку сообщения всегда посыла- ются конкретному окну, указываемому с помощью дескриптора HWND в первом параметре функций PostMessage или SendMessage: HWND hMainWindow, hCheckBox; // Дескрипторы окон PostMessage(hMainWindow, WM_STARTFONTS, 0, 0L); SendMessage(hCheckBox, BM_GETCHECK, 0, 0L) ; Этот вызов явно говорит о том, что WMJSTARTFONTS передается в основное окно программы. Если бы оно случайно было послано в отмечаемый блок, то Windows просто проигнорировала бы все шрифты системы и возвратила бы состояние отмечаемого блока. Бывают случаи, когда вам требуется создать сообщение, предназначенное для не- скольких приложений. Чтобы добиться этого, вызовите функцию RegisterWindowMes- sage, возвращающую уникальное сообщение (определяющееся во время выполнения) для использования вашими приложениями. Используйте WMUSER в качестве смещения для сообщений, адресованных только одному классу. Не пытайтесь пересылать эти сообщения между приложениями. Используйте функцию RegisterWindowMessage для назначения номеров сообщениям, которые будут пересылаться между приложениями. SendMessage и PostMessage Теперь, когда вы знаете, как объявляется WMJSTARTFONTS, можно рассмотреть SendMessage и PostMessage. Это одни из наиболее интересных вызовов интерфейса прикладного программирования. Функции, которые они выполняют, на первый взгляд могут показаться весьма похожими, нона самом деле являются совершенно различными. Они должны занимать в вашем воображении отдельные, но соседние комнаты. Основная цель как SendMessage, так и PostMessage — выдавать конкретному окну команду на выполнение некоторого задания. Функция SendMessage делает это явно, вызывая процедуру того окна, которое соответствует дескриптору HWND из списка параметров, и не выходит из оконной процедуры, пока та не обработает запрошенное сообщение. Функция PostMessage не вызывает явно оконную процедуру, а пересылает сообщение в очередь сообщений приложения. Каждое приложение имеет очередь сообщений, которая по умолчанию вмещает до восьми сообщений. Сообщения выбираются из очереди с помощью функции GetMessage. Из рассмотрения функции WinMain програм- мы FonsExp видно, что после вызова GetMessage сообщение передается оконной процедуре с помощью функции DispatchMessage. Все это схематически показано на рис. 11.1.
Рис. 11.1. SendMessage направляет сообщение непосредственно в оконную процедуру, a PostMessage выбирает более извилистый маршрут Используйте SendMessage, когда затраты времени существенны, то есть копа вы хотите быть уверенными, что сообщение будет обработано прежде, чем закончится SendMessage. Ik используйте SendMessage, если вы можете отложить обработку сообщения. Помните, что SendMessage нс закончится, пока сообщение нс будет обработано. Не забывайте, что PostMessage заканчивается немедленно, как только поместит сообщение в очередь, позволяя вашей программе продолжить работу, по крайней мерс, до тех пор, пока сообщение нс будет доставлено по назначению (или какое-либо другое событие ire завладеет процессором). В нашем конкретном случае FontsExp использует PostMessage по двум причинам. Во-первых, нет нужды обрабатывать сообщение немедленно, а во-вторых, создание окна должно завершиться прежде, чем будет обработано сообщение WM STARTFONTS. Откуда программа FontsExp знает, что создание окна завершится прежде, чем будет обработано сообщение? Чтобы понять это, просто проследите приложение по шагам. Стартуйте отладчик и поместите точку прерывания перед первым вызовом CreateWindow. Затем пройдите программу с начала до момента вызова WinMain. Первый шаг — вызов RegistcrWindow. Затем следует обращение к CreateWindow, ShowWindow, UpdateWindow и (ictMcssage. Замечание. Поскольку у нас может быть один из множества различных комшьъпиров, я нс могу скипать точно, как гюльзоштля вашим отладчиком Если вы еще нс научились им пользов-тг-ся. нпЦд1ггс время и почитай гс документацию по компилятору. Приказ о помещении в очередь сообщении WM_STARTFONTS отдается в конце обработчика сообщения WM..CREATE. Сообщение WM. CREATE посылается во время вызопа CreateWindow. Это означает, что окно будет создано, показано и обновлено прежде, чем Get Message сможет выбрать сообщение WM_STARTFONTS из очереди приложения. Повторим весь процесс еще раз: 1. Регистрация окна. 2. Вызов функции CreateWindow. Это этап, на котором окно обрабатывает сообщение WM CREATE. Тогда же отправляется в очередь сообщение WM. SFARTFONTS. 3. Отображение и обновление окна на экране. 4. Старт цикла обработки сообщений. Именно на этом этапе сообщение WM_START - FONTS действительно передается в WndProc. Я подробно обсуждаю эту тему, поскольку вся идея непосредственной и опосредо- ванной (через очередь) передачи сообщений составляет критический период жизни Windows-приложения. Кроме того, вы просто нс поймете то, о чем говорится в оставшейся части главы, нс представляя хотя бы в общих чертах, как работают SendMes- sage и PostMessagc.
Перечисление системных шрифтов Из предыдущего раздела вы узнали, как доставляется почта. Вы проследили сообще- ние WM_STARTFONTS от момента помещения его в очередь до момента его поступле- ния в WndProc. После того как почта сделала свое дело, следующий шаг — обработать сообщение в теле WndProc. Чтобы проследить это с помощью отладчика, поместите точку прерывания на строчку, начинающуюся с IpfnEnumProc. Теперь вновь запустите программу FontsExp с самого начала и продолжайте, пока не достигнете точки преры- вания в WM_STARTFONTS. 115: case ИМ STARTFONTS: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 135: 136: ( HDC DC - GetDC(hwnd); IpfnEnumProc =(FONTENUMPROC)MakeProcInstance( (FARPROC)FontCallBack, hlnstance); EnumStruct.Count = 0; EnumStruct.hWindow = hFontList; EnumFontFamilies(DC, NULL, IpfnEnumProc, (LONG)SEnumStruct) ; FreeProcInstance((FARPROC)IpfnEnumProc); ReleaseDC(hwnd, DC); wsprintf(S, "There are %d fonts available", EnumStruct.Count); Se tWindowText(hNumFonts, S); SetFocus(hFontList); SendMessage(hFontList, LB_SETCURSEL, 0, 0); ShowTheFont(hwnd); return 1; > Цель этого фрагмента — осуществить полный перебор системных шрифтов. Про- грамма спрашивает систему: “Какие шрифты вы имеете в наличии?” Система отвечает: “Arial, New Times Roman, Script... (и т.д.)”. Сложность этого процесса определяется в основном способом получения этой информации программой FontsExp. Решение состоит в том, чтобы указать некоторый адрес, по которому Windows должна отправлять информацию, а затем останется лишь просто подождать, пока не осущест- вится полный перебор всех доступных шрифтов. Всякий раз, когда обнаруживается шрифт, Windows посылает “письмо” в приложение FontsExp по указанному адресу. Это равносильно какому-нибудь заказу по каталогу Land’s End. Вы что-то посылаете почтой и ждете, когда прибудут товары. Каждый может сделать это! Первый шаг — установить адрес получателя, которым в данном случае оказывается функция FontCallBack. Пока не думайте, как эта функция работает, просто знайте о ее существовании. Это маленький почтовый ящик со своим собственным адресом. Вот как адрес функции FontCallBack сообщается Windows: IpfnEnumProc = (FONTENUMPROC)MakeProcInstance( (FARPROC)FontCallBack, hlnstance); Выглядит довольно скверно. Но не беспокойтесь. В данном случае не так уж трудно отделить синтаксические зерна от синтаксических плевел. Вся суть заключается в обращении к MakeProcInstance. Эта функция устанавливает адрес для процедуры FontCallBack. На самом деле Windows присоединяет к FontCallBack специальный пролог, который связывает сегмент данных приложения FontsExp с функцией FontCallBack. Замечание. Процесс установки процедуры FontCallBack напоминает тот, с которым вы познако- мились при изучении процедуры DialogBox. Все проблемы те же самые. Функция FontCallBack является частью приложения FontsExp, но должна быть вызвана самой Windows. Эго означает, что, будучи вызванной, FontCallBack является уже частью Windows (а не вашего приложения). Поэтому, естественно, функция FontCallBack не имеет доступа к сегменту данных FontsExp. Одна из целей вызова MakeProcInstance состоит в решении этой задачи с помощью кода пролога, упомянутого ранее.
Если По какой-то причине последние абзацы вам не вполне понятны, вернитесь к обсуждению процедуры DialogBox, вновь погрузитесь в аналогию с почтовым адресом, запустите отладчик, установив точку прерывания в функции FontCallBack, и исследуйте программу, пока не поймете весь этот процесс. Дело в том, что Windows и ваша программа должны согласовать адрес, по которому будет доставлен список шрифтов. Функция MakeProcInstance регистрирует этот адрес в почтовой службе и гарантирует наличие чистого канала связи. Чтобы успешно вызвать MakeProcInstance, вы должны привести возвращаемое ею значение к типу FONTENUMPROC. Это необходимо, поскольку процедура EnumFont- Families, о которой вы скоро прочитаете, ожидает адрес именно этого типа. Процедура FontCallBack, в свою очередь, должна быть приведена к типу FARPROC. FARPROC — это на самом деле только родовой процедурный тип без каких либо специальных аргументов или возвращаемого значения. Само собой разумеется, что все функции типа FARPROC объявляются как FAR. Замечание. Если вы не вполне знакомы с приведением типов, можете использовать для понимания сказанного выше следующую аналогию: форд “Мустанг” — это специфический тип машины, точно так же, как функция FontCallBack — специфический тип функции; FARPROC же — это просто родовое имя для процедур, как слово машина или автомобиль часто используется в качестве родового имени для “Мустанга”. MakeProcInstance возвращает родовое имя, a FontsExp приводит тип таким образом, чтобы с этим возвращаемым значением можно было работать, как со специальным адресом. Она говорит: “Ладно. Ваше дело — просто доставить автомобиль. Но я-то знаю, что эта конкретная машина — “Мустанг”, так что я буду с ней обращаться, как с “Мустангом”. Или, если хотите, можете представить себе парня, который развозит на грузовике автомобили и думает: “Я просто развожу автомобили и мне нет дела до того, что это за модели”. Однако дилер, которому он доставляет автомобили, точно знает, какие именно модели прибудут и может сказать своим рабочим: “Ну-ка, пойдите и пригоните мне тот “Мустанг”, который привезли сегодня”. Следующие несколько строчек выглядят следующим образом: EnumStruct.Count •= 0; EnumStruct.hwindow = hFontList; EnumFontFamilieS (DC, NULL, IpfnEnumProc, (LONG)SEnumStruct); Главным здесь является вызов EnumFontFamilies. Первый параметр — контекст устройства. Второй параметр — имя семейства шрифтов — в данном случае NULL. Третий параметр — это адрес обработчика перечисляемых шрифтов, представляющей собой “почтовый ящик”, в который посылается информация. Последний параметр — адрес некоторых данных, которые вы можете передать в функцию FontCallBack. Во многих случаях этот последний параметр можно положить равным нулю. Здесь я показал его, чтобы вы знали, как им пользоваться. В последнем параметре вы можете передать адрес структуры или иных данных любого типа. В данном случае я передаю запись, состоящую из двух полей: первое — целое, а второе — типа HWND. Имеется в виду, что я приспособил эту структуру для своих собственных целей. Если хотите, можете передать структуру, содержащую четыре сим- вольные строки и число с плавающей точкой, адрес другой процедуры или просто старый добрый NULL. Годится любой правильный указатель. Обработчик перечисляемых шрифтов Во время работы EnumFontFamilies Windows передает “почту” обработчику перечис- ляемых шрифтов — функции FontCallBack. Чтобы понять, как здесь осуществляется связь, воспользуйтесь отладчиком. Установите точку прерывания в FontCallBack и пройдите программу по шагам до вызова EnumFontFamilies в WndProc. Вы увидите, что фокус переключается с EnumFontFamilies прямо на FontCallBack: 298: int CALLBACK FontCallBack(LPENUMLOGFONT Ipnlf, 299; LPNEWTEXTMETRIC Ipnfm, int FontType, ENUMSTRUCT FAR * IpData) 300:
301: ( 302: SendMessage(lpData->hWindow, LB__ADDSTRING, 0, 303: LPARAM(lpnlf->elfLogFont.IfFaceName)); 304: lpData->Count++ 305: return 1; 306: ) Параметры FontCallBack определяются функцией интерфейса прикладного програм- мирования EnumFontFamProc. В действительности вы можете никогда не называть программу EnumFontFamProc. Эта функция просто столбит место для имени, опреде- ляющегося внутри конкретной программы. Как видите, в предыдущем коде я подставил вместо EnumFontFamProc имя FontCallBack. Впрочем, если вам нужно будет уточнить параметры, передающиеся в эту функцию, то в документации нужно будет искать EnumFontFamProc. Функция FontCallBack int CALLBACK FontCallBack (LPENUMLOGFONT, LPNEWTEXTMETRIC, int, ENUMSTRUCT FAR*) Передаваемые в FontCallBack параметры говорят почти все, что программист может когда-либо захотеть узнать о шрифтах. Первый параметр — структура LOGFONT шрифта. Второй параметр — структура TEXTMETRIC. Н Третий параметр можно использовать для определения того, имеет ли шрифт тип TrueType или предназначается для вывода на экран или принтер. Н Последний параметр — пользовательские данные, передающиеся при вызове EnumFontFamilies. Первые два из этих параметров содержат структуру, включающую около тридцати различных полей, детализирующих характеристики шрифта. (Чтобы исследовать эти поля воспользуйтесь отладчиком.) Пример: int CALLBACK FontCallBack (LPENUMLOGFONT Ipnlf, LPNEWTEXTMETRIC Ipnfm, int FontType, ENUMSTRUCT FAR * IpData) ( SendMessage(IpData->hWindow, LB_ADDSTRING, 0, LPARAM(lpnlf->elfLogFont.IfFaceName)); return 1; ) В этом частном случае 90% данных в FontCallBack просто игнорируются. Единствен- ное, что представляет интерес, — это поле ifFaceName структуры LOGFONT. Эти данные пересылаются непосредственно в перечень, где они визуально отображаются для про- смотра пользователем. Процесс передачи сообщения в перечень описывается в следую- щем разделе. Очередная “корреспонденция” достигает адресата немедленно после отправления (так сказать, авиапочтой) при любезном посредничестве Windows. Снова FontCallBack “запечатывает в конверт” имя шрифта и посылает “письмо” в перечень для отображения на экране. Так продолжается до тех пор, пока не исчерпается список шрифтов или пока обработчик перечисляемых объектов не вернет нуль. По окончании EnumFontFamilies программист должен позаботиться об удалении кода пролога, размещенного в памяти функцией MakeProcInstance: FreeProcInstance ((FARPROC)Ipfn EnumProc); Кроме того, не забывайте освобождать контекст устройства, использовавшегося во время вызова EnumFontFamilies: ReleaseDC (hwnd, DC); Ну вот и все. Только что вы видели грубую схему того, как осуществить полный перебор шрифтов системы с помощью обработчика перечисляемых объектов. Процесс состоял из семи шагов:
Написать процедуру обработчика перечисляемых шрифтов. Получить контекст устройства. Вызвать MakeProcInstance, чтобы создать соединительное звено между вашей про- граммой и самой Windows. Вызвать EnumFontFamilies и подождать, пока Windows перешлет информацию о шрифтах в ваш обработчик перечисляемых объектов. Обработать информацию, посланную вашему обработчику перечисляемых шрифтов. С помощью FreeProcInstance удалить код пролога, созданного MakeProcInstance. Освободить контекст устройства. Перечисленные действия, безусловно, необходимы и полезны. Однако все описанное до сих пор никак не информирует пользователя о том, что же фактически происходит. Чтобы вызвать визуальный элемент, приложение FontsExp в первую очередь должно установить непосредственную связь с ним. Взаимодействие с перечнями Одна из важнейших задач функции FontCallBack — вызов SendMessage: SendMessage(lpData->hWindowf LB_ADDSTRINGr О, LPARAM(lpnlf->elfLogFont.ifFaceName)) ; Эта функция фактически передает имена перечисляемых шрифтов в перечень, где их может увидеть пользователь. Вы уже знаете, что SendMessage доставляет сообщение непосредственно конкретной WndProc, которой в данном случае является оконная процедура перечня. Новым здесь является сообщение LB_ADDSTRING: LB_ADDSTRING — это одно из почти сорока предварительно определенных сооб- щений, которые могут передаваться в перечень. Прочитав о нем в своем справочнике, вы увидите, что, когда посылается это сообщение, происходит следующее. Windows ожидает, что третий параметр (WPARAM) SendMessage или PostMessage равен нулю. Четвертый параметр полагается равным адресу строки, которая должна быть добав- лена к перечню. Поскольку четвертый параметр функции SendMessage есть LPARAM, необходимо привести его тип к символьной строке перед отправкой в перечень. Ниже приводится список наиболее употребимых сообщений, посылаемых в перечень. LB_ADDSTRING LB_DELETESTRING LB-DIR LB_GETCONUNT LB_GETCURSEL LBGETSEL LB_GETSELCOUNT LB_GETTEXT LBGETTEXTLEN LB_RESETCONTENT LBSELECTSTRING LB_SELITEMRANGE LBSETCOLUMNWIDTH Добавляет строку Удаляет строку Добавляет список имен файлов Получает количество элементов перечня Получает индекс выбранного элемента перечня Получает состояние выбора (выбран/не выбран) элемента перечня Получает количество выбранных элементов перечня Копирует элемент перечня в буфер Получает длину в байтах элемента перечня Удаляет все элементы перечня Выбирает подходящую строку перечня по заданному префиксу Выбирает несколько элементов перечня, стоящих подряд Устанавливает ширину столбцов в перечне
LB_SETCURSEL LB_SETSEL LBSEIIOPINDEX LB SETTABSTORS Выбирает элемент перечня по индексу Выбирает элемент перечня с множественным выбором Делает видимым заданный элемент перечня Устанавливает позицию табуляции В программе FontsExp, я использовал для связи с элементами управления функцию SendMessage. Однако в WINDOWSX существует множество объявленных макросов, которые могут упростить всю эту процедуру. Например, вместо посылки сообщения LB_ADDSTRING, WINDOWSX предлагает вам воспользоваться следующим макросом: Bdefinc ListBox_AddStrinq (hWndCtl. ipsz) который определяется как: {(int) (DWORD) SendMessage ((hWndCtl), IBADDS3BING, 0. (LPARAM) (LFCSTR) (Ipszl) ) . Многим легче пользоваться макросами из WINDOWSX, чем функциями SendMes- sage. Однако в этой книге я иногда применяю SendMessage по двум причинам. В1 Во-первых, я считаю важным, чтобы вы понимали, как работают макросы из WINDOWSX. WINDOWSX — чудесная вещь, но вы нс должны ею пользоват ься, пока нс разберетесь, на чем опа основана Во-вторых, вы должны в совершенстве знать, как пользоваться SendMessage, по- скольку встретите массу программ, зависящих от этой функции. Jlirfflo я часто использую макросы из WINDOWSX вместо SendMessage, поскольку WINDOWSX элегантен и легко переносится на Win32. После того как функции FontCallBack переданы имена всех шрифтов системы, программе требуется заполнить статическое поле, предшествующее перечню wsprintf(S, "There are id fonts available", EnumStruct.count); SetWindowText(hNumFonts, S>. Заметьте, что эти строчки — только часть ответа на сообщение WMJ5TARTFONTS. Здесь ноле Count увеличивается па единицу всякий раз, когда в FontCallBack посылается очередная порция информации (см. рис. 11.3) There are 61 loots available Americana ВТ Americana XBd ВТ Americana XBdCn ВТ Arial Bello on Bd НТ BankGothic Md ВТ BauerBodni BdCn ВТ BauerBodni BlkCn ВТ BauerBodni ВТ Bedrock BernhardFashlon ВТ Рис. 11.3. Статическое поле и перечень после заполнения информацией о шрифтах Следующее действие программы — установить фокус на перечень, а затем подсветить его первый элемент. (Пройдите с помощью отладчика строки 132 и 133, которые, кстати, являются все еще лишь частью ответа на WM_STARTFONTS): SctFocus(hFontList); SendKessage(hFontList, LB_SETCURSEL, 0, 0); Этот вызов SetFocus очень важен. Перечень реагирует на манипуляции клавишами- стрелками, однако для этого он должен находиться в фокусе и быть выбранным. Чтобы выбрать перечень, вызовите SetFocus с дескриптором HWND этого перечня в качестве единственного параметра. Эффект будет таким же, как если бы вы щелкнули на нем мышью.
Выбор элемента перечня не вызывает затруднений. Для этого достаточно послать в перечень сообщение LB_GETCURSEL и индекс элемента, который необходимо подсве- тить. Сообщение само приказывает перечню выделить конкретный элемент. Индекс элемента, который необходимо подсветить, указывается в WPARAM. Нулевое значение WPARAM соответствует первому по счету элементу перечня. Визуальное отображение шрифта К этому времени вы уже рассмотрели все вызовы, инициированные сообщением WM_STARTFONTS, кроме вызова ShowTheFont. Функция ShowTheFont занимается всеми элементами управления, за исключением перечня и находящегося непосредствен- но над ним статического поля. Точнее говоря, она показывает в большом статическом поле имя выбранного в данный момент шрифта, а в специальном прокручиваемом редактируемом поле — последовательность символов этого шрифта. Кроме того, соот- ветствующим образом устанавливаются отмечаемые блоки (см. рис. 11.4). ЕдуцроХ АВХАЕФГНТдКАММОГ Е True Type □ Heavy □ Italic Рис. 11.4. Эти элементы управления обрабатываются функцией ShowTheFont Замечание, функция ShowTheFont вызывается не только в ответ на сообщение WM_START- FONTS в начале программы, но и всякий раз, когда пользователь выбирает в перечне другой шрифт. Иначе говоря, перечень заполняется только один раз — во время создания программы. Ниже приводится исходный код функции ShowTheFont. Найдите время, чтобы пройти его с помощью отладчика. 232: void ShowTheFont(HWND hwnd) 233: ( 234: FONTENUMPROC IpfnEnumProc; 235: char lpszBuffer[150]; 236: ENUMSTRUCT EnumStruct; 237: HFONT Savelt; 238: 239: char Alphaf] = {"1234567890abcdefghijklmnopqrstuvwxyz" 240: "ABCDEFGHlJKLMNOPQRSTUVWXYZ"); 241: 242: HDC DC = GetDC(hwnd); 243: 244: int Index » SendMessage(hFontList, LB_GETCURSEL, 245: SendMessage(hFontList, LB_GETTEXT, Index, LPARAM(IpszBuffer)); 246: IpfnEnumProc « (FONTENUMPROC)MakeProcInstance( 247: (FARPROC)DescribeFontCallBack, hlnstance); 248: EnumStruct.Count = 0; 249: EnumStruct.hWindow = hwnd; 250: EnumFontFamilies(DC, IpszBuffer, IpfnEnumProc,(LONG)SEnumStruct); 251: FreeProcInstance((FARPROC)IpfnEnumProc); 252: 253: if (TheFont != 0) 254: Savelt = SelectFont(DC, TheFont); 255: GetTextMetrics(DC, STextMetrics); 256: HandleMetrics(TextMetrics); 257: GetTextFace(DC, 150, aTextFace); 258: if (TheFont != 0) 259: SelectFont(DC, Savelt); 260: 261: ReleaseDC(hwnd, DC);
262: 263: SendMessage(hFontName, WM_SETTEXT, 0, LPARAM(slpszBuffer)); 264: SendMessage(hFontName, WM SETFONT, WPARAM(TheFont), 0); 265: 266: SendMessage(hAlphaEdit, WMJSETTEXT, m, LPARAM(&Alpha)); 267: SendMessage(hAlphaEdit, WMJSETFONT, WPARAM(TheFont), 0); 268: ) Вначале функция берет из перечня имя выбранного в данный момент шрифта'. Для этого она должна сначала найти индекс выбранного элемента, а затем запросить строку, ассоциированную с номером этого элемента. Замечание. Обычно, выбирая элемент из перечня, вы сначала узнаете с помощью сообщения LB_GETCURSEL, какой элемент выбрал пользователь, а затем с помощью сообщения LB_GET- ТЕХТ вибираете строку: int Index = SendMessage(hFontList, LB_GETCURSEL, SendMessage(hFontList, LB_GETTEXT, Index, LPARAM(IpszBuffer)); Сообщение LB_GETCLJRSEL требует, чтобы значения WPARAM и LPARAM функции SendMes- sage были равны нулю. С другой стороны, сообщение LB GETTEXT полагает, что в аргументе WPARAM содержится индекс строки, а в LPARAM — буфер, в котором должна содержаться эта строка. Буфер в LPARAM должен быть достаточно длинным, чтобы вместить строку вместе с оконечным нулем. Если вам нужно получить длину конкретной строки, пошлите сообщение LB_GETTEXTLEN. Естественно, что при первой посылке этого сообщения будет выбран первый элемент перечня. Однако, как показано в следующей главе, в течение жизни программы эта функция вызывается постоянно. В дальнейшем пользователь, скорее всего, выберет не тот элемент, который установ- лен по умолчанию в начале программы. Возврат из EnumFontFamilies Следующий шаг — второй вызов EnumFontFamilies. На этот раз имя шрифта, о котором вы хотите узнать, передается во втором параметре. Почтовый адрес, т.е. обработчик перечисляемых шрифтов, в данном случае называется DescribeFontCallBack: । 311: #pragma argsused 312: int CALLBACK DescribeFontCallBack(LPENUMLOGFONT Ipnlf, 313: LPNEWTEXTMETRIC Ipntm, 314: int FontType, ENUMSTRUCT FAR * IpData) 315: ( 316: SendMessage(lpData->hWindow, WMNEWFONT, 0, LPARAM (Slpnl->elf Log Font)) ; 317: return 1; 318: ) Во время первого обращения к EnumFontFamilies процедура обработчика перечис- ляемых шрифтов вызывалась один раз для каждого элемента системы. Однако на этот раз DescribeFontCallBack вызывается всего однажды. Цель первого набора вызовов заключалась в получении имен всех шрифтов системы. Цель второго вызова состоит в получении детальной информации о конкретном шрифте, указанном во втором пара- метре EnumFontFamilies. Замечание. Очевидно, в этой программе можно было обойтись одним вызовом EnumFontFamilies. Я мог бы за один проход создать связанный список или динамический массив, содержащий всю информацию о каждом шрифте системы. Я предпочел не делать этого по следующим причинам: Я хочу дать вам рабочие примеры, демонстрирующие два различных способа вызова EnumFont- Families. Я не хочу усложнять код и перегружать память введением таких посторонних структур данных, как списки и динамические массивы. Я не хочу дублировать используемые ресурсы. Если информация доступна непосредственно из Windows, зачем программисту держать отдельный список для своей программы? Подобные соображения всегда приходится принимать во внимание, разрабатывая приложения под Windows.
Функция DescribeFontCallBack, к которой обращается EnumFontFamilies, использует процедуру SendMessage, чтобы сообщить главной программе о том, какую информацию она получила. На этот раз посылается сообщение WM_NEWFONT, которое попадает прямо в основное окно, а не в перечень. С сообщением WMNEWFONT передается структура LOGFONT. Заметьте, что размеры шрифта выбираются самой Windows, и программа не пытается их изменить. В WndProc ответ на сообщение WM_NEWF0NT состоит лишь в том, чтобы исполь- зовать LOGFONT д ля создания нового шрифта основного окна. 138: case WM_NEWFONT: 139: ( 140: if (TheFont != 0) 141: DeleteObject(TheFont); 142: TheLogFont = (LPLOGFONT)IParam; 143: TheFont = CreateFontlndirect(TheLogFont); 144: return 1; 145: ) Обратите внимание, что здесь аккуратно удаляется любой уже существующий шрифт. Затем LPARAM приводится к типу LPLOGFONT и вызывается CreateFontlndirect для создания нового шрифта. Собственно шрифт хранится в глобальной переменной. После обработки сообщения из функции SendMessage управление возвращается функции ShowTheFont. Сонет. Воспользуйтесь отладчиком для лучшего уяснения связей, установив точки прерывания на операторах DescribeFontCallBack и case WM NEWFONT, а затем пройдя программу несколько раз для лучшего уяснения связей между этими двумя фрагментами кода. Это квинтэссенция программирования под Windows! Работа с отмечаемыми блоками Теперь, когда в вашем распоряжении имеется копия нового шрифта, покажите его пользователю вместе с соответствующей информацией. Сначала вызывается GetTextMetrics, доставляющая всю информацию о шрифте, включая его тип и начертание. Эта структура передается в HandleMetrics, которая устанавливает отмечаемые блоки в соответствии с полученной информацией: 273: void HandleMetrics(TEXTMETRIC TextMetrics) 274: ( 275: 276: if ((TextMetrics.tmPitchAndFamily & TMPF_TRUETYPE) =-= TMPF_TRUETYPE) 277: SendMessage(Buttonwindows[0], BM_SETCHECK, 1, 0L); 278: else 279: 280: SendMessage(Buttonwindows[0], BM_SETCHECK, 0, 0L); 281: if ((TextMetrics.tmWeight) > 600) 282: SendMessage(Buttonwindows[1], BM_SETCHECK, 1, 0L) 283: else 284: 285: SendMessage(Buttonwindows 11], BM_SETCHECK, 0, 0L) 286: if (TextMetrics.tmltalic) 287: SendMessage(Buttonwindows[2], BM_SETCHECK, 1, 0L); 288: else 289: SendMessage(Buttonwindows[2], BM_SETCHECK, 0, 0L); 290: 291: ) Заметьте, что последний параметр сообщения BM_SETCHECK всегда равен нулю. WPARAM нужно присваивать значение 1, чтобы установить пометку, и нуль, чтобы убрать ее. Еще раз отмечу, что никто не ждет, что вы запомните, как пользоваться сообщением BM_SETCHECK. Важно знать о его существовании и суметь найти инфор- мацию о нем. Конечно, здорово, если вы это сможете запомнить, но не тратьте слишком много времени на все детали. Просто знайте, как отыскать их в справочнике в случае необходимости.
Заключительные вызовы ShowTheFont посылают информацию двум редактируемым полям с помощью сообщения WMJSETTEXT, в последнем параметре которого должен передаваться буфер строки. Передав шрифт в элемент управления, установите его с помощью сообщения WM_SETFONT. Эти два последних вызова SendMessage выполня- ют важное задание, которое вы можете использовать в своих собственных программах. Поэтому вам, видимо, нужно рассмотреть их подробнее. Повторим основные шаги функции ShowTheFont (если это возможно, пройдите их с помощью отладчика): Найти в перечне имя выбранного в данный момент шрифта. И Послать имя шрифта в Windows с помощью EnumFontFamilies. Windows возвращает соответствующую структуру LOGFONT из DescribeFontCallBack. С помощью LOGFONT создать глобальный шрифт. Использовать TEXTMETRIC для выборки нескольких битов детализированной ин- формации для предъявления последней пользователю. Рассмотрим подробнее один из фрагментов этого процесса: FontExp вызывает EnumFontFamilies. EnumFontFamilies вызывает Windows. Windows посылает информацию в процедуру обработчика перечисляемых шрифтов. Процедура обработчика перечисляемых шрифтов посылает сообщение в основное окно. Основное окно создает копию шрифта. Как вы могли увидеть при помощи отладчика, описанная здесь логика радикально отличается от последовательного программирования, характерного для DOS. Сообщения снуют туда-сюда, сегменты данных сшиваются с кодом пролога, а указатель команд прыгает от одной части вашей программы к другой. Это классический пример того, что представляет собой ориентированное на события программирование. Не тратьте время на попытку решить, лучше эта система какой-нибудь другой из знакомых вам или нет. Этот вопрос интересен сам по себе, но не является темой данной книги. Пока сконцентрируйтесь на том, как работает Windows. Это чарующий процесс и он еще не закончен, как вы увидите из следующего раздела. Возврат из ShowTheFont Прежде чем закончить Эту главу, хочу обратить ваше внимание на обработчик сообщения WM_COMMAND, который получает сообщения всякий раз, когда пользо- ватель выбирает очередной элемент перечня. Чтобы исследовать это место с помощью отладчика, поместите точку прерывания на функцию ShowTheFont (строка 219) в FontExp_OnCommand: 211: void FontsExp_OnCoramand(HWND hwnd, int id, HWND hwndCtl, VINT codeNotify) 212: ( 213: char S[500] ; 214: 215: switch (id) 216: ( 217: case ID_LISTBOX: 218: if (codeNotify == LBN_SELCHANGE) 219: ShowTheFont(hwnd); 220: break; 221: 222: case CM_INFO: 223: GetFontString(S, TextMetrics, aTextFace); 224: MessageBox(hwnd, S, "Ihfo", MB_OK); 225: break; 226: ) 227: )
Этот код проверяет, положен ли параметр id равным ID_LISTBOX и указывает ли посланное сообщение на то, что выбор в перечне изменился. Если оба эти условия верны, вызывается ShowTheFont. Функция ShowTheFont знает, как установить элементы управ- ления в окне так, чтобы продемонстрировать пример и описание текущего шрифта. Для Windows характерно сильно облегчать проверку на наличие изменений выбора в перечне. Благодаря Microsoft получение информации о том, что сделал пользователь, как правило, не составляет труда. Однако для Windows типично также затруднять для вас обратную передачу информации пользователю. Windows настолько мощна и разукрашена, что создание эффективного интерфейса подчас может оказаться весьма хитрым делом. Наконец, вы должны заметить, что эта программа вызывает функцию GetFontString. Эта функция отображает на экране дополнительную информацию о текущем шрифте. Я включил ее сюда, поскольку она полезна для пользователя, а также показывает, как просто разделять модуль между двумя различным Windows-программами (см. гл. 9). Резюме Эта глава охватила довольно обширный материал. Вы узнали об осуществлении связи со статическими и редактируемыми полями, перечнями и отмечаемыми блоками. Вы еще раз рассмотрели шрифты и увидели, как получать их в полное распоряжение с помощью EnumFontFamilies и GetTextMetrix. Теперь вы должны почувствовать, что можете абсолютно полностью управлять визуальным отображением текстов. Вы знаете все о LOGFONT, TEXTMETRIC и обработчиках перечисляемых шрифтов функции EnumFontFamilies. Это знание должно помочь вам преподносить текстовую информацию пользователю со всем блеском, какого только можно пожелать. Сознаю, что часть информации об элементах управления свалилась на вас слишком поспешно и неожиданно. Не беспокойтесь, я собираюсь снизить темп. В следующей главе мы снова рассмотрим графические элементы управления и научимся манипули- ровать информацией о каталогах файлов. Вопросы и ответы 1. Я все еще не понимаю функцию EnumFontFamProc? Пожалуйста, объясните ее еще раз. Один из ключевых моментов, которые вам необходимо знать при работе с обработ- чиками перечисляемых объектов, — это то, как установить почтовый ящик, в который попадает информация. Совсем не каждый почтовый ящик подойдет для этой цели. Он должен иметь ряд особых характеристик. Точнее говоря, Windows предполагает, что функция, которая посылает информацию, имеет ряд аргументов конкретного типа. Функция EnumFontFamProc определяет, каковы эти типы, так что вы сможете узнать, как установить почтовый ящик. В действительности обработчик перечисляемых шриф- тов не обязательно должен иметь имя EnumFontFamProc. Вы можете назвать его как угодно. 2. Вы дали мне два длинных списка констант, ассоциированных с перечнем. Я не могу в них разобраться. Что делать? В предыдущей главе я перечислил стили, которые вы можете приписать перечню. Вы можете передать стили перечня (LBS), такие, как LBS_STANDART или LBS MUL- TIPLESEL в функцию CreateWindow, когда потребуется определить конкретный тип перечня. Однако, если вы захотите установить связь с перечнем, воспользуйтесь сооб- щениями, которые перечислены в этой главе: LB_GETSEL, LB_GETTEXT, LB_SETSEL. Очевидно, не стоит запоминать все сообщения, которые можно отправить в элемент управления. Просто нужно помнить, что существует два типа констант, ассоциирован- ных с каждым элементом управления. Константы первого типа помогают определить его стиль и внешний вид. Они используются с CreateWindow. Константы второго типа
помогают взаимодействовать с элементами управления. Эти константы используются SendMessage или PostMessage. 3. Почему второй нараметр функции EnumFontFamilies пуст во время первого вызо- ва и не пуст во время второго? Когда вы вызываете EnumFontFamilies с пустым вторым параметром, эта функция осуществляет полный перебор шрифтов системы, заботясь о создании экземпляра LOGFONT для каждого типа. Когда вы заполняете параметр IpszFamily, Windows ищет информацию о конкретном шрифте. В обоих случаях экземпляры выбираемых шрифтов проектируются Windows. Если хотите, можете изучить фактическую структуру LOG- FONT, которую создает Windows, либо внутри отладчика, либо в программе FontsExp. Вопросы для самопроверки 1. Как вынудить Windows установить фокус на конкретный элемент управления? 2. В чем разница между PostMessage и SendMessage? 3. Как вы думаете, что обозначают буквы ВМ в BM SETCHECK? 4. Как определить, что делать с WPARAM и LPARAM сообщения LB_GETTEXT? 5. Что такое обработчик перечисляемых объектов? 6. Каково назначение кода пролога, созданного MakeProcInstance? 7. Каждому вызову MakeProcInstance должен соответствовать вызов_______? 8. Как создать сообщение с уникальным идентификатором? 9. Если конкретный оконный класс имеет только одно определяемое пользователем сообщение, какое числовое значение обычно ассоциируется с ним? 10. Что произойдет, если вы пошлете сообщение BM_GETCHECK в основное окно программы FontsExp? Упражнения 1. С помощью информации, полученной приложением FontsExp, создайте програм- му, которая пишет на экране две строки: одну с помощью шрифта New Times Roman, а другую с помощью WingDings. 2. Добавьте в программу FontsExp дополнительное статическое поле, которое пока- зывает высоту и вес выбранного в данный момент текста.
День 12 ЭЛЕМЕНТЫ УПРАВЛЕНИЯ И ИНТЕРФЕЙС УПРАВЛЕНИЯ СООБЩЕНИЯМИ Основная цель этой главы состоит в том, чтобы дать вам дополнительные сведения о графических элементах управления. В частности, здесь рассматриваются следующие вопросы: Кнопки-селекторы (radio buttons) и группирующие рамки (group boxes). Код, показывающий, как использовать интерфейс управления сообщениями вместо функции SendMessage. И Код, показывающий, как переключаться между элементами управления. И Код, показывающий, как объединять элементы управления в группы. Код, показывающий, как создавать простую оболочку Windows. Краткое знакомство с сообщением WM PARENTNOTIFY. Демонстрационная программа для этой главы, называемая FileBox, позволяет поль- зователю проверять содержимое подкаталога, изменять подкаталоги и запускать другие протраммы. Она может быть использована в качестве недоразвитого заменителя менед- жера программ. Обсуждение этой программы, как и предыдущей, занимает две главы. День L3 будет посвящен четырем основным темам: И Создание подклассов — прием, позволяющий изменить поведение элемента управ- ления, заданное по умолчанию. Кнопки (push buttons). Использование специальных свойств перечней для управления файлами. Управление размером окна с помощью сообщения WM GETMINMAXINFO. Создание оболочки Windows Разрабатывая программу FileBox, я прежде всего стремился продемонстрировать применение элементов управления. В частности, я хотел показать, как создавать под- классы элементов управления и как использовать разного рода кнопки и некоторые более развитые возможности перечней. Конечно, всегда приятно немного украсить демонстрационные программы, придав им некоторую дополнительную функциональность. В данном случае одна из интерес- нейших черт программы FileBox состоит в том, что ее можно использовать в качестве примитивной замены менеджера программ или другой оболочки Windows вроде Norton Desktop.
Для программистов будет полезно понять точнее, *гго делает менеджер программ. Ведь это их работа — заглядывать под поверхность операционной среды, чтобы понять, как она функционирует на самом деле. Разумеется, покровы таинственности могут быть сняты лишь постепенно, но проникновение за фасад менеджера программ определенно представляется одним из важнейших шагов. На рис. 12.1 показана программа FilcBox в качестве оболочки Windows. Рис. 12.1. Программа FileBox, функционирующая как оболочка Windows Чтобы использовать пршрамму FilcBox в качестве оболочки Windows, откройте файд SYSTEM.INI в подкаталоге Windows и измените строчку shell = progman.exe на следующую: shell — c:\bw\filebox\filebox.exe где c:\bw\filebox — маршрут к вашей копии программы FilcBox. В следующий раз, когда вы запустите Windows, приложение FilcBox появится вместо менеджера программ. Теперь вам нужно поискать в подкаталогах на жестком диске требуемый исполняемый файл и дважды щелкнуть по нему мышью Он стартует, как если бы вы дважды щелкнули на его пиктограмме в менеджере файлов. Замечание. Предполагается, что вы используете версию Win3.1 ни \Vin3 0 для DOS. Программа FileBox, вероятно, не будет работать в Windows NT в качестве замены менеджера программ. Однако вы все-таки сможете запустить ее, как обычное приложение. Возможно, вы заметили, что когда закрывается менеджер программ, он посылает сообщение, требующее закрыть все остальные приложения. Это особенность отсутствует в программе FileBox. Просто я не хочу, чтобы вам приходилось все время покидать Windows при экспериментах с FileBox. Основная цель этой программы — изучить элементы управления. Ес роль как оболочки является второстепенной. Однако, если вы захотите сымитировать поведение менеджера программ во время закрытия, внесите несколько маленьких изменений в обработчик сообщения WM_CLOSE: voxd FileBox—Or.Close (HWND hwnd) 1 11 (MessageBox (hwnd, "Exit Windows?", "FilcBox", MB_ICONQUESTION 1 HBOKCANCEL) = IDOK) i if tExitWlndov.s (C, 0) ) DestroyWindow(hwnd); > > Весь фокус заключается в обращении к Exit Windows.
Функция ExitWindows BOOL ExitWindows (DWORD, UINT) Функция ExitWindow используется для закрытия операционной среды Windows. Она имеет два параметра: DWORD dwReturnCode; UINT reserved; Этот же вызов можно использовать для повторного старта Windows или для перезагрузки DOS с последующим рестартом Windows. Такая возможность используется программистами для измене- ния среды, после того как пользователь модифицировал драйверы или другие части системы. Для этого передайте в первом параметре ExitWindows одну из следующих констант: ew_rebootsystem Закончить выполнение системы и рестартовать EW_RESTSRTWINDOWS Закончить выполнение Windows и рестартовать Пример: if (ExitWindows(Ог 0)) DestroyWindow(hwnd); Перед тем как перейти к исходному коду программы FileBox, я хотел бы заметить, что она немного похожа на первую версию программы Snake, так как разработана с целью подстегнуть ваш интерес. Однако ее возможности весьма ограничены, и, если вы собираетесь создать добротную оболочку для Windows, начните с FileBox. Нет лучшего способа научиться программировать, чем написать и реализовать свою собственную программу. Исходный код Теперь, после того как все предварительные мероприятия позади, можно со спокой- ной душой порадоваться приводимому ниже исходному тексту небольшой программки, которая делает что-то, по крайне мере, потенциально полезное. Листинг 12.1. FILEBOX.CPP 1: ///////////////////////////////////////////////// 2: // Программа: FILEBOX.CPP 3: // Автор: Чарли Калверт 4: // описание: 5: // Дата: 06/28/93 6: ///////////////////////////////////////////////// 7: 8: «define STRICT 9: «include <windows.h> 10: «include <windowsx.h> 11: «pragma warning (disable: 4068) 12: «pragma hdrstop 13: «include <direct.h> 14: «include <string.h> 15: «include "filebox.h" 16: // ================================================ 17; // Интерфейс 18: // ================================================ 19: 20: // Переменные 21: static char szAppName(] = "FileBox"; 22: static HWND MainWindow; 23: static HINSTANCE hlnstance; 24: 25: char *ButtonText[] 3 {"SDrives", "SDirectories", "SFiles"); 26: char *BmpName[] = {"DRIVES", "DIRS", "FILES"); 27: WORD DirShowValf] = (DDL_DRIVES ) DDL_EXCLUSIVE, DDL_DIRECTORY 28: I DDL_EXCLUSIVE, DDL_ARCHIVE}; 29: HWND hControl[8];
30: HBITMAP Bmp[3); 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 5В: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: 85: 86: 87: 88: 89: 90: 91: 92: 93: 94: 95: 96: 97: 98: 99: 100: 101: 102: 103: 104: HWND PathWin; FARPROC IpfnNewEditProc; char FilesWildCard[100]; // —================—============================= // Инициализация // ===========— ============================= ////////////////////////////////////////////////////// // Точка входа ////////////////////////////////////////////////////// ♦(pragma argsused int PASCAL WinMain(HINSTANCE hinst, HINSTANCE hPrevInstance, LPSTR IpszCmdParam, int nCmdShow) ( MSG Msg; if (!hPrevInstance) if ('Register(hinst)} return FALSE; SetMessageQueue(20) ; if (!(MainWindow = Create(hinst, nCmdShow)}} return FALSE; while (GetMessage(SMsg, NULL, 0, 0)) ( if (!IsDialogMessage(MainWindow, SMsg}} ( TranslateMessage(SMsg); DispatchMessage(SMsg); } } return Msg.wParam; } ////////////////////////////////////// // Регистрация окна ////////////////////////////////////// BOOL Register(HINSTANCE hinst) ( WNDCLASS WndClass; WndClass. style = CS_HREDRAW 1 CS_VREDRAW; WndClass.IpfnWndProc = WndProc; WndClass.cbClsExtra - 0; WndClass.cbWndExtra = 0; WndClass.hlnstance = hinst; WndClass. hlcon = Loadicon (NULL, IDI_APPLICATION) ; WndClass.hCursor = Loadcursor(NULL, IDC_ARROW); WndClass.hbrBackground = GetStockBrush(WHITE_BRUSH); WndClass. IpszMenuName = NULL; WndClass. IpszClassName = szAppName; return Registerclass (SWndClass); ) /III III III IIIП////////////////////III//III III III//// // Создание окна ///////////////////////////////////////////////////// HWND Create(HINSTANCE hinst, int nCmdShow) ( hlnstance = hinst; HWND hwnd = CreateWindow(szAppName, szAppName, WS_OVERLAPPED I WS_CAPTION I WS_SYSMENU | WS_MINIMIZEBOX | WS_THICKFRAME, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, NULL, NULL, hinst, NULL);
105: if (hwnd == NULL) 106: return hwnd; 107: 108: Showwindow(hwnd, nCmdShow); 109: UpdateWindow(hwnd); 110: 111: return hwnd ; 112: } 113: 114: // =========-----------------=====-----======------===== 115: // Реализация 116: //------======----==========================-------===== 117: 118: //////////////////////////////////////////////////////////// 119: // Оконная процедура 120: //////////////////////////////////////////////////////////// 121: LRESULT CALLBACK export WndProc (HWND hwnd, UINT Message, 122: WPARAM wParam, LPARAM IParam) 123: ( 124: switch(Message) 125: ( 126: HANDLE_MSG (hwnd, WM_CREATE, CopyAll_OnCreate) ; 127: HANDLE_MSG (hwnd, WM_DESTROY, FileBox_OnDestroy); 128: HANDLE_MSG (hwnd, WM_CLOSE, FileBox_OnClose); 129: HANDLE_MSG (hwnd, WM_COMMAND, FileBox_OnCommand); 130: HANDLE_MSG (hwnd, WM_GETMINMAXINFO, FileBoxJDnGetMinMaxInfo) ; 131: HANDLE_MSG(hwnd, WM_PAINT, FileBox_OnPaint); 132: HANDLE_MSG (hwnd, WM_PARENTNOTIFY, FileBox_OnParentNotify); 133: HANDLE_MSG (hwnd, WM_RBUTTONDOWN, FileBox_OnRButtonDown); 134: default: 135: return FileBox_DefProc(hwnd, Message, wParam, IParam); 136: ) 137: ) 138: 139: /////////////////////////////////////////////////////// 140: // Замена оконной процедуры 141: /////////////////////////////////////////////////////// 142: void MakeCallBackProcs() 143: ( 144: IpfnNewEditProc - 145: MakeProcInstance(FARPROC(NewEditProc), hlnstance); 146: 147: OldEditProc = (WNDPROC)SetWindowLong(hControl[IDJEDIT], 148: GWL_WNDPROC, LONG(IpfnNewEditProc)); 149: ) 150: 151: ////////////////////////////////////////////////////// 152: // Обработка сообщения WM_Create 153: ////////////////////////////////////////////////////// 154: ffpragma argsused 155: BOOL CopyAll_OnCreate (HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) 156: ( 157: 158: for (int i = 0; i < 3; i++) 159: ( 160: Bmp[i] = LoadBitmap(hlnstance, BmpName[i]}; 161: if ( !Bmp[i] ) 162: ( 163: MessageBox(hwnd, "No Bitmap", "Fatal Error", MB_OK); 164: return FALSE; 165: } 166: } 167: 168: hControl[ID_FILELIST] = CreateWindow("listbox", NULL, 169: WS_CHILD I WS_VISIBLE I 170: LBS_STANDARD I WS_TABSTOP, 171: 15, 30, 220, 180, hwnd, HMENU(ID_FILELIST), 172: hlnstance, NULL); 173: 174: hControl[ID_GROUP] = CreateWindow("button", "Mode", 175: WS_CHILD I WS_VISIBLE I BS_GROUPBOX, 176: 250, 2, 131, 122, hwnd, HMENU(ID_GR0UP), 177: hlnstance, NULL); 178: 179:
180: hControl [ID_DRIVES] = CreateWindow("button". 181: 182: 183: 184: 185: 186: 187: 188: 189: 190: 191: 192: 193: 194: 195: 196: 197: 198: 199: 200: 201: 202: 203: 204: 205: 206: 207: 208: 209: 210: 211: 212: 213: 214: 215: 216: 217: 218: 219: 220 221: 222: 223: 224: 225; 226: 227: 228: 229: 230: 231: 232: 233: 234: 2.35: 236: 237: 238: 239: 240: 241: 242: 243: 244: 245: 246: 247: ButtonText[ID_DRIVES], WS_CHILD | WS_V1SIBLE I BS AUTORADIOBUTTON WS TABSTOP I WS GROUP, 270, 25 + (0 * 30}, 95, 30, hwnd, HMENU (ID_DRIVES + 100}, hlnstance, NULL}; for (i = 1,- i < 3; i++} hControlfi] = CreateWindow("button", ButtonText[i], WS CHILD 1 WS VISIBLE | BS AUTORADIOBUTTON, 270, 25 + (i * 30}, 95, 30, hwnd, HMENUfi + 100}, hlnstance, NULL}; hControl(ID_EDIT] = CreateWindow("edit", "*.exe", WS_CHILD | WS_VISIBLE I WS_BORDER| WSTABSTOP I WS_GROUP, 250, 130, 131, 25, hwnd, HMENU (ID_EDIT}, hlnstance, NULL}; hControl[ID_CLOSE] “ CreateWindow("button", "Close", WS_CHILD I WS_VISIBLE 1 BS_PUSHBUTTON | WS TABSTOP I WS_GROUP, 250, 161, 131, 45, hwnd, HMENU(ID_CLOSE}, hlnstance, NULL}; PathWin = CreateWindow("static", NULL, WS CHILD | WS VISIBLE I WS BORDER, 14, 10, 222, 20, hwnd, HMENU (ID_PATHS), hlnstance, NULL); DlgDirList(hwnd, ID_FILELIST, ID_PATHS, DirShowVal[DirShowType]}; MakeCallBackProcs (}; Button Setcheck(hControl[0], TRUE}; SetFocus(hControl(ID_FILELIST]}; strepy(FilesWildCard, "*.exe"}; return TRUE; } //////////////////////////////////////////////////// // Обработка сообщения WM DESTROY /////////////////////////7////////////////////////// #pragma argsused void FileBox OnDestroy(HWND hwnd) ( for (int i = 0; i < 3; i++} DeleteBitmap(Bmp[i]}; SetWindowLong(hControl[ID_EDIT], GWL_WNDPROC, LONG(OldEditProc)}; FreeProcInstance(IpfnNewEditProc); PostQuitMessage (0}; } /////////////////////////////////////// // Обработка сообщения WM CLOSE /////////////////////////7///////////// void FileBox OnClose(HWND hwnd} ( if (MessageBox(hwnd, "Do you want to exit?", “FileBox", MB_I CONQUESTION | MB_OKCANCEL} == IDOK} DestroyWindow(hwnd); } 248: ///////////////////////////////////////// 249: // SetListbox 250: ///////////////////////////////////////// 251: #pragma argsused 252: void SetListbox(HWND hwnd} 253: ( 254: RECT R ;
255: char Wildcard[150]; 256: 257: if (DirShowType == FILEMODE} 258: strcpy(Wildcard, FilesWildCard}; 259: else 260: strcpy (Wildcard , "*.*"}; 261: 262: ListBox_ResetContent(hControl[ID_FILELIST]}; 263: ListBox_Dir(hControl[ID_FILELIST], DirShowVal[DirShowType], 264: Wildcard}; 265: 266: R.left = 14; 267: R.top = 220; 268: R.right ’ 14 t BMPX; 269: p.bottom = 220 + BMPY; 270: InvalidateRect(hwnd, SR, FALSE); 271: ) 272: 273: 274: ////////////////////////////////////////////////////////////////// 275: // Обработка щелчков мышью на перечне для смены дисков и каталогов 276: ////////////////////////////////////////////////////////////////// 277: #pragma argsused 278: void HandleMouseClick(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify} 279: ( 280: char Buffer[100]; 281: 282: DlgDirSelect(hwnd, Buffer, ID_FILELIST]; 283: DlgDirList(hwnd. Buffer, IDFILELIST, ID_PATHS, 284: DirShowVal[DirShowType]); 285: } 286: 287: 288: /////////////////////////////////////////////////////// 289: // Обработка сообщения WM COMMAND 290: /////////////////////////7///////////////////////////// 291: Spragma argsused 292: void FileBox OnCommand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify) 293: ( 294: char S(150], IpszBuffer[150); 295: 296: switch(id] 297: ( 298: case ID_DRIVES + 100: 299: DirShowType = DRIVEMODE; 300: SetListbox(hwnd); 301: break; 302: 303: case IDJDIRS + 100: 304: DirShowType = DIRMODE; 305: SetListbox(hwnd); 306: break; 307: 308: case ID_FILES + 100: 309: DirShowType = FILEMODE; 310: SetListbox(hwnd); 311: break; 312: 313: case ID_FILELIST: 314: if (codeNotify =“ LBN_DBLCLK) 315: ( 316: if (DirShowType != FILEMODE) 317: HandleMouseClick(hwnd, id, hwndCtl, codeNotify}; 318: else 319: ( 320: int index = ListBox_GetCurSel(hControl[ID_FILELIST]}; 321: _getdcwd(0, S, 125}; 322: ListBox_GetText(hControl[ID_FILELIST], index, 323: IpszBuffer}; 324: strcat(S, "\\"}; 325: strcat(S, IpszBuffer}; 326: WinExec(S, SWJSHOWNORMAL]; 327: ) 328: } 329: break;
330: 331: case ID_CLOSE: 332: SendMessage(hwnd, WMCLOSE, 0, 0); 333: break; 334: } 335: ) 336: 337: ////////////////////////////////////// 336: // Обработка сообщения WM GetMinMaxInfo 339: /////////////////////////7//////////// 340: #pragma argsused 341: void FileBox_OnGetMinMaxInfo (HWND hwnd, MINMAXINFO FAR* IpMinMaxInfo) 342: ( 343: lpMinMaxInfo->ptMaxSize.x = XSIZE; 34 4: lpMinMaxInfo->ptMaxSize.y = YSIZE; 345: lpMinMaxInfo->ptMaxPosition.x = 100; 346: lpMinMaxInfo->ptMaxPosition.у = 100; 347: lpMinMaxInfo->ptMinTrackSize.x = XSIZE; 346: lpMinMaxInfo~>ptMinTrackSize.y = YSIZE; 349: lpMinMaxInfo->ptMaxTrackSize.x = XSIZE; 350: lpMinMaxInfo->ptMaxTrackSize. у = YSIZE; 351: } 352: 353: void HandleRightButton(HWND hwnd} 354: ( 355: switch(DirShowType) 356: ( 357: case DRIVEMODE: 358: Button_SetChec k(hControl[ 1 ], TRUE}; 359: ButtonSetCheck(hControl[0], FALSE); 360: Button_SetCheck(hControl[2], FALSE}; 361: DirShowType = DIRMODE; 362: break; 363: 364: case DIRMODE: 365: Button_SetCheck(hControl[2], TRUE); 366: Button_SetCheck(hControl[0], FALSE}; 367: Button_SetCheck(hControl[1], FALSE}; 368: DirShowType = FILEMODE; 369: break; 370: 371: default: 372: Button_SetCheck(hControl[0], TRUE); 373: Button_SetCheck(hControl[l], FALSE); 374: ButtonSetCheck(hControl[2], FALSE}; 375: DirShowType = DRIVEMODE; 376: } 377: SetListbox(hwnd}; 378: ) 379: 380: /////////////////////////////////////////// 381: // обработка сообщения WM_PAINT 382: /////////////////////////////////////////// 383: void FileBox_onPaint(HWND hwnd} 384: ( 385: PAINTSTRUCT PaintStruct; 386: HBITMAP OldBmp; 387: 388: HDC PaintDC = BeginPaint(hwnd, SPaintStruct); 389: HDC BltDC = CreateCompatibleDC(PaintDC); 390: 391: OldBmp — SelectBitmap(BltDC, Bmp[DirShowType]} ; 392: BitBlt (PaintDC, 14, 220, BMPX, BMPY, BltDC, 0, 0, SRCCOPY}; 393: 394: SelectBitmap(BltDC, OldBmp); 395: DeleteDC(BltDC); 396: EndPaint(hwnd, SPaintStruct); 397: ); 398: 399: ///////////////////////////////////////// 400: // Обработка сообщения WM PARENTNOTIFY 401: ////////////////7/Z//////7/////////////// 402: #pragma argsused 403: void FileBoxOnParentNotify(HWND hwnd, UINT msg, 404: HWND hwndChild, int idChild)
405: { 406: if (msg == WM_RBUTTONDOWN) 407: HandleRightButton(hwnd); 408: ) 409: 410: //////////////////////////////////////// 411: // Обработка сообщения WM RBUTTONDOWN 412: /////////////////////////7////////////// 413: #pragma argsused 414: void FileBox_OnRButtonDown(HWND hwnd, BOOL fDoubleClick, 415: int x, int y, UINT keyFlags) 416: ( 417: HandleRightButton(hwnd); 418: ) 419: 420: // =================================== 421: // Оконные процедуры подклассов 422: // =================================== 423: 424: void SetNewWildCard(HWND hwnd) 425: ( 426: char Buffer[150]; 427: 428: GetWindowText(hwnd, Buffer, sizeof(Buffer)); 429: strepy(FilesWildCard, Buffer); 430: if (DirShowType == FILEMODE) 431: SetListbox(MainWindow); 432: ) 433: 434: ////////////////////////////////////////////////// 435: // Новая оконная процедура для редактируемого поля 436: ////////////////////////////////////////////////// 437: LRESULT CALLBACK NewEditProc(HWND hwnd, UINT Message, 438: WPARAM wParam, LPARAM IParam) 439: ( 440: switch(Message) 441: ( 442: case WM_GETDLGCODE: 443: return DLGC_WANTALLKEYS; 444: 445: case WM_KEYDOWN: 446: switch (wParam) 447: { 448: case VK_RETURN: 449: SetNewWildCard(hwnd); 450: SetFocus(hControl[ID_CLOSE]); 451: break; 452: 453: case VK_TAB: 454: int State = GetKeyState(VK_SHIFT); 455: if (State » 8) 456: SetFocus(hControl[DirShowType]); 457: else 458: SetFocus(hControl[ID_CLOSE]); 459: break; 460: ) 461: 462: break; 463: 4 64: case WM_KILLFOCUS: 465: SetNewWildCard(hwnd); 466: break; 467: 468: case WM_SETFOCUS: 469: Edit_SetSel(hwnd, 0, -1); 470: break; 471: ) 472: 473: return 474: CallWindowProc(01dEditProc, hwnd. Message, wParam, IParam); 475: )
Листинг 12.2. FILEBOX.H 1: ///////////////////////////////////////////////// 2: // Модуль: FILEBOX.H 3: // Автор: Чарли Калверт 4: // Дата: 06/25/93 5: ///////////////////////////////////////////////// 6: 7: // Константы 8: «define ID_DRIVES 0 9: «define ID_DIRS 1 10: «define ID_FILES 2 11: «define ID_CLOSE 3 12: «define ID_FILELIST 4 13: «define ID_GROUP 5 14: «define ID_EDIT 6 15: «define ID_PATHS 7 16: 17: «define BMPX 365 18: «define BMPY 100 19: 20: «define XSIZE 403 21: «define YSIZE 360 22: 23: // Типы 24: enum TCurMode {DRIVEMODE, DIRMODE, FILEMODE); 25: 26: // Объявления для класса FileBox 27: «define FileBox_DefProc DefWindowProc 28: BOOL CopyAll_OnCreate(HWND hwnd, 29: CREATESTRUCT FAR* IpCreateStruct),- 30: void FileBox_OnDestroy(HWND hwnd); 31: void FileBoX—OnClose(HWND hwnd); 32: void FileBox_OnCommand(HWND hwnd, int id, 33: HWND hwndCtl, UINT codeNotify); 34: void FileBox_OnGetMinMaxInfo(HWND hwnd, 35: MINMAXINFO FAR* IpMinMaxInfo) ; 36: void FileBox_OnPaint(HWND hwnd); 37: void FileBox_OnParentNotify(HWND hwnd, UINT msg, 38: HWND hwndChild, int idChild); 39: void FileBox_OnRButtonDown(HWND hwnd, BOOL fDoubleClick, 40: int x, int y, UINT keyFlags); 41: 42: // Функции 43: LRESULT CALLBACK _export WndProc(HWND hwindow, UINT Message, 44: WPARAM wParam, LPARAM IParam); 45: LRESULT CALLBACK _export NewEditProc(HWND hwindow, UINT Message, 46: WPARAM wParam, LPARAM IParam); 47: void HandleRightButton(HWND hwnd); 48: BOOL Register(HINSTANCE hinst); 49: HWND Create(HINSTANCE hinst, int nCmdShow); 50: TCurMode DirShowType; 51: WNDPROC OldEditProc; Листинг 12.3. FILEBOX.RC 1: DRIVES BITMAP "DRIVE.BMP" 2: FILES BITMAP "FILES.BMP" 3: DIRS BITMAP "DIRS.BMP" Листинг 12.4. FILEBOX.DEF 1: ; FILEBOX.DEF 2: 3: NAME FileBox 4: DESCRIPTION 'FileBox Window' 5: EXETYPE WINDOWS 6: STUB 'WINSTUB.EXE' 7: HEAPSIZ-E 4096 8: STACKSIZE 5120 9: CODE PRELOAD MOVEABLE DISCARDABLE 10: DATA PRELOAD MOVEABLE MULTIPLE
Листинг 12.5. FILEBOX.MAK (Borland) 1: # =================== 2: # FILEBOX.MAK 3: # --=================== 4: 5: # макросы 6: APPNAME = FileBox 7: INCPATH = C:\BC\INCLUDE 8: LIBPATH = C:\BC\LIB 9: FLAGS = -H -ml -W -V -w4 -1$ (INCPATH) -L$ (LIBPATH) 10: 11: # компоновка 12: $(APPNAME).exe: $(APPNAME).obj $(APPNAME).def $(APPNAME).res 13: bcc $ (FLAGS) $ (APPNAME) .obj 14: rc $ (APPNAME) .res 15: 16: # компиляция 17 : S (APPNAME) . obj : $ (APPNAME) . cpp 18: bcc -C $(FLAGS) $(APPNAME).cpp 19: 20: # ресурсы 21: $ (APPNAME) .res: $ (APPNAME) .rc 22: rc -r -i$ (INCPATH) $ (APPNAME) .rc Листинг 12.6. FILEBOX.MAK (Microsoft) 1: # ================== 2: # FILEBOX.MAK 3: # ================== 4: 5: # макросы 6: APPNAME = FileBox 7: LINKFLAGS = /align:16, NUL, /nod slibcew libw 8: FLAGS = -c -AL -GA -Ow -W3 -Zp 9: 10: # ================== 11: # компоновка 12: # =================== 13: $ (APPNAME) .exe : $ (APPNAME) .obj S (APPNAME) .def $ (APPNAME) .res 14: link $ (APPNAME), $ (LINKFLAGS) , $ (APPNAME) 15: rc $(APPNAME).res 16: 17: # =================== 18: # компиляция 19: # =================== 20: $(APPNAME).obj : $(APPNAME).cpp 21: cl $(FLAGS) $(APPNAME).cpp 22: 23: # ============== 24: # ресурсы 25: # =================== 26: S(APPNAME).res: $(APPNAME).rc 27: rc —r $(APPNAME)-rc В программе FileBox использовались следующие растровые изображения: DRIVES.BMP, FILES.BMP и DIRECTORIES.BMP При запуске этой программы на экране появляется картинка, изображенная на рис. 12.2. В правом верхнем углу окна, внутри группирующей рамки размещены три кноп- ки-селектора. Выбор мышью одной из этих кнопок, влечет за собой отображение на экране дисков, каталогов или файлов соответственно. Можно переключать эти режимы, щелкая правой кнопкой мыши в любой части окна. Если опция Files не выбрана, то можно просматривать текущие доступные диски и каталоги с помощью левой кнопки мыши. Старт исполняемого файла осуществляется с помощью двойного щелчка. Теку- щий выбранный режим высвечивается в нижней части экрана большими буквами. Редактируемое поле в середине правой части окна позволяет указывать новую маску файлов. Введите любое значение, а затем нажмите Enter или Tab и увидите новый перечень файлов.
Гис. 12.2. Программа FileBox показывает содержимое подкаталога Обсуждение этой программы лучше всего начать с рассмотрения использования в ней интерфейса управления сообщениями (message control API). Интерфейс управления сообщениями — это набор макросов из WINDOWSX, которые можно использовать вместо SendMessage и PostMcssagc. Эти макросы распространяются по программе, упрощая се понимание и поддержку. Интерфейсы SendMessage и 1’ostMcssage для элементов управления, которые вы видели в последних двух главах, требуют массы пояснений. Они очень громоздкие и вынуждают пользователя выполнять ряд неудобных приведений типов. Замечание. Другими альтернативами для интерфейса SendMessage являются такие объектно-ори- ентировагппяе структуры, как Borland's Object Windows Library (OWL) и Microsoft’s Foundation Classes (MFC) Эти обширные программные базы порой могут быть вполне элегантными и уже наверняка приобрели многих умных и красноречивых приверженцев. Объектно-ориентированное программирование, несомненно, имеет ряд преимуществ, но не всегда хорошо сочетается с Windows. Проблема состоит в том, что интерфейс прикладного программирования Windows — это процедурная программная база. Он не является объектпо- ориентированным в строгом смысле слова В результате две парадигмы оказываются несовмес- тимыми в определенных ключевых точках. Широко пользуясь библиотекой OWL, я пришел к выводу, что ее преимущество невозможно использовать должным образом, не поняв сначала в совершенстве API. Иными словами, хорошие объектно-ориеггтированные программисты по определению должны иметь глубокое знание материала. представленного в этой книге. MFC и OWL — полезные средства, но вы нс сможете по-настоящему понять их, пока досконально не изучите интерфейс прикладного программиро- вания, на котором они основывающей. Вы уже видели, как использовать WINDOWSX для упорядочивания операторов ease, разбросанных в оконных процедурах. Интерфейс управления сообщениями служит для аналогичных целей. Например, строчка SendMessage (hwr.dctl, LB_ADDSTRING, О, (LPARAM) IpszBuffer) ; может быть значительно упрощена с помощью интерфейса управления сообщениями- ListBox_AddString(hwndCtl, IpszBuffer);
Замечание. Интерфейса управления сообщениями нет в интерактивных файлах помощи компи- ляторов Borland и Microsoft. Можно предложить три решения: — распечатать WINDOWSX.H и держать его поблизости; — воспользоваться аннотацией в интерактивной системы помощи для добавления этого листинга в HLP-файл (см. рис. 12.3); — создать свой собственный файл помощи по WINDOWSX Annotate Annotation: Bullon_SelCheck(HWND, TRUE) l±j WindowsX macro wants an Г HWND and either 0,1 or 2 in the H second parameter. The value 2 represents an indeterminate state. Zero turns radiobutton off, one turns it on.| Рис. 12.3. Аннотация к интерактивной документации по WINDOWSX Вообще говоря, интерфейс управления сообщениями составляет блестящую альтер- нативу интерфейсу SendMessage. Он значительно проще в использовании и, кроме того, может работать с директивой STRICT компилятора, используя всю мощь проверки типов. Это позволит создавать хорошие, понятные программы. В отличие от SendMessage интерфейс управления сообщениями абсолютно совместим с Win32. Это серьезное преимущество. В наши дни наиболее опытные программисты стараются найти способы, облегчающие перенос их программ. Прежде чем начать заниматься вплотную использованием интерфейса управления сообщениями в FILEBOX.CPP, я объясню вам общую структуру программы. Но не волнуйтесь, обращения к интерфейсу управления сообщениями будут встречаться в этой и следующей главах, и я буду обсуждать каждое из них по очереди. Создание кнопок-селекторов Обработчик сообщения WMCREATE приложения FileBox довольно сильно напо- минает своего “визави” в программе FontsExp. Его основная задача — создавать графические элементы управления, взаимодействующие с пользователем в течение всей жизни программы. Наиболее важными из этих элементов управления являются три кнопки-селектора, объединенных группирующей рамкой. Ниже следует описание того, как они работают. Вы должны уловить следующие основные моменты: И кнопки-селекторы, и группирующие рамки принадлежат к классу кнопок. Ключом к их созданию является назначение им правильного стиля, такого, как BS_RA- DIOBUTTON и BSGROUPBOX. Стиль BSAUTORADIOBUTTON позволяет кнопкам-селекторам автоматически об- рабатывать щелчки мыши. Кнопки-селекторы должны упорядочиваться под эгидой группирующей рамки. Чтобы гарантировать возможность выбора только одного элемента внутри группы за один раз, следует использовать стиль WSGROUP. Группирующая рамка — это преимущественно визуальное средство. Действия раз- мещенных в ней элементов управления определяются стилями WS GROUP и WS TABSTOP и не зависят от существования группирующей рамки как таковой.
Пользователи должны быть в состоянии переключаться между элементами управле- ния в окне. Функция IsDialogMessage предоставляет такую возможность, требуя лишь минимального участия с вашей стороны. Кнопки-селекторы (показанные на рис. 12.4) позволяют пользователю выбрать одну из нескольких взаимоисключающих опций. Например, можно выбрать диски, каталоги или файлы. Однако нельзя выбрать две опции одновременно, например, диски и каталоги. Не удастся выбрать и все три сразу. " Mode О Drives О Directories ®iHiesi ______„I Рис. 12.4. Кнопки-селекторы в программе FileBox взаимоисключающие, т.е. можно выбрать лишь одну из них В следующих двух главах я буду говорить об этих взаимоисключающих опциях как о различных режимах. Иначе говоря, пользователь может находиться в режиме файлов, каталогов или дисков. Находясь в режиме файлов, можно оперировать файлами, в режиме дисков — дисками и т.д. Группирующая рамка объединяет набор кнопок-селекторов в единый модуль. Иногда требуется иметь на экране несколько групп, каждая из которых содержит набор взаимо- исключающих опций. Пользователь может выбрать одну из опций в каждой труппе. Замечание. Когда вы программируете диалоговые панели, Windows предусматривает встроенное поведение, помогающее следовать определенным правилам. Однако внутри окна вам потребуется вызвать функцию IsDialogMessage, гарантирующую, что кнопки-селекторы и другие элементы управления будут реагировать на нажатие клавиш так, как ожидает пользователь. Впрочем, встроенное поведение мыши остается неизменным независимо от того, находитесь ли вы внутри окна или в диалоговой панели. Я решил взяться за IsDialogMessage, WS_TABSTOP и за переключение между элементами управления в следующем разделе. Мы рассмотрим эту тему отдельно, чтобы вы лучше поняли ее важность. Следующий фрагмент исходного кода создает кнопки-селекторы и объединяет их группирующей рамкой: 174: hControl[ID_GROUP] = CreateWindow("button", "Mode", 175: WS_CHILD 1 WS_VISIBLE I BS_GROUPBOX, 176: 250, 2, 131, 122, hwnd, HMENU (IDJGROUP), 177: hlnstance, NULL); 178: 179: 180: hControl[ID_DRIVES] = CreateWindow("button". 181: ButtonText[ID_DRIVES], 182: WS_CHILD 1 WS_VISIBLE I BS_AUTORADIOBUTTON 183: WS TABSTOP 1 WS GROUP, 184: 270, 25 + (0 * 30), 95, 30, hwnd. 185: HMENU(ID_DRIVES + 100), hlnstance, NULL); 186: 187: for (i = 1; i < 3; i++) 188: hControl [i] = CreateWindow("button", ButtonText[i], 189: WS CHILD I WS VISIBLE | BS AUTORADIOBUTTON, 190: 270, 25 + (i * 30), 95, 30, hwnd. 191: HMENUfi + 100), hlnstance, NULL); Как видите, кнопки-селекторы принадлежат к классу “button”. Чтобы отличить один тип кнопки от другого, FileBox помещает в стилевой параметр функции CreateWindow соответствующие константы, такие, как BS_AUTORADIOBUTTON или BS_RA- DIOBUTTON, соединенные логическим ИЛИ.
В отличие от BSJRADIOBUTTON, стиль BSAIJTORADIOBUTTON автоматически реагирует на щелчок, включая выбранную кнопку, а также сбрасывая все прочие кноп- ки-селекторы в текущей группе. Из основного листинга программы FileBox видно, что и первая кнопка-селектор, и кнопка Close использует стиль WS GROUP. Данный стиль информирует Windows о том, что этот и следующие за ним элементы управления должны рассматриваться как группа. Конец группы отмечается еще одним элементом управления, использующим стиль WS_GROUP. В частности, три кнопки-селектора рассматриваются как одна группа, а следующая группа начинается с кнопки, помеченной “Close”. Это происходит потому, что первая кнопка-селектор и кнопка, помеченная “Close”, имеют стиль WS_GROUP. Поведение конкретной группы характеризуется следующими двумя моментами: 1. За один раз из группы может быть выбрана только одна кнопка-селектор. 2. Вы можете перейти из одной группы в другую сразу, не проходя последовательно по всем кнопкам группы. Заметьте, что группирующая рамка, содержащая кнопки-селекторы, также принад- лежит к классу “button”. Этот факт может смутить, поскольку рамка совсем не похожа на кнопку. Задача группирующих рамок — просто объединять элементы управления в логические группы с тем, чтобы пользователь мог визуально определить их назначение. Поскольку группирующие рамки служат исключительно для наглядности, не следует искать в них сложностей, присущих другим компонентам Windows. Они не имеют никакой другой цели, кроме информирования пользователя о том, какие элементы управления следует рассматривать как группу. Теперь пора перейти к описанию функции IsDialogMessage и ее связи со стилями WS_GROUP и WS_TABSTOP. IsDialogMessage и переключение между управляющими элементами В предыдущем разделе вы узнали о важности объединения элементов управления в группы. Это простое действие здорово облегчает жизнь пользователю. Когда он захочет выбрать конкретную опцию, ему не потребуется сначала включить одну кнопку-селек- тор, а затем возвратиться и выключить другую. Кнопки работают вместе просто и логично. До сих пор предполагалось, что вы работаете главным образом мышью. Однако для пользователя желательно также иметь возможность перемещаться по окну с помощью клавиатуры. К сожалению, Windows устроена так, что поддерживает клавиатуру только во время работы с диалоговыми панелями, но не с окнами. Чтобы исправить положение, требуется изменить цикл обработки сообщений для всей программы. В частности, вам требуется добавить вызов IsDialogMessage: 58: while (GetMessage(SMsg, NULL, 0, 0)) 59: ( 60: if (! IsDialogMessage (MainWindow, SMsg)) 61: ( 62: TranslateMessage (SMsg) ,- 63: DispatchMessage(SMsg) ; 64: ) 65: ) 66: return Msg.wParam; 67: ) Сравните данный код co стандартным циклом обработки сообщений предыдущих программ этой книги: while (GetMessage(SMsg, NULL, 0, 0)) ( TranslateMessage(SMsg); DispatchMessage(SMsg); )
Программа FileBox устроена таким образом, что любое посланное ей диалоговое сообщение будет обработано отдельно, а не передано в TranslateMessage и DispatchMessage. Термин “диалоговое сообщение” — просто более благозвучный вариант термина “сообщение клавиатуры”. Функция IsDialogMessage контролирует каждое нажатие поль- зователем клавиши и обрабатывает их отдельно. В результате вы можете переключаться между элементами управления посредством клавиши Tab и выбирать кнопки-селекторы с помощью клавиш-стрелок. И последнее, что осталось разобрать, — стиль WS TABSTOP. Присвоение элементу управления этого стиля информирует Windows о том, что пользователь хочет иметь возможность перехода к данному элементу. В равной степени важно знать, когда следует опускать этот стиль, поскольку бывают такие управляющие элементы, переключение на которые нежелательно. В частности, этот стиль следует употреблять только с первым элементом управления группы кнопок-селекторов. Помните, что функция IsDialogMessage бесполезна, если вы забудете употребить с элементами управления подходящие стили. IsDialogMessage, WSJTABSTOP и WSGROUP должны работать вместе, чтобы обеспечить пользователю доступ к вашему программному интерфейсу. Нельзя недооценивать крайней важности функции IsDialogMessage. Ее вызов открывает для вашей программы массу возможностей, требуя лишь минимальной работы с вашей стороны. Она может показаться не такой уж важной на первый взгляд, но придет время, когда вы ощутите ее насущную необходимость. Не забывайте о ней! Любой элемент управления, на который вы хотите переключиться, должен иметь стиль WS TABSTOP. Первый член любой группы должен иметь стиль WS GROUP. Конец труппы отмечается назначением первому члену следующей труппы стиля WS GROUP. Использование кнопок-селекторов для переключения режимов Теперь, когда вы овладели способами группирования элементов управления и переключения между ними, можно глубже погрузиться в программу FileBox. В частности, посмотреть, как эта программа реагирует на выбор кнопок-селекторов с помощью мыши и клавиатуры. Для переключения между режимами Drives (диски), Directories (каталоги) и Files (файлы) в программе FileBox используются два различных приема: Первый заключается в реагировании на выбор кнопок-селекторов с помощью мыши или клавиш-стрелок. Второй способ предусматривает отклик на щелчки правой кнопкой мыши. Первый способ мы рассмотрим сию минуту, а второй будет обсуждаться частично в этой главе и частично в следующей. IsDialogMessage и стиль BS_AUTORADIOBUTTON служат для упрощения использования кнопок-селекторов. Все, что от вас требуется, — это добавить некоторый код в обработчик сообщения WM_COMMAND, а затем подо- ждать, пока пользователь не выберет кнопку-селектор. Упомянутый код в программе FileBox выглядит следующим образом: 298: case ID_DRIVES + 100: 299: DirShowType = DRIVEMODE; 300: SetListbox(hwnd); 301: break; 302: 303: case ID_DIRS + 100: 304: DirShowType = DIRMODE; 305: SetListbox(hwnd); 306: break; 307: 308: case ID_FILES + 100: 309: DirShowType = FILEMODE; 310: • SetListbox(hwnd); 311: break;
Если пользователь выбирает кнопку-селектор дисков, то переменной DirShowType присваивается значение DRIVEMODE и вызывается функция SetListBox. Обсуждение функции SetListBox и различных глобальных переменных, использующихся в этой программе, приводится в следующей главе. А сейчас запомните, что тот же самый процесс повторяется при выборе кнопок-селекторов файлов и каталогов. Ясно, что написать код, обрабатывающий выбор кнопок-селекторов мышью просто. Неприятности могут возникнуть лишь в том случае, если вы забудете установить стиль WS GROUP в начале каждой группы или то, что кнопки-селекторы непрерывно информируют вас о своем состоянии (с помощью сообщений WM COMMAND). Имейте в виду эти два момента. Только что вы узнали о кнопках-селекторах и группирующих рамках и о том, как они создаются. Вот что следует запомнить: Кнопки-селекторы и группирующие рамки — это кнопки, созданные с помощью стилей BS RADIOBUTTON и BS_GROUPBOX. Стиль BS_AUTORADIOBUTTON позволяет кнопкам-селекторам автоматически ре- агировать на щелчки мышью. Используйте стиль WS_GROUP для того, чтобы собрать кнопки-селекторы внутри группирующей рамки. Группирующие рамки — это преимущественно визуальные средства. Функция IsDialogMessage обеспечивает встроенное переключение между элементами управления. Нажимайте правую кнопку! При программировании под Windows часто пренебрегают правой кнопкой мыши, оставляя неиспользованным значительный потенциал. Нет нужды говорить, что подоб- ные ситуации представляют собой источник великих возможностей. Пытаясь показать, что можно сделать правой кнопкой мыши, я набросал следующий код: 353: void HandleRightButton(HWND hwnd) 354: ( 355: switch(DirShowType) 356: ( 357: case DRIVEMODE: 358: ButtonSetCheck(hControl[1], TRUE); 359: Button_SetCheck(hControl[0], FALSE); 360: Button_SetCheck(hControl[2], FALSE); 361: DirShowType = DIRMODE; 362: break; 363: 364: case DIRMODE: 365: Button_SetCheck(hControl[2], TRUE); 366: Button_SetCheck(hControl[0], FALSE); 367: Button_SetCheck(hControl[1], FALSE); 368: DirShowType == FILEMODE; 369: break; 370: 371: default: 372: Button_SetCheck(hControl[0], TRUE); 373: ButtonSetCheck(hControl[1], FALSE); 374: ButtonSetCheck(hControl[2], FALSE) ; 375: DirShowType = DRIVEMODE; 376: } 377: SetListbox(hwnd); 378: ) 410: //////////////////////////////////////// 411: // Обработка сообщения WM_RBUTTONDOWN 412: lllllllllll/llllll/lllllllllllllll/l/lll 413: ttpragma argsused 414: void FileBox_OnRButtonDown(HWND hwnd, BOOL fDoubleClick, 415: int x, int y, UINT keyFlags) 416: ( 417: HandleRightButton(hwnd); 418: )
Здесь осуществляется последовательное переключение режимов при щелкании пра- вой кнопкой мыши. Трудности возникают из-за необходимости синхронизации кнопок- селекторов с происходящими изменениями. Обрабатывать такие ситуации значительно сложнее, чем просто реагировать на непосредственный выбор кнопок мышью. Разница в том, что работа, соответствующая стилю BS_AUTORADIOBUTTON, уже не выполняется автоматически. Программа File- Box должна явно изменять состояния кнопок-селекторов. Например, если пользователь щелкает правой кнопкой мыши, когда программа находится в режиме DRIVEMODE, то кнопка-селектор дисков (Drives) выключается с помощью вызова макроса Button_SetCheck. Затем включается кнопка-селектор каталогов (Directories), и DirShowType устанавливается в режим DIRMODE. При этом программа совершает еще один, возможно, излишний вызов с целью убедиться, что кнопка-селек- тор дисков выключена и все идет гладко. Нечто подобное происходит, когда программа находится в режимах DIRMODE или FILEMODE. Синтаксис значительно упрощается с помощью интерфейса управления сообщения- ми. Эти макросы из WINDOWSX настолько понятны, что мне почти не нужно объяснять, как они работают. Впрочем, не помешает пройти этот процесс хотя бы раз, чтобы увидеть, как макросы интерфейса управления сообщениями четко и ясно раскладывают все по полочкам. Макрос Button_SetCheck соответствует сообщению BM_SETCHECK. Если бы вы вызывали SendMessage непосредственно, ваш код выглядел бы следующим образом: SendMessage(RadioBtns[0], BMSETCHECK, WPARAM(TRUE), OL); SendMessage(RadioBtns [1], BM_SETCHECK, WPARAM(FALSE), OL); SendMessage(RadioBtns[2], BM_SETCHECK, WPARAM(FALSE), OL); WINDOWSX упрощает эти вызовы, позволяя вам написать следующее: Button_SetCheck(RadioBtns[0], TRUE); Button_SetCheck(RadioBtns[1], FALSE); Button_SetCheck(RadioBtns[2], FALSE); Объявление макроса ButtonJSetCheck в WINDOWSX. H выглядит следующим обра- зом: #define Button_SetCheck(hwndCtl, check) ((void)SendMessage((hwndCtl), BM_SETCHECK, (WPARAM) (int)(check) , OL) ) Этот макрос просто вызывает SendMessage, аккуратно преобразуя тип пользователь- ского запроса на включение или выключение кнопки. Нет нужды говорить, что нулевое значение WPARAM выключает, а ненулевое включает кнопку-селектор. Несмотря на то, что интерфейс управления сообщениями не упоминается в интер- активном файле помощи компиляторов Microsoft и Borland, его все-таки стоит исполь- зовать. Помните, что интерфейс управления сообщениями имеет несколько преимуществ: Его синтаксис понятен и прост в использовании. И Он предусматривает строгую проверку типа, облегчая чреватый ошибками процесс приведения типов. Он обеспечивает совместимость с WIN32, чего могло бы и не быть в случае непосредственного использования SendMessage. Сообщения WM_PARE NT NOTIFY Осталось рассмотреть еще одну важную вещь о том, как FileBox обрабатывает щелчки правой кнопкой мыши. Проблема возникает, когда пользователь щелкает правой кноп- кой мыши на графической кнопке или перечне. Неприятность связана с тем, что сообщение WM_RBUTTONDOWN, генерируемое Windows, поглощается элементом управления. К счастью, ребята из фирмы Microsoft предвидели подобную ситуацию и создали сообщение WMJPARENTNOTIFY, которое посылается родительскому окну элемента управления в случае получения последним одного из следующих сообщений:
WM_CREATE WM_DESTROY WM_LBUTTONDOWN WM_MBUTTONDOWN WMRBUTTONDOWN В результате элементы управления могут становиться “полупрозрачными”, будучи выбранными правой кнопкой мыши. Сообщения, которые могли бы быть потеряны, “садятся верхом” на сообщения WMPARENTNOTIFY, информируя таким образом основное окно о том, что произошло. Ответить на сообщение WM_PARENTNOTIFY нетрудно: 403: void FileBox_OnParentNotify(HWND hwnd, UINT msg, 404: HWND hwndChild, int idChild) 405: ( 406: if (msg == WM_RBUTTONDOWN) 407: HandleRightButton(hwnd); 408: ) Резюме Предметом этой главы были главным образом кнопки-селекторы и интерфейс управления сообщениями. В частности вы узнали следующее: И Как создавать оболочку Windows. Как создавать кнопки-селекторы. Как взаимодействовать с кнопками-селекторами с помощью макроса But- ton_SetCheck. Я Как объединять кнопки-селекторы в группы с помощью стилей WS_GROUP и WS_TABSTOP. Как общаться с перечнями и кнопками-селекторами с помощью интерфейса управ- ления сообщениями. Как использовать IsDialogMessage д ля обработки окном нажатий клавиш на клавиа- туре. Это была только часть рассказа о программе FileBox. Вторая его часть включает в себя кнопки (push buttons), перечни и содание подкласса окна. Обо всем этом вы узнаете из следующей главы. Вопросы и ответы 1. Я все-таки не понимаю IsDialogMessage. Зачем оно нужно? Переключение между элементами управления и выбор кнопок-селекторов с помо- щью клавиш-стрелок кажется пользователю настолько понятным, что он может легко посчитать это само собой разумеющимся. Однако сам процесс должен выполняться вручную буквальным перемещением фокуса с одного элемента управления на другой в нужное время. К счастью, Windows имеет свою собственную внутреннюю логику обработки ситуаций такого типа. Все, что вам нужно сделать, чтобы воспользоваться этим преимуществом, — вызвать IsDialogMessage. Как только это сделано, Windows сама отслеживает сообщения клавиатуры и соответствующим образом перемещает фокус. Вопросы для самопроверки 1. Какую команду можно использовать для автоматической перезагрузки системы или рестарта Windows? 2. Что делает функция IsDialogMessage, и где вы должны поместить ее в своей программе? 3. К какому классу принадлежат группирующие рамки? А как насчет кнопок-селек- торов?
4. Где можно найти список вызовов интерфейса управления сообщениями? 5. Какое стандартное сообщение WS_XXX соответствует макросу ButtonJSetCheck? 6. Как добиться, чтобы кнопка-селектор автоматически реагировала на щелчки мышью? 7. Каково назначение группирующей рамки? 8. Как пометить начало и конец группы элементов управления? 9. В чем разница стилей WS_GROUP и WS_TABSTOP? 10. Как проверить, был ли вызов WinExec успешным, и что следует предпринять в случае неудачи? Упражнения 1. Создайте программу, использующую два набора кнопок-селекторов. Установите их таким образом, чтобы можно было переключаться между группами и выбирать в каждой группе одну кнопку. 2. Добавьте в оболочку Windows — FileBox — меню со следующими функциями: Календарь Часы Управляющая панель Командная строка DOS Менеджер файлов Блокнот Редактор Write Пусть соответствующая программа запускается при выборе пользователем любого из этих пунктов. Учтите, что лучший способ запустить окно DOS — это стартовать DOSPRMPT.PIF. 3. Выведите на экран окно сообщения, извещающее о неудачной попытке вызова WinExec. Используйте код возврата WinExec для отправки информационного сообщения пользователю.
День 13 СОЗДАНИЕ ПОДКЛАССОВ ОКОННЫХ ЭЛЕМЕНТОВ УПРАВЛЕНИЯ В этой главе после рассмотрения достаточно простых вопросов, касающихся кнопок (push buttons), сообщения WM_GETMINMAXINFO и перечней, мы подробно обсудим создание подклассов (subclassing). Эта важная технология представляет собой последний кирпичик в вашем знании оконных элементов управления. Создание подклассов позволяет вам изменять поведение элементов управления, временно принимая на себя ответственность за них вместо оконной процедуры. В результате, как вы увидите, можно модифицировать перечень, кнопку или иной элемент управления, чтобы он делал в точности то, что вы хотите. В конце этой главы приводится относительно короткая программа, демонстрирую- щая, как можно создать подкласс окна, принадлежащего совершенно другой программе. Этот довольно таинственный способ позволяет залезать в другие программы или даже внутрь самой Windows и изменять их поведение. Вот список основных предметов, освещаемых в этой главе: Обзор кнопок. Сообщение WM_CLOSE и функция DestroyWindow. Обзор сообщения WM_GETMINMAXINFO. В Повторное рассмотрение перечней, сосредоточенное на их способности показывать содержимое каталогов с помощью DlgDirList и DlgDirSelect. В Объяснение того, как программа осуществляет переход от одного элемента перечня к другому. В Обширное множество примеров создания подклассов окна. В Обсуждение чтения/записи файлов инициализации (*.INI). В Объяснение способов создания меню “на лету”. Работа с кнопками • Сейчас вам нужно подхватить нить повествования примерно с того места, где она обрывается в предыдущей главе. Напомним, что предметом изучения были новые элементы управления программы FileBox. Следующий инструмент, подлежащий обсуждению, — кнопка с серой тенью, которую пользователь может выбрать с помощью мыши. Даже самые неопытные пользователи могут догадаться, как закрыть программу FileBox: для этого достаточно “нажать” большую графическую кнопку Close (см. рис. 13.1). Классические кнопочные элементы управления почти так же характерны для
Windows, как пиктограммы или стандартные, перекрывающиеся окна. Вероятно, вы уже прежде видели этот тип кнопок тысячу раз и если решите заняться программистским ремеслом, то, скорее всего, создадите еще несколько тысяч. er\books\w21VilebDx Iя!______ —~ IM м («М HI 14 "Mode----------- Ф Drives О Directories О files *.ехе Рис. 13.1. Кнопка Close Вот фрагмент функции FileBox OnCreaie (из листинга 12 ) предыдущей главы), создающий кнопку Close: 199: hControl [IDCLCSE] - CreateWindow("button", "Close”, 2C0: WS CHILD I WS VISIBLE I BS_PUSHBLTTOK I 201 : WS TABSTOP I WS GROUP, 202: 25C, 161, 131, 45, hwr.d, HMENU(ID CTOSE), 203: blnsLancc, NULL); Трудоемкость создания кнопок несоизмеримо мала по сравнению с функциональ- ностью и элегантностью, привносимыми ими в программы. Создание такого же визу- ального эффекта в типичной программе для DOS заняло бы гораздо больше строчек кода, не говоря уже о значительных затратах времени, необходимых на его разработку Ключевые моменты предыдущею обращения к CreateWindow просты Указать класс “button” в параметре IpszCreateWindow (строчка 199) Указать в параметре dwStylc стиль BS PUSHBUTTON (строчка 200) Указать координаты кнопки (строчка 202) Присвоить кнопке идентификатор и привести его к типу HMENU (строчка 202) К настоящему времени этот процесс должен быть уже настолько хорошо знаком вам, что вы можете выполнять его, почти нс задумываясь. Решировать на “нажатая" графических кнопок почти также легко, как и создавать их В действительности этот процесс подобен отклику на выбор меню. Вы запускаете функцию Cls_OnCoinmand и ждете, когда можно будет послать сообщение WM_.COM- MAND с идентификатором, соответствующем вашей кнопке. Вот, например, очень простой отлет на выбор кнопки: case ID_CLCSF.: MessageBox(hwrd, "Close Button pushed", "Beep", HB_OK); break; Соответствующий код в функции FileBox OnCommand въплядит следующим образом: 331: case ID CLOSE: 332: SendMessage (hwnd, WMCIiOSE, 0, 01: 333: break; 334: ) Программа FileBox передает выбор пользователя отдельной часта программы, на- правляя туда сообщение WMCLOSE (строчка 332). Сообщение WM_CLOSE закрывает приложение. Помните, что эту программу можно использовать в качестве оболочки Windows. Как только вы закроете оболочку, она завертит все активные приложения, а
затем и собственно Windows. Очевидно, последнее событие достаточно важно для того, чтобы переспросить пользователя, таковы ли в действительности его намерения. Трудность здесь связаны с тем, что существуют два различных способа закрыть приложение FileBox. Вы можете “нажать” кнопку Close или использовать системную пиктограмму в левом верхнем углу главного окна программы. Разумеется, системное меню не посылает в FileBox_OnCommand сообщения IDCLOSE. Вместо этого оно посылает в основное окно сообщение WMCLOSE. Замечание. Системная пиктограмма присоединяется к окну посредством объединения через логическое ИЛИ третьего параметра функции CreateWindow со стилем WS_SYSMENU. Разуме- ется, вы можете закрыть приложение, либо дважды щелкнув мышью по его системной пикто- грамме, либо выбрав “Close” в системном меню. Поскольку поведение системного меню определяется самой Windows, программа FileBox безропотно следует заданной схеме. Она посылает свое собственное сообщение WM_CLOSE, а затем отвечает на сообщения как системного меню, так и кнопки Close следующим кодом: 241: void FileBox_OnClose(HWND hwnd) 242: ( 243: if (MessageBox(hwnd, "Do you want to exit?", "FileBox", 244: MB_ICONQUESTION I MB OKCANCEL) = IDOK) 245: DestroyWindow (hwnd) ; 246: } Для закрытия программы достаточно вызвать DestroyWindow в основном окне приложения. Этот вызов деактивизирует окно, убирает его меню и дочерние окна, очищает очередь и таймеры, отключает окно от остальной системы и помещает фокус куда-либо еще. Нет нужды говорить, что DestroyWindow также посылает сообщение WM_DESTROY в основное окно. Если вы не перекроете реакцию окна на сообщение WM_CLOSE по умолчанию, оно автоматически вызовет DestroyWindow. Что и происходит в программе FileBox. Правда, после того как пользователь подтвердит свои намерения. Если вы хотите завершить приложение, закрывайте его, посылая сообщение WM_CLOSE или вызывая DestroyWindow непосредственно. Никогда не пытайтесь вызывать Cls_OnDestroy напря- мую и закрывать окно, посылая в него сообщение WM DESTROY. Ограничение размера окна В отличие от других примеров, которые вы видели в этой книге, окно приложения FileBox устроено таким образом, что пользователь не может изменить его размеры. Кроме того, окно не изменит своих размеров, даже когда вы попытаетесь максимизировать его. Такое поведение, отчасти напоминающее поведение диалоговой панели, достигается следующим ответом на сообщение WM_GETMINMAXINFO: 341: void FileBoxOnGetMiriMaxInfo (HWND hwnd, MINMAXINFO FAR* IpMinMaxInfo) 342: ( 343: lpMinMaxInfo->ptMaxSize.x = XSIZE; 344: IpMinMaxInfo-iptMaxSize. у = YSIZE; 345: lpMinMaxInfo->ptMaxPosition.x = 100; 346: lpMinMax!nfo->ptMaxPosition.y - 100; 347: lpMinMaxInfo->ptMinTrackSize.x = XSIZE; 348: lpMiriMaxInfo->ptMinTrackSize.y = YSIZE; 349: lpMinMaxlnfo->ptMaxTrackSize.x = XSIZE; 350: lpMinMax!nfo->ptMaxTrackSize.y = YSIZE; 351: ) Обработчик этого сообщения имеет два параметра: Копия дескриптора окна (тип HWND), с которым ассоциируется сообщение. Структура типа MINMAXINFO.
MINMAXINFO имеет шесть полей, каждое из которых объявляется как тип POINT. Структура типа POINT обычно используется для указания места на экране. Она имеет два поля типа integer: х и у. Поля структуры MINMAXINFO показаны в таблице 13.1. Таблица 13.1 Поля структуры MINMAXINFO PTREASOFT He используется PTMAXSIZE Насколько велико будет окно после максимизации PTMAXPOSITION Где должен быть размещен левый верхний угол окна после максимизации PTMINTRACKSIZE Наименьший размер, до которого пользователь может стянуть границы окна PTMAXTRACKSIZE Наибольший размер, до которого пользователь может растянуть границы окна Сообщение WM_GETMINMAXINFO приходит, когда окно уже создано (или при- мерно в то время, когда отправляется сообщение WM_CREATE). Замечание. Если вы не пользуетесь WINDOWSX, то, отвечая на сообщение WMMIN MAXINFO, потребуется привести тип LPARAM к типу MINMAXINFO. После этого следует применять тот же подход, что и в программе FILEBOX.CPP. Пытаясь управлять размерами основного окна, программисты часто манипулируют параметрами х, у, n Width и nHeight функции CreateWindow. Это неправильно. Самое лучшее — передавать в этих параметрах CWUSEDEFAULT. Реальный способ управле- ния размером и формой основного окна состоит в обработке сообщений WM_GETMIN- MAXINFO. Это не жесткое правило, но обычно это лучше, чем непосредственно изменять координаты. Ну вот и все, что можно сказать о сообщении WMGETMINMAXINFO. Оно не слишком сложно в техническом отношении, но, употребленное по назначению, может оказаться неоценимым. Фокусы с каталогами FILEBOX.EXE заполняет перечень именами файлов, каталогов и дисководов. Это сложное, на первый взгляд, задание здорово упрощается несколькими простыми функ- циями интерфейса прикладного программирования Windows, именуемыми DlgDirList и DlgDirSelect. Ни одна из этих функций сама по себе не является сложной в использовании. Тем не менее программа FileBox взаимодействует с ними с помощью глобальных констант DirShowType и DirShowVal. Обе эти константы помогают сделать программу значительно более читабельной и легко поддерживаемой. Чуть ниже вы прочитаете о новых функциях интерфейса прикладного программирования и технике их использования. Цель состоит в том, чтобы научиться избегать создания безнадежно запуганного, словно макароны, кода, для понимания которого вам не хватит и трех месяцев. Для начала рассмотрим следующий фрагмент обработчика сообщения WM CREATE: DlgDirList(hwnd, IDJFILELIST, ID_PATH, DirShowVal[DirShowType]); Вызов функции DlgDirList наполняет перечень информацией о конкретном диско- воде или подкаталоге. Например, списком доступных в данный момент файлов, диско- водов и подкаталогов. В таблице 13.2 перечислены параметры, передающиеся DlgDirList.
Таблица 13.2 Параметры, передающиеся DlgDirList HWND hwndDlg LPSTR IpszPath int idListBox Дескриптор окна или диалога, содержащего перечень Шаблон имен файлов, подлежащих показу Идентификатор перечня int idStaticPath Идентификатор статического поля для выбранного в данный момент файла Uint wFileType Идентификатор, обозначающий типы подлежащих показу файлов При вызове DlgDirList начинайте с помещения идентификатора соответствующего перечня в третий параметр DlgDirList. Затем заполните остальные параметры информа- цией о файлах или каталогах, которые вы хотите вывести на экран. Не забудьте, что DlgDirList автоматически вносит в статическое поле имя текущего выбранного файла. Достаточно лишь передать идентификатор этого элемента управления в четвертом параметре DlgDirList. Константы, которые могут быть заданы в пятом параметре DlgDirList, перечислены в таблице 13.3. Таблица 13.3 Пятый параметр DlgDirList содержит одну или более копстант, определяющих, что именно должно быть показано в блоке перечисления DDLJREADWRITE DDL_READONLY DDL_HIDDEN DDL_SYSTEM DDL_DIRECTORY DDL_ARCHIVE DDL_POSTMSGS Файлы данных для чтения и записи Файлы только д ля чтения Скрытые файлы Системные файлы Каталоги Архивы Помещает в очередь сообщение для приложения, но не для диалоговой панели DDL_DRIVES DDL_EXCLUSIVE Дисководы Исключает обычные файлы и показывает только файлы указанного типа Если передать в пятом параметре функции DlgDirList константу DDL_READWRITE, то в указанном перечне будут перечислены файлы, имеющие атрибуты для чтения и записи. Если вы передадите идентификатор DDL_DRIVES, то увидите все обычные файлы и список дисководов. Если вы желаете увидеть только дисководы, передайте DDL_DRIVES, объединенную логическим ИЛИ с DDL EXCLUSEVE. В программе FileBox массив констант задает каждый из трех типов показов, генери- руемых приложением: 27: WORD DirShowVal[) = (DDL_DRIVES I DDL_EXCLUSIVE, 28: DDL_DIRECTORY I DDL_EXCLUSIVE, DDL_ARCHIVE}; DirShowVal всегда устанавливается в один из трех режимов, показанных в его объявлении. Например, если пользователь выбирает кнопку-селектор файлов (Files), то DirShowVal принимает значение DDL_ARCHIVE, что гарантирует показ всех нормаль- ных файлов текущего каталога. Если пользователь выбирает кнопку Directories, то DirShowVal присваивается значение DDL DIRRECTORY | DDLEXCLUSIVE, в резуль- тате чего показывается только список доступных в настоящий момент подкаталогов. Программа FileBox реализует это с помощью локальной переменной DirShowType типа TCurMode: enum TCurMode {DRIVEMODE, DIRMODE, FILEMODE),- TCurMode DirShowType;
Взаимодействие этих различных переменных гарантирует, что в результате обраще- ния к DlgDirList всегда будет генерироваться либо список обычных файлов, либо список каталогов, либо список дисководов, в зависимости от текущего значения DirShowType, например, такого: DirShowType = FILEMODE; Теперь, когда потребуется вызвать DlgDirList, вы можете передать правильные константы, индексируя массив DirShowVal: DirShowVal[DirShowType ] Последний вызов выглядит следующим образом: DlgDirList(hwnd, ID_FILELIST, ID_PATHS, DirShowVal[DirShowType]); Конечно, существуют и другие способы обработки ситуации такого типа. Данный способ показан здесь потому, что сильно упрощает программирование. Некоторые путают константы, рассыпанные по Windows-программе, подобно кон- фетти. В случае DlgDirList это компенсируется тем, что только недавние документы используют стандартно объявленные в Windows константы вместо голых чисел. Константы служат просто для того, чтобы объявить набор флажков, имеющих определенный смысл. Фактически это очень простая идея, не сложнее детской игры. Например, дети любят устанавливать коды, управляющие поведением: “Если я скажу “один”, повернись налево, если я скажу “два”, повернись направо”. Ну что-то в этом роде. Очень просто и очень доступно. Так или иначе фактические константы, использующиеся функцией DlgDirList, оп- ределяются в WINDOWS.H: /* Значение флажков в DlgDirList и DlgDirListComboBox ★/ «define DDL_READWRITE 0x0000 «define DDL—READONLY 0x0001 «define DDL_HIDDEN 0x0002 «define DDL_SYSTEM 0x0004 «define DDL_DIRECTORY 0x0010 «define DDL_ARCHIVE 0x0020 «define DDL—POSTMSGS 0x2000 «define DDL—DRIVES 0x4000 «define DDL_EXCLUSIVE 0x8000 Это можно перевести на детский язык примерно следующим образом: “Если я скажу “один”, покажи мне файлы только чтения; если я скажу “два”, покажи мне спрятанные файлы”. Это очень простая система, лишь слегка усложняющаяся присутствием логи- ческих операторов. В объявлении массива DirShowVal значения DDL-DIRECTORY и DDL_EXCLUSIVE объединяются посредством логического ИЛИ. DDL_DIRECTORY I DDL_EXCLUSIVE Что эквивалентно следующему: 0x0010 I 0x8000 Между этими операторами нет принципиальной разницы. Можно было бы также написать 0x8010, что соответствует дизъюнкции этих двух значений. Проблема в том, что 0x8010 будет не слишком понятным тем, кто попытается расшифровать ваш код несколько месяцев или лет спустя. Поэтому в Windows исполь- зуются предварительно определенные константы. Это не всегда самая приятная, с эстетической точки зрения, система в мире, но очень практичная. Прежде чем двигаться дальше, будет полезно подвести итог сказанному: Функция DlgDirList заполняет перечень списком файлов, каталогов, дисководов и Т.д. И DlgDirList зависит от пяти параметров, обработка каждого из которых при обычных обстоятельствах не составляет труда.
Режим программы FileBox указывается с помощью одного из трех наборов иденти- фикаторов, передающихся в параметре uFileType. Программа FileBox предусматривает для отслеживания этих идентификаторов две глобальные переменные DirShowType и DirShowVal. Смена дисков и каталогов Следующий (и последний) шаг состоит в том, чтобы рассмотреть, как FileBox реагирует на выбор пользователем произвольного элемента перечня. Иначе говоря, вам требуется понять, как программа FileBox перемещается по каталогам и позволяет пользователю запустить конкретную программу. Если пользователь выбирает в перечне каталог или диск, в обработчик сообщения WM_COMMAND посылается сообщение. Приводится в действие следующий код: 313: 314 : 315: 316: 317: 318: 319: 320: 321: 322: 323: 324: 325: 326: 327: 328: 329: case ID FILELIST: if (codeNotify == LBN DBLCLK) ( if (DirShowType != FILEMODE) HandleMouseClick(hwnd, id, hwndCtl, codeNotify); else ( int index - ListBoxGetCurSel(hControl[IDFILELIST]); _getdcwd(0, S, 125); ListBox_GetText(hControl[ID_FlLELIST], index, IpszBuffer); strcat(S, "\\"); strcat(S, IpszBuffer); WinExecfS, SW_SHOWNORMAL) ; ) > break; FileBox проверяет, не был ли сделан выбор в перечне посредством двойного щелчка мышью. Если да, то программа выполняет одну из двух вещей, в зависимости от того, находится или нет пользователь в режиме файлов. Если пользователь просматривает список файлов, то программа пытается вызвать WinExec, чтобы запустить файл, соот- ветствующий выбранному имени. Если пользователь находится в режиме дисков или каталогов, то вызывается функция HandleMouseClick: 278: void HandleMouseClick (HWND hwnd, int id, HWND hwndCtl, UINT codeNotify) 279: ( 280: char Buffer[100]; 281: 282: DlgDirSelect(hwnd, Buffer, ID_FILELIST); 283: DlgDirList(hwnd, Buffer, IDFILELIST, ID_PATHS, 284: DirShowVal[DirShowType]); 285: ) Функция DlgDirSelect находит файл, который пользователь указал мышью. Если выбран каталог или диск, то DlgDirSelect отбрасывает обрамляющие его имя скобки и дефисы и возвращает правильный список каталогов или дисков. Передайте это значение в DlgDirList, и Windows автоматически перейдет на указанный диск или каталог. Windows выполняет всю черновую работу, связанную с грамматическим разбором имен файлов и сменой каталогов, а также предохраняет как программиста, так и пользователя от всех мерзостей командной строки DOS. Цель состоит в том, чтобы попытаться произвести более интуитивно ясный интерфейс с темным и непонятным железом, затаившемся внутри. Обычно люди любят свои машины, но не любят открывать кожух и пачкать руки. Функции, подобные DlgDirList, упрощают дело. Они помогают сделать компьютеры более дружественными. Конечно, есть люди, которым нравится открывать кожух и разбираться в том, что происходит под ним. Для таких любознательных я включил следующую функцию: void SetListbox(HWND hwnd) ( RECT R;
ListBox_ResetContent(BoxWin); ListBox_Dir (BoxWin, DirShowVal[DirShowType], "*.*"); R.left = 14; R.top = 220; R.right = 14 + BMPX; R.bottom =220+ BMPY; InvalidateRect(hwnd, SR, FALSE); J Первые две строчки кода, использующие интерфейс управления сообщениями, делают примерно то же самое, что и DlgDirList. Функция ListBox_ResetContent очищает перечень, а макрос ListBox_Dir заполняет его соответствующей информацией из теку- щего подкаталога. Чего не делает эта функция — так это не меняет каталоги. Впрочем, функции SetListBox и не требуется этого, потому что она вызывается только в том случае, если пользователь переключается из режима файлов в режим каталогов или из режима каталогов в режим дисков (и т.д.). Макрос ListBoxResetContent соответствует сообщению LB_RESETCONTENT. До появления WINDOWSX перечни всегда очищались следующим образом: SendMessage(BoxWin, LB RESETCONTENT, 0, 0L) ; К настоящему времени вы, возможно, уже понимаете, по какому принципу имену- ются макросы управления сообщениями. Поэтому для вас не будет сюрпризом то, что функция ListBox_Dir соответствует сообщению LBDIR. : SendMessage(BoxWin, LBDIR, DDL DRIVES | DDLEXCLUSIVE, LPARAM(IpszBuffer)); В этом примере IpszBuffer может содержать, например, такую символьную строку, как *.* или *.ЕХЕ. FileBox использует макросы WINDOWSX и несколько других хитростей для упрощения вызова: ListBox_Dir(BoxWin, DirShowVal[DirShowType] , Это все еще не образец синтаксической ясности, но это гораздо легче читать. Замечание. Может быть, вам захочется .также разобраться с вызовом InvalidateRect в конце функции SetListBox. Как вы помните, InvalidateRect обусловливает передачу в окно сообщения WM_PAIN'T. Это один из тех редких случаев, когда вы можете использовать второй параметр этой функции. Передача RECT в этом параметре вынуждает Windows перерисовывать только определенную часть вашего окна. Существуют две причины передачи RECT: 1. Сохранение циклов часов 2. Предотвращение мерцания при перерисовке окна. Введение в создание подклассов оконных элементов управления В последних нескольких главах вы познакомились с обзором всех основных элемен- тов управления: отмечаемых блоков, редактируемых полей, группирующих рамок, пере- чней, кнопок, кнопок-селекторов, линеек прокрутки и статических полей. К настоящему времени вы должны понимать, насколько важны эти инструменты для конструирования любой полезной Windows-программы. Хорошо научитесь ими пользо- ваться, и вы сможете создавать программы, простые в использовании и легкие для понимания. —- Впрочем, существует одно серьезное препятствие. Проблема в том, что элементы управления остаются для программистов черными ящиками. Мы не можем знать, что там происходит внутри, потому что фирма Microsoft никогда не публиковала их исходных кодов. Кроме того, иногда нам требуется слегка изменить их поведение с тем, чтобы они гладко вписывались в наши программы.
Очевидно, мне нс следовало бы каешься этой темы. гели бы фирма Мкгоъой не пре дуемо грела решение данной проблемы. Эю решение называется созА.чшдм глздк. .асом (stibcla.ssins). Создание подкласса иконною элемента управления технически несложно, но требует, чтобы программисты усвоили несколько важных новых понятий Нит что вам требуется знать. Точно так же, как диалоговая панель или окно, каждый элемент управления имеет оконную процедуру, определяющую ею повеление. И Адрес оконной процедуры элемента управления хранится и памяти и может был» найден и/или заменен. Если вы замените оконную процедур} элемента управления адресом одной из ваших функций, то сможете первыми проникнуть внутрь любого сообщения, посылаемою в элемент управления □ После тою как вы обнаружили конкретное сообщение, можете либо передать его в исходную оконную процедуру элемента управления, либо проглотить его. так что оно исчезнет без следа. В любом случае вы можете ответить на сообщение по-спос.му, изменив тем самым поведение элемента управления. Вот и вес об этом. В общем то, достагочнп простая процедура, что-то вроде создания диалоговых панелей или обработчиков перечисляемых объектов. Иначе говоря, ключе- вые моменты заключаются в выгоне MakeProcInstance и установке “почтового адреса", по которому Windows может отправлять сообщения. Замечание. В книге, подобной этот:, пег особой нужды <Хыуж£37ьсоз.т.11<тгс пслк.тассовзлг'-кгггоь управления. Моей целью было т оказать вам почелные срслстза и дать примеры тети. как они должны бы работать в нормальных, ini', даже идеальных. условиях Впрочем, в реальном мире программистам приходнтск стппкипатъся с “исключениями" пт пролил почти также ч.хгго, как с ‘'нормальными условиями" Пппрвм.ср, создание подклассов элсмснюв управления — это то. •по программистам приходится делать рсгу шрио. Иначе юверя. это другая важная тема. и вам, по видимому. следует должным образом. изучить йог Mjrepiun Особенности создания подклассов элементов управления Теперь, когда вы понимаете, ч го такое создание подклассов, пора обсудить конкрст ный пример. 11рог|>амма FileBox создаст подкласс своего рслаюиругмог о поля. Она делает это по пяти отчасти взаимосвязанным причинам. 11 Ей требуется обрабатывать сообщения WM KU.LFOCL'S так, чтобы можно было проверять. нужно ли релаксируемому потно информироилТо перечень о том, чго пользователь изменил маску имен файлов («м рис 13 2). □ Ей требуется обрабатывать сообщения WM GFTD1 GCODF □ Ей требуется обрабатывать особым образом клавишу Enter. □ Fii требуется восстановить нормальное поведение переключения от одного элемента управления к другому, которое она потеряла, отвечая на \\bi_GCTDl.GCODE. Ей требуется подсвечип.пь текст в редактируемом по.чг тсякиЙ раз. когда оно попадает и фокус, то сеть подучает сообщение W.M_SFTFOCIJS Рис. 13.2. Раполатл&шм кед кнопке^ рсдск/пир) ез-toe по те содержит маску имаз
Приведенный выше список представляет хитросплетения идей, довольно точно отражающих требования, которых следует ожидать, когда вы сталкиваетесь с реальным программным проектом для Windows. Единственный способ выпутаться из этой паутины проблем — начать создавать подклассы, как сумасшедшему. Не беспокойтесь, если все это не очень понятно. Это сложная проблема, и точные детали, возможно, не прояснятся до тех пор, пока вы не изучите их с помощью отладчика с нескольких различных точек зрения. Чтобы исследовать эту проблему, рассмотрим сообщение WM_GETDLGCODE, довольно интересным образом взаимодействующее с IsDialogMessage. Как объяснялось в последней главе, IsDialogMessage перехватывает определенные нажатия клавиш и обрабатывает их, обеспечивая тем самым вашу программу таким важным свойством, как автоматическое переключение между элементами управления. Преимущество тут в том, что IsDialogMessage позволяет не заботиться об управлении теми нажатиями клавиш, которые обрабатываются Windows. В частности, если редактируемое поле не укажет специально обратное (при ответе на сообщения WM_GETDLGCODE), IsDialogMessage полагает, что редактируемому полу в действительности не нужно видеть клавишу Enter. Ну, а что, если вы хотите реагировать на нажатие клавиши Enter? Тогда потребуется обработать сообщения WM_GETDLGCODE, возвращая DLGC_WANTALLKEYS: case WM_GETDLGCODE: return DLGC_WANTALLKEYS; К сожалению, сага еще не вся, потому что сообщение DLGC_WANTALLKEYS эффективно исключает встроенное в IsDialogMessage поведение переключения для редактируемого поля. Это означает, что программе FileBox требуется явно восстанавли- вать приемлемое переключение для редактируемых полей. Лучший способ сделать это — создать подкласс. Если все это представляется немного запутанным и сложным, то это лишь потому, что все действительно сложно и запутано. Вы сейчас видите не то, что разработчики Windows хотели бы показать почти всем, а идете по территории, на которой заслужили свои нашивки лучшие программисты Windows. Все, что было установлено до сих пор, — это то, что редактируемое поле в программе FileBox требует создания подкласса, чтобы тот мог обрабатывать определенные сообще- ния конкретным образом. Иначе говоря, поведение по умолчанию для редактируемого поля при данных обстоятельствах просто не совсем приемлемо. Поэтому вам нужно более глубоко изучить, как изменить это поведение. Вот как это работает. Когда вы создаете структуру WNDCLASS в функции Register, или когда вы передаете информацию с помощью вызова CreateWindow, Windows сохраняет вашу работу в локальной динамической области библиотеки динамической компоновки, называемой USER.EXE. Совершая обращения к ряду функций с именами вроде SetWindowLong и SetClassLong, вы можете взять или заменить большую часть этой информации. Поскольку элементы управления в действительности являются просто окнами со своими собственными структурами WNDCLASS и своими собственными внутренними данными, нет причины, по которой вы не могли бы обратиться к Windows и запросить адрес их оконной процедуры. Затем вы можете заменить его одним из своих собственных. Создавая подкласс оконного элемента управления, начинайте со следующих шагов: Создайте память для оконной процедуры с помощью вызова MakeProcInstance. Обменяйте прежнюю оконную процедуру на новую. Вот как все это выглядит, когда вы пишете код для создания подкласса редактируе- мого поля: FARPROC IpfnNewEdit; WNDPROC OldListProc; HWND hEdit; IpfnNewEdit = MakeProcInstance(FARPROC(NewEditProc), hlnstance); OldEditProc = (WNDPROC)SetWindowLong(hEdit, GWL_WNDPROC, LONG(IpfnNewEdit));
IpfnNewEdit — переменная-указатель на новую оконную процедуру, поставляемую программой FileBox. Переменную OldEditProc, с другой стороны, можно использовать для хранения адреса старой оконной процедуры, разработанной фирмой Microsoft. FileBox размещает код пролога для новой процедуры с помощью вызова MakePro- cInstance. Адрес новой оконной процедуры передается в Windows, а адрес старой сохраняется. Это делается с помощью обращения к SetWindowLong. Следующий шаг — разработать новую оконную процедуру, которая выглядит при- мерно следующим образом: LRESULT CALLBACK NewEditProc(HWND hwnd, UINT Message, WPARAM wParam, LPARAM IParam) ( switch(Message) ( case WM_GETDLGCODE: return DLGC WANTALLKEYS case WM_KEYDOWN; ... // Код обработки переключения break; case WM_KILLFOCUS: SetNewWildCard(hwnd); break; case WM_SETFOCUS: Edit_SetSel(hwnd, 0, -1); break; I return CallWindowProc(OldEditProc, hwnd. Message, wParam, IParam); } Объявление для NewEditProc выглядит так же, как объявление для любой другой оконной процедуры. NewEditProc имеет такие же параметры и возвращает те же самые значения. Она точно такая же, как и основная оконная процедура программы FileBox, только используется для редактируемого поля. Оператор switch, который формирует тело оконной процедуры, точно такой же, как и оператор switch, который вы можете видеть в WNDPROC основного окна или в оконной процедуре диалоговой панели. Фактически единственная разница между этой оконной процедурой и нормальной оконной процедурой состоит в том, что первая завершается ссылкой на функцию CallWindowProc, а не на DefWindowProc: return CallWindowProc(OldEditProc, hwnd. Message, wParam, IParam); Нет нужды говорить, что миссия CallWindowProc заключается в том, чтобы передать сообщение в исходную оконную процедуру. Это становится возможным потому, что вы специально передаете адрес исходной процедуры в качестве первого параметра. Не забывайте передавать сообщения в исходную оконную процедуру, если хотите, чтобы они обрабатывались нормально. Нельзя передавать никаких сообщений, обработкой которых вы не хотите управлять. Например, многие программисты создают подклассы редактируемых полей, а затем просто пренебрегают передачей любого нечислового ввода. В итоге редактируемое поле вынуждает пользователя печатать цифры и отказывается воспринимать любые попытки ввести буквы. Если вам требуется, чтобы элемент редактирования вел себя таким образом, можете добиться этого с помощью создания подкласса. Как обычно, последний шаг в этом процессе состоит в очищении. В FileBox это происходит при ответе на сообщение WMJDESTROY: SetWindowLong(hEdit, GWLWNDPROC, LONG(OldEditProc)); FreeProcInstance(IpfnNewEdit); Обращение к SetWindowLong требует три параметра. Первый — дескриптор окна, которое вы хотите изменить; второй — константа, указывающая смещение данных,
размещенных в локальной динамической области памяти библиотеки USER.EXE; тре- тий — функция, которую вы хотите вставить в память. После того как FileBox заменит оконную процедуру, которую она столь бесцеремонно позаимствовала, последний шаг состоит в том, чтобы уничтожить окно, которое она создала. Ну вот! Теперь все вернулось “на круги своя”, как было до выхода на сцену приложения FileBox. Не хотите ли задержаться, чтобы обсудить прозошедшее здесь? Основные моменты, которые следует усвоить, таковы: И Программе FileBox потребовалось изменить поведение, определяемое по умолчанию, ее редактируемого поля. И Чтобы сделать это, она должна загрузить адрес собственной оконной процедуры в локальную динамическую область памяти библиотеки USER. EXE и получить назад адрес старой оконной процедуры. В Программа FileBox обработала определенные сообщения, которые сочла нужными, и передала остальные непосредственно в старую оконную процедуру. В Закончив, программа FileBox тщательно убрала за собой, поместив старую оконную процедуру обратно туда, где она ее обнаружила. Затем FileBox вызвала FreeProcIn- stance по адресу ее собственной заказной оконной процедуры. Надеюсь, что вы можете понять, почему над созданием подклассов витает некая аура колдовства. Это интересная область, где вы действительно можете получить некоторое удовольствие, если вы имеете такую склонность. Должен заметить, что создание подклассов, приведенное здесь, относится к конкрет- ному окну. Можно создавать подклассы для целого класса элементов управления так, что все версии этого элемента управления, появляющиеся в любой программе, будут демонстрировать поведение, которое вы определите. По очевидным причинам, это как раз то, что вы, конечно же, не захотите сделать, поэтому я не освещаю этот вопрос в данной книге. Премиальная программа: создание подкласса рабочего стола Windows Под занавес я приготовил короткую демонстрационную программу MenuAid, пока- зывающую, как создать подкласс окна, которое не является частью вашего приложения. MenuAid цепляется к рабочему столу, представляющему собой задний план, на фоне которого появляется оболочка Windows при первом старте системы. Единственная задача MenuAid при создании подкласса рабочего стола — в ответ на щелчок правой кнопкой мыши передать сообщения обратно в свою собственную основную оконную процедуру. Получив это сообщение, основное окно отображает на экране меню доступных про- грамм. Если пользователь выберет пункт из этого меню, MenuAid запустит соответст- вующую программу. Таким образом, пользователь может получить список доступных программ, Щелкнув правой кнопкой мыши на рабочем столе. Идея этой программы была предложена Дэйвом Уилхэлмом — ветераном програм- мирования на Си и Паскале — работающим в отделе технической поддержки фирмы Borland. Я решил сделать свою собственную версию, поскольку это весьма интересная программа, служащая практическим целям. Приношу благодарность и снимаю шляпу перед Дэйвом Уилхэлмом. Он блестящий программист, и с его стороны было очень мило поделиться своей идеей с нами. Листинг 13.1. MENUAID.CPP 1: ////////////////////////////////////////////////////////// 2: // Программа: MENUAID.CPP 3: // Автор: Чарли Калверт 4: // Благодарности: Дэйву Уилхелму 5: II Описание: MenuAid — программа для Windows 6: // Дата: 07/04/93
7: 8: Э: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 4В: 49: 50: 51: 52 53: 54. 55: 56: 57: 58: 59: 60: 61: 62: 63. 64: 65 66: 67. 68: 69- 70: 71: 72: 73: 74: 75: 76: 77: ////////////////////////////////////////////////////////// «define STRICT «include <windows.h> «include <windowsx.h> «include <string.h> U ————————— // Интерфейс // - «define CMEDIT 1 «define WM_SPECIAL (WM_USER + 0x100) «define ID_LISTBOX 102 «define CM_UPDATE 103 «define XSIZE 223 «define YSIZE 253 LRESULT CALLBACK _export WndProc(HWND hwnd, UINT Message, WPARAM wParam, LPARAM IParam) ; LRESULT CALLBACK _export NewDesktopProc(HWND hwindow, UINT Message, WPARAM wParam, LPARAM IParam) ; BOOL Register(HINSTANCE hlnst); HWND Create (HINSTANCE hlnst, int nCmdShow); HMENU NewMenu (void) ; // Объявления для класса MenuAid «define MenuAid_DefProc DefWindowProc BOOL MenuAid_OnCreate (HWND hwnd, CREATESTRUCT FAR* IpCreateStruct); void MenuAid_OnDestroy (HWND hwnd); void MenuAid OnCommand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify); void MenuAid OnGetMinMaxInfo(HWND hwnd, MINMAXINFO FAR* IpMinMaxInfo) ; static char szAppName[] = "MenuAid"; static char IniNamet] = "MenuAid.ini"; static HWND MainWindow, DeskWnd, hListBox; static HINSTANCE hlnstance; WNDPROC OldDesk; FARPROC IpfnNewProc; HMENU Float; static int itemsInMenu = 1; // // Инициализация // //////////////////////////////////// // Точка входа //////////////////////////////////// «pragma argsused int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInstance,LPSTR IpszCmdPAram, int nCmdShow) { MSG Msg; if (!hPrevInstance) if (’Register(hlnst) ) return FALSE; if (’(MainWindow = Create(hlnst, nCmdShow))) return FALSE; while (GetMessage(&Msg, NULL, 0, 0)) ( TranslateMessage(&Msg); DispatchMessage(&Msg); ) 78 79: 80 return Msg.wParam; ) 81: ////////////////////////////////////////
82: 83: 84: 85: 86: 87: 88: 89: 90: 91: 92: 93: 94: 95: 96: 97: 98: 99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: // Регистрация окна //////////////////////////////////////// BOOL Register(HINSTANCE hinst) ( WNDCLASS WndClass; WndClass.style WndClass.IpfnWndProc WndClass.cbClsExtra WndClass.cbWndExtra WndClass.hlnstance WndClass.hlcon WndClass.hCursor WndClass.hbrBackground WndClass. IpszMenuName WndClass.IpszClassName = CS_HREDRAW | CSVREDRAW; = WndProc; = 0; = 0; = hinst; = Loadicon(hinst, "MenuAid"); = LoadCursor(NULL, IDC_ARROW); - GetStockBrush(LTGRAYBRUSH); = NULL; = szAppName; return Registerclass (SWndClass); ) /////////////////////////////// // Создание окна /////////////////////////////// HWND Create(HINSTANCE hinst, int nCmdShow) ( hlnstance = hinst; DWORD Style = WS_OVERLAPPEDWINDOW & ~WS_MAXIMIZEBOX; HWND hwnd = CreateWindow (szAppName, szAppName, Style 4 ~WS_THICKFRAME, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW USEDEFAULT, NULL, NULL, hinst? NULL); if (hwnd == NULL) return hwnd; nCmdShow = SW_SHOWMINIMIZED; ShowWindow(hwnd, ncmdShow); UpdateWindow (hwnd); return hwnd ; ) 127: // =========== 128: // Реализация 129: // ========-- 130: 131: ///////////////////////////////// 132: // Оконная процедура 133: IIIIIIIUIIIIIIIIIIIIllllllllllll 134: LRESULT CALLBACK _export WndProc (HWND hwnd, UINT Message, 135: WPARAM wParam, LPARAM IParam) 136: ( 137: switch(Message) 138: ( 139: case WM_SPECIAL: 140: POINT P = MAKEPOINT(IParam); 141: Float = NewMenu(); 142: TrackPopupMenu(Float, TPMLEFTALIGN, 143: P.x, P.y, 0, hwnd, NULL); 144: return 0; 145: 146: HANDLE_MSG (hwnd, WM CREATE, MenuAid_OnCreate) ; 147: HANDLEJMSG (hwnd, WM_DESTROY, MenuAid_OnDestroy) ; 148: HANDLE_MSG (hwnd, WM_COMMAND, MenuAid_OnCommand) ; 149: HANDLEJMSG (hwnd, WM_GETMINMAXINFO, MenuAid_OnGetMinMaxInfo) ; 150: default: 151: return MenuAidDefProc (hwnd. Message, wParam, IParam); 152: ) 153: ) 154: 155: void FillListBox (HWND hwnd) 156: {
157: int Temp, Total = 0; 158: const int Size = 1024; 159: char Buffer[Size]; 160: 161: ListBox_ResetContent(hwnd); 162: ListBoxAddString(hwnd, "Edit"); 163: 164: int Len = GetPrivateProfileString("Files", NULL, "", 165: Buffer, Size, IniName); 166: while (Len > Total) 167: ( 168: ListBox_AddString (hwnd, Buffer); 169: Temp = strlen(Buffer) + 1; 170: Total += Temp; 171: memmove(Buffer, &Buffer[Temp], Size - Total); 172: } 173: ) 174: 175: //////////////////////////////////// 176: // Обработчик сообщения WM_CREATE 177: //////////////////////////////////// 17 8: ((pragma argsused 179: BOOL MenuAidOnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) 180: ( 181: Float - NULL; 182: 183: DeskWnd = GetDesktopWindow(); 184: IpfnNewProc = 185: MakeProcInstance(FARPROC(NewDesktopProc), hlnstance); 186: OldDesk = (WNDPROC) SetWindowLong (DeskWnd, 187: GWLWNDPROC, LONG(IpfnNewProc)); 188: 189: hListBox = CreateWindow("ListBox", NULL, 190: WS_CHILD I WS_VISIBLE I LBS_NOTIFY I WS_BORDER, 191: 10, 10, 200, 200, hwnd, 192: HMENU(ID_LISTBOX), hlnstance, NULL); 193: 194: FillListBox(hListBox); 195: 196: HMENU TheMenu = CreateMenu (); 197: HMENU AMenu = CreatePopupMenu () ; 198: AppendMenu(AMenu, MF_STRING, CM_EDIT, "Edit"); 199: AppendMenu(AMenu, MF_STRING, CM_UPDATE, "Update"); 200: AppendMenu (TheMenu, MFENAHLED I MF POPUP, 201: (UINT)AMenu, "SFile"); 202: SetMenu(hwnd, TheMenu); 203: 204: Float = NewMenuO; 205: 206: return TRUE; 207: ) 208: 209: ////////////////////////////////////////// 210: // Обработчик сообщения WM_DESTROY 211: ////////////////////////////////////////// 212: ((pragma argsused 213: void MenuAid_OnDestroy(HWND hwnd) 214: ( 215: SetWindowLong(DeskWnd, GWL_WNDPROC, LONG(OldDesk)); 216: FreeProcInstance(IpfnNewProc) ; 217: DestroyMenu(Float); 218: PostQuitMessage(0); 219: ) 220: 221: ////////////////////////////////////// 222: // Launch 223: ////////////////////////////////////// 224: void FAR Launch(int id) 225: ( 226: char Filename[50]; 227: char Buffer[200]; 228: 229: if (GetMenuString(Float, id, FileName, 230: sizeof(FileName), MF_BYCOMMAND) > 0) 231: if (GetPrivateProfileString("Files", FileName,
232: Buffer, sizeof(Buffer), IniName) > 0) 233: WinExec(Buffer, SW_SHOWNORMAL) ; 234: ) 235: 236: ///////////////////////////////////// 237: // Обработчик сообщения WMCOMMAND 238: ///////////////////////////////////// 239: ttpragma argsused 240: void MenuAid_OnCommand (HWND hwnd, int id, HWND hwndCtl, UINT codeNotify) 241: ( 242: const int Size = 250; 243: char Buffer[Size]; 244: char Buffer2[Size]; । 245: 246: if((id > CM_EDIT) && (id <= ItemsInMenu)) 247: Launch(id); 248: else 249: switch(id) 250: ( 251: case CM_EDIT: 252: GetWindowsDirectory(Buffer, Size); 253: strcpy(Buffer2, Buffer); 254: strcat (Buffer2, "Wnotepad.exe "); 255: strcat(Buffer2, Buffer); 256: strcat(Buffer2, "\\MenuAid.ini"); 257: WinExec (Buffer2, SW_SHOWNORMAL) ; 258: break; 259: 260: case ID_LISTBOX: 261: if(codeNotify == LBN_DBLCLK) 262: ( 263: int Index = ListBox_GetCurSel(hListBox); 264: SendMessage(hwnd, WM_COMMAND, Index + 1, 0L); 265: ) 266: break; 267: 268: case CM_UPDATE: 269: FillListBox(hListBox) ; 270: Float = NewMenuf); 271: break; 272: } 273: ) 274: 275: //////////////////////////////////////////// 276: // Обработчик сообщения WMGetMinMaxInfo 277: //////////////////////////////////////////// 278: #pragma argsused 279: void MenuAid_OnGetMinMaxInfo (HWND hwnd, 280: MINMAXINFO FAR* IpMinMaxInfo) 281: ( 282: IpMinMaxInfo-iptMaxSize.x = XSIZE; 283: IpMinMaxInfo-iptMaxSize. у = YSIZE; 284: IpMinMaxInfo-iptMaxPosition.x = 100; 285: IpMinMaxInfo-iptMaxPosition.у = 100; 286: lpMinMaxInfo->ptMinTracksize.x = XSIZE; 287: IpMinMaxInfo-iptMinTrackSize. у = YSIZE; 288: IpMinMaxInfo-iptMaxTrackSize.x = XSIZE; 289: lpMinMaxInfo->ptMaxTrackSize.у = YSIZE; 290: ) 291: 292: ////////////////////////////////////////// 293: // NewMenu 294: ////////////////////////////////////////// 295: HMENU NewMenu (void) 296: ( 297: int Temp, Total =0; 298: const int size = 1024; 299: char Buffer[Size]; 300: ItemsInMenu = 2; 301: 302: if (Float) DestroyMenu(Float); 303: int Len = GetPrivateProfileString("Files", NULL, 304: Buffer, Size, IniName); 305: 306: Float = CreatePopupMenu() ;
307: AppendMenu(Float, MFSTRING, t, "Edit"); ЗОВ: 30S: while(Len > Total! 310: { 311: AppendMenu(Float, MFENABLED I MF_STRING, 312: itemsInMenu, Buffer); 313: Temp - strlen(Buffer) + 1; 314: Total += Temp; 315: memmove(Buffer, &Buffer[Temp], Size - Total); 316: ItemsInMenu++; 317; } 318: 319: return Float; 320: ) 321: 322: lllllllllllllllllllllllllllllllllllllll 323: // NewDesktopPrOC 324: IllllllllilllHIIIHIIIIIIIIIIIIIIIIIII 325: LRESULT CALLBACK NewDesktopProc(HWND hwnd, UINT Message, 326: WPARAM wParam, LPARAM IParam) 327: ( 328: if (Message = WM!_RBUTTCNDOWN> 329: PostMessage(MainWxndow, WM_SPECIAL, 0, IParam); 330: 331: return CallWirdowProc(01dDesk, hwnd. Message, wParam, IParam); 332: } Листинг 13.2. MENUAID.DEF 1:; MENUAID.DEF 2: NAME 3: DESCRIPTION 4: ЕУ.ЕТУРЕ 5: STUB 6: CODE 7: DATA 8: HEAPSIZE 9: STACKSTZE MenuAid 'MenuAid Window' WINDOWS 'WINSTUB FXE' PRELOAD MOVEABLE PRELOAD MOVEABLE MULTIPLE 4096 25120 Листинг 13.3. MENUAID.RC 1: // MENUAID.RC 2: MenuAid ICON "MENUAID.ICO" MENUAID.ICO Листинг 13.4. MENUAID.MAK (Borland) 1: ft MENUAID.MAK 2: 3: ft макросы 4: APPNAME - MenuAid 5: INCPATH - C:\BC\INCLUDE 6: LIBPATH = C:\BC\LIB 7: FLAGS == -H -ml -W -v -w4 -IS (INCPATH) -L$ (LIBPATH) 8: 9: ft компоновка 10; $ (APPNAME) , exe: $ (APPNAME) . obj $ (APPNAME) .def $ (APPNAME). res 11: bcc $ (FLAGS) S (APPNAME) .obj 12: rc $(APPNAME).res 13: ft компиляция 14: S(APPNAME).obj: $ (APPNAME) .cpp 15: bcc -c $ (FLAGS) $ (APPNAME). cpp 16: 17: ft компиляция ресурсов 18: S (APPNAME) .res: $ (APPNAME) .rc 19: rc -r -1$(INCPATH) S(APPNAME).rc
Листинг 13.5. MENUAID.МАК (Microsoft) 1: # MENUAID.МАК 2: 3: # макросы 4: APPNAME = MenuAid 5: 6: LINKFLAGS = /align:16, NUL, /nod llibcew libw 7: FLAGS = -c -AL -Gw -Ow -W3 -Zp 8: 9: # компоновка 10: $ (APPNAME) .exe : $ (APPNAME) . obj $ (APPNAME) . def $ (APPNAME) .res 11: link $ (APPNAME), $( LINKFLAGS) , $ (APPNAME) 12: rc $(APPNAME).res 13: 14: # компиляция 15: $ (APPNAME) . obj : $ (APPNAME) . cpp 16: cl —c $ (FLAGS) $ (APPNAME) .cpp 17: 18: It компиляция ресурсов 19: S (APPNAME) .res: $ (APPNAME) .rc 20: rc —r $(APPNAME).rc Эта программа позволяет запускать приложения, выбирая их мышью как из перечня в главном окне, так и из выскакивающего меню. Меню можно отобразить на любом месте рабочего стола, щелкнув правой кнопкой мыши. Эта программа сначала появляется в минимизированном виде. Можете оставить ее в таком состоянии или раскрыть, обнаружив те же самые файлы, что ив выскакивающем меню (см. рис. 13.3). Список программ, который вы можете запустить, хранится в файле MENUAID.INI, который должен размещаться в подкаталоге Windows. Опция Edit в программном меню позволяет вам модифицировать этот файл в любое время с тем, чтобы изменить список доступных файлов. Рис. 13.3. По умолчанию программа MenuAid появляется “свернутой”в пиктограмму. В “развернутом ” виде она выглядит, как показано здесь Коротко о MenuAid Код программы MenuAid был тщательно проверен и должен пойти на вашей системе без проблем. Однако, прежде чем вы начнете его выполнять, предупреждаю, что создание подкласса рабочего стола Windows может оказаться довольно деликатной операцией. Поэтому вам следует сохранить вашу работу, прежде чем начать испытания. Я не собираюсь тратить много времени на обсуждение этой программы. В частности, я предоставляю вам самим разобраться, как программа создает подкласс рабочего стола. (Совет: проверьте первые три вызова в MenuAid OnCreate, начиная со строчки 179). В этой программе используются два важных приема, о которых следует знать всем: MenuAid показывает, как создавать меню динамически, во время выполнения. Н Она также показывает, как читать содержимое файла инициализации, который в данном случае называется MENUAID.INI. В следующих двух разделах мы обсудим оба эти момента.
Работа с файлами инициализации Windows-программы хранят информацию в файлах инициализации, имеющих рас- ширение INI. Они бывают двух видов. Первый, маленький (но важный), называется WIN.INI. Доступ к содержимому этого файла можно получить с помощью следующих функций: GetProfileString: Выбирает символьную строку из WIN.INI GetProf ilelnt: Выбирает целочисленное значение из WIN.INI WriteProfileString: Пишет символьную строку в WIN.INI Вот два фрагмента из файла WIN.INI моего компьютера: [SoundBlaster] Port=220 Int=7 DMA=1 [PDOXWIN] WORKDIR=C:\PDOXWIN\WORKING PRIVDIR=C:\PDOXWIN\PRIVATE Если один из драйверов моей звуковой карты захочет узнать, какой порт использо- вать, он сможет получить доступ к соответствующей информации с помощью GetPro- filelnt. Paradox for Windows может узнать текущий рабочий каталог, обратившись к GetProfileString. Любая информация может быть изменена вызовом WriteProfileString. Проблема с этой схемой состоит в том, что на любой Windows-машине могут быть сотни программ, каждая из которых может пожелать сохранить инициализирующие данные. Поэтому вскоре файл WIN.INI становится еще более неуправляемым, чем он был при самой первой загрузке Windows. Противоядием от этого является следующий набор вызовов, который можно использовать для чтения или записи информации “частного” файла инициализации, носящего любое имя по вашему выбору. GetPrivateProFileString: Выбирает строку из INI-файла GetPrivateProFilelnt: Выбирает целое значение из INI-файла WritePrivateProFileString: Записывает строку в INI-файл Программа MenuAid использует GetPrivateProFileString для чтения информации из MENUAID.INI, хранящегося в подкаталоге Windows. Формат MENUAID.INI выглядит следующим образом: [Files] <FileName> ® <PathToFile> Основные части этого файла описываются следующим образом: Слово Files представляет заголовок единственного раздела файла инициализации. Слово Filename представляет собой элемент в выскакивающем меню программы. Строка PathToFile информирует MenuAid, где найти программу, которую хочет запустить пользователь. Рис. 13.5 поможет вам понять, как этот простой формат работает на практике. Как видно из файла инициализации, первый пункт программного меню запускает знаменитую игру Windows Solitaire. В частности, если пользователь выберет Sol из выскакивающего меню программы, MenuAid сможет найти место нахождения соответ- ствующей программы, сделав следующий вызов: if (GetPrivateProfileString("Files", FileName, "", Buffer, sizeof(Buffer), IniName) > 0)
Рис. 13.4. Выбор пункта Edit в плавающем меню запускает текстовый редактор Notepad с файлом MENUAID.INI Получив маршрут к указанной пользователем программе, MenuAid передает инфор- мацию в функцию WINEXEC, которая запускает эту программу. Если вы хотите изучить этот процесс более подробно, посмотрите процедуру Launch в исходном коде программы. GetPrivateProfileString int GetPrivateProfileString (LPCSTER, LPCSTR, LPCSTR, LPSTR, INT, LPCSTR) GetPrivateProfileString имеет шесть параметров: LPCSTR Ipszsection: адрес раздела в файле LPCSTR IpszEntry: адрес элемента раздела (например, Sol) LPCSTR IpszDefault: строка, возвращаемая по умолчанию в случае ошибки LPCSTR IpszReturnBuffer: буфер, в котором содержится ответ int cbReturnBuffer: размер буфера, содержащего ответ LPCSTR IpszFilename: файл инициализации (например, MENUAID.INI) Для получения информации из файла инициализации, отличного от WIN.INI, используйте функцию GetPrivateProfileString. Просто передайте в нее имя файла, имя раздела в файле и имя элемента раздела, который вы хотите прочитать. В ответ GetPrivateProfileString выберет этот элемент. Если функция не сможет найти его, то возвратит строку, которую вы указали в четвертом параметре. Пример: GetPrivateProfileString ("Files'*, FileName, Buffer, sizeof(Buffer), IniName) Вы должны знать, что программа MenuAid также использует GetPrivateProfileString для возвра- щения списка всех элементов раздела <Files> файла MENUAID.INI: int Len = GetPrivateProfileString("Files", NULL, Buffer, Size, IniName) Вызванная таким образом GetPrivateProfileString возвращает список всех элементов раздела <Files> файла MENUAID.INI. Каждый элемент оканчивается нулем. Программа MenuAid содержит функцию NewMenu, демонстрирующую одну из возможных способов анализа такого рода буфера. Динамические меню Другой технический прием, который вы сможете изучить с помощью программы MenuAid, заключается в создании динамических меню. Программа MenuAid должна создавать меню “на лету”, поскольку она никогда не знает, что может оказаться в файле MENUAID.INI.
Исключительно в целях обучения я также создал основное меню программы в самом начале этапа выполнения. Использовавшийся при этом прием может вам пригодиться, хотя маловероятно, что вам потребуется сразу строить меню. Вот как это работает: 196: HMENU TheMenu = CreateMenu(); 197: HMENU AMenu = CreatePopupMenu(); 198: AppendMenu (AMenu, MF_STRING, CM_EDIT, "Edit"); 199: AppendMenu (AMenu, MF_STRING, CMUPDATE, "Update") ; 200: AppendMenu (TheMenu, MF_ENABLED I MF_POPUP, 201: (UINT) AMenu, "SFile") ; 202: SetMenu(hwnd, TheMenu); Как видите, программа сначала создает базовое меню вызовом CreateMenu, а затем всплывающее меню, обращаясь к CreateOfUpMenu. Оба эти вызова возвращают дескрип- тор меню типа HMENU. Создав меню, FileBox заполняет его содержимое, вызывая AppendMenu. Заметьте, что AppendMenu используется также для добавления всплывающего меню к основному меню. AppendMenu BOOL AppendMenu (HMENU, UINT, UINT, LPCSTR) AppendMenu имеет четыре параметра: HMENU hmenu меню, к которому добавляются пункты uint fuFlags флажки, такие, как MF_STRING или MF_DISABLE UINT ifNewitem идентификатор, передающийся с WM_C0MMAND LPCSTR lpNewltem строка или данные, которые требуется показать Используйте функцию AppendMenu, чтобы добавить новый пункт к существующему меню. Состояние пункта можно указать во втором параметре. Пример: AppendMenu(AMenu, MFSTRING, CM_EDIT, "Edit") Создав меню вашей программы, вы можете показать его пользователю, вызвав SetMenu, Более интересным аспектом программы MenuAid является вызов. TrackPopUpMenu. Эта функция создает выскакивающее меню, которое в ответ на щелчки мыши, посылает сообщение WM_COMMAND в окно, указанное в четвертом параметре. В MenuAid это меню показывается вне рабочей области главного окна. Впрочем, вы можете создать меню, которое всплывает, когда пользователь щелкает правой кнопкой мыши на любом окне. TrackPopUpMenu имеет семь аргументов: HMENU hmenu; UINT fuFlags; int x; int y; int nReserved; HWND hwnd; const RECT FAR *lprc; выводит необходимое меню флажки, такие, как TBM_RIGHTLLINE координата столбца координата строки зарезервировано окно, в которое нужно посылать сообщения WM_COMMAND (владелец) прямоугольная область, в которой пользователь может щелкать мышью, не упуская меню
Как правило, при работе с меню нет ничего сложного. Windows в совершенстве покрывает эту область. Ее создатели проделали замечательную работу, предусмотрев средства, легкие для использования, как с точки зрения программиста, так и пользова- теля. Однако, если вы захотите поместить внутрь меню растровое изображение, это действительно окажется немного сложнее. Вы поймете, как сделать это, прочитав главу 18. В этой главе рассматривается ряд вопросов, касающихся программирования сложных меню. Резюме Эта глава дала вам достаточно исчерпывающее знакомство с созданием подклассов. Вы также рассмотрели: Сообщение WM_GETMINMAXINFO. Н Создание меню “на лету”. И Создание кнопок. Н Чтение файлов инициализации и манипуляции с ними. Функции DlgDirlist и DlgPerSelect. Можете откинуться на спинку кресла и поздравить себя с тем, что вы прошли материал, касающийся элементов управления. Возможно, вы, как Боб Дилан, почувст- вуете потребность разгрузить вагон, чтобы развеяться, хотя не уверен, что он думал о компьютерах, когда писал ту строчку! Так или иначе, почему бы вам не расслабиться и не отметить победу? Впрочем, истинные программисты до мозга костей, вероятно, захотят сесть и написать маленькую программу, показывающую все элементы управле- ния, которые мы изучили в последних четырех главах. Правда? Нет! Вопросы и ответы 1. Мне все еще непонятно отношение между IsDialogMessage и WM GETDLGCODE. Объясните, пожалуйста. Суть в том, что IsDialogMessage транслирует определенные нажатия клавиш, напри- мер, Tab или Shift-Tab так, что в результате выбирается следующий элемент управления или группа элементов управления. Однако IsDialogMessage посылает сообщения WM_GETDLGCODE во все элементы управления, находящиеся в ее поле зрения. И если какой-то из них отвечает сообщением DLGC WANTALLKEYS, все нажатия клавиш проходят через этот элемент управления. В FileBox требуется найти середину между этими двумя крайностями. Чтобы получить элемент управления такого рода, требуется создать подкласс. 2. Расскажите подробнее, когда я должен и когда не должен посылать сообщения в CallWindowProc. Функция NewEditProc изменяет поведение редактируемого поля, в основном реаги- руя особым образом на определенные сообщения. Например, будучи выбранным, редактируемое поле получает сообщение WM_FOCUS и отвечает подсвечиванием своего содержимого. Столь же мощный прием заключается в том, чтобы просто проглатывать любые сообщения, поступающие в элемент управления. Например, если вы не хотите, чтобы пользователь удалял что-нибудь в редактируемом поле, можете отказаться пере- давать все сообщения о нажатиях клавиш-стрелок и Backspace.
Вопросы для самопроверки 1. Какие стили используются д ля различения обычных кнопок и кнопок-селекторов при вызове CreateWindow? 2. Какой макрос из WINDOWSX вы можете использовать вместо сообщения LB_DIR? 3. Назовите десять макросов интерфейса управления сообщениями, которые можно использовать для манипуляции перечнями? 4. Какой параметр функции WNDPROC содержит структуру MINMAXINFO при передаче сообщения WM_GETMINMAXINFO? 5. Почему при определении формы и размера окна порой бывает лучше реагировать на сообщения WM_GETMINMAXINFO, нежели изменять координаты в аргументах CreateWindow? 6. Какой вызов API используется для замены оконной функции элемента управле- ния одной из ваших собственных функций? 7. Найдите макрос из WINDOWSX, использовавшийся в программе FileBox для подсвечивания текста в редактируемом поле. 8. Как создать выскакивающее меню? 9. В чем состоит разница между GetPrivateProfileString и GetProfileString? 10. Какое сообщение посылается всякий раз, когда вызывается InvalidateRect? Что делает второй параметр InvalidateRect? Упражнения 1. В программе FileBox закомментируйте ссылку на CallWindowProc из функции NewEditProc, а затем выполните программу. Что происходит? 2. Модифицируйте редактируемое поле так, чтобы пользователь не смог напечатать в нем никакого ошибочного символа в имени файла (например, пробел).
ОКНА В ЭЛЕГАНТНОМ СТИЛЕ Пора подробнее рассмотреть процесс создания и регистрации окон. В частности, в этой главе исследуется следующие вопросы: И Как изменить стиль окна. И Как создавать дочерние и всплывающие окна. Как изменить стиль окна с помощью GetClassWord и SetClassWord. М Как использовать поле cbWndExtra структуры WNDCLASS с помощью GetWindow- Word и SetWindowWord. В этой главе внимание сосредоточено на программе WinStyle, показывающей 10 различных дочерних окон с различными комбинациями оконных стилей в каждом. Создание стиля Вероятно, вы уже догадались, что фирма Microsoft не зря назвала свою новую операционную среду Windows (окна). Все технические приемы программирования, обсуждавшиеся до сих пор, так или иначе касались создания, уничтожения или поддерж- ки окон. Тем не менее мы поговорим на эту тему еще. Вы изучили всего несколько основных концепций, касающихся всплывающих и дочерних окон. Главное окно программы мечет эти маленькие икринки, создавая тем самым дополнительное пространство для отображения информации или для получения команд от пользователя. Каждому “ребенку”, как и основному окну, можно приписать конкретный стиль таким образом, чтобы приспособить их внешний вид и назначение стоящим перед ними целям. Совет. Если пользователь щелкнет мышью на любом дочернем окне, появится окно сообщения со списком стилей, использовавшихся при создании выбранного окна. Десять дочерних окон программы WinStyle располагаются в двух группах. Первая располагается вне физических границ основного окна, в то время как вторая выстраива- ется внутри рабочей области. Все окна из первого набора имеют стиль WSPOPUP, в то время как во втором наборе используется стиль WS_CHILD. Урок, который отсюда следует извлечь, прост: Окна стиля WS CHILD нельзя передвинуть за границы окна. Н С другой стороны, окна стиля WS POPUP можно двигать по всей поверхности рабочего стола.
Манипулируя стилевым параметром функции CreateWindow, можно построить окна, радикально отличающиеся друг от друга внешним видом. Например, некоторые из дочерних окон программы WinStyle имеют рамку, а другие не имеют. У некоторых есть заголовок, а некоторые имеют линейку прокрутки. У одних окон с линейкой заголовка нет кнопок минимизации или максимизации, а у других есть. Фактически программа WinStyle производит целый ряд окон, каждое из которых имеет свои собственные характерные черты. Дочерние окна программы WinStyle обладают важной способностью показывать свой стиль посредством окна сообщений. Таким образом, для того чтобы узнать, как создано дочернее окно, показанное на экране, достаточно щелкнуть на нем мышью. Оно сразу высветит комбинацию стилей, использовавшихся при его создании. Прежде чем читать дальше, запустите программу WinStyle (см. листинг 14.1) на своей машине, чтобы иметь возможность пройти ее по частям. Листинг 14.1. WINSTYLE.CPP 1: /////////////////////////////////////////////////// 2: // Программа: WINSTYLE.CPP 3: // Автор: Чарли Калверт 4: // Описание: WinStyle - программа для Windows 5: И Дата: 04/03/93 6: /////////////////////////////////////////////////// 7: «define STRICT 8: «include «windows.h> 9: «include «windowsx.hi 10: «pragma warning (disable:4068) 11: «pragma hdrstop 12: «include «string.h> 13: «include «stdlib.h> 14: «include "winstyle.h" 15: // ================================================ 16: // Интерфейс 17: // ================================================ 18: 19: static char szAppName(] = "WinStyle"; 20: static char szChildName[] = "StyleChrld"; 21: static HWND MainWindow; 22: static HINSTANCE hlnstance; 23: 24: 25: // ========================----=======--=—•==== 26: // Инициализация 27 : // ===========-------------------------================ 28: 29: //////////////////////////////////////////////////////// 30: // Точка входа 31: //////////////////////////////////////////////////////// 32: «pragma argsused 33: int PASCAL WinMain(HINSTANCE hinst, HINSTANCE hPrevInstance, 34: LPSTR IpszCmdParam, int nCmdShow) 35: ( 36: MSG Msg; 37: 38: if ((hPrevInstance) 39: if ((Register(hinst)) 40: return FALSE; 41: 42: if (((MainWindow = Create(hinst, nCmdShow))) 43: return FALSE; 44: 45: while (GetMessage)sMsg, NULL, 0, 0)) 46: ( 47; TranslateMessage(&Msg) ; 48: DispatchMessage(SMsg); 49: ) 50: 51: return Msg.wParam; 52: ) 53: 9 Чарльз Калверт
54: /////////////////////////////////////////////////////// 55: // Регистрация окна 56: ✓////////////////////////////////////////////////////// 57: BOOL Register(HINSTANCE hlnst) 58: { WNDCLASS WndClass; 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: ВО: 81: 82: 83: 84: 85: WndClass.style WndClass.IpfnWndProc WndClass.cbClsExtra WndClass.CbWndExtra WndClass.hlnstance WndClass.hlcon WndClass.hCursor WndClass.hbrBackground WndClass. IpszMenuName WndClass.IpszClassName = CS HREDRAW I CSVREDRAW; = WnSProc; = 0; = 0; = hlnst; = Loadicon(NULL, IDI_APPLICATION) = Loadcursor(NULL, IDC_ARROW); = NULL; = "MENU_1”; “ szAppName; BOOL Result = Registerclass (KWndClass); if ((Result) return FALSE ; WndClass.IpfnWndProc WndClass.cbWndExtra WndClass.hlcon WndClass.hCursor WndClass.IpszMenuName WndClass.IpszClassName - ChildWndProc; = sizeof(WORD); = NULL; = Loadcursor (NULL, IDC_IBEAM) ; = NULL; = szChildName; return Registerclass ((.WndClass); 86: ) 87: 88: /////////////////////////////////////////////////// 89: // Создание окна 90: ////////////////////////////////////////////////// 91: HWND Create(HINSTANCE hlnst, int nCmdShow) 92: ( 93: 94: hlnstance = hlnst; 95: 96: HWND hWindow = CreateWindow(szAppName, szAppName, 97: WS CAPTION I WSMINIMIZEBOX I WS_THICKFRAME, 98: 10, 150, CW_USEDEFAULT, CW_USEDEFAULT, 99: NULL, NULL, hlnst, NULL); 100: 101: if (hWindow = NULL) 102: return hWindow; 103: 104: ShowWindow(hWindow, nCmdShow); 105: UpdateWindow(hWindow); 106: 107: return hWindow; 108: ) 109: 110: // ======== 111: // Реализация 112: // ====== 113: 114: ////////////////////////////////////////////////////////// 115: // Процедура главного окна 116: ////////////////////////////////////////////////////////// 117: LRESULT CALLBACK _export WndProc(HWND hwnd, UINT Message, 118: WPARAM wParam, LPARAM IParam) 119: ( 120: switch(Message) 121: ( .122: HANDLE_MSG(hwnd, WM_CREATE, WinStyle_OnCreate) ; 123: HANDLE_MSG(hwnd, WM_DESTROY, WinStyle_OnDestroy); 124: HANDLE_MSG (hwnd, WM_COMMAND, WinStyle_OnCommand) ; 125: default: 126: return WinStyle_DefProc(hwnd. Message, wParam, IParam); 127: ) 128: )
129: 130: 131: //////////////////////////////////////////////////////////// 132: // Arrangewinds 133: //////////////////////////////////////////////////////////// 134: void ArrangeWinds(HWND hwnd) 135: ( 136: RECT R; 137: 138: int j = 0; 139: 140: for (int i = 0; i < 9; i++) 141: ( 142: Movewindow(Childwindows[i], 10 + (j * 100), 143: 10, 100, 100, TRUE); 144: if (i == 4) 145: j = 0; 146: else 147: j++; 148: ) 149: 150: GetWindowRect(hwnd, 4R); 151: 152: Movewindow(Childwindows[iJ, 153: R.left + 10 + 154: GetSysteniMetrics (SM_CXFRAME) + (j * 100), 155: R.top + GetSysteniMetrics (SM_CYCAPTION) + 156: GetSysteniMetrics (SM_CYFRAME) + 157: GetSysteniMetrics (SM_CYMENU) + 158: 10, 100, 100, TRUE); 159: ) 160: 161: /////////////////////////////////////////////////////// 162: // Обработка сообщения WM_Create 163: ////////////////////////////////////////////////////// 164: #pragma argsused 165: BOOL WinStyle_OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) 166: ( 167: 168: Patternl = LoadBitmap(hlnstance, "PATTERN1"); 169: if ('Patternl) 170: MessageBox(hwnd, "No Pattern”, "Error", MB_OK); 171: 172: Pattern2 = LoadBitmap(hlnstance, "PATTERN2”); 173: if (!Pattern2) 174: MessageBox(hwnd, "No Pattern", "Error", MB_OK); 175: 176: Patterns = LoadBitmap(hlnstance, "PATTERNS”); 177: if (!Pattern2) 178: MessageBox(hwnd, "No Pattern", "Error", MB_OK); 179: 180: hPurpleHaze = CreateSolidBrush(RGB(127, 255, 255)); 181: 182: Setclassword(hwnd, GCW_HBRBACKGROUND, (WORD)hPurpleHaze); 183: 184: 185: for (WORD i = 0; i < 9; i ++) 186: ( 187: Childwindows [i] = CreateWindow(szChildName, NULL, Styles[i], 188: 0,0,0,0, hwnd, NULL, hlnstance, NULL); 189: ) 190: 191: Childwindows[i] = CreateWindow(szChildName, NULL, Stylesfi], 192: 0, 0, 0, 0, NULL, NULL, hlnstance, NULL); 193: 194: 195: hPurpleHaze = CreateSolidBrush(RGB(255, 255, 127)); 196: 197: SetClassWord (Childwindows [0], GCW_HBRBACKGROUND, 198: (WORD)hPurpleHaze); 199: 200: for (i =0; i < 10; i++) 201: Setwindowword(Childwindows[i], 0, i); 202: 203: ArrangeWinds(hwnd);
204: 205: SetWindowText(Childwindows[8], "Inactive"); 206: return TRUE; 207: ) 208: 209: //////////////////////////////////////////////////////////// 210: // Обработка сообщения WM DESTROY 211: /////////////////////////7////////////////////////////////// 212: flpragma argsused 213: void WinStyle_OnDestroy(HWND hwnd) 214: ( 215: HBRUSH OldBrush; 216: 217: DeleteObject(Patternl) ; 218: DeleteObject(Pattern2); 219: DeleteObject(Pattern3) ; 220: 221: OldBrush = (HBRUSH) GetClassWord(hwnd, GCW HBRBACKGROUND) ; 222: SetClassWord (hwnd, GCW_HBRBACKGROUND, 223: (WORD)GetStockObject(WHITE_BRUSH)); 224: DeleteBrush(OldBrush); 225: 226: PostQuitMessage(0); 227: ) 228: 229: llllllllllllllllllllllllllllllllllllllllllllllllllllllllllll 230: // Обработка сообщения WM COMMAND 231: /////////////////////////7////////////////////////////////// 232: ((pragma argsused; 233: void WinStyle_OnCommand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify) 234: ( 235: HBRUSH OldBrush; 236: 237: switch (id) 238: ( 239: . case CM_ARRANGE: 240: ArrangeWinds(hwnd); 241: 242: Case CM_WHISTLE: 243: SetFocus(Childwindows[9]); 244: break; 245: 246: case CM_RED: 247: OldBrush = (HBRUSH)GetClassWord(hwnd, GCW_HBRBACKGROUND); 248: hPurpleHaze = CreateSolidBrush(RGB(255, 127, 127)); 249: SetClassWord (hwnd, GCW_HBRBACKGROUND, (WORD) hPurpleHaze) ; 250: DeleteBrush(OldBrush); 251: InvalidateRect(hwnd, NULL, TRUE); 252: break; 253: 254: case CM_GREEN: 255: OldBrush = (HBRUSH)GetClassWord(hwnd, GCW_HBRBACKGROUND) ; 256: hPurpleHaze = CreateSolidBrush(RGB(127, 255, 127)); 257: SetClassWord (hwnd, GCW_HBRBACKGROUND, (WORD) hPurpleHaze) ; 258: DeleteBrush(OldBrush); 259: InvalidateRect(hwnd, NULL, TRUE); 260: break; 261: 262: case CM_BLUE: 263: OldBrush = (HBRUSH)GetClassWord(hwnd, GCW_HBRBACKGROUND); 264: hPurpleHaze = CreateSolidBrush(RGB(127, 127, 255)); 265: SetClassWord (hwnd, GCW_HBRBACKGROUND, (WORD) hPurpleHaze) ; 266: DeleteBrush(OldBrush); 267: InvalidateRect(hwnd, NULL, TRUE); 268: break; 269: 270: case CM_SPECIAL1: 271: OldBrush = (HBRUSH)GetClassWord(hwnd, GCWHBRBACKGROUND); 272: hPurpleHaze = CreatePatternBrush(Patternl); 273: SetClassWord (hwnd, GCW HBRBACKGROUND, (WORD) hPurpleHaze) ; 274: DeleteBrush(OldBrush); 275: InvalidateRect(hwnd, NULL, TRUE); 276: break; 277: 278: case CM_SPECIAL2:
279: OldBrush = (HBRUSH)GetClassWord(hwnd, GCW_HBRBACKGROUND) ; 280: hPurpleHaze = CreatePatternBrush(Pattern2); 281: SetClassWord(hwnd, GCW_HBRBACKGROUND, (WORD)hPurpleHaze) ; 282: DeleteBrush(OldBrush); 283: InvalidateRect(hwnd, NULL, TRUE); 284: break; 285: 286: case CMSPECIAL3: 287: OldBrush = (HBRUSH)GetClassWord(hwnd, GCW_HBRBACKGROUND) ; 288: hPurpleHaze = CreatePatternBrush(Pattern3); 289: SetClassWord(hwnd, GCW_HBRBACKGROUND, (WORD) hPurpleHaze) ; 290: DeleteBrush(OldBrush); 291: InvalidateRect(hwnd, NULL, TRUE); 292: break; 293: 294: case CMEXIT: 295: SendMessage(Childwindows[9], WM_CLOSE, 0, 0); 296: 297: OldBrush = (HBRUSH)GetClassWord(Childwindows[0], 298: GCW_HBRBACKGROUND); 299: SetClassWord(ChildWindows(0), GCW_HBRBACKGROUND, 300: (WORD)GetStockObject(WHITE_BRUSH)); 301: DeleteBrush(OldBrush); 302: 303: DestroyWindow(hwnd); 304: break; 305: 306: case CM_HELP: 307: MessageBox(hwnd, 308: "Click on child windows to see their style", 309: "Help", MBOK I MB_ICONASTERISK) ; 310: break; 311: ) 312: ) 313: 314: 315: // =================================================== 316: // Дочерние окна 317:-----// -----—жж———---------------------------=====----- 318: 319: ////////////////////////////////////////////////////// 320: // Оконная процедура 321: ////////////////////////////////////////////////////// 322: LRESULT CALLBACK _export ChildWndProc(HWND hwnd, UINT Message, 323: WPARAM wParam, LPARAM IParam) 324: ( 325: switch(Message) 326: ( 327: HANDLEJMSG (hwnd, WM_LBUTTONDOWN, StyleChild_OnLButtonDown) ; 328: HANDLEJMSG(hwnd, WM_PAINT, StyleChild_OnPaint); 329: default: 330: return StyleChild_DefProc(hwnd. Message, wParam, IParam); 331: } 332: ) 333: 334: /////////////////////////////////////////////////////////////// 335: // Обработка сообщения WM_LBUTTONDOWN 336: /////////////////////////////////////////////////////////////// 337: ftpragma argsused 338: void StyleChild_OnLButtonDown(HWND hwnd, BOOL fDoubleClick, 339: int x, int y, UINT keyFlags) 340: ( 341: char szNum[100]; 342: 343: WORD i = GetWindowWord(hwnd, 0); 344: wsprintf(szNum, "Number: %d", i); 345: MessageBox(hwnd, szStyles[i], szNum, 346: MB_OK I MB_ICONINFORMATION) ; 347: ) 348: 349: //////////////////////////////////////////////////////////////// 350: // Обработка сообщения WM PAINT 351: /////////////////////////7////////////////////////////////////// 352: void StyleChild_OnPaint(HWND hwnd) 353: (
354: PAINTSTRUCT PaintStruct; 355: HDC PaintDC; 356: char IpszBuffer[100]; 357: RECT R; 358: 359: WORD i = GetWindowWord(hwnd, 0); 360: wsprintf(IpszBuffer, ”%d", i); 361: 362: PaintDC = BeginPaint (hwnd, SPaintStruct);. 363: 364: SetTextColor(PaintDC, RGB(0, 0, 255)); 365: SetBkMode(PaintDC, TRANSPARENT); 366: GetClientRect(hwnd, SR); 367: DrawText(PaintDC, IpszBuffer, -1, SR, 368: DTSINGLELINE I DTCENTER I DTVCENTER); 369: 370: EndPaint(hwnd, SPaintStruct); 371: ) Листинг 14.2. WINSTYLE.H 1: ////////////////////////////////////////////////////////// 2: // Программа: WINSTYLE.H 3: // Автор: Чарли Калверт 4: // Описание: WinStyle - программа для Windows 5: // Дата: 04/03/93 6: ///////////////////////////////////////////////////////// 7: 8: // Константы 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: ♦ define CM_ARRANGE 1 ♦ define CM_WHISTLE 2 ♦ define CM_EXIT 3 ♦ define CM_HELP 4 ♦ define CM_BLUE 101 ♦ define CM_RED 102 ♦ define CM_GREEN 103 ♦ define CM_SPECIAL1 104 ♦ define CM_SPECIAL2 185 ♦ define CM_SPECIAL3 106 DWORD Styles[] = ( WSPOPUP I WSVISIBLE, WS_POPUP I WS_VISIBLE I WSCAPTION, WS POPUP I WS_VISIBLE I WS_CAPTION I WS MINIMIZEBOX I WS_MAXIMIZEBOX, WS_POPUP I WS VISIBLE I WS_CAPTION I WS_HSCROLL I WS_VSCROLL, WS_OVERLAPPEDWINDOW ( WS_VISIBLE, WS_CHILDWINDOW | WS_VISIBLE, WS_CHILDWINDOW | WS_VISIBLE I WS_THICKFRAME, WS_CHILDWINDOW I WS_VISIBLE I WS_BORDER | WS_CAPTION, WS CHILDWINDOW | WS_VISIBLE I WS_CAPTION I WS_DISABLED, WS_OVERLAPPEDWINDOW I WS-VISIBLE ); char *szStyles[] = ( "WS_POPUP I WS_VISIBLE", "WS_POPUP I WS_VISIBLE I WS_CAPTION", "WS_POPUP I WS_VISIBLE I WS_CAPTION l\ WS_MINIMIZEBOX I WS_MAXIMIZEBOX", ”WS_POPUP I WS_VISIBLE | WS_CAPTION l\ WS_HSCROLL I WS_VSCROLL", "WS_OVERLAPPEDWINDOW I WS_VISIBLE", "WS_CHILDWINDOW | WS_VISIBLE", "WS_CHILDWINDOW I WS_VISIBLE l\ WS_THICKFRAME", "WS_CHILDWINDOW I WS_VISIBLE I WS_BORDER l\ WS_CAPTION", "WS_CHILDWINDOW | WS_VISIBLE I WS_CAPTION l\ WS_DISABLED", "WS_OVERLAPPEDWINDOW | WS_VISIBLE" // Объявления для класса WinStyle ♦define WinStyle_DefProc DefWindowProc
55: BOOL WinStyle_OnCreate (HWND hwnd, CREATESTRUCT FAR* IpCreateStruct); 56: void WinStyle_OnDestroy(HWND hwnd); 57: void WinStyleOnCommand(HWND hwnd, int id, HWND hwndCtl, 58: UINT codeNotify); 59: 60: ((define StyleChild_DefProc DefWindowProc 61: void StyleChild_OnPaint(HWND hwnd); 62: void StyleChildOnLButtonDown(HWND hwnd, BOOL fDoubleClick, 63: int x, int y, UINT keyFlags); 64: 65: // Переменные 66: HWND Childwindows[10]; 67: HBRUSH hPurpleHaze; 68: HBITMAP Patternl, Pattern2, Pattern3; 69: 70: // Родительские процедуры 71: LRESULT CALLBACK _export WndProc(HWND hwindow, UINT Message, 72: WPARAM wParam, LPARAM IParam) ; 73: BOOL Register(HINSTANCE hinst); 74: HWND Create(HINSTANCE hinst, int nCmdShow); 75: 76: // Дочерние процедуры 77: LRESULT CALLBACK _export ChildWndProc(HWND hwnd, UINT Message, 78: WPARAM wParam, LPARAM IParam); Листинг 14.3. WINSTYLE.RC 1: ((include "winstyle.h" 2: 3: MENU_1 MENU 4: BEGIN 5: MENUITEM “«Exit", CMEXIT 6: MENUITEM "«Arrange", CM_ARRANGE 7: MENUITEM "«Whistle", CM_WHISTLE 8: POPUP "«Background" 9: BEGIN 10: MENUITEM "«Blue", CM_BLUE 11: MENUITEM "SRed", CM RED 12: MENUITEM "«Green ", CM_GREEN 13: MENUITEM "sSpeciall”, CM_SPECIAL1 14: MENUITEM "SSpecial_2", CM_SPECIAL2 15; MENUITEM *'«Special_3", CM_SPECIAL3 16: END 17: MENUITEM "«Help", CMHELP 18: END 19: 20: PATTERNl BITMAP "PATTERN1.BMP" 21: PATTERN2 BITMAP "PATTERN2.BMP" 22: PATTERNS BITMAP "PATTERN3.BMP" Листинг 14.4. WINSTYLE.MAK (Borland) 1: # WINSTYLE.MAK 2: 3: # макросы 4: APPNAME = WinStyle 5: INCPATH = C:\BC\INCLUDE 6: FLAGS = H ml -W -v -w4 -1$ (INCPATH) 7: 8: # компоновка 9: $ (APPNAME) .exe: $ (APPNAME) . obj $ (APPNAME) .def $ (APPNAME) . res 10: bcc $ (FLAGS) $ (APPNAME) .obj 11: rc $(APPNAME).res 12: 13: К компиляция 14 : $ (APPNAME) . obj : $ (APPNAME) . cpp 15: bcc -c $(FLAGS) $(APPNAME).cpp 16: 17: ft ресурсы 18 : $ (APPNAME) . res: $ (APPNAME) . rc 19: rc -r -i$ (APPNAME) .rc
264 ДЕНЬ 14 Листинг 14.5. WINSTYLE.МАК (Microsoft) 1; ft ====».•— г===— 2: If WINSTYLE.КАК 3: ---------,=-_===. 4: 5: APPNAME = WinStyle 6: 7: ft—---=».======^——-------------------------- 8 * компоновка 9 : ft——— =CMM — ^.-Ц— .»! l_ — 10: $(APPNAME).exe : $(APPNAME).obj S(APPNAME).def S(APPNAME).res 11. link $ (APPNAME), /align:16, NtTL, (r.od llibcew libw, S(APPNAME) 12: rc S(APPNAME).res 13: 14: ~-====^—^=- 15: ft компиляция 16: ftn=~~~" n-_——-.. _ 17: S (APPNAME) .obj : $ (APPNAME) .cpp 18: cl -c AL GA -Ow -W3 -Zp 5 (APPNAME) .cpp 19: 20; ft=^====^^——-=^========»»-—™-==w=™==^_ 21: ft ресурсы 22: #====-=»----- 23: $ (APPNAME) . res: $ [APPNAME) . rc 24 : rc -r $ (APPNAME) . rc Эта программа создаст ряд дочерних и всплывающих окон, иллюстрирующих исполь- зование стилевого параметра функции CreateWindow для управления внешним видом окна. Заметьте, что половина дочерних окон основной программы имеет стиль WS POPUP и может свободно перемещаться по рабочему столу. Другая половина имеет стиль WS CHILD и ограничена рабочей областью основного окна. Чтобы увидеть, какой именно стиль ассоциируется с конкретным окном, щелкните на нем мышью. Меню программы показывает, что все дочерние окна управляются основным окном. То есть основное окно является родителем, а остальные — детьми и должны его слушаться. WinStyle Inactive С5Й Рис. 14.1. Программа WinStyle отображает 10 дочерних окон Создание дочерних окон Как и в предыдущих двух главах, чтобы понять работу этой программы, вам нужно сосредоточиться на функции обработчика сообщения WM_CREATE. Код, на который следует обратить внимание, выглядит следующим образом:
static char szChildName[] = "StyleChild"; for (WORD i = О; i < 9; i ++} < Childwindows[i] = CreateWindow(szChildName, NULL, Styles[i], 0, 0, 0, 0, hwnd, NULL, hlnstance, NULL} } Childwindows[i] = CreateWindow(szChildName, NULL, Styles[i], 0, 0, 0, 0, NULL, NULL, hlnstance, NULL}; Это не более чем еще два обращения к функции CreateWindow. Как видите, в данном случае я присвоил оконному классу имя StyleChild, а не одно из имен таких предопре- деленных оконных классов, как “button” или “listbox”. Поскольку этот класс не был зарегистрирован в Windows заранее, программа WinClass вынуждена зарегистрировать его сама. Строгих правил, определяющих место, где следует регистрировать оконный класс, нет. Как правило, большие классы регистрируют в отдельном модуле, а маленькие — в той же самой функции, что и основное окно. Однако это дело вкуса, и программисты вольны разрабатывать или перенимать любой стиль, устраивающий их (или их начальство). Замечание. Некоторая путаница происходит из-за того, что программисты имеют тенденцию называть любое порожденное окно дочерним. Однако следует отличать технический термин WS CHILD от более широкого разговорного понятия “дочерний”. Так или иначе класс StyleChild достаточно невелик, и, вероятно, выглядел бы не на своем месте, будучи изолированным в отдельном модуле. Поэтому я загнал код его регистрации в функцию Register: 57: BOOL Register(HINSTANCE hlnst) 58: ( 59: 60: WNDCLASS WndClass; 61: WndClass.style = CSHREDRAW I CS 62: WndClass.IpfnWndProc = WndProc; 63: WndClass-cbClsExtra - 0; 64: WndClass.cbWndExtra = 0; 65: WndClass.hlnstance = hlnst; 66: WndClass.hIcon = Loadicon(NULL, ( 67: WndClass.hCursor = Loadcursor (NULL, 68: WndClass.hbrBackground = NULL; 69: WndClass.IpszMenuName = "MENU_1"; 70: 71: WndClass.IpszClassName = szAppName; 72: 73: 74: 75: 76: BOOL Result = Registerclass (bWndClass); if ((Result) return FALSE ; 77: WndClass.IpfnWndProc » ChildWndProc; 78: WndClass.cbWndExtra = sizeof(WORD); 79: WndClass.hlcon = NULL; 80: WndClass.hCursor = LoadCursor(NULL, 81: WndClass.IpszMenuName = NULL; 82: 83: WndClass.IpszClassName - szChildName; 84: 85: 86: return Registerclass (KWndClass); } VREDRAW; IDC IBEAM) ; IDI_APPLICATION); IDC_ARROW) ; Первая половина этого кода почти такая же, как любая другая функция Register, которые вы видели до сих пор, за исключением того, что поле hbrBackground полагается равным NULL. Это позволяет WinStyle использовать особый фон, сгенерированный в функции WinStyle_OnCreate. В центре внимания функции WinStyle_OnCreate регистрация класса StyleChild. Четыре поля класса WinStyle используются там без изменения, в то время как остальные шесть переопределяются.
В частности, вы могли заметить, что StyleChild имеет свою собственную оконную процедуру и свой собственный курсор. Чтобы посмотреть, как работает курсор, загрузите программу и проведите мышь по одному из активных дочерних окон, например, по окну 5. Вы увидите, что курсор меняет свой внешний вид со стрелки на 1-образный. Бдительные читатели, вероятно, также заметили, что полю cbWndExtra отводится два байта (слово). Просто здесь Windows информируется о том, что она должна резервировать два байта памяти всякий раз, когда создается новое окно класса StyleChild. Это делается на всякий случай. Windows никогда не тронет этого пространства, оно зарезервировано для программиста. В данном случае WinStyle просто заполняет эту область номером окна. Иначе говоря, у первого окна в этом поле будет нуль, у второго — 1, у третьего — 2 и т.д. Позже, во время выполнения процедуры изображения дочернего окна, WinStyle возьмет это число из памяти и отобразит на экране. Однако я забегаю вперед. Сейчас, вероятно, лучше всего остановиться, сосредото- чившись на обработке сообщения WM_CREATE. Все окна, за исключением одного, создаются в едином цикле. Последнее окно стоит в стороне от всех остальных, так как оно не признает своего предка хозяином и, следовательно, не имеет владельца. Поэтому его целиком можно спрятать за основным окном, а пользователь может совершенно забыть о его существовании. Поскольку может возникнуть необходимость вызвать это окно на передний план, я устроил все таким образом, что пользователю достаточно будет “свистнуть”, и оно всплывет оттуда, где было спрятано. Это делается с помощью функции SetFocus. Возьмите эту функцию себе на заметку, поскольку будете применять ее достаточно часто: case CM_WHISTLE: SetFicuS(Childwindows[9]); break; Функция SetFucus HWND SetFocus(HWND) HWND hwnd: описатель окна, которое должно оказаться в фокусе В случае успеха SetFocus возвращает дескриптор HWND последнего из окон, находившегося в фокусе. В противном случае функция возвращает NULL. Функцией SetFocus очень просто пользоваться. В качестве единственного параметра ей переда- ется дескриптор окна, который вы хотите поместить в фокус. В результате это окно выводится на передний план и дальнейший ввод клавиатуры адресуется непосредственно ему. В случае программы WinStyle это особенно легко, поскольку она заботливо сохраняет дескрипторы всех дочерних окон в массиве. Если дескрипторы окна или элемента управления недоступны, то обычно его можно получить с помощью обращения к GetWindow или GetDlgltem. Пример: SetFocus (MyWindow); Возможно, вы заметили, что, вызывая CreateWindow для своих детей, WinStyle обнуляет параметры х, у, nwidth, и nheight. Это делается отчасти из-за того, что вычисление правильных размеров довольно сложно. Поэтому я храню эти длинные строчки кода в отдельной функции, где их легко видеть. Но еще важнее то, что этот код может быть вызван более одного раза. Как только пользователь выбирает пункт Arrange из основного меню, все окна спешат назад, на исходную позицию. Дело в том, что код для упорядочения окон должен вызываться как во время создания программы, так и при выборе пункта меню Arrange. Поэтому он располагается в своей собственной функции: 134: void ArrangeWinds(HWND hwnd) 135: ( 136: RECT R; 137: 138: int j = 0; 139: 140: for (int i = 0; i < 9; i++) 141: (
142: MoveWindow(ChildWindows[i], 10 + (j * 100), 143: 10, 100, 100, TRUE); 144: if (i == 4) 145: j = 0; 146: else 147: j++; » 148: } 149: 150: GetWindowRect(hwnd, SR); 151: 152: MoveWindow(Childwindows[i], 153: R.left + 10 + 154: GetSystemMetrics(SM_CXFRAME) + (j * 100), 155: R.top + GetSystemMetrics (SM_CYCAPTION) + 156: GetSystemMetrics(SM_CYFRAME) + 157: GetSystemMetrics(SM_CYMENU) + 158: 10, 100, 100, TRUE); 159: } Этот код служит введением в изящную подпротрамму MoveWindow, которая, по-ви- димому, окажется полезной во многих ситуациях. Функция MoveWindow BOOL MoveWindow (HWND, int, int, int, int, BOOL) HWND hwnd; int nLeft; int nTop; int nWidth; int nHight; BOOL fRepaint; /* Дескриптор окна */ /* Координата x */ /* Координата у */ /* Ширина окна */ /* Высота окна */ /* Флаг перерисовки */ Вызов MoveWindow очень прост. С первым параметром передается дескриптор HWND окна, которое вы хотите передвинуть, а в остальных четырех параметрах — координаты прямоугольника, в который вы хотите поместить это окно. С помощью этой процедуры одновременно можно изменить положение и размер окна. Если функция MoveWindow не вполне удовлетворяет ваши потребности, можете использовать в качестве дополнения к ней функцию SetWindowPos. Пример: MoveWindow(hMywindow, 0, 0, 100, 100, TRUE) Необходимо заметить, что положение дочернего окна определяется координатами его владельца, в то время как позиция всплывающего окна определяется его положением на экране. В любом случае позиция (0,0) рассматривается как левый верхний угол координатной системы. Так, в системе координат рабочей области окна это обычно левый верхний угол окна, а в системе координат экрана — левый верхний угол экрана. Замечание. В программе WinStyle окна 0 и 5 имеют одинаковые координаты, но размещаются в различных местах экрана. То же самое можно сказать об окнах 1 и 6, 2 и 7, 3 и 8. Разница в том, что всплывающие окна используют координаты экрана, а дочерние окна — координаты рабочей области родительского окна. Эта разница проявляется во множестве различных фрагментов программы. Например, в случае вызовов функций GetClientRect и GetWindowRect первая устанавливает координаты окна относительно его собственных измерений, в то время как последняя возвращает оконные координаты относительно экрана. Иначе говоря, GetClientRect всегда возвращает (0,0) в качестве левого верхнего угла окна. Если бы в этом было все дело, то предмет системы координат Windows исчерпывался бы несколькими предложениями. Однако позиция (0,0) на самом деле не всегда определяется как верхний левый угол экрана или окна. Даже эти священные экранные координаты могут измениться, если программист решит устано- вить окно посредством вызова функций SetWievportOrg и SetWindowOrg. Эти мощные вызовы обсуждаются в главе 18. Чтобы проверить, действительно ли вы поняли основы координатной системы Windows, взгляните функцию, которая определяет положение последнего из созданных окон, назы- ваемое окном номер девять (невольная дань Джону Леннону). Это окно, как вы помните, не имеет владельца. Поэтому его размеры определяются в экранных координатах.
Впрочем, я хотел поместить его вместе с группой дочерних окон, чтобы вы могли видеть, что оно может быть скрыто за основным окном. Эта черта характерна для окон, не имеющих владельца. Но его “сестры” всегда располагаются спереди от своего предка. Рассмотрите внимательно вызов, устанавливающий размерности окна номер девять: ВЕСТ В; GetWindowRect(hwnd, SR); Movewindow(Childwindows[i], B.left + 10 + (j * 100) + GetSystenMetrics (SMCXFRAME) , B.top + GetSystemMetrics (SM_CYCAPTION) + GetSystemMetrics (SM_CYFRAME) + GetSystemMetrics (SM_CYMENU) + 10, 100, 100, TRUE); Программа начинается с получения координат основного окна программы в базисе экрана. Теперь как окно номер девять, так и его родитель, определяются относительно своей позиции на экране. К этой позиции добавляется десятка, а присутствие четырех дочерних окон учитывается посредством увеличения в j раз ширины каждого из этих окон. Впрочем, это еще не конец. Прежде чем может быть вычислено предпочтительное положение окна, должна быть также учтена ширина его рамки. Для этого программа WinStyle обращается к GetSystemMetrics и передает в нее константу SM_CXFRAME. Словом, программа просит Windows вернуть ширину левой стороны рамки этого и каждого из следующих окон. Эти вычисления должны быть выполнены прежде, чем будет правильно вычислено положение вершины окна номер девять. В частности, WinStyle вызывает GetSystemMet- rics, чтобы получить высоту рамки от верха окна, высоту заголовка и высоту полоски меню. Все эти данные добавляются к экранным координатам вершины родительского окна и увеличиваются на 10. Замечание. Нормальным дочерним окнам не требуется учитывать высоту полоски меню или заголовка. Им достаточно знать, что полоска меню и заголовок располагаются в 10 пикселах от вершины рабочей области окна, которому они принадлежат. Иначе говоря, полоска меню, заголовок и рамка никогда не рассматриваются, как часть рабочей области окна. Объяснение всех этих штучек, касающихся экранных координат и координат внутри рабочей области, GetWindowRect и GetClientRect, заняло у меня не слишком много времени. Впрочем, я думаю, полезно будет указать на то, что ни одна из этих коорди- натных систем сама по себе не является особенно сложной. Если порой накопленная информация начнет слегка подавлять, замедлитесь и осваивайте все это постепенно, шаг за шагом. Продвигайтесь неспеша, найдите время на осмысление пройденных вещей, и вы обнаружите, что Windows действительно не сложна для программирования. Если хотите сделать что-то в хорошем стиле, понадобится много классов Наверное, наступило подходящее время поговорить об оконных стилях. Вот стили десяти дочерних окон: 1. WS_POPUP | WS_VISIBLE 2. WSPOPUP | WS_VISIBLE | WSCAPTION 3. WS_POPUP I WS_VISIBLE I WS_CAPTION I WS_MINIMIZEBOX I WS_MAXIMIZEBOX 4. WS_POPUP I WS_VISIBLE | WS_CAPTION | WS_HSCROLL | WS_VSCROLL 5. WS_OVERLAPPEDWINDOW I WS_VISIBLE 6. WS_CHILDWINDOW | WS_VISIBLE 7. WS_CHILDWINDOW | WS_VISIBLE | WS_THICKFRAME 8. WS_CHILDWINDOW | WS_VISIBLE I WS_BORDER | WS CAPTION 9. WS_CHILDWINDOW I WS_VISIBLE I WS_CAPTION | WS_DISABLED 10. WS_OVERLAPPEDWINDOW I WS_VISIBLE
Четыре первых окна имеют стиль WS_POPUP, поэтому в них используются коорди- наты экрана, а не рабочей области. Кроме того, их можно передвигать за границы родительского окна, в то время как дочерним окнам не позволяется отлучаться слишком далеко от гнезда. Заметим также, что пятое и десятое окна имеют один и тот же стиль. Разница между ними состоит в том, что у одного из них есть владелец, а у другого нет. Иначе говоря, восьмой параметр пятого окна содержит дескриптор HWND основного окна WinStyle, а восьмой параметр десятого окна — NULL. Константа WS_OVERLAPPEDWINDOW на самом деле является комбинацией сле- дующих шести стилей: WS_OVERLAPPED WS_CAPTION WS_SYSMENU WS_THICKFRAME WS_MINIMTZEBOX WS_MAXIMI ZEBOX Разработчики Windows создали стиль WS_OVERLAPPEDWINDOW, поскольку эти шесть констант часто встречаются вместе. Они просто подумали, что любой устал бы от постоянного написания одних и тех же шести слов, и изобрели сокращение. Пожмем руку разработчикам Windows: они сделали доброе дело! Большинство стилей довольно ясны. Исключением является дочернее окно 9, которому назначен стиль WS_DISABLED. Окна этого стиля абсолютно неподвижны. Ими нельзя манипулировать с помощью мыши или клавиатуры. Замечание. Окна с такими же свойствами можно создавать с помощью вызова EnableWindow. Эта функция API зависит от двух параметров: дескриптора HWND окна, которое вы хотите обездвижить, и параметра типа BOOL, равного FALSE. Вызов этой функции со вторым параметром, равным TRUE, аннулирует инертность окна. В любом случае цель программы WinStyle состоит в том, чтобы определять стили визуально с помощью программы. Как видите, некоторые из них имеют рамки, другие — кнопки минимизации и т.д. Для того чтобы увидеть, как именно создавался тот или иной визуальный эффект, просто щелкните на окне мышью. Таким путем идет сейчас весь мир. Наши справочные руководства становятся все более интерактивными. Писатели больше не хотят объяснять все на свете; они предпо- читают просто сказать вам: “Эй, почему бы вам просто не запустить программу и не посмотреть? Просто щелкните на одном из дочерних окон и увидите, что я имею в виду!” Замечание. Стили этой программы хранятся в массиве подобно тому, как хранились атрибуты файла для DlgDirList (см. код в предыдущей главе). Как я объяснил на довольно глубоком уровне в главе 13, этот способ хранения списков идентификаторов или констант может помочь упростить вашу программу. Это прием, которым должны овладеть все Windows-программисты. Кусочек фона К настоящему времени вы уже познакомились с основными элементами программы WinStyle. Вы знаете, в чем состоит отличие между дочерними и всплывающими окнами и как изменять их внешний вид, варьируя стилями. Вооружившись этими идеями, вы можете двигаться дальше к исследованию изменения фона окна. Изучая эгу технику, вы сможете овладеть функцией SetWindowLong, представленной в предыдущей главе. Сле- дующие две строчки кода изменяют основные характеристики класса WinStyle: hPurpleHaze = CreateSolidBrush(RGB(127, 255, 255)); SetClassWord(hwnd, GCW_HBRBACKGROUND, (WORD)hPurpleHaze) ; Чтобы лучше почувствовать, что здесь происходит, сначала рассмотрите следующую выдержку из функции Register: WndClass.hlcon - Loadicon(NULL, IDI_APPLICATION); WndClass.hCursor e LoadCursor(NULL, IDC_ARROW); WndClass.hbrBackground = NULL; WndClass. IpszMenuName = "MENU_1 ” ;
Ясно, что это место, где определяются главные характеристики основного окна. В частности, вы могли заметить, что эта программа имеет поле hbrBackground, которое полагается равным NULL. Чтобы заполнить это поле, программа WinStyle вызывает SetClassWord, передает ей HWND, константу и дескриптор кисти. Раньше все кисти, использовавшиеся в этой книге, были получены с помощью обращений к GetStockObject. Однако кисть PurpleHaze создавалась путем обращения к CreateSolidBrush. Функция CreateSolidBrush Функция CreateSolidBrush зависит от единственного параметра, определяющего цвет кисти, которую вы хотите создать. В данном случае WinStyle определяет светло-голубой (light cyan) цвет кисти. Конечно, такой выбор может показаться не слишком подходящим. Впрочем, в дни своей молодости программа WinStyle была значительно краше, чем теперь. Если вы хотите восстановить некоторую часть ее девичего задора, попробуйте передать RGB следующие параметры: hPurpleHaze = CreateSolidBrush(RGB(255, 100, 255)); Не правда ли, это воскрешает некоторые воспоминания? Но, как говорится, если вы помните шестидесятые, вы, конечно же, испытываете жуткую тоску. К сожалению, не все в них было только хорошим. Кроме HWND и кисти, программа WinStyle передает SetClassWord константу GCW_HBRBACKGROUND. Если вы найдете эту константу в своем справочном руко- водстве, то увидите, что она имеет значение -10. SetClassWord позволяет вам изменять значения, которые вы указали, вызывая функ- цию Register. В частности, если вы передатите во втором параметре 0, то получите доступ к полю cbClsExtra структуры WNDCLASS. Однако WinStyle передает значение -10, которое возвращает вам пять 16-битовых слов позади поля HBRBACKGROUND. Не используйте арифметику такого рода, пытаясь создать свои собственные константы для доступа к различным частям структуры WNDCLASS. Вместо этого применяйте предоп- ределенные константы, которые вы можете найти в документации. Вам важно помнить, что функция CreateSolidBrush использует некоторые из ресурсов GDI, доступных в Windows. Когда программа завершается, она должна отдать эти ресурсы назад. Поэтому в функцию WinStyle OnDestroy включен следующий код: 215: HBRUSH OldBrush; 221: OldBrush = (HBRUSH)GetClassWord(hwnd, GCW_HBRBACKGROUND) ; 222: SetClassWord(hwnd, GCW_HBRBACKGROUND, 223: (WORD) GetStockObject(WHITE_BRUSH) ); 224: DeleteBrush (OldBrush_) ; Функция GetClassWord — это функция SetClassWord наоборот. WinStyle использует GetClassWord для того, чтобы выбрать кисть из динамической области модуля USER.EXE (где хранится структура WNDCLASS). После того как WinStyle снова получит кисть, вам следует подумать о ее удалении. Впрочем, это не тот случай. Проблема состоит в том, что после того как кисть выбрана в первый раз, она все еще принадлежит системе — операционной среде Windows! Чтобы удалить кисть из системы, WinStyle дает Windows другую кисть взамен старой. Эта кисть является ничем иным, как предварительно определенным объектом, что означает ее безусловную принадлежность к системе. Теперь, когда Windows удовлетво- рена, WinStyle может приступить к удалению кисти, которую она создала ранее. Я знаю, что вы уже видели логику подобного рода прежде в этой книге, но здесь я вновь вернулся к ней, поскольку это так важно и так легко забывается. Это место, в котором програм- мисты могут запросто напустить в свои программы “блох”, обнаружение которых займет часы или даже дни. Кисти на переправе ... меняют Если вы выберите из основного меню программы опцию Background, то увидите меню, показанное на рис. 14.2.
Рис. 14.2. Элемент Background предлагает 6 различных вариантов фона Для того, чтобы создать меню Background, вам нужно включить в WTNSTYLE.RC следующий код: POPUP "«Background" BEGIN MENUITEM "«Blue", CM_BLUE MENUITEM "«Red", CM_RED MENUITEM "«Green", CMGREEN MENUITEM "SSpecial_l", CMJSPECIALl MENUITEM "«Special_2", CMJSPECIAL2 MENUITEM "SSpecie 1_3", CM_SPECIAL3 END Это выпадающее меню содержит шесть различных пунктов. При выборе пользова- телем любого из них в WndProc посылается сообщение WM_COMMAND. Например, если пользователь выбирает пункт Blue, программа WinStyle выполняет следующий код из функции WinStyle_OnCommand: 262: case CM_BLUE: 263: OldBrush = (HBRUSH)GetClassWord(hwnd, GCW_HBRBACKGROUND); 264: hPurpleHaze - CreateSolidBrush(RGB(127, 127, 255)); 265: SetClassWord(hwnd, GCW_HBRBACKGROUND, (WORD)hPurpleHaze); 266: DeleteBrush(OldBrush); 267: InvalidateRect(hwnd, NULL, TRUE); 268: break; Этот код сильно напоминает то, что вы видели ранее в обработчике сообщения WM_DESTROY. Программа WinStyle сначала высвобождает старую кисть из динамичес- кой области модуля USER.EXE, а затем создает новую кисть и сует ее в голодную пасть Windows (с помощью функции SetClassWord). Следующий шаг состоит в том, чтобы удалить недавно высвобожденную кисть, а затем заставить Windows показать результи- рующее изменение, вызвав перерисовку с помощью функции InvalidateRect. При выборе пользователем пункта Special_2 выполняется легкая вариация на эту же тему. В данном случае одна из трех растровых картинок программы превращается в кисть благодаря возможностям функции CreatePattemBrush: 278: case CMJSPECIAL2: 279: OldBrush - (HBRUSH)GetClassWord(hwnd, GCW_HBRBACKGROUND); 280: hPurpleHaze = CreatePattemBrush (Pattern2); 281: SetClassWord(hwnd, GCW_HBRBACKGROUND, (WORD) hPurpleHaze); 282: DeleteBrush(oldBrush); 283: InvalidateRect(hwnd, NULL, TRUE); 284: break; Задержитесь, чтобы удостовериться в том, что вы усвоили эту информацию. Ключе- вой момент, о котором необходимо помнить, состоит в том, что Windows способна превращать растровое изображение в кисть! Эта кисть должна иметь размер ровно 8x8 пикселов, как показано на рис. 14.3. Создав кисть с помощью этого механизма, Windows повторно рисует ее так, что она заполняет весь фон окна. Например, второй задний план, показанный на рис. 14.3, может
быть использован для того, чтобы паказывагь пользователей, отказывающихся следовать предписанным правилам. Впрочем, вы должны пообещать заменить его на более приятный фон, если они согласятся вести себя хорошо. Фон Special_3 должен быть знаком всем, кто работает с торжественными и элегантно отточенными борландовскими диалогами. Рис. 14.3. Крупный план элементов фонов типа “Special" Использование поля cbWndExtra Последний маленький трюк, использующийся программой WinStyle, касается тех двух байтов, которые были зарезервированы в поле cbWndExtra функцией Register. Как упоминалось, по время выполнения WinStyle_OnCreate эти байты заполняются номерами дочерних окон; 200: for (1 - 0 < 10; 1++) 201: SetWindowWord (Childwindows [i), 0, i) ; Заметьте, что в данном случае WinStyle использует функцию SetWindowWord, а не SetClassWord. Разница в том, что SetClassWord сосредотачивается на байтах поля cbWndExtra, а не cbClassExtra. Используйте байты cbWndExtra. когда вы хотите поставить в соответствие каждому конкретному окну конкретного класса собственный набор данных. Не используйте для этой цели байты cbClassExtra Они применяются, пивным образом, в тех редких случаях, когда вы хотите ассоциировать один и тот же набор данных с каждым экземпляром конкретного класса Данные, хранящиеся в поле cbWndExtra, выбираются во время ответа на сообщение WM PAINT: 352: void StyleChildOnPaint(HWND hwnd) 353: I 354: PAINTSTRUCT PalnLStruct; 355: HDC PaintDC; 356: char Ipsr.Buffer [1001; 357: RECT R; 35B: 359: WORD i - GetWindowWord (hwr.d, 0); 360: wsprintf HpsxBuffer, "%d", i); 361: 362: PaintDC = BeginPaint(hwr.d, SPaintStruct); 363: 364: SetTextColor(PaintDC, RGB(0, 0, 255)); 365: SetBkMode(PaintDC, TRANSPARENT);
366: GetClientRect(hwnd, SR); 367: DrawText(PaintDC, IpszBuffer, -1, SR, 368: DTJSINGLELINE I DT CENTER | DT VCENTER) ; 369: 370: EndPaint(hwnd, SPaintStruct); 371: ) Как видите, WinStyle вырывает байты поля cbWndExtra с помощью функции GetWin- dowWord, преобразует их в строку и передает их в дочернее окно на всеобщее обозрение. Заметьте, что каждый экземпляр класса StyleChild пользуется одним и тем же методом Paint. Поэтому все они изображают свои номера посередине своих экранов. Последнее, представляющее интерес здесь, — это то, что метод StyleChildOnPaint пользуется методом DrawText (а не TextOut) для вывода на экран своих маленьких сообщений. Константы DTJSINGLELINE, DT_CENTER и DT_VCENTER, обсуждав- шиеся ранее в этой книге, определяются в ваших справочных материалах. Ключевой момент, о котором необходимо помнить, состоит в том, что константа DTVCENTER, позиционирующая текст по вертикали относительно центра экрана, не будет работать иначе, как только совместно с DTJSINGLELINE. Снова замечу, что вам не нужно пытаться запомнить все эти факты сразу. Просто обращайтесь к ним по мере необходи- мости. Резюме Вся эта глава представляла собой медитацию на тему оконных классов и использо- вания структуры WNDCLASS. В частности, вы узнали о функциях GetClassWord, GetWindowWord, а также их близких родственницах: SetClassWord и SetWindowWord. Кроме того, вы познакомились с подробным обзором дочерних и всплывающих окон и чрезвычайно полезной функцией MoveWindow. Всей этой информацией вы часто будете пользоваться в течение своей карьеры в качестве Windows-программиста. Вопросы и ответы 1. Когда я вызываю SetClassWord или SetClassLong, что конкретно изменяется? Когда вы вызываете RegisterClass, Windows распределяет память для вашей структуры WNDCLASS и копирует ее в эту память. Кроме того, она обнуляет поля cbClassExtra и cbWndExtra. Это означает, что после обращения к RegisterWindow в памяти будет находится реальная копия структуры WNDCLASS. SetClassWord и GetClassWord позво- ляют вам войти в память и изменить атрибуты этой структуры. Заметьте, что это лишь автоматически воздействует на окна, созданные после внесения изменений. 2. Я все еще не понимаю разницы между cbClassExtra и cbWndExtra. Пожалуйста, поясните это. Каждое окно имеет свои собственные байты cbWndExtra, в то время как существует только одна копия байтов cbClassExtra независимо от того, сколько окон этого класса находится в настоящий момент на рабочем столе. WinStyle, выполняясь, регистрирует окна классов WinStyle и StyleChild. Первое — основное окно программы; второе — это класс, использующийся при создании всех дочерних окон. Класс StyleChild регистриру- ется лишь однажды, но существует девять экземпляров этого класса, созданных про- граммой. Каждый из этих девяти экземпляров имеет свои собственные поля стиля и свое собственное поле cbWndExtra. Иначе говоря, Windows отводит память для одной копии структуры WNDCLASS класса StyleChild, но также отводит добавочную память для каждого экземпляра этого класса, создаваемого с помощью обращения к CreateWindow. Это означает, что программа WinStyle имеет одну копию поля cbClassExtra и, по крайней мере, девять копий поля cbWndExtra. Впрочем, важно заметить, что некоторые из полей структуры WNDCLASS копируются в каждую из структур памяти, размещаемых при создании каждого экземпляра дочернего окна.
Вопросы для самопроверки 1. В чем разница между дочерними и всплывающими окнами? 2. В чем разница между GetClientRect и GetWindowRect? 3. Каково назначение стиля WS_OVERLAPPEDWINDOW и какие другие стили связаны с ним? 4. Какие два вызова вы можете использовать для того, чтобы сжать окно до половины его текущего размера? 5. Как найти ширину рамки окна, имеющего стиль WS THICKFRAME? 6. Как сделать полностью инертное окно? 7. Всякий раз, когда вы вызываете CreateSolidBrush, вы должны сделать еще один вызов. Какой? 8. В чем разница между GetClassWord и GetWindowWord? 9. Каково назначение GCW_HBRBACKGROUND? 10. Кто решает, сколько дополнительных зарезервированных байтов будет у окна и какого рода назначения они могут иметь? Упражнения 1. Воспользуйтесь функцией ShowWindow, чтобы создать дочернее окно, не используя стиля WS_VISIBLE. 2. Используйте поле cbWndExtra структуры WNDCLASS для хранения строки, именующей каждое из дочерних окон с заголовком. Когда пользователь щелкает на одном из этих окон, пусть строка появляется в заголовке.
День 15 ДИАЛОГОВЫЕ ПАНЕЛИ И РЕЖИМЫ ОТОБРАЖЕНИЯ На этом уроке вы изучите диалоговые панели и разнообразие координатных систем Windows. В частности, мы рассмотрим следующие вопросы: Н Модальные диалоговые панели. Немодальные диалоговые панели. Я Режимы отображения. Логические координаты. В этой главе вводится программа WINSIZE.CPP, демонстрирующая создание и поддержку диалогов и то, как манипулировать шестью координатными системами Windows. Кроме этого, рассматривается собственно создание модальных и немодальных диалоговых панелей. Управление цветом диалога и манипулирование данными, содер- жащихся в них, составляют предмет следующей главы. Координирование координат Как показано на рис. 15.1, программа WinSize имеет два диалога для вывода данных и основное окно, в котором могут быть изображены геометрические фигуры. Мейьший из двух диалогов, диалог Size, показывает координаты основного окна при использова- нии программой любого из шести различных режимов отображения. Режимы отображения представляют собой способы описания единиц измерения, использующихся для определения оконных координат. Например, по умолчанию про- грамма использует режим отображения ММ_ТЕХТ, основывающийся на соглашении, что каждая единица измерения в окне эквивалентна одному пикселу. Замечание. Пиксел это наименьшая видимая единица, которой можно манипулировать на экране. Например, если программа задействует целый экран и окрашивает его полностью в черный цвет, за исключением одной маленькой точки в левом верхнем углу, то эта маленькая точка и будет пикселом. В Windows предусмотрены подпрограммы SetPixel и GetPixel для манипулирования экраном на этом уровне. Стандартный экран VGA имеет 640 пикселов по горизонтали и 480 пикселов по вертикали. Типичные режимы SVGA — 800x600 или 1024x768 пикселов. Поскольку экраны могут иметь различное число пикселов, программисты иногда предпочитают отказаться от координатной системы ММ_ТЕХТ и использовать вместо нее более устойчивую единицу измерения. Чтобы дать программистам то, что они хотят, среда Windows предусматривает несколько логических координатных систем.
Рис. 15.1. Программа WinSize исползует два диалога для показа основной информации о координатной системе Window Замечание. Физическая координатная система можгтора всегда измеряется в пикселах. Эта единица реально существует на экране Монитор и компьютер представляют себе координатную систему экрана как множество пикселов, покрывающих конкретную площадь экрана. Тем не менее мы, люди, думаем примерно так: “Ага, отложим 3 дюйма сверху экрана” или так- “Приблизительно в 12 миллиметрах от левого кроя экрана пролегает маленькая красная черточ- ка . ”. Когда мы отображаем свою систему измерения па экранную физическую систему, это называется созданием логического режима отображения. Хотя в конечном итоге это всегда физические пикселы экрана. Логические координатные системы Windows (в теории) измеряют экран в дюймах, миллиметрах и твииах. Твипы — это единицы, использующиеся для измерения шрифтов. Конкретнее, твил — это 1/20 пункта, а пункт — это примерно 1/72 дюйма. Следователь- но, твил — это 1/20 ♦ 1/72 = 1/1440 дюйма. Эти очень точные на вид числа могут несколько сбить с толку, так как Windows никогда нс бывает абсолютно точной при описании режима отображения, отличного от ММ ТЕХТ. Иначе говоря, Windows всегда точно знает, сколько пикселов находится на экране внутри конкретной площади, но не всегда может точно определить, насколько велик дюйм или миллиметр в конкретной системе измерения. Причина этого отчасти в том, что закое устройство, как монитор, никогда не сообщает своих размеров программ ному обеспечению системы. То есть Windows не может определить разницу между 14-дюймовым и 15-дюймовым монитором Функция SetMapMode int SetMapMode(HDC, int) Команда на изменение режима отображения очень проста. Достаточно лишь выбрать режим отображения, который вы хотите использовать в текущем контексте устройства. Функция SetMapMode зависит от двух параметров. Первый — текущий контекст устройства, а второй — одна из констант fnMapMode (определяющихся далее в этом разделе). Функция возвра- щает предыдущий режим отображения (См. строчки 188, 205 и 301 в WINSIZE СРР). Пример: SetMapMode(PaintDC, HM_TEXT);
Функция GetMapMode int GetMapMode(HDC, int); Эта удобная функция выбирает текущий режим отображения из контекста устройства. Контекст устройства, о котором вы хотите узнать, является единственным аргументом этой функции. GetMapMode возвращает одну из констант fnMapMode, перечисленных в таблице 15.1. Пример: int CurrentMappingMode = GetMapMode(PaintDC); где возвращаемое значение — одна из констант fnMapMode. Таблица 15.1 Шесть главных систем отображения Режим отображения Логические единицы Физические единицы Х++ Y++ MMJTEXT 1 пиксел устройства Вправо Вниз MM_HIENGLISH 1000 1 дюйм Вправо Вверх MM_HIMETRIC 100 1 миллиметр Вправо Вверх MM_LOENGLISH 100 1 дюйм Вправо Вверх MM_LOMETRIC 10 1 миллиметр Вправо Вверх MM-TWIPS 1440 1 дюйм Вправо Вверх В этой таблице показывается, что каждая единица в системе отображения MM HIENGLISH имеет размер 0.001 дюйма, в то время как каждая единица системы MM_HIMETRIC — 0.01 миллиметра. Во всех случаях, за исключением режима ММ_ТЕХТ, значения X по умолчанию возрастают по мере движения вправо, a Y — по мере движения вверх. Один из способов понимания этих идей — представлять себе координатную систему ММ_ТЕХТ устроенной подобно тексту на странице. То есть вы читаете слева направо и сверху вниз. Остальные режимы отображения больше напоминают стандартную декар- тову решетку с началом координат (0,0), расположенным в левом верхнем углу экрана, и самим экраном, представляющим собой часть правого нижнего квадранта решетки. Эти концепции демонстрируются на рис. 15.2 и 15.3. ------------> Увеличение X Увеличение Y ------------у Увеличение X Уменьшение Y Рис. 15.2. Режим отображения ММ_ТЕХТ имеет по умолчанию координаты, увеличивающиеся при движении вправо и вниз Рис. 15.3. Режим отображения MM_HIENGLISH рассматривает экран как часть правого нижнего квадранта декартовой сетки
GDI и координаты устройства После того как вы разобрались с режимами отображения, нужно усвоить, что исходная точка, от которой отсчитываются координаты Windows, может сдвигаться в любое место экрана по вашему выбору. Самый простой путь — выполнить это с помощью команды SetViewportOrg (см. последующее детальное объяснение). Следующий фрагмент кода перемещает начало координат в его положение по умолчанию, т.е. в левый верхний угол окна: SetViewportOrg(PaintDC, 0, 0); Следующий набор команд перемещает начало координат в центр экрана, как показано на рис. 15.4: GetClientRect(hwnd, &Rect); SetViewportOrg(PaintDC, Rect.right / 2, Rect.bottom /2); Рис. 15.4. Система координат при использовании режима MM_HIENGLISH и перемещении нулевой точки в центр экрана Так что там с GDI? За этим предметом лежит одна из важнейших идей программирования в Windows. Весь графический вывод в Windows собирается под единственным заголовком “интерфейс графических устройств” (GDI). Как правило, GDI-команды работают с HDC, то есть с контекстом устройства И наконец, контексты устройств всегда работают с некоторым конкретным типом режима отображения. (GDI обсуждается далее в главе 18). Чтобы удостовериться, что эти идеи ясны, давайте рассмотрим обратную сторону медали. Логические координаты всегда ассоциируются с GDI-обьектами, то есть с контекстами устройств. Это означает, что такие команды, как GetClientRect или Get- WindowRect, никогда не возвращают логические координаты. Эти команды не исполь- зуют HDC и не являются GDI-командами. Следовательно, они не выбирают информацию в логических координатах, а всегда имеют дело с пикселами. То же самое отличие от координатной системы GDI характерно для системы сообщений Windows. Например, сообщения WM_SIZE, WM_MOVE и WM_LBUTTON- DOWN всегда посылают координаты устройства (т.е. физические), а не логические, поскольку не являются частью GDI. Из-за несоответствия между логическими и физическими координатами в Windows предусмотрены две функции, LPtoDP и DPtoLP, которые быстро преобразуют логичес- кие координаты в физические и наоборот. Последняя из этих функций демонстрируется в программе WinSize. Функция DPtoLP BOOL DPtoLP (HDC, POINT FAR *, int) Эта функция преобразует точку или рад точек физической системы координат в точку или рад точек логической системы координат. Первый параметр — контекст устройства, второй — массив точек, подлежащих преобразованию, И третий — количество точек в этом массиве.
Пример: RECT SizeData; DPtoLP(PaintDC, (LPPOINT)sSizeData, 2); Предыдущий код действует по образу и подобию программы WinSize, но используя структуру RECT вместо структуры POINT. Это делается потому, что DPtoLP часто применяется для преоб- разования значений, возвращаемых функциями GetClientRect или GetWindowRect. Ведь структура RECT — это фактически две стоящие подряд структуры POINT. (См. строчки 189 и 301 в WINSIZE.CPP). Более сложные концепции отображения Программисты Windows усвоили довольно запутанную терминологию, отличающую координаты зоны видимости (viewport) от координат окна. При использовании этой терминологии координаты устройства (координаты зоны видимости) всегда измеряются в пикселах. Однако оконные координаты измеряются в логических единицах, соответ- ствующих текущему режиму отображения (дюймы, миллиметры или твипы). Функция SetViewportOrg DWORD SetWindoworg(HDC, int, int); DWORD SetViewportOrg(HDC, int, int); SetViewportOrg устанавливает точку отсчета в координатной системе устройства. SetWindowOrg устанавливает точку отсчета в логической системе координат. Обе функции зависят от трех параметров: Н Первый — контекст устройства: HDC. Н Второй — целое число со знаком, определяющее координату X начала координат. И Третий — целое число со знаком, определяющее координату У начала координат. Функция SetViewportOrg возвращает координаты предыдущей точки отсчета, причем координата X помещается в младшее, а координата Y — в старшее слово. Примеры: SetViewportOrg(PaintDC, 100, 100);, SetWindoworg(PaintDC, 100, 100); Передача одних и тех же координат функциям SetViewportOrg и SetWindowOrg часто приводит к совершенно различным результатам, в зависимости от текущего режима отображения. Поскольку нулевая точка окна вычисляется относительно зоны видимости, следующие вызовы передвигают начало зоны видимости в центр экрана, а затем устанавливают начало координат окна ниже и правее этой точки: GetCleintRect(hwnd, SRect); SetViewportOrg(PaintDC, Rect.right / 2, Rect.bottom /2); SetWindoworg(PaintDC, -Rect.right / 2, -Rect.bottom / 2); Можно изменять координаты окна и зоны видимости одновременно, если вы используете соответствующий режим отображения. Нельзя изменять оконные и физические координаты одновременно, пока вы со всей определенностью не сможете проследить свой путь до некоторого четко видимого “логического” финала. Одно замечательное исключение связано с двумя режи- мами отображения, MM ISOTROPIC и MM UNISOTROPIC, не обсуждающимися в этой книге. Прежде чем двинуться дальше Я отдаю себе отчет в том, что материал, обсуждавшийся на последних нескольких страницах может вызвать серьезное расстройство некоторых важных нервных центров. Поэтому вместо того чтобы заводить мотор и ехать дальше, я оставлю вас с ощущением возможностей, присущих системе, и пусть юные сердцем и предприимчивые духом самостоятельно разбирают этот материал столь подробно, сколь пожелают. Это не означает, что я не считаю этот материал важным, просто здесь не место разбирать его в
деталях. Так или иначе программа WinSize демонстрирует эти идеи лучше, чем их можно выразить словами. Пришла пора запустить программу WinSize (листинг 15.1). Будьте внимательны. В этой программе содержатся некоторые хитрости, которыми вы будете постоянно поль- зоваться, работая в Windows. Листинг 15.1. WINSIZE.CPP 1: ////////////////////////////////////////////////////////// 2: // WINSIZE.CPP - Какого размера окно? 3: // Автор: Чарли Калверт 4: // Дата: 3/26/93 5: ////////////////////////////////////////////////////////// 6: «define STRICT 7: «include «windows.h> 8: «include <windowsx.h> 9: «pragma hdrstop 10: «include <stdio.h> 11: «include <stdlib.h> 12: «include <string.h> 13: «include ''winsize.h" 14: «pragma warning (disable: 4068) 15: 16: // ========================--===================== 17: // Начальные установки 18: // --------------------------====================== 19: 20: static char szAppName[] = "WinSize"; 21: static HWND MainWindow; 22: static HINSTANCE hlnstance; 23: 24: ///////////////////////////////////////////////////// 25: // Точка входа 26: ///////////////////////////////////////////////////// 27: «pragma argsused 28: int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInstance, 29: LPSTR IpszCmdParam, int nCmdShow) 30: ( 31: MSG Msg; 32: 33: hlnstance = hlnst; 34: 35: if ((hPrevInstance) 36: if (!Register(hlnst)) 37: return FALSE; 38: 39: if (! (MainWindow = Create(hlnst, nCmdShow))) 40: return FALSE; 41: 42: while (GetMessage(SMsg, NULL, 0, 0)) 43: ( 44: TranslateMessage(SMsg); 45: DispatchMessage(SMsg); 46: ) 47: 48: return Msg.wParam; 49: ) 50: 51: //////////////////////////////////////////////////////// 52: // Регистрация окна 53: //////////////////////////////////////////////////////// 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: BOOL Register(HINSTANCE hlnst) ( WNDCLASS WndClass; WndClass.style WndClass.IpfnWndProc WndClass.cbClsExtra WndClass.cbWndExtra WndClass.hlnstance WndClass.hlcon WndClass.hCursor WndClass.hbrBackground = CS_HREDRAW | CS_VREDRAW; = WndProc; = 0; = 0; = hlnst; = Loadicon(NULL, IDI_APPLICATION); = LoadCursor(NULL, IDC_ARROW); = GetStockBrush (WHITE_BRUSH);
66: WndClass.IpszMenuName = "MENU"; 67: WndClass.IpszClassName = szAppName; 68: 69: return Registerclass (sWndClass); 70: ) 71: 72: //////////////////////////////////////////////////////////// 73: // Создание окна 74: //////////////////////////////////////////////////////////// 75: HWND Create(HINSTANCE hlnst, int nCmdShow) 76: ( 77: HWND hWindow = CreateWindow(szAppName, szAppName, 78: WS_OVERLAPPEDWINDOW, 79: CW_USEDEFAULT, CW_USEDEFAULT, 80: CW_USEDEFAULT, CW_USEDEFAULT, 81: NULL, NULL, hlnst, NULL); 82: 83: if (hWindow == NULL) 84: return hWindow; 85: 86: ShowWindow(hWindow, nCmdShow); 87: UpdateWindow(hWindow); 88: 89: return hWindow; 90: ) 91: 92: //------======-----=====-------=========-----=====-----=== 93: // Реализация 94: // ————————----------------========—-----=====-----===---- 95: 96: // ===================----=========---========------------ 97: // Оконная процедура 98: // ———————----------------========-------====------— 99: 100: LRESULT CALLBACK _export WndProc(HWND hwnd, UINT Message, 101: WPARAM wParam, LPARAM IParam) 102: ( 103: switch (Message) 104: ( 105: HANDLE_MSG(hwnd, WM_COMMAND, WinSize_OnCommand); 106: HANDLE_MSG(hwnd, WM_CREATE, WinSize_OnCreate); 107: HANDLE_MSG(hwnd, WM_PAINT, WinSize_OnPaint); 108: HANDLE_MSG(hwnd, WMJSIZE, WinSize_OnSize); 109: HANDLE_MSG(hwnd, WM_DESTROY, WinSize_OnDestroy); 110: default: 111: return WinSizeDefProc(hwnd, Message, wParam, IParam); 112: ) 113: ) 114: 115: /////////////////////////////////////////////////////////////// 116: // Обработка сообщения WM CREATE 117: /////////////////////////7///////////////////////////////////// 118: ttpragma argsused 119: BOOL WinSize_OnCreate (HWND hwnd, CREATESTRUCT FAR* 120: IpCreateStruct) 121: ( 122: HINSTANCE hln; 123: 124: hln = lpCreateStruct->hInstance; 125: 126: IpfnSizeBox = MakeProcInstance((FARPROC)SizeBoxProc, hln); 127: 128: BlueBrush = CreateSolidBrush(RGB(0, 255, 255)); 129: GreenBrush = CreateSolidBrush(RGB(255, 255, 127)); 130: return TRUE; 131: } 132: 133: /////////////////////////////////////////////////////// 134: // Обработка сообщения WM_DESTROY 135: /////////////////////////////////////////////////////// 136: ttpragma argsused 137: void WinSize_OnDestroy(HWND hwnd) 138: ( 139: DeleteObject(BlueBrush); 140: DeleteObject(GreenBrush);
141: FreeProcInstance(IpfnSizeBox); 142: PostQuitMessage(0); 143: ) 144: 145: //////////////////////////////////// 146: // Обработка сообщения WM_COMMAND 147: //////////////////////////////////// 148: ftpragma argsused 149: void WinSize_OnCommand(HWND hwnd, int id, HWND hwndCtl, 150: UINT codeNotify) 151: ( 152: switch (id) 153: ( 154: case CMJSIZEBOX: 155: if (hSizeBox == 0) 156: ( 157: hSizeBox = CreateDialog(hlnstance, "SizeDialog", 158: hwnd, (DLGPROC)IpfnSizeBox); 159: InvalidateRect(hwnd, NULL, FALSE); 160: ) 161: break; 162: 163: case CM_MAKESHAPE: 16/: IpfnMakeShape = MakeProcInstance((FARPROC)MakeShapeProc, 165: hlnstance); 166: DialogBox(hlnstance, "MakeShape", 167: hwnd,(DLGPROC)IpfnMakeShape); 168: FreeProcInstance(IpfnMakeShape); 169: InvalidateRect(hwnd, NULL, FALSE); 170: break; 171: 172: case CM_EXIT: 173: DestroyWindow(hwnd); 174: break; 175: ) 176: ) 177: 178: //////////////////////////////////////////////////////// 179: // Если диалог Size открыт, 180: // он заполняется значениями размера окна 181: // в различных режимах отображения 182: //////////////////////////////////////////////////////// 183: void FillSizeBox(HWND hwnd, HDC PaintDC) 184: ( 185: TSIZEDATA SizeData; 186: for (int i = 0; i < 6; i++) 187: ( 188: SetMapMode(PaintDC, Modesti]); 189: GetClientRect(hwnd, SSizeData[i]); 190: DPtoLP(PaintDC, (LPPOINT)SSizeData[i], 2); 191: } 192: SendMessage (hSizeBox, WM_SETDATA, 0, (long) SSizeData); 193: } 194: 195: ////////////////////////////////////// 196: // Обработка сообщения WM_PAINT 197: ////////////////////////////////////// 198: void WinSize_OnPaint (HWND hwnd) 199: ( 200: RECT Rect ; 201: HDC PaintDC ; 202: PAINTSTRUCT ps ; 203: 204: PaintDC = BeginPaint (hwnd, sps) ; 205: SetMapMode (PaintDC, Modes[ModeCase]); 206: GetClientRect(hwnd, SRect); 207: 208: switch (OriginMode) 209: ( 210: case ORG_UPLEFT : 211: SetViewportOrg(PaintDC, 0, 0); 212: break ; 213: 214: 215: case ORG_LOWLEFT: SetViewportOrg(PaintDC, 0, Rect.bottom);
216: Ьгеак; 217: 218: case ORG_CENTER: 219: SetViewportOrg(PaintDC, Rect.right/2, Rect.bottom /2); 220: break; 221: } 222: 223: HBRUSH OldBrush = SelectBrush(PaintDC, BlueBrush) ; 224: 225: switch (Shape) 226: ( 227: case RECTANGLE: 228: Rectangle(PaintDC, RLeft, RTop, RRight, RBottom); 229: break; 230: 231: case CIRCLE: 232: Ellipse(PaintDC, RLeft, RTop, RRight, RBottom); 233: break; 234: ) 235: Selectobject(PaintDC, OldBrush); 236: 237: if (hSizeBox != 0) 23В: FillSizeBox(hwnd, PaintDC); 239: 240: EndPaint (hwnd, Sps) ; 241: ) 242: 243: ////////////////////////////////// 244: // Обработка сообщения WM SIZE 245: ////////////////////////////////// 246: #pragma argsused 247: void WinSize OnSize(HWND hwnd, UINT state, int ex, int cy) 248: ( 249: HDC PaintDC = GetDC(hwnd); 250: if (hSizeBox ! = 0) 251: FillSizeBox(hwnd, PaintDC); 252: ReleaseDC(hwnd, PaintDC); 253: ) 254: 255: ////////////////////////////////// 256: // Диалог Make Shape 257: ////////////////////////////////// 258: void SetRectText(HWND hwnd) 259: ( 260: char S[45]; 261: HWND Parentwindow; 262: 263: Parentwindow = GetWindow(hwnd, GW_OWNER); 264: InvalidateRect(Parentwindow, NULL, TRUE); 265: sprintf(S, "%d" , RLeft) ; 266: SendDlgltemMessage(hwnd, ID_RLEFT, WM_SETTEXT, 0, (long)S); 267: sprintf (S, ”%d", RRight); 268: SendDlgltemMessage(hwnd, ID_RRIGHT, WM_SETTEXT, 0, (long)S) 269: sprintf (S, ”»d", RTop); 270: SendDlgltemMessage(hwnd, ID_RTOP, WM_SETTEXT, 0, (long)S); 271: sprintf (S, ”»d", RBottom); 272: SendDlgltemMessage(hwnd, ID RBOTTOM, WM SETTEXT,0, (long)S) 273: ) 274: 275: /////////////////////////////////// 276: // GetUserCords 277: /////////////////////////////////// 278: void GetUserCords(HWND hwnd) 279: ( 280: char S[100]; 281: 282: GetWindowText(GetDlgItem(hwnd, ID_RLEFT), S, 100); 283: RLeft = atoi(S); 284: GetWindowText(GetDlgItem(hwnd, ID_RT0P), S, 100); 285: RTop = atoi(S); 286: GetWindowText(GetDlgltem(hwnd, ID_RRIGHT), S, 100); 287: RRight = atoi(S); 288: GetWindowText (GetDlgltem(hwnd, ID_RB0TT0M) , S, 100); 289: RBottom = atoi(S);
290: ) 291: 292: /////////////////////////////////// 293: // MakeShape 294: /////////////////////////////////// 295: void MakeShape(HWND hDlg) 296: { 297: RECT R; 298: 299: GetClientRect(GetParent(hDlg), SR) ; 300: HDC DC = GetDC(GetParent(hDlg)); 301: SetMapMode (DC, Modes[ModeCase]); 302: DPtoLP(DC,(LPPOINT)SR, 2); 303: ReleaseDC(GetParent(hDlg), DC); 304: 305: switch (OriginMode) 306: ( 307: case ORG_CENTER: 308: RLeft = -(R.right / 3); 309: RTop = -(R bottom / 3); 310: RRight = (R.right / 3); 311: RBottom = (R.bottom / 3); 312: break; 313: 314: case ORG_LOWLEFT: 315: RBottom = -(R.bottom / 3); 316: RLeft = R.left / 3; 317: RTop = R.top / 3; 318: RRight = R.right / 3; 319: break; 320: 321: case ORG_UPLEPT: 322: RLeft = R.left / 3; 323: RTop = R.top / 3; 324: RRight = R.right / 3; 325: RBottom = R.bottom / 3; 326: break; 327: ) 328: ) 329: 330: 331: ///////////////////////////////// 332: // DoDraw 333: ///////////////////////////////// 334: void DoDraw(HWND hwnd) 335: ( 336: if (UseCompCords) 337: MakeShape(hwnd); 338: SetRectText(hwnd) ; 339: ) 340: 341: ////////////////////////////////// 342: // DoRectCommand 343: ////////////////////////////////// 344: BOOL DoRectCommand (HWND hwnd, WORD wParam) 345: ( 346: switch(wParam) 347: { 348: case ID_DRAW: 349: GetUserCords(hwnd); 350: InvalidateRect(GetParent(hwnd), NULL, TRUE); 351: return TRUE; 352: 353: case ID_RTEXT: 354: ModeCase = TEXT; 355: DoDraw(hwnd); 356: return TRUE; 357: 358: case ID_RLOMETRIC: 359: ModeCase = LOMETRIC; 360: DoDraw(hwnd); 361: return TRUE; 362: 363: case ID_RHIMETRIC: 364: ModeCase = HIMETRIC;
365: DoDraw(hwnd); 366: return TRUE; 367: 368: case ID_RLOENGLISH: 369: ModeCase = LOENGLISH; 370: DoDraw(hwnd); 371: return TRUE ; 372: 373: case ID_RHIENGLISH: 374: ModeCase = HIENGLISH; 375: DoDraw(hwnd); 376: return TRUE; 377: 378: case ID_RTWIPS: 379: ModeCase = TWIPS; 380: DoDraw(hwnd) ; 381: return TRUE; 382: 383: case ID_ORGUPLEFT: 384: GetUserCords(hwnd); 385: OriginMode = ORG_UPLEFT; 386: DoDraw(hwnd); 387: return TRUE; 388: 389: case ID_ORGLOWLEFT: 390: GetUserCords(hwnd); 391: OriginMode = ORG_LOWLEFT; 392: DoDraw(hwnd); 393: return TRUE; 394: 395: case ID_ORGCENTER: 396: GetUserCords(hwnd) ; 397: OriginMode = ORG_CENTER; 398: DoDraw(hwnd); 399: return TRUE; 400: 401: case ID_USERCORDS: 402: GetUserCords(hwnd); 403: UseCompCords = FALSE; 404: return TRUE; 405: 406: case ID_COMPCORDS: 407: UseCompCords = TRUE; 408: return FALSE; 409: 410: case ID_RECT: 411: Shape = RECTANGLE; 412: DoDraw(hwnd); 413: return TRUE; 414: 415: case ID_CIRCLE: 416: Shape = CIRCLE; 417: DoDraw(hwnd); 418: return TRUE; 419: 420: case IDOK: 421: case IDCANCEL: 422: ( 423: EndDialog(hwnd, TRUE); 424: return TRUE; 425: ) 426: ) 427: return FALSE; 428: ) 429: 430: /////////////////////////////////////////// 431: // Процедура диалоговой панели Make Shape 432: /////////////////////////////////////////// 433: ((pragma argsused 434: BOOL CALLBACK _export MakeShapeProc (HWND hwnd, WORD Msg, 435: WORD wParam, LONG IParam) 436: ( 437: switch (Msg) 438: ( 439: case WM_INITDIALOG:
286 440: 441: 442: 443: 444: 445: 446: 447: 448: 449: 450: 451: 452: 453: 454: 455: 456: 457: 458: 459: 460: 461: 462: 463: 464: 465: 466: 467: 468: 469: 470: 471: 472: 473: 474: 475: 476: 477: 478: 479: 480: 481: 482: 483: 484: 485: 486: 487: 488: 489: 490: 491: 492: 493: 494: 495: 496: 497: 498: 499: 500: 501: 502: 503: 504: 505: 506: 507: 508: 509: 510: 511: 512: 513: 514: SendDlgltemMessage (hwnd, ID_RTEXT, BM_SETCHECK, 1, OL) ; SendDlgltemMessage (hwnd, ID_RECT, BM_SETCHECK, 1, OL) ; SendDlgltemMessage (hwnd, ID_ORGUPLEFT, BM_SETCHECK, 1, OL); SendDlgltemMessage (hwnd, ID_COMPCORDS, BM_SETCHECK, 1, OL) ; return TRUE; case WM_COMMAND: return (!DoRectCommand(hwnd, wParam)); case WM_CTLCOLOR: switch(HIWORD(IParam)) ( case CTLCOLOR_STATIC: case CTLCOLOR_BTN: case CTLCOLOR_EDIT: // Сделать белый текст на синем фоне SetTextColor((HDC)wParam, RGB(0, 127, 0)); SetBkMode ((HDC) wParam, TRANSPARENT) ; return (BOOL) GreenBrush; case CTLCOLOR_DLG: return (BOOL) GreenBrush; ) return (BOOL) NULL; ) return FALSE; //====— ----========================================== // Процедура диалоговой панели Size //=================================================== #pragma argsused BOOL CALLBACK _export SizeBoxProc(HWND hDlg, WORD Msg, WORD wParam, LONG IParam) ( TSIZEDATA SizeData; void *lpSizeData; char S [20]; int i; int Indexs[] = (2100, 2200, 2300, 2400, 2500, 2600); switch(Msg) ( case WM_CLOSE: DestroyWindow(hDlg); hSizeBox = 0; return TRUE; case WM_CTLCOLOR: switch(HIWORD(IParam)) ( case CTLCOLOR_STATIC: SetTextColor((HDC)wParam, RGB(255, 0, 0)); SetBkMode((HDC)wParam, TRANSPARENT); return (BOOL) GetStockObject(BLACK_BRUSH); case CTLCOLOR_DLG: return (BOOL) GetStockObject(BLACK_BRUSH); ) return (BOOL) NULL; case WM_SETDATA: IpSizeData = (void *)IParam; memcpy(SizeData, IpSizeData, sizeof(TSIZEDATA)); for (i = 0; i < 6; i++) ( sprintf(S, "%d" , SizeData[i].left) , SendDlgltemMessage(hDlg, Indexs[i] + 1, WM_SETTEXT, 0, long(S)); sprintf(S, "%d" , SizeData[i]-right); SendDlgltemMessage(hDlg, Indexs[i] + 2, WM_SETTEXT, 0, long(S)); sprintf(S, ”%d", SizeData [ij.top) ; SendDlgltemMessage(hDlg, Indexs[i] + 3,
515: WMJSETTEXT, 0, long(S)); 516: sprintf(S, "%d ", SizeData[i].bottom); 517: SendDlgltemMessage(hDlg, Indexs[i] + 4, 518: WMJSETTEXT, 0, long(S)); 519: } 520: return TRUE; 521: ) 522: return FALSE; 523: ) Листинг 15.2. WINSIZE.H 1: ////////////////////////////////////// 2: // WINSIZE.H 3: // Автор: Чарли Калверт 4: // Дата: 7/15/93 5: ////////////////////////////////////// 6: 7: // Константы 8: «define WM_SETDATA (WM USER + 1) 9: «define CM_EXIT 101 10: «define CM_SIZEBOX 1000 11: «define CM_MAKESHAPE 1001 12: «define RECTSIZE 2000 13: «define ID MMLEFT 2101 14: «define ID_MMRIGHT 2102 15: «define ID_MMTOP 2103 16: «define ID_MMBOTTOM 2104 17: «define ID_LMLEFT 2201 18: «define ID_LMRIGHT 2202 19: «define ID_LMTOP 2203 20: «define ID LMBOTTOM 2204 21: «define ID HMLEFT 2301 22: «define ID_HMRIGHT 2302 23: «define ID HMTOP 2303 24: «define ID HMBOTTOM 2304 25: «define ID_LELEFT 2401 26: «define ID_LERIGHT 2402 27: «define ID_LETOP 2403 28: «define ID_LEBOTTOM 2404 29: «define ID HELEFT 2501 30: «define ID HERIGHT 2502 31: «define ID HETOP 2503 32: «define ID_HEBOTTOM 2504 33: «define ID_TLEFT 2601 34: «define ID_TRIGHT 2602 35: «define ID_TTOP 2603 36: «define ID_TBOTTOM 2604 37: «define ID RTEXT 3101 38: «define ID_RLOMETRIC 3102 39: «define ID_RHIMETRIC 3103 40: «define ID_RLOENGLISH 3104 41: «define ID RHIENGLISH 3105 42: «define ID_RTWIPS 3106 43: «define ID_RlSOTROPIC 3107 44: «define ID_RANISOTROPIC 3108 45: «define ID_RLEFT 3110 46: «define ID_RRIGHT 3111 47: «define ID_RTOP 3112 48: «define ID_RBOTTOM 3113 49: «define ID DRAW 3115 50: «define ID_COMPCORDS 3117 51: «define ID_USERCORDS 3118 52: «define ID_ORGUPLEFT 3120 53: «define ID_ORGLOWLEFT 3121 54: «define ID_ORGCENTER 3122 55: «define ID RECT 4001 56: 57: 58: «define ID_CIRCLE // Типы 4002 59: typedef RECT TSIZEDATA[6]; 60: enum TModeCase (TEXT, LOMETRIC, HIMETRIC, LOENGLISH, 61: HIENGLISH, TWIPS, ISOTROPIC, ANISOTROPIC); 62: enum TOriginMode (ORG_UPLEFT, ORG_LOWLEFT, ORG_CENTER); 63: enum TShape (RECTANGLE, CIRCLE);
64: int Modes[] = {MM_TEXT, MM_LOMETRIC, MM_HIMETRIC, 65: MM-LOENGLISH, MM_HIENGLISH, MMJTWIPS, 66: MM_ISOTROPIC, MM-ANTSOTROPIC); 67: 68: // Объявления для класса Generic 69: #define WinSizeDefProc DefWindowProc 70: BOOL WinSize__OnCreate (HWND hwnd, 71: CREATESTRUCT FAR* IpCreateStruct); 72: void WinSize_OnDestroy(HWND hwnd); 73: void WinSize_OnCommand(HWND hwnd, int id, 74: ‘ HWND hwndCtl, UINT codeNotify) ; 75: void WinSize_OnPaint(HWND hwnd); 76: void WinSize_OnSize (HWND hwnd, UINT state, int ex, int cy) ; 77: 78: // Переменные 79: FARPROC IpfnSizeBox; 80: FARPROC IpfnMakeShape; 81: HBRUSH BlueBrush, GreenBrush; 82: HWND hSizeBox; 83: TModeCase ModeCase = TEXT; 84: TOriginMode OriginMode = ORG_UPLEFT; 85: int RLeft = 10; 86: int RTop = 10; 87: int RRight = 100; 88: int RBottom = 100; 89: TShape Shape; 90: BOOL UseCompCords = TRUE; 91: 92: // Процедуры 93: LRESULT CALLBACK _export WndProc(HWND hwnd, UINT Message, 94: WPARAM wParam, LPARAM IParam); 95: BOOL Register(HINSTANCE hlnst); 96: HWND Create(HINSTANCE hlnst, int nCmdShow); 97: BOOL CALLBACK _export MakeShapeProc(HWND hWindow, WORD Msg, 98 : WORD wParam, LONG IParam) ; 99: BOOL CALLBACK ^export SizeBoxProc(HWND hWindow, WORD Msg, 100: WORD wParam, LONG IParam); Листинг 15.3. WINSIZE.RC 1: ///////////////////////////////////////////////////////// 2: // WINSIZE.RC - Какого размера это окно? 3: // Автор: Чарли Калверт 4: // Дата: 7/15/93 5: ///////////////////////////////////////////////////////// 6: «include "WinSize.h" 7: «include "Windows, h" 8: 9: ////////////////////////////////////////////////////////// 10: // Я определил следующие стили, чтобы сделать исходный 11: // код, как минимум, более читабельным. 12: // Это не является необходимым шагом, но придает 13: // книге больше четкости 14: ///////////////////////////////////////////////////////// 15: «define STY STANDARD WS_CHILD I WS_VISIBLE I WS_GROUP 16: «define STY_GRPCHILD BS_GROUPBOX I WS_CHILD I WS_VISIBLE 17: «define STY RTEXT SS_RIGHT I WS_CHILD I WS_VISIBLE | WSJSROUP 18: «define STY_AUTRAD \ 19: BS_AUTORADIOBUTTON I WS_CHILD | WS_VISIBLE I WS_TABSTOP 20: «define STY_STATLEFT \ 21: SS_LEFT I WS_CHILD I WS_VISIBLE I WS_BORDER I WS_TABSTOP 22: «define STY_AUTRADGRP \ 23: BS_AUTORADIOBUTTON I WS_CHILD I WS_VISIBLE I WS_GROUP I WS_TABSTOP 24: 25: Menu MENU 26: BEGIN 27: POPUP "File" 28: BEGIN 29: MENUITEM "ESxit", CM_EXIT 30: END 31: POPUP "Options" 32: BEGIN 33: MENUITEM "Size Dialog", CM_SIZEBOX 34: MENUITEM "Make Shape" , CM_MAKESHAPE 35: END
36: END 37: 38: SizeDialog DIALOG 16, 18, 170, 100 39: STYLE WS_POPUP I WS_CAPTION I WSSYSMENU I WS_VISIBLE 40: CAPTION "Size Dialog" 41: { 42: LTEXT "MMText", -1, 7, 17, 40, 9, STYJSTANDARD 43: LTEXT "LoMetric", -1, 7, 30,, 40, 9, STYJSTANDARD 44: LTEXT "HiMetric", -1, 7, 45, 40, 9, STYJSTANDARD 45: LTEXT "LoEnglish", -1, 7, 59, 40, 9, STY_STANDARD 46: LTEXT "HiEnglish", -1, 7, 73, 40, 9, STY_STANDARD 47: LTEXT "Twips", -1, 7, 87, 40, 9, STY -STANDARD 48: LTEXT "", IDJ4MLEFT, 42, 16, 27, 11,' STY-STATLEFT 4 9: LTEXT "", IDJ4MRIGHT, 105, 16, 27, 11, STYJSTATLEFT 50: LTEXT ID_MMTOP, 74, 16, 27, 11, STYJSTATLEFT 51: LTEXT "", ID_MMBOTTOM, 138,16, 27, 11, STY_STATLEFT 52: LTEXT "", ID_LMLEFT, 42, 30, 27, 11, STYJSTATLEFT 53: LTEXT ID_LMRIGHT, 105, 30, 27, 11, STY_STATLEFT 54: LTEXT "", ID_LMTOP, 74, 30, 27, 11, STY_STATLEFT 55: LTEXT "", IDLMBOTTOM, 138,30, 27, 11, STYJSTATLEFT 56: LTEXT "", ID_HMLEFT, 42, 45, 27, 11, STYJSTATLEFT 57: LTEXT "", ID_HMRIGHT, 105, 45, 27, 11, STYJSTATLEFT 58: LTEXT "", ID_HMTOP, 74, 45, 27, 11, STYJSTATLEFT 59: LTEXT "", ID_HMBOTTOM, 138,45, 27, 11, STYJSTATLEFT 60: LTEXT "", ID_LELEFT, 42, 59, 27, 11, STY_STATLEFT 61: LTEXT ID_LERIGHT, 105, 59, 27, 11, STY_STATLEFT 62: LTEXT "", ID_LETOP, 74, 59, 27, 11, STY_STATLEFT 63: LTEXT "", ID_LEBOTTOM, 138,59, 27, 11, STYJSTATLEFT 64: LTEXT "", ID_HELEFT, 42, 73, 27, 11, STYJSTATLEFT 65: LTEXT "", ID_HERIGHT, 105, 73, 27, 11, STYJSTATLEFT 66: LTEXT "", ID HETOP, 74, 73, 27, 11, STYJSTATLEFT 67: LTEXT IDHEBOTTOM, 138,73, 27, 11, STYSTATLEFT 68: LTEXT IDTLEFT, 42, 87, 27, 11, STYJSTATLEFT 69: LTEXT "", IDJTRIGHT, 105, 87, 27, 11, STY_STATLEFT 70: LTEXT "", IDJTTOP, 74, 87, 27, 11, STYJSTATLEFT 71: LTEXT IDJTBOTTOM, 138, 87, 27, 11, STY_STATLEFT 72: LTEXT "Left", -1, 42, 6, 16, 8, STYJSTANDARD 73: LTEXT "Top", -1, 74, 6, 16, 8, STY_STANDARD 74: LTEXT "Right", -1, 105, 6, 25, 8, STY_STANDARD 75: LTEXT "Bottom", -1, 138, 6, 25, 7, STY_STANDARD 76: ) 77: 78: MakeShape DIALOG 18, 18, 190, 162 79: STYLE WS_POPUP I WS_CAPTION I WS SYSMENU I WS_VISIBLE 80: CAPTION "Make Shape" 81: ( 82: CONTROL "MMJTEXT", ID_RTEXT, "BUTTON", STY_AUTRADGRP, 10,8,66,10 83: CONTROL "MM_LOMETRIC", ID_RLOMETRIC, "BUTTON", STY_AUTRAD, 10, 21, 66, 10 84: CONTROL "MM_HIMETRIC", ID_RHIMETRIC, "BUTTON", STY_AUTRAD, 10, 34, 66, 10 85: CONTROL "MMLOENGLISH", ID_RLOENGLISH, "BUTTON", STYAUTRAD, 10, 47, 66, 10 86: CONTROL "MMHIENGLISH", ID_RHIENGLISH, "BUTTON", STY AUTRAD, 10, 47, 66, 10 87: CONTROL "MM_HIENGLISH", ID_RHIENGLISH, "BUTTON", STY AUTRAD, 10, 60, 66, 10 88: CONTROL "MM_TWIPS", ID_RTWIPS, "BUTTON", STY_AUTRAD, 10, 73, 66, 10 89: EDITTEXT ID_RLEFT, 124, 10, 52, 12, STY_STATLEFT 90: EDITTEXT ID_RTOP, 124, 24, 52, 12, STY_STATLEFT 91: EDITTEXT ID_RRIGHT, 124, 38, 52, 12, STYJSTATLEFT 92: EDITTEXT ID_RBOTTOM, 124, 52, 52, 12, STY_STATLEFT 93: CONTROL "Origin Upper Left", ID_ORGUPLEFT, "BUTTON", STY_AUTRADGRP, 95, 81, 84, 10 94: CONTROL "Origin Lower Left", ID_ORGLOWLEFT, "BUTTON", STY_AUTRAD, 95, 95, 84, 10 95: CONTROL "Origin Center", ID_ORGCENTER, "BUTTON", STY_AUTRAD, 95, 108, 84, 10 96: CONTROL "User Coordinates", ID_USERCORDS, "BUTTON", STY_AUTRADGRP, 95, 133, 84, 12 97: CONTROL "Computer Coordinates", ID_COMPCORDS, "BUTTON", STY_AUTRAD, 95, 144, 84, 10 98: PUSHBUTTON "Close", IDOK, 5, 134, 33, 21, WS_CHILD | WS_VISIBLE I WSJTABSTOP 99: PUSHBUTTON "Draw", ID_DRAW, 48, 134, 33, 21 100: RTEXT "Left", -1, 94, 12, 25, 8, STYRTEXT 101: RTEXT "Right", -1, 94, 40, 25, 8, STY_RTEXT 102: RTEXT "Top", -1, 94, 26, 25, 8, STY_RTEXT 103: RTEXT "Bottom", -1, 94, 54, 25, 8, STY_RTEXT 104: GROUPBOX 3116, 90, 128, 94, 27, STY_GRPCHILD 105: GROUPBOX 3119, 90, 74, 94, 49, STY_GRPCHILD 10 Чарльз Калверт
106: GROUPBOX "", 3107, 5, 88, 77, 107: CONTROL "Rectangle", ID_RECT, 108: CONTROL "Ellipse", IDCIRCLE, 109: GROUPBOX 3108, 91, 1, 90, 110: GROUPBOX "", 3109, 7, 1, 74, 111: ) 35, STY_GRPCHILD "BUTTON", STY_AUTRADGRP, 11,95,66,10 "BUTTON", STY_AUTRAD, 11,109,66,10 69, STY_GRPCHILD 5, STY_GRPCHILD Листинг 15.4. WINSIZE.DEF 1: ; WinSize.def 2: NAME WinSize 3: DESCRIPTION 'Mapping Modes Info' 4: EXETYPE WINDOWS 5: STUB 'WINSTUB.EXE' 6: CODE PRELOAD MOVEABLE DISCARDABLE 7: DATA PRELOAD MOVEABLE MULTIPLE 8: HEAPSIZE 4096 9: STACKSIZE 8192 Листинг 15.5. WINSIZE.MAK (Borland) 1: #---============================= 2: # WINSIZE.MAK 3: # ================-----------==== 4: 5: И макросы 6: APPNAME = WinSize 7: INCPATH = C:\BC\INCLUDE 8:LIBPATH = C:\BC\LIB 9: FLAGS = -H -ml -W -v -w4 -1$ (INCPATH) -L$ (LIBPATH) 10: 11: # компоновка 12: $(APPNAME).exe; $(APPNAME).obj $(APPNAME).def (APPNAME).res 13: bcc $(FLAGS) $(APPNAME).Obj 14: brc $(APPNAME).res 15: 16: # компиляция 17: $ (APPNAME)-obj : $ (APPNAME). cpp 18: bcc —c $ (FLAGS) $ (APPNAME). cpp 19: 20: # ресурсы 21: $ (APPNAME) .res: $ (APPNAME) . rc 22: brc —r -i$(INCPATH) $(APPNAME).rc Листинг 15.6. WINSIZE.MAK (Microsoft) 1: #===================== 2: # WINSIZE.MAK 3: #==================== 4: 5: # компоновка 6: WINSIZE.EXE : WINSIZE.OBJ WINSIZE.DEF WINSIZE.RES 7: link WinSize, /align:16, NUL, /nod llibcew libw, WinSize 8: rc WINSIZE.RES 9: 10: # компиляция 11: WINSIZE.OBJ : WINSIZE.CPP 12: cl -c -AL -GA -Ow -W3 -Zp WINSIZE.CPP 13: 14: # компиляция ресурсов 15: WINSIZE.RES: WINSIZE.RC 16: rc —r WINSIZE.RC Программа WinSize вычерчивает в окне прямоугольник или эллипс. Она также позволяет вам открыть два диалога: диалог Make Shape (рис. 15.6) и диалог Size (рис. 15.7). Диалог Size сообщает размер всего окна, измеренный в любом из следующих режимов отображения: ММТЕХТ, MMHIENGLISH, MM_LOENGLISH, MM_HIMETRIC, MM_LOMETRIC или MM_TWIPS. Диалог Make Shape позволяет изменять тип показываемой геометрической фигуры и ее размеры, а также режим отображения и физическое начало координат. Если вы используете диалог Make Shape
для изменения размеров фигуры, выберите на диалоговой панели кнопку User coordinates (пользовательские координаты), а затем введите новые значения в редактируемые поля в верхнем правом углу “Нажмите” кнопку Draw (нарисовать), чтобы увидеть результат. Помните, что если вы затем измените начало координат, фигура может исчезнуть с экрана. Основная цель опции Computer Coordinates (компьютерные координаты) — заставить компьютер вычислять координаты, i юмешаюшие фигуру таким образом, чтобы она была видна пользователю. Рис. 15.5. Типичный пример экрана программы WinSize Диалоговые панели. Обзор и повторение Прежде чем обсудить внутренний механизм программы WinSize, следует акцентиро- вать внимание на нескольких ключевых моментах, касающихся диалогов: И Диалоги — это просто специальные формы окон. С каждым диалогом ассоциируется диалоговая процедура. Это просто разновидность стандартной оконной процедуры, с которой вы так часто встречались в этой книге. Как правило, диалоги снабжаются элементами управления, определяемыми в RC- файлах так же, как и меню. Элементы управления, располагающиеся на диалоговых панелях, идентичны окон- ным элементам управления, детально обсуждавшимся в течение второй недели обучения. И Обычно легче изобразить предварительный набросок диалога (подобный тому, что изображен на рис. 15.6 и 15 7) с помощью Resource Workshop, Арр Stud о или подобного им визуального инструмента, чем программировал, его непосредственно. Когда у вас получится что-то близкое к тому, что вы хотите видеть, используйте метод, кажущийся наиболее простым. На этом этапе игры лете всего представлять себе, что диалоговые панели существуют прежде всего для того, чтобы нргараммисты имели простой способ манипулирования оконными элементами управления. Иначе говоря, вы можете погрузиться в Resource Workshop или Арр Studio и разработать интерфейс для диалога за несколько минут. Затем вы можете высветить вновь созданную диалоговую панель на экране с помощью нескольких относительно простых вызовов. Когда это сделано, у вас появляется простой способ ведения беседы или “диалога” с пользователем.
M«ikc Shape GMM_LOMtIR)C О MM. HIMt I fllC Ommhiengush C MM HIENGUSH О MM TWIPS ® Origin Upper Lett О Origin Lower Lett О Origin Center ® rectangle О Ellipse Cluse Draw O User Coordinates ® Computer Coordinates Рис. 15.6. Диалоговая панель Make Shape Size Dialog Lett Top High! Bollutn ММ Text 0 -333 518 0 LoMetnc 0 1082 1684 0 IliMetri 0 10023 16015 n LoEiiglish 0 436 663 0 HiEngltsh о 4261 ,6620 0 TwIps 0 6136 9544 0 Рис. 15.7. Когда появляется немодальный диалог Size Dialog, доступ к меню главного окна программы не блокируется Позвольте добавить для ясности, что предыдущий абзац представляет собой сильное упрощение. В реальной жизни диалоги могут сводиться к обслуживанию ряда весьма разнообразных целей (кроме уже перечисленных). Цель последнего абзаца нс в том, ч гобы дать вам исчерпывающее описание диалогов, а в том, чтобы снабдить вас основой для их понимания. Замечание. В главах 12 и 13 пы изучили установку стиля WS GROUP для первой кнопки-селек- тора внутри группы. Тот же самы]) процесс должен быть реализован внутри диалогов, как показано в Wl NSIZE.RC. Точно так же стиль WS TABSTOP устанавливается для всех элементов управления диалога Make Shape на которые пользователь может переключаться с помощью клавиши Tab. Поонятия модального и немодального диалогов Остаток этом главы посвящен объяснению разницы между созданием модальных элементов диалога, подобных Make Shape и немодальных (диалог Size). Это две основные категории диалогов, и поэтому всем Windows-программистам необходимо понимать, что означают эти термины. Главное, что нужно уяснить себе относительно мо альных и немодальных диалогов, — это следующее: Модальные диалоги блокируют остальные окна так, что пользователь не сможет ничего сделать, пока нс выполнит выбор в текущем диалоге и нс закроет его.
Немодальные диалоги весьма похожи на окна, созданные с помощью стиля WS_CHILD. Они всплывают в верхней части основного окна и дают пользователю возможность доступа к остальным возможностям программы. Оба вида диалога создаются вызовом MakeProcInstance для размещения пролога диалоговой процедуры. Затем для запуска диалога вызываются CreateDialog (в случае немодального диалога) или DialogBox (для модального диалога). Когда все это сделано, вызовите FreeProcInstance для очистки использованной памяти. Все эти четыре пункта объясняются ниже. В частности, вы увидите, что хотя модальный и немодальный диалоги создаются с помощью похожих вызовов, существует ряд специфических отличий в реализации. Если вы этого еще не сделали, запустите программу WinSize и начните эксперимен- тировать с двумя диалогами. Через некоторое время вы, возможно, заметите, что имеете доступ к основному меню программы, когда активизирован диалог Size, но не имеете такого доступа, когда на экране диалог Make Shape. Причина этого в том, что диалог Make Shape является модальным, в то время как Size — немодальный. Модальные диалоговые панели обычно не препятствуют переключению с одного приложения на другое. Иначе говоря, если вы используете диалог Make Shape, вы можете переключиться на менеджер файлов или программ, но не можете использовать основное меню программы WinSize. Единственное исключение из этого правила состоит в том, что в редких случаях можно использовать системную модальную диалоговую панель. Системные модальные диалоги позволяют пользователю работать внутри лишь одного диалога и не позволяют переключаться ни на какие другие программы. В данном частном случае диалог Size является немодальным, поскольку пользователю нужно наблюдать результаты изменения координат, когда он буксирует окно программы WinSize. Суть тут в том, что диалог Size показывает размеры основного окна, измеренные в нескольких различных режимах отображения. Если кто-то изменяет размер основного окна, изменяются числа в диалоге Size. Если бы диалог Size был модальным, он был бы не в состоянии сделать этот эффект наблюдаемым. Программирование модальных и немодальных диалогов Хотя в действительности выполнение модальных и немодальных диалогов в прин- ципе похоже, существует ряд специфических отличий в способе их создания. Чтобы понять природу этих отличий, нужно обратиться к функции WinSize_OnCreate. Как было продемонстрировано в предыдущих главах, методы ответа на сообщение WM CREATE могут быть довольно сложны, когда программа имеет в своем основном окне много элементов управления. Впрочем, программа WinSize использует относительно простой подход к инициализации своего основного окна. В основном потому, что диалоги создаются в функции WinSizeOnCommand. Так или иначе программа WinSize делает с сообщениями WM CREATE следующее: 119: BOOL WinSizeOnCreate(HWND hwnd, CREATESTRUCT FAR* 120: IpCreateStruct) 121: { 122: HINSTANCE hln; 123: 124: hln = lpCreateStruct->hInstance; 125: 126: IpfnSizeBox = MakeProcInstance((FARPROC)SizeBoxProc, hln); 127: 128: BlueBrush = CreateSolidBrush(RGB(0, 255, 255)); 129: GreenBrush = CreateSolidBrush(RGB(255, 255, 127)); 130: return TRUE; 131: )
Замечание. Выходит так, что CREATESTRUCT, оседлавшая сообщение WM CREATE, содержит копию дескриптора HINSTANCE программы. Исходный код, приведенный в предыдущих главах этой книги, обычно использовал глобально объявленную переменную типа HINSTANCE. Фрагмент кода, предшествующий данному замечанию, демонстрирует альтернативный метод. Он особенно полезен, если вы хотите вывести функцию Cls OnCreate за пределы вашего основного модуля, не привлекая при этом сомнительную практику объявления переменных глобальными для более чем одного модуля. В результате вызова MakeProcInstance происходит инициализация переменной IpfnSizeBox, использующейся, когда наступает время создавать диалог Size. Полученные здесь результаты почти такие же, как в главе 11 (когда вы видели, что MakeProcInstance вызвалось прежде EnumFontFamilies). То есть вам требуется связать сегмент данных программы WinSize с оконной процедурой диалога Size. Теперь оконная процедура диалога Size хотя и вызывается самой Windows, но все-таки имеет доступ к переменным программы. Я не собираюсь идти дальше замечания, что заглушка оконной процедуры диалога Size размещается в ответ на сообщение WM_CREATE, но вызов MakeProcInstance в диалоговой процедуре Make Shape задерживается до более поздних этапов жизни программы. Точная причина этих различных способов действия прояснится далее. Теперь пора рассмотреть часть функции-обработчика сообщения WM_COMMAND, в которой запускаются эти две диалоговые панели. Нет нужды говорить, что каждый из следующих фрагментов кода вызывается только после того, как пользователь осуществит выбор в меню программы: 154: 155: 156: 157: 158: 159: 160: 161: 162: 163: 164: 165: 166: 167: 168: 169: 170: case CMJSIZEBOX: if (hSizeBox == 0) ( hSizeBox = CreateDialog(hlnstance, "Options", hwnd, (DLGPROC)IpfnSizeBox); InvalidateRectfhwnd, NULL, FALSE); ) break; case CM_MAKE SHAPE: IpfnMakeShape = MakeProcInstance((FARPROC)MakeShapeProc, hlnstance); DialogBox(hlnstance, "MakeShape", hwnd,(DLGPROC)IpfnMakeShape); FreeProcInstance(IpfnMakeShape); InvalidateRectfhwnd, NULL, FALSE); break; Сообщения CM_SIZEBOX посылаются в программу, как только выбирается опция диалога Size из меню, а сообщения CM MAKESHAPE — при выборе опции Make Shape. Как видите, программа WinSize по-разному реагирует на сообщения CM_SIZEBOX и CM_MAKESHAPE. Это происходит потому, что модальные диалоги создаются вызо- вами функции DialogBox, а немодальные — с помощью функции CreateDialog. Далее, обращение к процедуре DialogBox не прекращается, пока пользователь не закроет диалог Make Shape. Вот почему можно быстро вызвать одну за другой MakeProcInstance, DialogBox и FreeProcInstance: 164: IpfnMakeShape = MakeProcInstance((FARPROC)MakeShapeProc, 165: hlnstance); 166: DialogBox(hlnstance, "MakeShape", 167: hwnd,(DLGPROC)IpfnMakeShape); 168: FreeProcInstance(IpfnMakeShape); Для FreeProcInstance не составит труда освободить память процедуры диалога, поскольку диалог Make Shape к этому времени уже закрылся. То же самое неверно для процедуры CreateDialog. Вот почему программа WinSize вызывает MakeProcInstance для диалога Size в ответ на сообщение WM CREATE и освобождает задействованную память во время обработки сообщения WM DESTROY. Дело тут в том, что нельзя определить, когда пользователь закроет диалог Size, так что
переменная IpfnSizeBox может быть безопасно удалена только после того, как пользова- тель закроет основное окно. Далее необходимо проверить значение переменной hSizeBox до любого обращения к CreateDialog: 155: if (hSizeBox == 0) 156: ( 157: hSizeBox = CreateDialog(hlnstance, "Options", 158: hwnd, (DLGPROC)IpfnSizeBox); 159: InvalidateRect(hwnd, NULL, FALSE); 160: } Это делается для гарантии того, что пользователь не заполнит экран целым набором экземпляров диалога Size. Но для диалога Make Shape в этом нет необходимости, поскольку пользователь не может получить доступ к меню, пока модальный диалог находится на экране. Не имея доступа к меню, пользователь не в состоянии посылать сообщения CMMAKESHAPE в WndProc. Ключевой момент создания каждого диалога — передача адреса его оконной проце- дуры в MakeProcInstance. В ответ на это программа получает должным образом установ- ленный указатель. В случае модального диалога адрес MakeShapeProc называется IpfnMakeShape. В случае немодального диалога адрес SizeBoxProc передается MakePro- cInstance, и возвращаемый указатель называется IpfnSizeBox. Как вы знаете, обе процедуры, адреса которых передаются MakeProcInstance, на самом деле представляют собой просто специальные типы оконных процедур, которые в наиболее упрощенной форме выглядят следующим образом: BOOL CALLBACK GenericDialogProc(HWND hDlg, WORD Message, WPARAM wParam, LPARAM IParam) ( switch(Message) ( case WM_INITDIALOG: return TRUE; case WM COMMAND: if (wParam == IDOK I I wParam == IDCANCEL) ( EndDialog(hDlg, TRUE); return TRUE; ) break; ) return FALSE; I Как видите, диалоги могут быть закрыты с помощью обращений к EndDialog. Замечание. Важно заметить, что процедуры диалоговых панелей не совсем идентичны оконным процедурам. Во-первых, процедуры диалогов возвращают BOOL, а не LRESULT, то есть не имеют обращений к DefWindowProc. Вместо этого они просто возвращают TRUE или FALSE. Другое значительное отличие состоит в том, что процедуры диалоговых панелей обрабатывают сообщения WMJNITDIALOG, а не WM CREATE. Беглый взгляд на исходный модуль WinSize обнаруживает, что MakeShapeProc и SizeBoxProc значительно более сложны, чем фрагменты кода, приведенные выше. Дополнительный код в этих функциях используется, как правило, для изменения цвета диалогов и размещения/выборки данных в их элементах управления. Фактические детали этого процесса будут обсуждаться в следующей главе. Резюме Из этой главы вы узнали о системе координат Windows и создании модальных и немодальных диалогов. В частности, вы узнали, что:
Н Существует восемь логических режимов отображения. Только один из них, называе- мый ММ_ТЕХТ, имеет, по крайней мере, квази-непосредственную связь с коорди- натами физического устройства — пикселами. Н Строго логические координатные системы, подобные MMJLOENGLISH, полезны для программистов, но все-таки не совсем точны. Существует два различных типа диалогов, называемых модальными и немодальными. Н Модальные диалоги забирают фокус программы, пока пользователь не закроет их. Немодальные диалоги позволяют пользователю в любое время возвратиться к основ- ному меню программы или к любой из доступных возможностей. В следующей главе вы увидите, как осуществлять связь с обоими типами диалогов. В частности, вы увидите, как передавать данные в диалог и как получать их обратно, чтобы проверить, изменил ли их пользователь. Следующая глава также содержит утилиту, использующуюся при проектировании игрового поля программы Snako. Эта утилита соответствует теме следующей главы, поскольку в ней широко используются диалоговые панели. Вопросы и ответы 1. Я все еще не понимаю, с какой стати кому-то вообще захочется изменять режим отображения окна. Что это дает? Существует несколько различных причин для изменения режимов отображения, но одна из наиболее веских состоит в том, что координаты устройства радикально изменя- ются при переходе от системы к системе. Люди, использующие ваши программы в режимах SVGA, могут иметь 1024 пиксела по оси X, в то время как тем, кто работает с VGA, доступно лишь 640 пикселов. Если вы определите ваше основное окно, имеющим 400x300 пикселов, то на второй системе оно будет почти вдвое меньше, чем на первой. Один из способов улаживания этих различий состоит в том, чтобы переключиться на режим MM_LOENGLISH и определить ваше основное окно как имеющее ширину 4 дюйма и высоту 3 дюйма.. Теперь ваше окно будет примерно одинакового размера независимо от типа системы, имеющейся у пользователя. 2. Почему WinSize вызывает MakeProcInstance в ответ на WM_CREATE и FreeProcInstance в ответ на WMJDESTROY? Важно понимать, что решение выполнять все таким образом ни в коем случае не является произвольным. Каждое обращение к MakeProcInstance должно уравновеши- ваться одним (и только одним) обращением к FreeProcInstance; существенно, что FreeProcInstance не вызывается, пока диалог находится на экране. Единственный способ гарантировать, что все будет работать таким образом — вызвать MakeProcInstance в SizeBoxProc прямо в самом начале жизни программы и освободить эту память только после того, как пользователь решит уничтожить основное окно. Другие действия могут случайно сделать возможными обращения к FreeProcInstance, пока диалог находится на экране или, что еще хуже, попытаться запустить диалог без обращения к MakeProcIn- stance. Вопросы для самопроверки 1. Что такое режим отображения? 2. Что такое пиксел? 3. Больше или меньше пиксела стандартного 14-дюймового VGA-монитора основная единица режима отображения MM_LOMETRIC? 4. Что такое физическое начало координат? 5. В чем разница между физическими и логическими координатами? 6. В чем разница между SetWindowOrg и SetViewportOrg? 7. В чем основное различие между модальными и немодальными диалогами?
8. Какая функция используется для создания модального диалога? 9. Какая функция используется для создания немодального диалога? 10. В чем заключаются два отличия между диалоговой и оконной процедурами? Упражнения 1. Прежде чем обратиться к CreateDialog, программа WinSize проверяет, установлен ли hSizeBox в NULL. Попробуйте удалить эту строчку и перекомпилируйте. Что происходит, когда вы выбираете в меню диалог Size три раза подряд? 2. Переделайте диалог Size в модальный. Каковы преимущества и недостатки такого устройства?
День 16 СЛОЖНЫЕ ДИАЛОГИ. РАЗМЕЩЕНИЕ И ИЗВЛЕЧЕНИЕ ДАННЫХ Сегодня вы изучите управление цветом диалоговых панелей, а также способы размещения/выборки данных в их элементах управления. Кроме того, в эту главу включен пример того, как растягивать и стягивать растровые изображения перед выводом на экран. В частности, в этой главе содержится следующая информация: SendDlgltemMessage и GetDlgltem. Я Сообщения WM_CTLCOLOR. Я Использование StretchBlt для стягивания или растягивания растрового изображения перед выводом на экран. Большая часть этой главы посвящается приложению WinSize, представленному в главе 15. Новая программа, имеющая название Mapper, появится ближе к концу этой главы. Mapper является частью проекта Snake (с которым я познакомил вас в главе 8 и который будет закончен в главе 21). Программа Mapper представляется здесь потому, что две ее диалоговые панели хорошо вписываются в тему сегодняшнего дня. Помещение данных в диалог Size Диалоговая панель Size Dialog (см. рис. 15.7) из программы WinSize показывает текущие координаты основного окна, измеренные в системах отображения ММ_ТЕХТ, MM_LOMETRIC, MM_HIMETRIC, MM_LOENGLISH, MM_HIENGLISH, MMTWIPS. В этом разделе содержится описание того, как программа WinSize вычис- ляет эту информацию и показывает ее на диалоговой панели. Вкратце эти шаги можно описать следующим образом: Фактические вычисления исполняются в компактном цикле, быстро вызывающем SetMapMode, GetClientRect и DPtoLP друг за другом. Результаты вычислений помещаются в массив, а затем посылаются в форме сообще- ния в диалог Size. Диалог Size помещает эту информацию в свои статические поля с помощью ряда обращений к SendDlgltemMessage. Ниже дается обзор каждого из этих шагов, показывающий, как именно они работают. Как вы помните из рассмотрения ответа на определенное пользователем сообщение CMJSIZEBOX, немодальный диалог Size создается с помощью обращения к CreateDia- log. Сразу же за этим обращением приложение WinSize выполняет вызов функции
InvalidateRect, которая гарантирует, что сообщение WM_PAINT посылается в основное окно. (Функция WinSizeOnPaint содержится в строчках 198—241 модуля WINSIZE.CPP). Функция WinSize_OnPaint выполняет четыре основных действия: Копирование выбранного пользователем режима отображения в текущий контекст устройства. Копирование выбранной пользователем начальной точки зоны видимости в текущий контекст устройства. Вычерчивание выбранной пользователем геометрической фигуры (квадрат или эл- липс). В Заполнение соответствующими данными диалоговой панели Size, если последняя находится на экране. Вы уже видели, как устанавливаются режим отображения и начало координат зоны видимости с помощью обращений к SetMapMode и SetViewPortOrg. Вычерчивание прямоугольника или эллипса преимущественно заключается просто в определении структуры типа RECT, содержащей конкретную фигуру. Этот предмет подробно осве- щается в главе 18. При этом четверть кода функции WinSize OnPaint не выполняется, если не был создан и показан на экране диалог Size: 237: if (hSizeBox != 0) 238: FillSizeBox(hwnd, PaintDC); hSizeBox представляет собой дескриптор диалоговой панели Size. Если hSizeBox не равно нулю, то вызывается процедура FillSizeBox и диалог Size заполняется координа- тами окна (см. рис. 16.1). Процедура FillSizeBox обеспечивает передачу дескрипторов основного окна и теку- щего контекста устройства: 183: void FillSizeBox(HWND hwnd, HDC PaintDC) 184: ( 185: TSIZEDATA SizeData; 186: for (int i = 0; i < 6; i++) 187: { 188: SetMapMode(PaintDC, Modes[i]); 189: GetClientRect(hwnd, sSizeData[i]); 190: DPtoLP(PaintDC, (LPPOINT)SSizeData[i] , 2); 191: ) 192: SendMessage(hSizeBox, WMSETDATA, 0, (long)SSizeData); 193: } Этот фрагмент кода показывает, как WinSize пробегает шесть режимов отображения (см. главу 15), индексируя приведенный ниже перечисляемый тип, который содержит список подходящих констант. int Modest] = (MMJTEXT, MMJLOMETRIC, MM_HIMETRIC, MM_LOENGLISH, MM_HIENGLISH, MM_TWIPS); При первом вызове SetMapMode используется константа ММ_ТЕХТ; при втором — MM_LOMETRIC; затем MM HIMETRIC и т.д. После того как режим отображения установлен, текущее положение окна, выражен- ное в координатах устройства, копируется в структуру типа TSizeData: typeclef RECT TSizeData[6]; TSizeData представляет собой массив, имеющий тип нашего старого друга RECT, который является обычной структурой, использующейся для определения местоположе- ния прямоугольника посредством указания координат его верхнего левого и нижнего правого углов. Разумеется, целью диалога Size является определение размеров окна не в координатах устройства, а в логических координатах. По этой причине выполняется обращение к функции DPtoLP, переводящей точки устройства в логические точки.
Визуализация данных На этом этапе игры у программы WinSize есть числа, которые она хочет показать. Осталось лишь поместить эти числа туда, где их можно увидеть. Для этого сначала посылают числа в оконную процедуру диалога Size: SendMessage(hSizeBox, WM_SETDATA, 0, (long)sSizeData); Послать информацию в диалог — абсолютно то же самое, что послать информацию в элемент управления. При этом не нужно изучать никаких новых технических приемов и усваивать какие-либо новые понятия. Правда, может несколько смутить приведение типа в последнем параметре. Здесь WinSize рассматривает адрес массива SizeData как 4-байтовое длинное целое. Поскольку сообщение WM_SETDATA определяется пользователем, ответ на него является делом программы WinSize: 502: 503: 504: 505: 506: 507: 508: 509: 510: 511: 512: 513: 514: 515: 516: 517: 518: 519: 520: case WM_SETDATA: IpSizeData = (void *)IParam; memcpy(SizeData, IpSizeData, sizeof(TSIZEDATA)); for (i =0; i < 6; i++) { sprintfIS, "Id" , SizeData[i].left) , SendDlgltemMessage(hDlg, Indexs[i] + 1, WM_SETTEXT, 0, long(S)); sprintf(S, "Id" , SizeData(i].right); SendDlgltemMessage(hDlg, Indexs[i] + 2, WMSETTEXT, 0, long(S)); sprintf(S, "id", SizeData (i].top) ; SendDlgltemMessage(hDlg, lndexs[i] + 3, WM_SETTEXT, 0, long(S)); sprintf(S, ”%d ", SizeData[i].bottom); SendDlgltemMessage(hDlg, Indexs(i] + 4, WM_SETTEXT, 0, long(S)); } return TRUE; В данном случае программе WinSize приходится бороться с системой сообщений Windows без защитной брони макросов WINDOWSX. Поэтому приходится решать неэстетичную и затруднительную задачу преобразования данных, на которые ссылается LPARAM, к чему-то пригодному для использования: TSIZEDATA IpSizeData = (void *)IParam; memcpy(SizeData, IpSizeData, sizeof(TSizeData)); Этот код приводит LPARAM к типу “указатель”, а затем копирует данные, адресуемые этим указателем, в переменную типа TSizeData. Теперь, когда у программы WinSize имеются данные в пригодной для использования форме, она превращает их в символь- ную строку и посылает в статическое поле диалоговой панели: sprintf(S, "%d", SizeData[i].left); SendDlgltemMessage(hDlg, Indexs[i] + 1, WM_SETTEXT, 0, long(S)); В этом коде вводится функция SendDlgltemMessage, служащая удобной альтернати- вой функции SendMessage. Проблема с функцией SendMessage состоит в том, что она требует дескриптор окна (HWND) прежде, чем сможет послать сообщение в элемент управления. Очевидно, было бы очень сложно отслеживать HWND каждого элемента управления в диалоге. SendDlgltemMessage облегчает жизнь программистам, позволяя использовать идентификатор элемента управления вместо его HWND. SendDlgltemMessage SendDlgltemMessage(HWND, int, UINT, WPARAM, LPARAM); Вот параметры SendDlgltemMessage: HWND hwndDlg; int idDlgltem; UINT uMsg; Дескриптор диалоговой панели, содержащей элемент управления Идентификатор элемента управления Сообщение, посылаемое в элемент управления
WPARAM wParam; 2-байтовый параметр LPARAM IParam; 4-байтовый параметр Используйте функцию SendDlgltemMessage для того, чтобы послать сообщение в элемент управления, находящийся на диалоговой панели. Этой функции требуются дескриптор HWND диалога и идентификатор элемента управления в качестве первых двух параметров. После этого все обстоит так же, как и в случае SendMessage. Иначе говоря, остальные три параметра представляют собой собственно сообщение и стандартные WPARAM и LPARAM. В SendDlgltemMessage нет ничего сложного — это просто удобный способ вызова SendMessage при работе с элементом управления, находящимся на диалоговой панели. Пример: SendDlgltemMessage(hDlg, IDCONTROL, WM_SETTEXT, 0, long(S)); Важно понимать близкое родство вызовов SendMessage и SendDlgltemMessage. Например, следующие два вызова совершенно эквивалентны: SendMessage(GetDlgItem(hDlg,Index[i] + 1), WM_SETTEXT, 0, long(S)); SendDlgltemMessage(hDlg, Index(i] + 1, WM_SETTEXT, 0, long(S)); SendDlgltemMessage позволяет вам обойти обращение к GetDlgltem (см. ниже). В остальном все так же, как и в случае с SendMessage. Функция GetDlgltem GetDlgltem(HWND, int); GetDlgltem можно использовать, чтобы выудить оконный дескриптор любого элемента управ- ления, который вам понравится. Эту функцию программисты часто не замечают до тех пор, пока она не станет жизненно необходимой; тогда GetDlgltem всегда должна будет находиться под рукой. Параметры GetDlgltem: HWND hwndDlg; Дескриптор диалоговой панели, содержащей элемент управления int idcontrol; Идентификатор элемента управления Разумеется, возвращаемым значением является HWND элемента управления. Пример: GetDlgltem(hDlg, ID_CONTROL); И это все о размещении текста на диалоговой панели. Наше повествование завершилось так быстро потому, что понятие передачи сообщений является одной из основных тем этой книги. К настоящему времени функции SendMessage, PostMessage и SendDlgltemMessage уже должны быть вам хорошо знакомы. Итак, для передачи и отображения данных на диалоговой панели программа WinSize должна: Создать диалог с помощью вызова MakeProcInstance или CreateDialog. И Заполнить массив с помощью обращений к GetMapMode, GetClientRect и DPtoLP. Послать массив в диалог посредством SendMessage. Распаковать массив и привести типы. И Разослать конкретные фрагменты массива по соответствующим элементам управле- ния с помощью процедуры SendDlgltemMessage. Овладейте этим процессом и усвойте его так, чтобы он стал второй натурой; тогда вы уже действительно сможете заявлять о себе, как о настоящем Windows-программисте. Фактически вы закладываете один из важнейших камней фундамента, который позволит вам шагнуть с промежуточного уровня к началу реальной работы над сложными вещами.
Конечно, помещение текста в элемент управления на диалоговой панели — только полдела. Вторая половина — извлечение текста обратно. Поскольку нет необходимости извлекать текст из диалога Size, обсуждение этого процесса включается в следующий раздел, где предметом рассмотрения будет диалог Make Shape. Теория. Модальный диалог общается со своим родителем Диалог Make Shape является модальным диалогом, делающим кое-что немного необычное: он довольно часто взаимодействует с основным окном программы. В частности, вы можете изменять форму фигур в основном окне, нажимая кнопки на диалоговой панели Make Shape. Это свидетельствует о том, что модальный диалог не изолирован от своего родительского окна или от какой-либо другой части программы. Рассмотрим этот важный момент под другим углом. Модальные диалоги препятст- вуют манипуляциям с основным телом программы. Например, пользователи не могут получить доступ к основному меню программы, пока на экране находятся модальные диалоги. Для программистов же такого ограничения не существует. Ничто не мешает им посылать сообщения из диалога в основное тело программы. Иначе говоря, с точки зрения программиста, линия связи все еще открыта, по крайней мере, в одном направ- лении. Используя линейную аналогию, можно сказать, что программисты следуют принци- пу, когда инструкция А выполняется прежде инструкции В, а С — прежде D. Такое упорядочение позволяет программистам DOS проходить свои программы последователь- но шаг за шагом с помощью отладчика. Как вы, возможно, уже заметили, то же самое невозможно в Windows-программах. Вместо этого вам нужно помещать точки прерыва- ния на разделах кода, которые вы хотите проверить, а затем ждать, пока соответствующая строчка не будет выполнена и не произойдет прерывание. В программе WinSize вызывается процедура DialogBox, и пока она выполняется, могут выполняться подпрограммы WinSize OnPaint и FillSizeBox. Как вы увидите через несколько секунд, это делается посредством передачи сообщения из процедуры диалога в основное окно. Конечный эффект состоит в том, что WinSize имеет доступ к большинству возможностей, ассоциированных с ее основным окном, даже когда выпол- няется “модальная” процедура DialogBox. Замечание. Для непосвященного подобный процесс выглядит Windows’oecKoft магией. Вы находитесь в точке D вашей программы — в процедуре DialogBox. Внезапно вы прыгаете в точку В — процедуру WinSize_OnPaint — а затем в процедуру FillSizeBox и снова в точку D. (Воспользуйтесь отладчиком, чтобы посмотреть, как это работает). Является ли эта вновь обретенная свобода благословением или проклятием — вопрос, на который должен себе ответить каждый пользователь. Некоторые наслаждаются этим — другие же нет. Это ваше дело. Практика. Извлечение данных из диалога Make Shape Диалог Make Shape позволяет пользователю управлять программой WinSize. Это кресло пилота, с которого пользователь может “вести” программу в любом направлении. Первым делом в процедуре диалога Make Shape следует проинициализировать кнопки-селекторы, находящиеся на диалоговой панели: 439: case WM_INITDIALOG: 440: SendDlgltemMessage(hwnd, 441: SendDlgltemMessage(hwnd, 442: SendDlgltemMessage(hwnd, 443: SendDlgltemMessage(hwnd, 444: return TRUE; ID_RTEXT, BM_SETCHECK, 1, 0L); IDRECT, BMSETCHECK, 1, 0L); IDORGUPLEFT, BMSETCHECK, 1, 0L); ID_COMPCORDS, BMJSETCHECK, 1, OL) ; Сейчас такого рода код уже должен быть вам знаком. Требуется просто установить кнопку умолчания в каждой из основных групп на экране. Это достигается посредством
посылки сообщений BMJSETCHECK в соответствующие элементы управления. Нет ничего проще. Ядром процедуры диалога Make Shape является ответ на сообщения WM_COMMAND. Поскольку это длинный и запутанный процесс, WinSize реализует его в отдельной функции с названием DoRectCommand. Функция DoRectCommand (строчка 344) содержит длинный оператор case, выпол- няющийся, как только пользователь выбирает одну из обычных кнопок или кнопок-се- лекторов на диалоговой панели. Например, если пользователь выбирает кнопку Draw, выполняется следующий код: 348: case ID___DRAW: 349: GetUserCords(hwnd); 350: InvalidateRect(GetParent(hwnd), NULL, TRUE); 351: return TRUE; Как вы могли заметить, пользователь может манипулировать редактируемыми поля- ми диалоговой панели Make Shape для указания новых координат фигуры, отображаемой в основном окне. Цель данного фрагмента кода — извлечь координаты из редактируемых полей диалоговой панели и использовать их для описания размера фигуры, изображен- ной в рабочей области основного окна. Функция GetUserCords показывает один из способов выборки данных из редактиру- емых полей диалоговой панели: 278: void GetUserCords(HWND hwnd) 279: ( 280: char S[100); 281: 282: GetWindowText(GetDlgltem(hwnd, ID_RLEFT), S, 100); 283: RLeft = atoi (S); 284: GetWindowText(GetDlgltem(hwnd, ID_RTOP), S, 100); 285: RTop = atoi(S); 286: GetWindowText(GetDlgltem(hwnd, ID_RRIGHT), S, 100); 287: RRight = atoi(S); 288: GetWindowText(GetDlgltem(hwnd, ID_RBOTTOM), S, 100); 289: RBottom - atoi(S); 290: ) В данном случае WinSize использует GetWindowText, а не SendDlgltemMessage вкупе с сообщением WM_GETTEXT. Я показываю вам этот способ, чтобы вы имели более широкий выбор. Функция GetWindowText int GetWindowText(HWND, LPSTR, int) Само по себе обращение к GetWindowText очень просто. Функция требует лишь три параметра: И Первый параметр — это дескриптор HWND элемента управления, содержащего текст. Н Второй — собственно текст элемента управления. И Последний — наибольшая возможная длина текста. Пример: GetWindowText(hControl, MyStr, 100); После того как текст выбран из элемента управления, он переводится в цифровую форму и используется в WinSize_OnPaint для описания структуры RECT. Прямоугольник или эллипс рисуются внутри RECT. И снова опыт, который вы уже получили из этой книги, позволяет мне описать такой относительно сложный процесс лишь несколькими короткими абзацами. Естественно, это не означает, что извлечение данных из диалога не является чрезвычайно важной частью программирования в Windows. Все дело в том, что вы уже подробно познакоми- лись с передачей данных в статические и редактируемые поля и извлечением их обратно, а также с другими элементами управления. Ни один из принципов не изменится, если вместо обычного окна будет диалоговая панель.
Все это означает лишь то, что работа с диалогами — дело здравого смысла. Например, если вы хотите показать на диалоговой панели адрес улицы из базы данных, то должны действовать следующим образом: Прочитать адрес текстового или двоичного файла и поместить его в структуру. Переслать эту структуру в диалог аналогично тому, как вы пересылали массив в предыдущем разделе. С помощью SetWindowText или SendDlgltemMessage разослать элементы структуры по соответствующим редактируемым полям. И Ждать, пока пользователь не нажмет кнопку, сигнализирующую о том, что он закончил редактирование или просмотр адреса. Выбрать текст из редактируемых полей с помощью GetWindowText или SendDlgltem- Message. Переслать структуру обратно в основное тело программы с помощью обращения к SendMessage. И Если структура изменилась, то в основном теле программы новые данные должны быть записаны в файл. Ответ на смену режима отображения Прежде чем закончить эту часть главы, видимо, стоит вкратце рассмотреть код, который выполняется, когда пользователь меняет режимы отображения, выбирая кноп- ки-селекторы: 353: case ID_RTEXT: 354: ModeCase = TEXT; 355: DoDraw(hwnd); 356: return TRUE; Переменная ModeCase имеет один из нескольких перечисляемых типов, объявленных в WINSIZE.H. Она используется, чтобы отслеживать текущий выбор пользователя: 60: enum TModeCase (TEXT, LOMETRIC, HIMETRIC, LOENGLISH, 61: HIENGLISH, TWIPS, ISOTROPIC, ANISOTROPIC); 62: enum TOriginMode (ORG_UPLEFT, ORG_LOWLEFT, ORG_CENTER); 63: enum TShape (RECTANGLE, CIRCLE); Все кнопки-селекторы на диалоговой панели отражены значениями, включенными в эти перечисляемые типы. Следовательно, сразу после того как пользователь выберет кнопку, следует установить значение соответствующего перечисляемого типа (см. строку 354, где переменной ModeCase присваивается значение TEXT). Затем нужно проверить, выберет ли пользователь или программа WinSize координа- ты: 334: void DoDraw(HWND hwnd) 335: ( 336: if (UseCompCords) 337: MakeShape(hwnd); 338: SetRectText(hwnd); 339: ) Если это дело оставляется WinSize, то вызывается процедура MakeShape и координаты текущего устройства транслируются в оконные координаты с помощью вызовов GetCli- entRect и LPtoDP. Это процесс, аналогичный тому, который использовался в процедуре FiUSizeBox. Все еще находясь внутри MakeShape, программа WinSize вычисляет размеры фигуры, которую предстоит нарисовать: 307: case ORG_CENTER: 308: RLeft = —(R.right / 3); 309: RTop = -(R.bottom / 3); 310: RRight = (R.right / 3); 311: RBottom = (R.bottom /3); 312: break;
Реальные размеры не имеют значения. Предыдущий код предназначен для гарантии того, что фигура всегда видима и покрывает один и тот же процент площади пропорци- онально размеру окна. Кроме того, программа WinSize гарантирует, что фигура покры- вает одну и ту же площадь, выраженную в координатах устройства в данной зоне видимости. Естественно, логические координаты радикально изменяются всякий раз, когда пользователь выбирает новый режим отображения. Это позволяет наблюдать резуль- таты применения различных режимов отображения в системе логических координат. Управление цветом диалоговой панели Пора заканчивать обсуждение программы WinSize. Осталось только рассмотреть, как изменяется цвет диалога. Когда инициализируется диалог Size, программа WinSize тщательно устанавливает подходящие цвета диалога. Это делается посредством ответа на сообщения WM_CTLCOLOR: 489: case WMCTLCOLOR: 490: 491: 492: 493: 494: 495: 496: 497: 498: 499: 500: switch(HIWORD(IParam)) ( case CTLCOLOR_STATIC: SetTextColor ( (HDC) wParam, RGB(255, 0, 0)),- SetBkMode((HDC)wParam, TRANSPARENT); return (BOOL) GetStockObject(BLACK_BRUSH); case CTLCOLOR_DLG: return (BOOL) GetStockObject(BLACK_BRUSH); ) return (BOOL) NULL; Сообщения WM_CTLCOLOR бомбардируют диалог подобно шквалу — по одному сообщению для каждого из возможных элементов управления. В предыдущем случае WinSize устанавливает статические поля таким образом, чтобы они имели красный текст на черном фоне. Обратите внимание на использование вызова SetBkMode, который устанавливает прозрачный для текста фон. В этом случае установка цвета фона опреде- ляется стандартным BLACK_BRUSH. Предыдущие фрагменты кода соответствуют идентификаторам CTLCOLOR_STATIC и CTLCOLOR_DLG. Ниже приводится полный список этих констант, посылаемых в диалог всякий раз, когда нужно обновить один из соответствующих элементов управления: CTLCOLOR_BTN CTLCOLORDLG CTLCOLOREDIT CTLCOLOR_LISTBOX CTLCOLOR—MSGBOX CTLCOLOR_SCROLLBAR CTLCOLOR STATIC Изменяет цвет кнопок (устаревший) Изменяет цвет блоков диалога Изменяет цвет редактируемых полей Изменяет цвет перечней Изменяет цвет окон сообщений Изменяет цвет линеек прокрутки Изменяет цвет статических полей Перечисленные выше параметры передаются в старшем слове LPARAM, сопровож- дающем каждое сообщение CTL_COLOR. Младшее слово LPARAM содержит дескрип- тор HWND текущего изображаемого элемента управления. Это означает, что вы можете различать отдельные элементы управления, даже когда они принадлежат одному классу, окрашивая, например, один статический элемент в красный цвет, а другой — в зеленый. Наконец, HDC элемента управления передается в параметре WPARAM, как показано в предыдущем фрагменте кода. Диалог Make Shape также реагирует на сообщения WMCTLCOLOR. Взгляните на этот код, поскольку в нем используются кисти, не являющиеся встроенными объектами. При этом обратите внимание, что использующиеся кисти создаются в обработчике сообщения WM_CREATE для основного окна и уничтожаются в обработчике сообщения WM_DESTROY.
Изменяйте цвет диалоговых панелей в ответ на сообщение WM CTLCOLOR. Не пытайтесь изменять цвет диалога таким же способом, что и цвет окна. Не думайте, что Win32 обрабатывает сообщение WM_CTLCOLOR так же, как и показанный здесь 16-битовый код. Это одно из немногих мест, где 16-битовые и 32-битовые коды различаются. Программа Mapper После выполненной вами тяжелой работы можно расслабиться, рассмотрев еще один фрагмент игры Snake (листинг 16.1). Это визуальное программное средство, разработан- ное, чтобы позволить программисту легко и быстро набросать фон двумерного поля игры. Листинг 16.1. MAPPER.CPP 1: ///////////////////////////////////////////// 2: // Программа: MAPPER.CPP 3: // Автор: Чарли Калверт 4: // Описание: Mapper - программа для Windows 5: // Дата: 7/18/93 6: ///////////////////////////////////////////// 7: В: «define STRICT 9: «include <windows.h> 10: «include <windowsx.h> 11: «pragma hdrstop 12: «include <string.h> 13: «include <stdio.h> 14: «include <stdlib.h> 15: «include "mapper.h" 16: «pragma warning (disable: 4068) 17: «pragma warning (disable: 4100) 18: // =========================================== 19: // Интерфейс 20: // =========================================== 21: 22: // Переменные 23: static char szAppName[] = "Mapper"; 24: static HWND MainWindow; 25: static HINSTANCE hlnstance; 26: static FARPROC IpfnNewBitProc, IpfnArrowBox; 27: char Map[MaxY][MaxX]; 28: WNDPROC StatProcl, StatProc2; 29: HBITMAP Grass, Road; 30: TDAT Dat; 31: 32: // ============================-----=========== 33: // Инициализация 34: // =====--==================================== 35: 36: //////////////////////////////////////////////// 37: // Точка входа 38: //////////////////////////////////////////////// 39: «pragma argsused 40: int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInstance, 41: LPSTR IpszCmdParam, int nCmdShow) 42: ( 43: MSG Msg; 44: 45: if ('.hPrevInstance) 46: if (!Register(hlnst)) 47: return FALSE; 48: 49: if (((MainWindow = Create(hlnst, nCmdShow))) 50: return FALSE; 51: 52: while (GetMessage(SMsg, NULL, 0, 0)) 53: ( 54: TranslateMessage(SMsg); 55: DispatchMessage(SMsg); 56: ) 57:
58: return Msg.wParam; 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: ) //////////////////////////////////////// // Регистрация окна / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / BOOL Register(HINSTANCE hinst) ( WNDCLASS WndClass ; WndClass. style = CS_HREDRAW 1 CS_VREDRAW; WndClass.IpfnWndProc = WndProc; WndClass.cbClsExtra = 0; WndClass.cbWndExtra = 0; WndClass.hlnstance = hinst; WndClass.hlcon = Loadicon(NULL, IDIAPPLICATION); WndClass.hCursor = LoadCursor(NULL, IDC_ARROW) ; WndClass.hbrBackground = GetStockBrush(WHITEBRUSH); WndClass . IpszMenuName = NULL; WndClass.IpszClassName = SzAppName; return Registerclass (SWndClass); ) 82: 83: 84: 85: 86: 87: 88: 89: 90: 91: 92: 93: 94: 95: 96: 97: 98: 99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: //////////////////////////////////////////// // Создание окна //////////////////////////////////////////// HWND Create(HINSTANCE hinst, int nCmdShow) { nCmdShow - SW_MAXIMIZE; hlnstance = hinst; HWND hWindow я CreateWindow(szAppName, szAppName, WS_POPUP, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, NULL, NULL, hlnstance, NULL); if (hWindow == NULL) return hWindow; ShowWindow(hWindow, nCmdShow); UpdateWindow(hWindow); return hWindow; ) // // Реализация ! / ===================================== ////////////////////////////////////////// // Оконная процедура ////////////////////////////////////////// LRESULT CALLBACK export WndProc(HWND hwnd, UINT Message, WPARAM wParam, LPARAM IParam) ( switch(Message) ( case WM_DIALOG: { FARPROC OptionsBox = MakeProcInstance((FARPROC)OptionsDlgProc, hlnstance); DialogBox(hlnstance, "Options", hwnd, (DLGPROC)OptionsBox); FreeProcInstance(OptionsBox); return FALSE; ) case WM HELP: { char *S = "МАРРЕR\n\n" "Use this program to design screens for SNAKO\n\n" "RSCREEN takes you one screen to the right\n" "LSCREEN takes you one screen to the left\n"
133: "LEFT takes you one column to the left\n" 134: "RIGHT takes you one column to the rightXn" 135: "To save a screen open the options DIALOG"; 136: MessageBox(hwnd, S, "Info", 137: MB_0K I MB_IC0NINF0RMATI0N) ; 138: return FALSE; 139: ) 140: HANDLE MSG (hwnd, WM_CREATE, Mapper _OnCreate) ; 141: HANDLE MSG (hwnd, WM_DESTROY, Mapper OnDestroy) ; 142: HANDLE_MSG (hwnd, WM_LBUTT0ND0WN, Mapper_OnLButtonDown); 143: HANDLE_MSG (hwnd, WMRBUTTONDOWN, Mapper_OnRButtonDown); 144: HANDLE_MSG (hwnd, WM_PAINT, Mapper_OnPaint); 145: default: return Mapper_DefProc(hwnd. Message, wParam, IParam) 146: ) 147: ) 148: 149: int ReadArray(HWND hwnd) 150: ( 151: FILE * fp; 152: 153: if ((fp = fopen ("Screen.Dta", "r")) == NULL) 154: ( 155: MessageBox(hwnd, "Can't find SCREEN.DTA" , NULL , MB_OK); 156: memset(Map, 1, sizeof(Map)); 157: return 0; • 158: ) 159: 160: fread(4Map, sizeof(Map), 1, fp); 161: fclose(fp); 162: 163: for (int i = 0, i < MaxY; i++) 164: for (int j = 0; j < MaxX; j++) 165: if (MapIiHj] != 1) 166: Map[i) [j] = 2; 167: 168: return 1; 169: ) 170: 171: ////////////////////////////////////// 172: // Обработчик сообщения WM CREATE 173: ////////////////////////////////////// 174: #pragma argsused 175: BOOL Mapper OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) 176: ( 177: Grass = LoadBitmap(hlnstance, "Grass"); 178: Road = LoadBitmap(hlnstance, "Road"); 179: 180: if (((Grass) II ((Road)) 181: ( 182: MessageBox (hwnd, "Bitmaps missing!". 183: "Fatal", MB_OK I MB_ICONSTOP) ; 184: return FALSE ; 185: ) 186: 187: int X = GetSysteniMetrics (SM_CXSCREEN) ; 188: 189: if (X == 1024) 190: ( 191: Dat.GrassX = Dat.GrassY = 32; 192: Dat.SizeX = Dat.SizeY = 32; 193: ) 194: 195: if (X == 800) 196: ( 197: Dat.GrassX = Dat.GrassY = 25; 198: Dat.SizeX = Dat.SizeY = 25; 199: ) 200: 201: if ( X == 640 ) 202: ( 203: Dat.GrassX = Dat.GrassY = 20; 204: Dat.SizeX = Dat.SizeY = 20; 205: ) 206: 207: Dat.SPos = 0;
208: Dat.MenuSpace = 3; 209: 210: 211: 212: 213: 214: 215: 216: 217: 218: 219: 220: 221: 222: 223: 224: 225: 226: 227: 228: 229: 230: 231: 232: 233: 234: 235: 236: 237: 238: 239: 240: 241: 242: 243: 244: 245: 246: 247: 248: 249: 250: 251: 252: 253: 254: 255: 256: 257: 258: 259: 260: 261: 262: 263: 264: 265: 266: 267: 268: 269: 270: 271: 272: 273: 274: 275: 276: 277: 278: 279: 280: 281: 282: IpfnArrowBox = MakeProcInstance((FARPROC)ArrowDlgProc, hlnstance); CreateDialog(hlnstance, "Arrows", hwnd, (DLGPROC)IpfnArrowBox); ReadArray(hwnd); return TRUE; ) ///////////////////////////////////////// // Обработчик сообщения WM DESTROY ///////////////////////////////////////// #pragma argsused void Mapper OnDestroy(HWND hwnd) { DeleteObject(Road); DeleteObject(Grass); FreeProcInstance(IpfnArrowBox); PostQuitMessage(0); ) /////////////////////////////////////////// // OnRButtonDown /////////////////////////////////////////// frpragma argsused void Mapper_OnRButtonDown(HWND hwnd, BOOL fDoubleClick, int x, int y, UINT keyFlags) ( char BoxX = (x / Dat.GrassX) + Dat.SPos; char BoxY = (y / Dat.GrassY) - Dat.MenuSpace; Map[BoxY] [BoxX] = 2; InvalidateRect(hwnd, NULL, FALSE); ) ///////////////////////////////////////////// // OnLButtonDown ///////////////////////////////////////////// ftpragma argsused void Mapper_OnLButtonDown(HWND hwnd, BOOL fDoubleClick, int x, int y, UINT keyFlags) ( char BoxX = (x / Dat.GrassX) + Dat.SPos; char BoxY = (y / Dat.GrassY) - Dat.MenuSpace; Map [BoxY] [BoxX] = 1; InvalidateRect(hwnd, NULL, FALSE); ) //////////////////////////////////////////////// // PAINTBitmaps // GrassX * MenuSpace - пространство для меню //////////////////////////////////////////////// void PaintBitmaps(HDC PaintDC, HDC GrassDC, HDC RoadDC) ( for (int i = 0; i < MaxY; i++) for (int j = Dat.SPos; j < MaxX; j++) ( if (Map[iJ [j] = 1) BitBlt(PaintDC, (j - Dat.SPos) * Dat.GrassX, (i * Dat.GrassY) + (Dat.GrassX * Dat.MenuSpace), Dat.GrassX, Dat.GrassY, GrassDC, 0, 0, SRCCOPY); else BitBlt(PaintDC, (j - Dat.SPos) * Dat.GrassX, (i * Dat.GrassY) + (Dat.GrassX ★ Dat.MenuSpace) Dat.GrassX, Dat.GrassY, RoadDC, 0, 0, SRCCOPY); ) I /////////////////////////////////////// // Обработчик сообщения WM PAINT /////////////////////////////////////// void Mapper OnPaint(HWND hwnd) ( PAINTSTRUCT PaintStruct;
283: HBITMAP OldGrass, OldRoad, OldGrassl, OldRoadl; 284: 285: HDC PaintDC = BeginPaint(hwnd, SPaintStruct); 286: 287: HDC TGrassDC = CreateCompatibleDC(PaintDC); 288: HDC TRoadDC — CreateCompatibleDC(PaintDC); 289: HDC GrassDC = CreateCompatibleDC(PaintDC); 290: HDC RoadDC = CreateCompatibleDC(PaintDC) ; 291: HBITMAP TGrass = 292: CreateCompatibleBitmap(PaintDC, Dat.GrassX, Dat.GrassY); 293: HBITMAP TRoad = 294: CreateCompatibleBitmap(PaintDC, Dat.GrassX, Dat.GrassY); 295: 296: OldGrass = SelectBitmap(TGrassDC, Grass); 297: OldRoad = SelectBitmap(TRoadDC, Road); 298: OldGrassl = SelectBitmap(GrassDC, TGrass); 299: OldRoadl = SelectBitmap(RoadDC, TRoad); 300: 301: StretchBlt(GrassDC, 0, 0, Dat.GrassX, Dat.GrassY, 302: TGrassDC, 0, 0, BITWIDTH, BITHEIGHT, SRCCOPY); 303: StretchBlt(RoadDC, 0, 0, Dat.GrassX, Dat.GrassY, 304: TRoadDC, 0, 0, BITWIDTH, BITHEIGHT, SRCCOPY); 305: 306: PaintBitmaps(PaintDC, GrassDC, RoadDC); 307: 308: SelectBitmap(TGrassDC, OldGrass); 309: SelectBitmap(TRoadDC, OldRoad); 310: SelectBitmap(GrassDC, OldGrassl); 311: SelectBitmap(RoadDC, OldRoadl); 312: DeleteObject(TRoad); 313: DeleteObject(TGrass) ; 314: 315: DeleteDC(GrassDC); 316: DeleteDC(RoadDC); 317: DeleteDC(TGrassDC); 318: DeleteDC(TRoadDC); 319: 320: EndPaint(hwnd, SPaintStruct); 321: ) 322: 323: // ========================-------====== 324: // Оконные процедуры диалоговых панелей 325: // ===========-===============---------- 326: 327: IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII 328: // SaveArray 329: ///////////////////////////////////// 330: int SaveArray(HWND hwnd) 331: ( 332: FILE * fp; 333: 334: if ((fp = fopen ("screen.dta", "w+")) == NULL) 335: ( 336: MessageBox (hwnd, "Can't save SCREEN.DTA", NULL, MB__OK) ; 337: return 0; 338: ) 339: 340: fwrite(SMap, sizeof(Map), 1, fp) ; 341: fclose(fp); 342: 343: MessageBox(hwnd, "SCREEN.DTA saved", "Succes", MB_OK); 344: 345: return 1; 346: ) 347: 348: /////////////////////////////////// 349: // Процедура диалога Options 350: /////////////////////////////////// 351: ((pragma argsused 352: BOOL CALLBACK OptionsDlgProc (HWND hDlg, WORD Message, 353: WPARAM wParam, LPARAM IParam) 354: ( 355: char S[100J; 356: HWND hwndl, hwnd2; 357:
358: switch(Message) 359: ( 360: case WMDESTROY: 361: hwndl = GetDlgltem(hDlg, IDBITMAP1); 362: hwnd2 = GetDlgltem(hDlg, ID_BITMAP2) ; 363: Subclasswindow(hwndl, StatProcl); 364: Subclasswindow(hwnd2, StatProc2); 365: FreeProcInstance(IpfnNewBitProc); 366: return TRUE; 367: 368: case WMINITD1ALOG: 369: itoa(Dat.GrassX, S, 10); 370: SetWindowText(GetDlgltem(hDlg, IDXSIZE), S); 371: itoa(Dat.GrassY, S, 10); 372: SetWindowText(GetDlgItem(hDlg, ID_YSIZE), S); 373: 374: itoa(MaxX, S, 10); 375: SetWindowText(GetDlgltem(hDlg, ID_NUMX), S); 376: itoa(MaxY, S, 10); 377: SetWindowText(GetDlgltem(hDlg, ID_NUMY), S); 378: 379: IpfnNewBitProc = 380: MakeProcInstance(FARPROC(BitmapProc), hlnstance); 381: hwndl = GetDlgItem(hDlg, ID_BITMAP1); 382: StatProcl = SubclassWindow(hwndl, IpfnNewBitProc); 383: hwnd2 = GetDlgltem(hDlg, ID_BITMAP2); 384: StatProc2 = SubclassWindow(hwnd2, IpfnNewBitProc); 385: return TRUE; 386: 387: case WM__COMMAND: 388: switch(wParam) 389: ( 390: case IDOK : 391: case IDCANCEL: 392: EndDialog(hDlg, TRUE); 393: return TRUE; 394: 395: case ID_SAVE: 396: SaveArray(hDlg); 397: return TRUE; 398: 399: case IDHELP: 400: PostMessage(GetParent(hDlg), WMHELP, 0, 0); 401: return TRUE; 402: ) 403: ) 404: return FALSE; 405: ) 406: 407: 408: BOOL ExitMapper(HWND hDlg) 409: { 410: int Result = MessageBox(hDlg, "Are you sure you want to quit?", 411: "Are we thinking?" , MB YESNO I MB_ICON0UESTION) ; 412: if (Result == IDYES) 413: ( 414: SendMessage(GetParent(hDlg), WMCLOSE, 0, 0); 415: return TRUE ; 416: ) 417: else 418: return FALSE; 419: ) 420: 421: ///////////////////////////////// 422: // Handlecommand 423: llllllllllllllllllllltllllllllllll 424: BOOL HandleCommand(HWND hDlg, WPARAM wParam) 425: { 426: switch(wParam) 427: ( 428: case IDOK: 429: case IDCANCEL: 430: PostMessage(hDlg, WM_CLOSE, 0, 0); 431: return TRUE; 432:
433: case IDRIGHT: 434: Dat.SPos++; 435: InvalidateRect(GetParent(hDlg), NULL, TRUE); 436: return TRUE; 437: 438: case ID_LEFT: 439: Dat.SPos-; 440: if (Dat.SPos < 0) 441: Dat.SPos = 0; 442: InvalidateRect(GetParent(hDlg), NULL, TRUE); 443: return TRUE; 444: 445: case ID_RSCREEN: 446: if (Dat.SPos < JUMPSPACE) 447: Dat.SPos = JUMPSPACE; 448: else 449: if (Dat.SPos < JUMPSPACE * 2) 450: Dat.SPos - JUMPSPACE * 2: 451: else 452: if (Dat.SPos < JUMPSPACE * 3) 453: Dat.SPos = JUMPSPACE * 3; 454: else 455: Dat.SPos = JUMPSPACE * 3; 456: InvalidateRect(GetParent(hDlg), NULL, TRUE); 457: return TRUE; 458: 459: case ID_LSCREEN: 460: if (Dat.SPos <= JUMPSPACE) 461: Dat.SPos = 0; 462: else 463: if (Dat.SPos <= JUMPSPACE * 2) 464: Dat.SPos = JUMPSPACE; 465: else 466: if (Dat.SPos <= JUMPSPACE * 3) 467: Dat.SPos = JUMPSPACE * 2; 468: else 469: Dat.SPos » JUMPSPACE * 3; 470: InvalidateRect(GetParent(hDlg), NULL, TRUE); 471: return TRUE; 472: 473: case ID_DIAL0G: 474: PostMessagefGetParent (hDlg), WM_DIALOG, 0, 0); 475: break; 476: 477: case IDHELP: 478: PostMessage(GetParent(hDlg), WM_HELP, 0, 0) ; 479: break; 480; 481: case IDQUIT: 482: ExitMapper(hDlg); 483: return TRUE; 484: ) 485: 486: return FALSE; 487: ) 488: 489: /////////////////////////////////// 490: // Процедура диалога Bitmap 491: /////////////////////////////////// 492: LRESULT CALLBACK export BitmapProc (HWND hwnd, UINT Message, 493: WPARAM wParam, LPARAM IParam) 494: ( 495: WORD id; 496: LRESULT IResult = 0; 497: BOOL CallOrig = TRUE; 498: HDC PaintDC, MemDC; 499: HBITMAP OldBitmap; 500: PAINTSTRUCT PaintStruct; 501: 502: id = GetWindowWord(hwnd, GWW ID); 503: 504: switch(Message) 505: ( 506: BITMAP Bits; 507:
508: case WM_PAINT: 509: 510: 511: 512: 513: 514: 515: 516: 517: 518: 519: 520: 521: 522: 523: 524: 525: 526: 527: 528: 529: 530: 531: 532: 533: 534: 535: 536: 537: 538: 539: 540: 541: 542: 543: 544: PaintDC = BeginPaint(hwnd, SPaintStruct); MemDC = CreateCompatibleDC(PaintDC); switch(id) ( case ID_BITMAP1: OldBitmap = SelectBitmap (MemDC, Road); break; case ID_BITMAP2: OldBitmap = SelectBitmap(MemDC, Grass); break; case ID_BITMAP3: break; case ID_BITMAP4: break; ) GetObject(Grass, sizeof(BITMAP), SBits); BitBlt(PaintDC, 1, 1, Bits.bmWidth, Bits.bmHeight, MemDC, 0, 0, SRCCOPY); SelectBitmap (MemDC, OldBitmap); DeleteDC(MemDC); EndPaint(hwnd, кPaintStruct); CallOrig = FALSE; break; ) if (CallOrig) if (id = ID_BITMAP1) iResult = CallWindowProc(StatProcl, hwnd. Message, wParam, IParam); else IResult = CallWindowProc(StatProc2, hwnd. Message, wParam, IParam); return IResult; 545: ) 546: 547: /////////////////////////////////// 548: // Процедура диалога Arrow 549: IHlIllllllllllllllllllllllllllltll 550: «pragma argsused 551: BOOL CALLBACK ArrowDlgProc (HWND hDlg, WORD Message, 552: WPARAM wParam, LPARAM IParam) 553: { 554: switch(Message) 555: { 556: case WM_COMMAND: 557: return Handlecommand(hDlg, wParam); 558: 559: case WM_CLOSE: 560: ExitMapper(hDlg); 561: return TRUE; 562: ) 563: return FALSE; 564: ) Листинг 16.2. MAPPER.II 1: ///////////////////////////////////////////// 2: // Программа: MAPPER.CPP 3: // Автор: Чарли Калверт 4: // Описание: Mapper - программа для Windows 5: И Дата: 7/18/93 6: ///////////////////////////////////////////// 7: 8: // Константы 9: «define WM_DIALOG (WM_USER + 0x100) 10: «define WM_HELP (WM_USER + 0x101) 11: 12: // Диалог Arrows 13: «define ID_LEFT 150 14: «define ID_RIGHT 251 15: «define ID DIALOG 252
16: ♦♦define ID QUIT 253 17; ♦♦define ID_START 254 18: ♦♦define ID_END 255 19: ♦♦define ID_RSCREEN 256 20: ♦♦define ID_LSCREEN 257 21: ♦♦define ID_HELP 1001 22: 23: // Константы опций диалогов 24: «♦define ID XSIZE 101 25: ♦♦define ID_YSIZE 102 26: ♦♦define ID_NUMX 103 27; ♦♦define ID_NUMY 104 28: ♦♦define ID_SAVE 105 29: ♦♦define ID BITMAP1 120 30: ♦♦define ID BITMAP2 121 31: ♦♦define ID__BITMAP3 122 32: ♦♦define ID_BITMAP4 123 33: 34: ♦♦define MaxY 21 35: ♦♦define MaxX 4 * 32 36: 37: «define BITHEIGHT 32 38: «define BITWIDTH 25 39: 40: «define JUMPSPACE 32 41: 42: // Типы 43: struct TDAT 44: ( 45: int MenuSpace; 46: in' SizeX, SizeY; 47: int SPos; 48: int GrassX; 49: int GrassY; 50: ); 51: 52: // Объявления для класса Mapper 53: «define Mapper_DefProc DefWindowProc 54: BOOL Mapper_OnCreate(HWND hwnd, 55: CREATESTRUCT FAR* IpCreateStruct) ; 56; void Mapper_OnDestroy(hwnd hwnd); 57: void Mapper_OnMouseMove(HWND hwnd, int x, int y, UINT keyFlags); 58: void Mapper_OnLButtonDown(HWND hwnd, BOOL fDoubleClick, 59: int x, int y, UINT keyFlags); 60: void Mapper_OnRButtonDown(HWND hwnd, BOOL fDoubleClick, 61: int x, int y, UINT keyFlags); 62: void MapperOnPaint(HWND hwnd); 63: 64: // Процедуры 65: LRESULT CALLBACK export WndProc(HWND hwnd, UINT Message, 66: WPARAM wParam, LPARAM IParam); 67: LRESULT CALLBACK export BitmapProc(HWND hwnd, UINT Message, 68: WPARAM wParam, LPARAM IParam) ; 69; BOOL Register(HINSTANCE hlnst); 70; HWND Create (HINSTANCE hlnst, int nCmdShow); 71: BOOL CALLBACK OptionsDlgProc (HWND hDlg, WORD Message, 72: WPARAM wParam, LPARAM IParam); 73: BOOL CALLBACK ArrowDlgProc(HWND hDlg, WORD Message, 7 4: WPARAM wParam, LPARAM IParam) ; Листинг 16.3. MAPPER.RC 1: ///////////////////////////////////////////////////////// 2: // Программа: MAPPER.RC 3: // Автор: Чарли Калверт 4: // Описание: Файл ресурсов для программы Mapper 5: // Date: 9/08/93 6: ///////////////////////////////////////////////////////// 7: 8: «include "windows.h" 9: «include "mapper.h" 10: 11: ROAD BITMAP "road2.bmp" 12: GRASS BITMAP "grass.bmp" 13:
14: «define STY_PUSH WS_CHILD I WS_VISIBLE I WSTABSTOP 15: «define STY_TEXT SS_BLACKFRAME I WS_CHILD I WS_VISIBLE I WSGROUP 16: «define STY_TEXT2 SS_LEFT I WS CHILD I WS VISIBLE I WS GROUP 17: 18: Options DIALOG 37, 35, 184, 118 19: STYLE DS_MODALFRAME I WS_POPUP I WS_CAPTION I WS_SYSMENU 20: CAPTION "Options" 21: BEGIN 22: PUSHBUTTON "Close", IDOK, 3, 98, 52, 14, STY_PUSH 23: PUSHBUTTON "save", ID_SAVE, 66, 98, 52, 14, STY_PUSH 24: LTEXT "XSize:", -1, 7, 9, 22, 8, STY TEXT 2 25: LTEXT "YSize:", -1, 6, 32, 23, 8, STY- JTEXT2 26: LTEXT ID_XSIZE, 30, 9, 25, 12 27: LTEXT ID_YSIZE, 30, 32, , 25, , 12 28: LTEXT "NumX:", -1, 7, 58, 22, 8, STY_TEXT2 29: LTEXT "NumY:", -1, 6, 80, 23, 8, STY_TEXT2 30: LTEXT "", ID_NUMX, 30, 58, 25, 12 31: LTEXT "", ID_NUMY, 30, 80, 25, 12 32: PUSHBUTTON "Help", ID_HELP, 129, 98, 52, 14, STYPUSH 33: CONTROL "Text", ID_BITMAP1, "STATIC", STYTEXT, 75,15,32,32 34: CONTROL "Text", ID_BITMAP2, "STATIC", STY_TEXT, 129,15,32,32 35: CONTROL "Text", ID_BITMAP3, "STATIC", STYTEXT, 129,51,32,32 36: CONTROL "Text", ID_BITMAP4, "STATIC", STY_TEXT, 75,51,32,32 37: CONTROL 104, "button", 38: BS_GROUPBOX I WS_CHILD I WS_VISIBLE, 63, 3, 108, 88 39: END 40: 41: Arrows DIALOG 92, 38, 102, 75 42: STYLE WS_POPUP I WS_VISIBLE I WS_CAPTION 43: CAPTION "Directions" 44: BEGIN 45: PUSHBUTTON "Start", ID_START, 0, 0, 34, 25, STY_PUSH 46: PUSHBUTTON "Left", ID_LEFT, 0, 25, 34, 25, STY_PUSH 47: PUSHBUTTON "LScreen", ID_LSCREEN, 0, 50, 34, 25, STY_PUSH 48: PUSHBUTTON "Dialog", ID_DIALOG, 34, 0, 34, 25, STY_PUSH 49: PUSHBUTTON "QUIT", ID_QUIT, 34, 25, 34, 25, STY_PUSH 50: PUSHBUTTON "Help", ID_HELP, 34, 50, 34, 25, STY_PUSH 51: PUSHBUTTON "End", ID_END, 68, 0, 34, 25, STY_PUSH 52: PUSHBUTTON "Right", ID_RIGHT, 68, 25, 34, 25, STY_PUSH 53: PUSHBUTTON "RScreen", ID_RSCREEN, 68, 50, 34, 25, STY_PUSH 54: END Листинг 16.4. MAPPER.DEF 1: ; MAPPER.DEF 2: 3: 4: 5: 6: NAME DESCRIPTION EXETYPE STUB Mapper 'Mapper window' WINDOWS ' WINSTUB.EXE' 7: CODE PRELOAD MOVEABLE DISCARDABLE 8: 9: 10: 11: DATA HEAPSIZE STACKSIZE PRELOAD 4096 5120 MOVEABLE MULTIPLE Листинг 16.5. MAPPER.MAK (Borland) 1: # Mapper, ma к 2: 3: « макросы 4: APPNAME = Mapper 5: INCPATH = C:\BC\INCLUDE 6: LIBPATH = C:\BC\LIB 7: FLAGS = -H -ml -W -v -w4 -1$ (INCPATH) -L$ (LIBPATH) 8: 9: « компоновка 10: $ (APPNAME) .exe: $ (APPNAME) . obj $ (APPNAME) . def $ (APPNAME) . res 11: bcc $(FLAGS) $(APPNAME)-obj 12: brc $(APPNAME).res 13: 14: « компиляция 15: $(APPNAME).obj: $(APPNAME).cpp 16: ЬСС -C $(FLAGS) $(APPNAME).cpp
17: 18: # ресурсы 19: $(APPNAME).res: $(APPNAME).rc 20: brc -r -1$ (INCPATH) $ (APPNAME) .rc Листинг 16.6. MAPPER.MAK (Microsoft) 1: #==================--- 2: # MAPPER.MAK 3: #--===============---- 4: 5: APPNAME = Mapper 6: 7: #===================== 8: # компоновка 9: #===================== 10: $ (APPNAME) .exe . $ (APPNAME) .obj $ (APPNAME) .def $ (APPNAME) .res 11: link $(APPNAME), /align:16, NUL, \ 12: /nod llibcew libw oldnames, $(APPNAME) 13: rc $(APPNAME).res 14: 15: #===================== 16: # компиляция 17: #===--------========== 18: $(APPNAME).obj : $(APPNAME).cpp 19: cl -c -AL -GA -Ow -W3 -Zp $ (APPNAME) .cpp 20: 21: #====--- 22: # компиляция ресурсов 23: #===================== 24: $(APPNAME).res: $(APPNAME).rc 25: rc -r $(APPNAME).rc На рисунке 16.1 показано окно программы Mapper, содержащее две диалоговых панели. Одна из них всегда находится на экране, если протрамма присутствует в памяти. Рис. 16.1. Программа Mapper Программа Mapper представляет собой утилиту, которую вы можете использовать для проектирования игрового поля протраммы Snake. Snake, как вы помните, представляет собой игру, в которой играющий в реальном времени управляет объектом, защищаю- щимся от ситуаций, создаваемых протраммой (см. главу 8). Обсуждение этой игры завершается в главе 21. Исходная версия программы Snake имела совершенно чистое игровое поле, по которому можно было водить змею, как заблагорассудится. Более развитая версия, которая будет представлена в главе 21, имеет фон, состоящий из дорожек, вьющихся по травяному покрытию, как показано на рис. 16.2. Правила игры гласят, что змея должна оставаться на дорожке и что она погибнет, если случайно выскочит на траву.
Рис. 16.2. Кадр из программы Snako Игра состоит из ряда уровней, причем каждый последующий сложнее предыдущего. Каждый уровень состоит из четырех экранов. Всякий раз, когда змея стирает все точки на одном из экранов, дается переход к следующему экрану. Когда она пройдет все четыре экрана одного из уровней, игра начинается снова на следующем уровне. Экраны выстраиваются слева направо, как показано на рис. 16.3. Когда змея завершает первый экран ряда, она передвигается на следующий справа экран и так далее, пока уровень не будет завершен. Один массив содержит четыре экрана Гис. 16.3. Четыре экрана иа каждом уровне программы Snako Каждый уровень внутренне представляется массивом растровых изображений высо- той 15 квадратиков и шириной 100 квадратиков. Ниже показан фрагмент массива для представления одной четверти уровня, или одного экрана: int AvArxay[15][25] “ ( (2,2,2,2. 2,2,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1.1,1,1} (2,2,2,2,2, 2,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1.1} {1,1,1,1,2, 2,1,1,1,1,1,1,1,1,1,1,1,1,1,2,2,2,2.2,2} {1,1,1,1,2, 2,2, 2, 2,2, 2,2, 2,2, 2, 1,1,1,1,2,2, 2,2, 2,2) {1,1,1,1,2, 2,2,2,2,2,2,2,2,2,2,1,1,1,1.2,2,1,1,1,1} {1,1, 1,1, 2, 2,1,1, 1,1,1,1, 1,2,2,1,1,1,1,2,2, 1,1,1,1) 11,1,1,1,2,2,1,1,1,1,1,1,1,2,2,1,1,1,1,2,2,1,1,1,1) {1,1,1,1,2, 2,1,1,1,1,1,1,1,2,2,1,1,1,1,2,2.1,1,1,1} (1,1,1,1,2,2,1,1,1,1,1,1,1,2,2,2,2,2,2,2,2,2,1,1,1} (1,1,1,1,2,2,1,1,1,1,1,1,1,2,2,2,2.2,2,2,2,2,1,1,1) {1,1,1,1,2, 2, 1,1,1,1,1,1,1,1,1,2,2, 1,1, 1,1,1,1,1,1) {1,1,1,1,2,2,1,1,1,1,1,1,1,1,1,2,2,1,1,1,1,1,1,1,1) {1,1,1,1,2,2,1,1,1,1,1,1,1,1,1,2,2,1,1,1,1,1,1,1,1) {1,1,1,1,2,2,1,1,1,1,1,1,1,1,1,2,2,1,1,1,1,1,1,1,1) {1,1,1,1,2,2,1,1,1,1,1,1,1,1,1,2,2,1,1,1,1,1,1,1,1} }
Здесь каждая единица соответствует растровому изображению травяного квадратика, а дорожки представлены двойками. Если программисты работают непосредственно с массивами чисел, создание экранов для каждого уровня игры будет чрезвычайно утомительным и чревато ошибками. Цель программы Mapper — упростить это дело до такой степени, чтобы можно было скон- центрироваться на разработке деталей при конструировании массива. Конкретней, программа Mapper представляет собой утилиту визуального программирования, позво- ляющую вам проектировать экраны с помощью мыши. Например, щелчок левой кнопкой мыши превращает квадрат в клочок травы, а щелчок правой кнопкой мыши — в секцию дорожки. Замечание. Работая с программой Mapper, вы обнаружите, что определенные возможности реализованы не до конца. Например, диалоговая панель Options содержит одно редактируемое и два статических поля, которые никогда не используются. Мне потребовалось бы лишь несколько мгновений, чтобы уничтожить эти визуальные элементы управления, однако я оставил их, поскольку программа Mapper представляет собой незаконченную разработку. Иначе говоря, эта программа содержит зачатки более гибких средств для проектирования фона любой игры или приложения, которое имеет двумерный задний план, сделанный из двух или более растровых картинок. Короче говоря, эти внешние визуальные элементы отражают внутренние конструк- тивные решения. В конце концов я хотел, чтобы программа была способна обрабатывать сценарии, определяющие элементы любого количества совершенно различных двумерных игро- вых полей. Mapper с точки зрения программиста Основная цель программы Mapper утилитарна. Она предназначена в основном для того, чтобы быть средством разработки двумерных экранов. Впрочем, здесь все-таки содержится один новый программный трюк, а также повторяется ряд важных техничес- ких приемов. Из соображений экономии пространства я могу лишь коротко упомянуть повторяемые моменты, а затем перейду к краткому описанию нового приема програм- мирования. Данная книга весьма насыщена листингами. Я представляю в каждой главе новую программу, и каждая из них достаточно велика. Это делается потому, что примеры — одно из лучших средств обучения. Так, программа Mapper дает несколько дополнитель- ных примеров кодирования, на которых можно научиться следующему: Mapper показывает, как создать подкласс статического поля, чтобы его можно было использовать как установочный для вывода растровых изображений на диалоговую панель. Это важный технический прием, использующийся многими программиста- ми. Подкласс статического поля располагается в диалоге Options. Фактическая оконная процедура подкласса, BitmapProc, начинается со строчки 492. Заметьте, что вместо вызова SetWindowLong программа Mapper пользуется макросом SubClassWin- dow из WINDOWSX. Кроме того, Mapper содержит два диалога: модальный и немодальный. Модальный диалог Arrow (рис. 16.4) появляется при первом запуске программы и уничтожается только при ее закрытии. Диалог Arrow представляет интерес преимущественно потому, что служит в качестве альтернативного меню. Средство такого рода требу- ются программе Mapper, так как в ней нет места для размещения меню в верхней части основного окна. Я разработал программу Mapper таким образом, чтобы в перспективе ее можно было использовать для проектирования экрана, занимающего всю доступную область отображения, не оставляя места для меню в верхней части. Кое-что новенькое. StretchBlt Как и программа Snake, представленная в главе 8, программа Mapper должна быть устроена достаточно гибко, чтобы работать при различных разрешениях. В частности она “знает” о дисплеях 640x480, 800x600 и 1024x768. В главе 8 эта проблема решалась
достаточно просто, но в данном случае дело обстоит несколько сложнее. Ведь растровые картинки, составляющие траву и дорожки, имеют размер 25x32 пиксела. Mapper (и Snako) должны иметь 32 таких картинки в столбце при том, что самая левая из них касается левого края экрана, а самый правая — правого. Это должно выполняться независимо от текущего разрешения. Естественно, решение могло бы состоять в том, чтобы иметь три различных набора растровых картинок — по одному для каждого размера экрана. Это логично. Однако я решил отказаться от этого пути, поскольку он недостаточно гибкий и мог бы потребовать значительной работы с художественной частью при модернизации программы для работы с четырьмя, шестью, восемью и более растровыми изображениями одновременно. Решение, примененное в Mapper, заключается в использовании функции StretchBlt, позволяющей растягивать и сжимать растровые изображения, чтобы попасть в заданные размеры. Функция StretchBlt BOOL StretchBlt(HDC, int, int, int, int, HDC, int, int, int, int, DWORD) Функция StretchBlt переносит растровое изображение из одного контекста устройства в другой, автоматически растягивая или сжимая его так, чтобы он попадал в прямоугольник указанного размера. Ниже приводится подробная расшифровка параметров: HDC hdcDest; Конечный контекст устройства int nxoriginDest; Конечная х-координата int nYOriginDest; Конечная у-координата int nWidthDest; Конечная ширина int nHeightDest; Конечная высота int hdcSrc; Исходный контекст устройства int nXOriginSrc; Исходная х-координата int nYOriginSrc; Исходная у-координата int nwidthSrc; Исходная ширина int nHeightSrc; Исходная высота DWORD fdwRop; Логическая растровая операция (например, SRCCOPY) Пример: StretchBlt(PaintDC, О, MemryDC, О, О, 25, 25, О, 32, 32, SRCCOPY); Краткое исследование StretchBlt показывает ее сильную схожесть с функцией BitBlt. Впрочем, когда она используется в программе Mapper, возникает несколько затруднений, требующих немного больше внимания. Значительная сложность вытекает из того факта, что вызов StretchBlt отнимает относительно много времени. С другой стороны, программе Mapper требуется передать не одно, а 32x21=672 растровых изображения на экран. Выходит, что функция StretchBlt слишком медлительна для функции, которую нужно вызывать 672 раза подряд. Решение состоит в том, чтобы растянуть посредством StretchBlt каждую из двух картинок один раз, а затем передавать на экран результирующие контексты устройства. Следующие фрагменты показывают, как выглядела бы функция MapperOnPaint, если бы программа обрабатывала одновременно только одно растровое изображение: HDC TGrassDC = CreateCompatibleDC(PaintDC); HDC GrassDC = CreateCompatibleDC(PaintDC); HBITMAP TGrass = CreateCompatibleBitmap(PaintDC, Dat.GrassX, Dat.GrassY);
OldGrass = SelectBitmap(TGrassDC, Grass); OldGrassl = SelectBitmap(GrassDC, TGrass); StretchBlt(GrassDC, 0, 0, Dat.GrassX, Dat.GrassY, TGrassDC, 0, 0, BITWIDTH, BITHEIGHT, SRCCOPY); // Передача содержимого GrassDC на экран 200 или более раз SelectBitmap(TGrassDC, OldGrass); SelectBitmap(GrassDC, OldGrassl); DeleteObject(TGrass); DeleteDC(GrassDC); DeleteDC(TGrassDC) ; Как видите, Mapper начинает с создания двух правильных контекстов устройств с помощью обращений к CreateComatibleDC. Затем она создает совместимое растровое изображение, которое может быть выбрано в один из контекстов устройства. Другой контекст устройства используется для хранения исходного растрового изображения. Выполнив этот этап, вы будете иметь два контекста устройств: И Первый содержит пустое растровое изображение, имеющее подходящие для текущего разрешения экрана размеры. И Второй содержит исходное растровое изображение размером 25x32. Затем Mapper использует StretchBlt, чтобы скопировать исходное растровое изобра- жение в пустое растровое изображение. Результатом является растровое изображение требуемого размера, располагающееся в совместимом контексте устройства. Теперь Mapper вольна использовать это изображение в быстродействующей функции BitBlt. Конечно, если вы сделаете так, то вам потребуется пройти утомительный и чреватый ошибками путь, тщательно удаляя все растровые изображения и контексты устройства, которые вы создали. Чтобы быть уверенными, что все сделано правильно, запустите отладочную версию Windows, чтобы выверить правильность ваших действий. Резюме Первая половина этой главы была посвящена техническим приемам, использующим- ся для создания и взаимодействия с диалогами. В частности, вы узнали о сообщениях CTLCOLOR. Дополнительная программа продемонстрировала, как отвечать на щелчки кнопкой мыши и как обрабатывать соответствующие сообщения при посылке их в диалоговую процедуру. В последней половине этой главы вы познакомились с програм- мой Mapper и мощной функцией StretchBlt. Вопросы и ответы 1. Программа Mapper переносит растровое изображение в статическое поле диалога Options. Как еще можно отобразить растровую картинку на диалоговой панели? Отвечая на сообщения WM_PAINT, вы можете нарисовать растровое изображение непосредственно на диалоговой панели. Однако такой способ не всегда пригоден, поскольку размеры диалоговой панели вычисляются довольно специфическим образом. Поэтому часто решением является использование статического поля. Другая альтерна- тива реализуется с помощью кнопки, которой может быть приписан стиль BS_OWNER- DRAW. Программа Resource Workshop фирмы Borland предусматривает сокращенный метод для использования кнопок собственной разработки. 2. В последнем ответе вы упомянули, что в диалогах используется специфическая координатная система. Что это такое? Вместо пикселов, в диалоговых панелях применяется координатная система с еди- ницей измерения, представляющей собой 1/4 размера символа системного шрифта. Это
делается для сохранения относительных пропорций диалоговых панелей при любом разрешении экрана. Если вы захотите произвести вычисления с участием размеров диалога во время выполнения задачи, используйте функцию GetDialogBaseUnits для получения размера этих единиц и функцию MapDialogRect для преобразования их в пикселы. Вопросы для самопроверки 1. В чем разница между SendDlgltemMessage и SendMessage? 2. Если вам известен только идентификатор элемента управления, расположенного на диалоговой панели, как вы можете получить его HWND? 3. Как превратить координаты, выбранные с помощью GetClientRect, в логические с помощью режима отображения MM_TWIPS? 4. Если у вас нет доступа ни к чему, кроме HWND текущего диалога, как найти HWND его владельца? 5. Можно ли установить связь между модальным диалогом и его родителем? Если нет, то почему? Если да, то как? 6. Используя отладчик, вы не сможете пройти программу последовательно от начала до процедуры диалога, которую вы хотите проверить. Как обойти это ограничение, чтобы отладить диалоговую процедуру? 7. Почему программа Mapper создает подкласс статического поля? 8. Почему диалог Options не рисует растровые образы непосредственно на своей поверхности? 9. В чем разница между StretchBlt и BitBlt? 10. Почему программа Mapper должна вызывать CreateCompatibleBitmap? Упражнения 1. Ответьте на сообщение WM_CTLCOLOR окраской фона диалога в цвет борлан- довской “оружейной стали”. 2. В разделе “Получение данных из диалога Make Shape” я описал, как использовать диалоги в качестве интерфейса с базой данных имен и адресов. Создайте свою собствен- ную персональную книгу адресов, разработав свою собственную версию этой базы данных.
День 17 В ГЛУБИНЕ МЕНЮ И ПИКТОГРАММ Сегодня вы узнаете о некоторых увлекательных вещах, которые можно делать с меню, пиктограммами, курсорами и растровыми изображениями. В частности, мы изучим следующие вопросы: Как создавать вложенные выскакивающие меню. Как модифицировать системное меню. Н Как создавать пользовательские (owner draw) меню и простые меню растровых изображений. Н Как создавать и показывать свои собственные курсоры. Как работать с пиктограммами. Как добавлять к вашим программам ускорители, позволяющие пользователям акти- визировать пункты меню с помощью горячих клавиш (таких, как Alt-1 или Ctrl-Fl). В этой главе нет ничего особо сложного для программистов, быть может, за исключением пользовательского меню. На самом деле большая часть новых технических приемов, с которыми вы познакомитесь, представляет собой не что иное, как просто забавные трюки, которые вы можете проделывать с программами при минимальных затратах с вашей стороны. Чтобы вынести эти приемы на всеобщее обозрение, я наскоро соорудил пример, демонстрирующий все разнообразие возможностей меню, и который, надеюсь, вы найдете развлекательным и поучительным. Программа называется MENUTEST.CPP. Вообще говоря, вы должны найти эту главу более легкой, нежели несколько послед- них. Цените относительную простоту материала, пока он еще есть, поскольку хитроум- ный код уже поджидает вас за углом (в следующих нескольких главах). Что же у нас в меню? К этому времени вы, возможно, уже обнаружили две вещи: Большинство меню нетрудно сконструировать или показать. И Microsoft и Borland устраняют скрытые трудности, которые могут возникнуть при конструировании меню, предоставляя в ваше распоряжение Мощные интерактивные средства. Эти средства помогают, соорудить меню за несколько относительно простых шагов. Впрочем, меню настолько просты, что вместо того чтобы пользоваться Resource Workshop или Арр Studio, возможно, будет проще конструировать или модифицировать их с помощью редактора. Поэтому посмотрим на это чудище во всей красе.
MENU_1 MENU BEGIN POPUP "SFile" BEGIN MENUITEM "SNew", CM_NEW MENUITEM "SOpen..CM_OPEN MENUITEM "SSave", CM_SAVE MENUITEM "Save Sas...", CM_SAVEAS MENUITEM SEPARATOR POPUP "SPrint..." BEGIN MENUITEM "Print To Disk", CM_PRNDISK MENUITEM "Print LPTl”, CM_PRNLPT1 END MENUITEM "Page sestup...", CM_PAGESETUP MENUITEM "PSrinter setup...", CM_PRINTERSETUP MENUITEM SEPARATOR MENUITEM "ESxit", CM_FILEEXIT END POPUP "SCursors" BEGIN MENUITEM "SRound Cursor\tAlt+Fl”, CM_ROUNDCURSOR MENUITEM "SDiamond Cursor\tCtrl+F2”, CM_DIAMONDCURSOR MENUITEM "SDraw Icon\tShift+F3”, CM_ICONCURSOR END POPUP "BitCursors" BEGIN MENUITEM "Item", CM_BIT MENUITEM "Item", CM_BIT MENUITEM "Item", CM_BIT END MENU1 MENU2 MENU3 MENUITEM "SHelp", CM_HELP END Рис. 17.1. Меню программы Menuitem Хотя я уже вкратце обсуждал меню ранее, мой основной подход к ним состоит в том, чтобы вы смогли уловить их синтаксис за обычное для вас время и в той степени, которой считаете необходимой. (Исключением было лишь быстрое введение в создание динами- ческих меню в главе 13.) Решение рассматривать создание меню как преимущественно интуитивный акт обязано тому факту, что Resource Workshop и Арр Studio дают вам возможность (по крайней мере, теоретическую) стать блестящим Windows-программис- том, не написав ни одной строчки RC-файла. Так или иначе прекрасно сознавать, что синтаксический скелет меню состоит преимущественно из простых операторов BEGIN, END, MENUITEM и POPUP. Опе- раторы BEGIN и END — не что иное, как обложка, покрывающая тело меню. Разумеется, выскакивающие меню фактически представляют собой окна показываю- щие список возможных выборов. Можно вложить одно выскакивающее меню в другое, чтобы они появились на экране одновременно (см. рис. 17.2).
Рис. 17.2. Меню File программы Menuitem содержит вложенные выпадающие меню и растровое изображение текста EXIT С другой стороны, пунктом меню является как одиночный элемент в выскакивающем меню, так и отдельный пункт на полоске меню, который, будучи выбранным, ведет непосредственно к конкретному действию (а не вызывает появление на экране выска- кивающего меню). На рисунке 17.2 все пункты меню — это слова New, Open, Save и т.д. Грамотный способ создания вложенных выскакивающих меню состоит в том, чтобы просто вставить второе выскакивающее меню непосредственно внутрь первого: POPUP "SFile" BEGIN MENUITEM "SNew", CM_NEW MENUITEM SEPARATOR POPUP "SPrint..." BEGIN MENUITEM "Print To Disk", CM_PRNDISK MENUITEM "Print LPT1", CM_PRNLPT1 END Этот код создает вложенное меню, называющееся Print. Будучи выбранными, опции Print То Disk и Print LPT1, делаются доступными пользователю, как показано на рис. 17.2. В предыдущем коде вы можете видеть оператор MENUITEM SEPARATOR. Эти слова вызывают вставку разделителя — черной горизонтальной черты в середине меню. Разделители — это такие же пункты меню, как и все остальные, то есть их можно удалять, вставлять или модифицировать динамически во время выполнения программы. Прежде чем погрузиться вглубь, мне, по-видимому, следует немного поговорить о некоторых опциях, которые можно добавлять в код для создания нормальных элементов или выскакивающих меню. Эти необязательные операторы позволяют вам осуществлять действия, подобные отметке пункта меню или окраски его в серый полутон. Например, следующая строчка кода создает пункт меню с галочкой перед ним, как показано на рисунке 17.3. MENUITEM "SRound Cursor\tAlt+Fl", CM_ROUNDCURSOR, CHECKED В результате следующей строчки появляется отмеченный полутоновой пункт меню: MENUITEM "SRound Cursor\tAlt+Fl", CM_ROUNDCURSOR, CHECKED, GRAYED Замечание. Пометка \t вставляет в меню символ ТАВ. Результат, показанный на рисунке 17.3, позволяет пользователю очень четко отличить любую ускоряющую клавишу, ассоциированную с опцией меню. Ускорители обсуждаются позже в этой главе.
Рис. 17.3. "Галочка ” слева от пункта меню говорит о том, что выбрана какая-то конкретная опция Кроме отмечающих или затеняющих опций вы также можете пользоваться операто- рами MENUBREAK и MENUBARBREAK, располагать конкретный пункт выскакива- ющего меню с новой строки (см. рис. 17.4). Оператор MENUBARBREAK помещает между столбцами черную линию, в то время как MENUBREAK оставляет между ними лишь белое поле. Рис. 17.4. Оператор MENUBARBREAK создает многоколоночное меню Ниже следует код для меню, показанного на рисунке 17.4. Возможно, вы заметите, что я поместил в меню два фальшивых пункта Foo и Fool для симметрии. Просто я хотел, чтобы вы почувствовали, как пользоваться оператором MENUBARBREAK для упорядочения длинных столбцов опций. Пользователь может манипулировать этими столбцами относительно легко. MENU_1 MENU BEGIN POPUP "SFile" BEGIN MENUITEM "SNew", CM_NEW MENUITEM "SOpen...", CM_OPEN MENUITEM "SSave", CM_SAVE MENUITEM "Save Sas...", CM_SAVEAS MENUITEM SEPARATOR POPUP "SPrint..." BEGIN MENUITEM "Print To Disk", CMPRNDISK MENUITEM "Print LPT1", CM_PRNLPT1 END MENUITEM "Page seStup...", CM PAGESETUP MENUITEM "PSrinter setup. .. ",~CM_PRINTERSETUP MENUITEM SEPARATOR MENUITEM "ESxit", CM_FILEEXIT END Программа MenuTest Теперь, когда вы рассмотрели основные технические приемы создания меню, пора исследовать некоторые способы манипуляции с меню на этапе выполнения программы, чтобы создавать различные эффекты, позволяющие сделать вашу программу более удобной (или более забавной). Прежде чем двинуться дальше, следует рассмотреть код, ввести и запустить его (см. листинг 17.1).
Листинг 17.1. MENUTEST.CPP 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: /////////////////////////////////////////////////////// // Программа: MENUTEST.CPP // Автор: Чарли Калверт // Описание: MenuTest- программа для Windows // Дата: 07/20/93 /////////////////////////////////////////////////////// # define STRICT # include <windows.h> # include <windowsx.h> ((pragma hdrstop ((include "menutest.h" ((pragma warning (disable: 4068) ((pragma warning (disable: 4100) // = // Интерфейс // ===============================«================ static char szAppName[] = "MenuTest"; static HWND MainWindow; static HINSTANCE hlnstance; static HACCEL hAccel; // -=== // Инициализация / / -= ///////////////////////////////////////////////////// // Точка входа ///////////////////////////////////////////////////// ((pragma argsused int PASCAL WinMain(HINSTANCE hinst, HINSTANCE hPrevInstance, LPSTR IpszCmdParam, int nCmdShow) ( MSG Msg; if ((hPrevInstance) if (I Register(hinst)) return FALSE; if (! (MainWindow = Create(hinst, ncmdShow))) return FALSE; while (GetMessage(SMsg, NULL, 0, 0)) ( if ((TranslateAccelerator(MainWindow, hAccel, SMsg)) { TranslateMessage(SMsg); DispatchMessage(SMsg); ) ) return Msg.wParam; ) /////////////////////////////////////////////////////// // Регистрация окна /////////////////////////////////////////////////////// BOOL Register(HINSTANCE hinst) ( WNDCLASS WndClass; WndClass. style = CS HREDRAW I CS_VREDRAW; WndClass.IpfnWndProc = WndProc; WndClass.cbClsExtra = 0; WndClass.cbWndExtra = 0; WndClass.hlnstance = hinst; WndClass.hlcon = Loadicon(hinst, "ICON_1"); WndClass.hCursor = LoadCursor(NULL, IDC_ARROW); WndClass.hbrBackground = GetStockBrush(WHITE_BRUSH); WndClass.IpszMenuName = "MENU_1"; WndClass.IpszClassName = szAppName; return RegisterClass (SWndClass); )
74: 75: //////////////////////////////////'////////////////////// 76: // Создание окна 77: //////////////////////////////////////////////////////// 78: HWND Create (HINSTANCE hlnst, int nCmdShow) 79: ( 80: 81: hlnstance = hlnst; 82: 83: HWND hWindow = CreateWindow(szAppName, szAppName, 84: WS_OVERLAPPEDWINDOW, 85: CW_USEDEFAULT, CW_USEDEFAULT, 86: CW_USEDEFAULT, CW_USEDEFAULT, 87: NULL, NULL, hlnst, NULL); 88: 89: if (hWindow == NULL) 90: return hWindow; 91: 92: ShowWindow(hWindow, nCmdShow); 93: UpdateWindow(hWindow); 94: » 95: return hWindow; 96: ) 97: 98: //-----------------------------------------=====------- 99: // Реализация 100: //----------=========-----=======---------------===------ 101: 102: ///////////////////////////////////////////////////////// 103: // Оконная процедура 104: ///////////////////////////////////////////////////////// 105: LRESULT CALLBACK _export WndProc(HWND hwnd, UINT Message, 106: WPARAM wParam, LPARAM IParam) 107: ( 108: switch(Message) 109: ( 110: HANDLE_MSG(hwnd, WM_CREATE, MenuTest_OnCreate); 111: HANDLE_MSG(hwnd, WM_DESTROY, MenuTest_OnDestroy); 112: HANDLE_MSG (hwnd, WM_COMMAND, MenuTest_OnCommand) ; 113: HANDLE_MSG(hwnd, WM_DRAWITEM, MenuTest_OnDrawI tem) ; 114: HANDLE_MSG(hwnd, WM_LBUTTONDOWN, MenuTest_OnLButtonDown) ; 115: HANDLE_MSG (hwnd, WM_MOUSEMOVE, MenuTest_OnMouseMove) ; 116: HANDLE_MSG(hwnd, WM_MEASUREITEM, MenuTest_OnMeasureItem) ; 117: HANDLE_MSG (hwnd, WM_PAINT, MenuTest_OnPaint) ; 118: default: 119: return MenuTest_DefProc(hwnd. Message, wParam, IParam); 120: ) 121: ) 122: 123: /////////////////////////////////////////////////////////////// 124: // Обработчик сообщения WM_CREATE 125: /////////////////////////////////////////////////////////////// 126: #pragma argsused 127: BOOL MenuTest_OnCreate(HWND hwnd, 128: CREATESTRUCT FAR* IpCreateStruct) 129: ( 130: Cursorl = LoadCursor(hlnstance, "CURSOR_1"); 131: Cursor2 = LoadCursor(hlnstance, "CURSOR_2"); 132: Cursor3 = LoadCursor(hlnstance, "CURSOR_3"); 133: 134: Iconl = Loadicon(hlnstance, "ICON_1"); 135: 136: Bitmapl = LoadBitmap(hlnstance, "BITMAP_1"); 137: Bitmapla = LoadBitmap(hlnstance, "BITMAP1A"); 138: Bitmap2 = LoadBitmap(hlnstance, "BITMAP_2"); 139: Bitmap2a = LoadBitmap(hlnstance, "BITMAP2A”); 140: Bitmap3= LoadBitmap(hlnstance, "BITMAP_3"); 141: Bitmap3a = LoadBitmap(hlnstance, "BITMAP3A"); 142: BMPExit = LoadBitmap(hlnstance, "BMPEXIT"); 143: 144: GetObject(Bitmapl, sizeof(BITMAP), SBStruct); 145: 146: ModifyMenu(GetMenu(hwnd), 147: CM_BITMENU1, MF_BYCOMMAND I MF_OWNERDRAW, 148: CM_BITMENU1, (LPCSTR)MAKELONG (Bitmapl, 0));
149: ModifyMenu(GetMenu(hwnd), CM_BITMENU2, 150: MF_BYCOMMAND I MF_OWNERDRAW, 151: CM_BITMENU2, (LPCSTR)MAKELONG (Bitmap2, 0) ) ; 152: ModifyMenu (GetMenu(hwnd), CM_BITMENU3, 153: MF_BYCOMMAND | MF_OWNERDRAW, 154: CM_BITMENU3, (LPCSTR)MAKELONG (Bitmap3, 0) ) ; 155: ModifyMenu(GetMenu(hwnd), CM_EXIT, 156: MF_BYCOMMAND I MF_BITMAP, 157: CM_EXIT, (LPCSTR)MAKELONG (BMPExit, 0) ) ; 15B: 159: HMENU SysMenu = GetSystemMenu(hwnd, FALSE) ; 160: 161: DeleteMenu(SysMenu, 6, MFBYPOSITION); 162: DeleteMenu (SysMenu, 6, MF_BYPOSITION) ; 163: 164: EditBrush = CreateSolidBrush(RGB(255, 127, 255)); 165: Painticon = FALSE; 166: PaintGo = FALSE; 167: PaintSlow = FALSE; 16B: Paintstop = TRUE; 169: 170: hAccel = LoadAccelerators(hlnstance, "MYKEYS"); 171: ' 172: if (hAccel == NULL) 173: MessageBox(MainWindow, "No Accelerators", "Warning", MB_OK); 174: 175: return TRUE; 176: ) 177: 17B: //////////////////////////////////////// 179: // Обработчик сообщения WMDESTROY 1B0: llllllllllllllllllllllllllllllllllllllll 181: Spragma argsused 1B2: void MenuTest_OnDestroy(HWND hwnd) 1B3: ( 1B4: DeleteObject(EditBrush); 1B5: DeleteObject(Bitmapl); 1B6: DeleteObject(Bitmapla); 1B7: DeleteObject(Bitmap2); IBB: DeleteObject(Bitmap2a); 1B9: DeleteObject(Bitmap3); 190: DeleteObject(Bitmap3a); 191: DeleteObject(BMPExit) ; 192: DestroyCursor(Cursorl); 193: DestroyCursor(Cursor2); 194: DestroyCursor(Cursorj); 195: Destroylcon(Iconl); 196: PostQuitMessage(0); 197: ) 19B: 199: ///////////////////////////////////////// 200: // Проверить выбор пользователем курсора 201: ///////////////////////////////////////// 202: void Checkitem(HWND hwnd, int ID) 203: ( 204: HMENU Menu = GetMenu (hwnd) ; 205: CheckMenuItem(Menu, 206: CM_ROUNDCURSOR, MF_BYCOMMAND I MF_UNCHECKED); 207: CheckMenuItern(Menu, 20B: CM_DIAMONDCURSOR, MF_BYCOMMAND I MF__UNCHECKED) ; 209: CheckMenuItem(Menu, 210: CM_ICONCURSOR, MF_BYCOMMAND | MF_UNCHECKED) ; 211: if (ID) 212: CheckMenuItem (Menu, ID, MF_BYCOMMAND I MF CHECKED) ; 213: ) 214: 215: //////////////////////////////////////////// 216: // Обработчик сообщения WM COMMAND 217: //////////////////////////7///////////////// 21B: ffpragma argsused 219: void MenuTest_OnCorranand (HWND hwnd, int id, HWND hwrtdCtl, UINT codeNotify) 220: ( 221: FARPROC IpfnHelpBox; 222: 223: switch(id)
224: < 225: case CM_NEW: 226: case CM_OPEN: 227: case CM_SAVE: 228: case CM_SAVEAS: 229: case CM_PRNDISK: 230: case CM_PRNLPT1: 231: case CM_PAGESETUP: 232: case CM_PRINTERSETUP: 233: MessageBox(hwnd, "Not yet implemented", "Info", 234: mb_ok | mb_iconinformation); 235: break; 236: 237: case CM_EXIT- 23В: DestroyWindow(hwnd); 239: break; 240: 241: case CM ROUNDCURSOR: 242: SetClassWord(hwnd, GCW_HCURSOR, (WORD)Cursor1); 243: Setcursor(Cursorl); 244: Painticon = FALSE; 245: Checkitem(hwnd, CM_ROUNDCURSOR); 246: break; 247: 248: case CM DIAMONDCURSOR: 249: SetClassWord(hwnd, GCWHCURSOR, (WORD)Cursor2); 250: Setcursor(Cursor2); 251: Painticon — FALSE; 252: Checkitem (hwnd, CM_DIAMONDCURSOR); 253: break; 254: 255: case CM ICONCURSOR: 256: SetClassWord(hwnd, GCW_HCURSOR, (WORD)Cursor3) ; 257: Setcursor(СигзогЗ) ; 25В: Painticon = TRUE; 259: Checkitem(hwnd, CM_ICONCURSOR); 260: break; 261: 262: case CMBITMENUl: 263: PaintGo = TRUE; 264; PaintSlow = FALSE; 265: PaintStop “ FALSE; 266: InvalidateRect(hwnd, NULL, TRUE); 267: break; 268: 269: case CM_BITMENU2: 270: PaintGo = FALSE; 271: PaintSlow = TRUE; 272: PaintStop = FALSE; 273: InvalidateRect(hwnd, NULL, TRUE); 274: break; 275: 276: case CMBITMENU3: 277: PaintGo = FALSE; 27В: PaintSlow = FALSE; 279: PaintStop = TRUE; 2В0: InvalidateRect(hwnd, NULL, TRUE); 2В1: SetClassWord(hwnd, GCW_HCURSOR, 282: (WORD)LoadCursor(NULL, IDCARROW)); 2ВЗ: Setcursor(LoadCursor(NULL, IDCARROW)); 284: Checkitem(hwnd, 0); 285: Painticon = FALSE; 2В6: break; 287: 288: case CM_HELP: 2В9: IpfnHelpBox = 290: MakeProcInstance((FARPROC)HelpBoxProc, hlnstance) 291: DialogBox(hlnstance, "HELPBOX", hwnd. 292: (DLGPROC)IpfnHelpBox); 293: FreeProcInstance(IpfnHelpBox); 294: break; 295: ) 296: ) 297:
298: /////////////////////////.//////////////////////// 299: // Нарисовать растровую картинку в меню 300: ///////////////////////////////////////////////// 301: void DrawBitmap(HDC PaintDC, HBITMAP Bitmap, int YVal) 302: ( 303: HDC MemDC; 304: HBITMAP OldBitmap; 305: 306: MemDC = CreateCompatibleDC(PaintDC); 307: OldBitmap = SelectBitmap(MemDC, Bitmap); 308: BitBlt (PaintDC, 0, YVal * BStruct.bmHeight, BStruct.bmWidth, 309: BStruct.bmHeight, MemDC, 0, 0, SRCCOPY); 310: SelectObject(MemDC, OldBitmap); 311: DeleteObject(MemDC); 312: ) 313: 314: /////////////////////////////////////// 315: II Обработчик сообщения WM DRAWITEM 316: lllllllllllllllllllllllllllllllllllllll 317: ((pragma argsused 318: void MenuTest_OnDrawltem(HWND hwnd, 319: const DRAWITEMSTRUCT FAR* IpDrawItem) 320: ( 321: switch(IpDrawItem->itemID) 322: ( 323: case CM_BITMENU1; 324: if (lpDrawItem->itemState & ODS_SELECTED) 325: DrawBitmap(IpDrawItem->hDC, Bitmapla, 0); 326: else 327: DrawBitmap(lpDraw!tem->hDC, Bitmapl, 0); 328: break; 329: 330: case CM_BITMENU2: 331: , if (lpDrawItem->itemState S ODS SELECTED) 332: DrawBitmap(lpDrawItem->hDC, Bitmap2a, 1); 333: else 334: DrawBitmap(IpDrawItem->hDC, Bitmap2, 1); 335: break; 336: 337: case CMBITMENU3: 338: if (lpDrawItem->itemState S ODS_SELECTED) 339: DrawBitmap(IpDrawItem->hDC, Bitmap3a, 2) ; 340: else 341: DrawBitmap(lpDrawItem->hDC, Bltmap3, 2); 342: break; 343: ) 344: ) 345: 346: ///////////////////////////////////////// 347: // Обработчик сообщения WM LBUTTONDOWN 348: lllllllllllllllllllllllllllllllllllllllll 349: ((pragma argsused 350: void MenuTest_OnLButtonDown(HWND hwnd, BOOL fDoubleClick, int x, 351: int y, UINT keyFlags) 352: ( 353: if (Painticon) 354: ( 355: HDC PaintDC - GetDC(hwnd); 356: Drawicon(PaintDC, x, y, Iconl); 357: ReleaseDC(hwnd, PaintDC); 358: . ) 359: ) 360: 361: //////////////////////////////////////// 362: II Обработчик сообщения WM MEASUREITEM 363: //////////////////////////7////////////// 364: ((pragma argsused 365: void MenuTest_OnMeasureItem(HWND hwnd, MEASUREITEMSTRUCT 366: FAR* IpMeasureltem) 367: ( 368: WORD CheckWidth; 369: 370: Checkwidth = LOWORD (GetMenuCheckMarkDimensions () ) ; 371: switch (lpMeasureItem->itemID) 372: (
373: case CM_BITMENU1: 374: case CM_BITMENU2: 375: case CM_BITMENU3: 376: lpMeasureItem->itemWidth = BStruct.bmWidth - Checkwidth - 3; 377: lpMeasureItem->itemHeight = BStruct.bmHeight - 1; 378: break; 379: ) 380: } 381: 382: ///////////////////////////////////////// 383: // Обработчик сообщения WM MOUSEMOVE 384: //////////////////////////7////////////// 385: void MenuTestOnMouseMove(HWND hwnd, int x, int y, UINT keyFlags) 386: ( 387: if(((keyFlags s MK_LBUTTON) = MK_LBUTTON) 44 (Painticon)) 388: ( 389: HDC PaintDC = GetDC(hwnd); 390: Drawicon(PaintDC, x, y, Iconl); 391: ReleaseDC(hwnd, PaintDC); 392: ) 393: ) 394: 395: ////////////////////////////////////////// 396: // Обработчик сообщения WM PAINT 397: llllllllllllllllllllllllinillllllllHIIII 398: void MenuTest_OnPaint(HWND hwnd) 399: ( 400: PAINTSTRUCT PaintStruct; 401: HDC PaintDC, MemDC; 402: RECT R; 403: HBITMAP OldBitmap; 404: 405: PaintDC = BeginPaint(hwnd, 4PaintStruct); 406: 407: if (!PaintStop) 408: ( 409: GetClientRect(hwnd, 4R); 410: int i = R.right / BStruct.bmWidth; 411: int j “ R.bottom / BStruct.bmHeight; 412: 413: MemDC = CreateCompatibleDC(PaintDC); 414: 415: if (PaintSlow) 416: OldBitmap = SelectBitmap(MemDC, Bitmap2); 417: else 418: OldBitmap = SelectBitmap(MemDC, Bitmapl); 419: 420: for (int x = 0; x <= i; x++) 421: for (int у = 0; у <= j; y++) 422: BitBlt(PaintDC, BStruct.bmWidth * x, BStruct.bmHeight * y, 423: BStruct.bmWidth, BStruct.bmHeight, MemDC, 0, 0, SRCCOPY); 424: 425: SelectObject(MemDC, OldBitmap); 426: DeleteDC (MemDC); 427: ) 428: 429: EndPaint(hwnd, SPaintStruct); 430: ) 431: 432: // ======================= 433: // Процедура диалога About 434: 11 ======================= 435: ttpragma argsused 436: BOOL CALLBACK HelpBoxProc(HWND hDlg, WORD Message, WPARAM wParam, 437: LPARAM IParam) 438: ( 439: switch(Message) 440: ( 441: case WM_INITDIALOG: 442: SendDlgltemMessage(hDlg, ID_HELPEDIT, 443: WMJSETTEXT, 0, LPARAM(HelpStr)) ; 444: return TRUE; 445: 446: case WM_CTLCOLOR : 447: switch(HIWORD(IParam))
448: ( 449: // Cover up background of Static control 450: case CTLCOLORSTATIC: 451: return (BOOL) GetStockObject(BLACK BRUSH); 452: 453: case CTLCOLOR_EDIT: 454: SetTextColor((HDC)wParam, RGB(127,127,127)); 455: return NULL; 456: 457: case CTLCOLOR_DLG: 458: return (BOOL) EditBrush; 459: ) 460: return (BOOL) NULL; 461: 462: case WM_COMMAND: 463: if (wParam == IDOK I I wParam == IDCANCEL) 464: ( 465: EndDialog(hDlg, TRUE); 466: return TRUE; 467: ) 468: break; 469: } 470: return FALSE; 471: ) Листинг 17.2. MENUTEST.H 1: /////////////////////////////////////////////////////// 2: // Программа: MENUTEST.H 3: // Автор: Чарли Калверт 4: // Описание: MenuTest- программа для Windows 5: // Дата: 07/20/93 6: /////////////////////////////////////////////////////// 7: «define cm_new 101 8: «define CM_OPEN 102 9: «define CM_SAVE 103 10: «define CM_SAVEAS 104 11: «define CM_PRNDISK 151 12: «define CMPRNLPT1 152 13: «define CMPAGESETUP 105 14: «define CM_PRINTERSETUP 106 15: «define CM_EXIT 107 16: 17: «define CM_ROUNDCURSOR 201 18: «define CM_DIAMONDCURSOR 202 19: «define CM_ICONCURSOR 203 20: 21: «define CM_BITMENU1 301 22: «define CM_BITMENU2 302 23: «define CM BITMENU3 303 24: 25: «define CM_HELP 401 26: «define ID_HELPEDIT 402 27: 28: // Константы 29: char FAR *HelpStr="Choose ROUND CURSOR or DIAMOND CURSOR to see" 30: . " new cursors. Choose DRAW ICON to draw on the" 31: " screen. Choose GO or SLOW to set background, " 32: " choose BYE to reset screen. The close option " 33: " has been removed from the system menu, so exit " 34: " using the File menu"; 35: 36: // Объявления для класса MenuTest 37: «define MenuTest_DefProc DefWindowProc 38: BOOL MenuTest_OnCreate(HWND hwnd, 39: CREATESTRUCT FAR* IpCreateStruct); 40: void MenuTest_OnDestroy(HWND hwnd); 41: void MenuTest_OnCommand(HWND hwnd, int id, 42: HWND hwndCtl, UINT codeNotify); .43: void MenuTest_OnDrawItem(HWND hwnd, 44: const DRAWITEMSTRUCT FAR* IpDrawItem); 45: void MenuTest_OnLButtonDown(HWND hwnd, BOOL fDoubleClick, 46: int x, int y, UINT keyFlags); 47: void MenuTest_OnMeasureItem(HWND hwnd, 48: MEASUREITEMSTRUCT FAR* IpMeasureltem) ;
49: void MenuTestOnMouseMove(HWND hwnd, int x, 50: int y, UINT keyFlags); 51: void MenuTest_OnPaint(HWND hwnd); 52: 53: // Переменные 54: HICON Iconl; 55: HBRUSH EditBrush; 56: HCURSOR Cursorl, Cursor2, Cursor3; 57: HBITMAP Bitmapl, Bitmapla, Bitmap2, Bitmap2a; 58: HBITMAP Bitmap3, Bitmap3a, BMPExit; 59: BITMAP BStruct; 60: BOOL Painticon, PaintGo, PaintSlow, Paintstop; 61: 62: // Функции 63: LRESULT CALLBACK _export WndProc (HWND hwindow, UINT Message, 64: WPARAM wParam, LPARAM IParam); 65: BOOL Register(HINSTANCE hinst); 66: HWND Create(HINSTANCE hinst, int nCmdShow); 67: BOOL CALLBACK HeIpBoxProc(HWND hDlg, WORD Message, 68 : WPARAM wParam, LPARAM IParam) ; Листинг 17.3. MENUTEST.RC 1: ///////////////////////////////////////////////////// 2: // Program Name: MENUTEST.RC 3: // Programmer: Charlie Calvert 4: // Description: MenuTest windows program resource script 5: // Date: 04/28/93 6: ///////////////////////////////////////////////////// 7: #include "menutest.h" 8: Sinclude «windows.h> 9: 10: MYKEYS ACCELERATORS 11: BEGIN 12: VK Fl, CM_ROUNDCURSOR, VIRTKEY, ALT 13: VK~F2, CM_DIAMONDCURSOR, VIRTKEY, CONTROL 14: VKF3, CM_ICONCURSOR, VIRTKEY, SHIFT 15: ”1", CMROUNDCURSOR, VIRTKEY, ALT 16: "2", CM DIAMONDCURSOR, VIRTKEY, ALT 17: "3", CM_ICONCURSOR, VIRTKEY, ALT 18: END 19: 20: CURSOR_1 CURSOR "cursorl.cur" 21: CURSOR_2 CURSOR "cursor2.cur" 22: CURSOR_3 CURSOR "cursor3.cur" 23: 24: ICON_1 ICON "iconl.ico" 25: 26: BITMAP_1 BITMAP "bitmapl.bmp" 27: BITMAP1A BITMAP "bitmapla.bmp" 28: BITMAP 2 BITMAP "bitmap2.bmp" 29: BITMAP2A BITMAP "bitmap2a.bmp" 30: BlTMAP_3 BITMAP "bitmap3.bmp" 31: BITMAP3A BITMAP "bitmap3a.bmp" 32: BMPEXIT BITMAP "exit.bmp" 33: 34: MENU_1 MENU 35: BEGIN 36: POPUP "sFile" 37: BEGIN 38: MENUIТЕМ "SNew", CM_NEW 39: MENUITEM "SOpen.CM_OPEN 40: MENUITEM "SSave", CM_SAVE 41: MENUITEM "Save Sas...", CM SAVEAS 42: MENUITEM SEPARATOR 43: POPUP "SPrint..." 44: BEGIN 45: MENUITEM "Print To Disk", CM_PRNDISK 46: MENUITEM "Print LPT1", CM_PRNLPT1 47: END 48: MENUITEM "Page sestup...", CM_PAGESETUP 49: MENUITEM "PSrinter setup...", CM_PRINTERSETUP 50: MENUITEM SEPARATOR 51: MENUITEM "ESXit", CM_FILEEXIT 52: END
53: POPUP ”«Cursors" 54: BEGIN 55: MENUITEM "«Round Cursor\tAit+Fl", CM_ROUNDCURSOR 56: MENUITEM "«Diamond Cursor\tCtrl+F2", CM_DIAMONDCURSOR 57: MENUITEM "«Draw Icon\tShift+F3", CMICONCURSOR 58: END 59: POPUP "BitCursors" 60: BEGIN 61: MENUITEM "Item", CM_BITMENU1 62: MENUITEM "Item", CM_BITMENU2 63: MENUITEM "Item", CM_BITMENU3 64: END 65: MENUITEM "«Help", CM_HELP 66: END 67: 68: HELPBOX DIALOG 18, 18, 166, 119 69: STYLE DS_MODALFRAME | WS_POPUP I WS_CAPTION I WS SYSMENU 70: CAPTION "Help Dialog" 71: BEGIN 72: PUSHBUTTON "Close", IDOK, 11, 97, 144, 14 73: CONTROL ”Icon_l", -1, "STATIC", SS_ICON I WS_CHILD I 74: WS_VISIBLE I WS_GROUP, 137, 9, 16, 16 75: CONTROL ”Icon_l", -1, "STATIC", SS_ICON I WS CHILD 1 76: WS-VISIBLE I WS_GROUP, 13, 9, 16, 1? 77: CONTROL , ID HELPEDIT, "EDIT", ES_CENTER I ES_MULTILINE I 78: ES_READONLY I WS_CHILD I WS_VISIBLE I WS_BORDER I 79: WS_VSCROLL I WS_TABSTOP, 6, 34, 154, 56 80: END Листинг 17.4. MENUTEST.DEF 1: ; MENUTEST.DEF 2: NAME MenuTest 3: DESCRIPTION 'MenuTest Window' 4: EXETYPE WINDOWS 5: STUB 'WINSTUB.EXE' 6: HEAPSIZE 4096 7: STACKSIZE 5120 8: CODE PRELOAD MOVEABLE DISCARDABLE 9: DATA PRELOAD MOVEABLE MULTIPLE Листинг 17.5. MENUTEST.MAK (Borland) 1: # MENUTEST.MAK 2: 3: # Макросы 4: APPNAME = MenuTest 5: INCPATH = C:\BC\INCLUDE 6: LIBPATH = C:\BC\LIB 7: FLAGS = -H -ml -W -v -w4 -1$ (INCPATH) -L$ (LIBPATH) 8: 9: # Компоновка 10: $ (APPNAME) .exe: $ (APPNAME) .obj $ (APPNAME) .def $ (APPNAME) .res 11: b CC $ (FLAGS) $ (APPNAME) .obj 12: brc menutest.res menutest.exe 13: 14: # Компиляция 15: $ (APPNAME) . obj : $ (APPNAME) . cpp 16: bcc -c $ (FLAGS SAPPNAME) . cpp 17: 18: # Компиляция ресурсов 19: MenuTest.res: $ (APPNAME) .rc 20: brc -r -i$(INCPATH) MenuTest.rc Листинг 17.6. MENUTEST.MAK (Microsoft) 1: 2: 3: 4: 5: 6: 7: # ============ # MenuTest.Mak # ============ # ============: # Компоновка « ============
6: MenuTest.еже : MenuTest.obj MenuTest.def MenuTest.res 9: linkMenuTest, /align:16, NUL, /nod llibcew llbw, MenuTest 10: rc MenuTest.res 11: 12 I If 'i- и 13: fl Компиляция 14: # 15: MenuTest.obj : MenuTest.cpp 16: cl -c -AL -GA -Он -ИЗ -Zp MenuTest.cpp 17: 18: « 19: I Компиляция ресурсов 20: # 21: MenuTest.res: MenuTest.rc 22: rc -r MenuTest.rc Рис. 17.5. Программа MenuTest позволяет помещать растровые изображения вменю и нарисовать что-нибудь пиктограммой Программа MenuTest не представляет большого практического интереса, если нс считать ее полезности как средства обучения. Моей основной целые при ее создании было показать некоторые из важных вариаций, которые можно производить с меню, включая использование растровых изображений и пользовательских меню. Кроме того, MenuTest демонстрирует, как динамически изменять курсор на этапе выполнения и как помещать в диалог пиктограмму. В качестве небольшого приза MenuTest позволяет вам рисовать образы в своем основном окне с помощью программной пиктограммы. Чтобы проследить основные шаги, выберите каждый из пунктов выскакивающих меню Cursors и BitCursors. Опции меню Cursors изменяют форму курсора программы. Пункт меню DrawCursor позволяет вам рисовать в основном окне, нажимая левую кнопку мыши. Еще раз о меню В первой части этой главы было дало подробное описание того, как создавать меню внутри RC-файла. Следующий этап — посмотреть, что можно проделывать с меню динамически на этапе выполнения. В частности, в этой главе освещается: Помещение в меню растрового изображения, как показано в пункте EXIT в меню File. Помещение или удаление галочки перед пунктом меню. Создание пользовательского меню, изменяющего форму и текстуру, когда пользова- тель выбирает конкретные пункты. Удаление пунктов из системного меню.
Помещение растрового изображения в меню Ключ к помещению растрового изображения в меню — команда ModifyMenu. Эта команда позволяет модифицировать содержимое существующего пункта меню. Конкрет- нее, она позволяет вам изменять строку, отображаемую в пункте меню, или полностью заменять эту строку растровым изображением (как это делает MenuTest, когда помещает растровое изображение EXIT в меню File). Функция ModifyMenu BOOL ModifyMenu (HMENU, UINT, UINT, UINT, LPCSTR) HMENU hmenu; UINT iditem; UINT fuFlags; UINT idNewItem; Дескриптор меню, подлежащего модификации Идентификатор или позиция пункта или выскакивающего меню Многоцелевой флажок (см. последующее объяснение) Новый идентификатор пункта меню LPCSTR IpNewItem; Новый пункт меню (обычно строка или растровое изображение) Чаще всего вам просто требуется изменить строку или идентификатор, ассоциированный с пунктом меню. Чтобы сделать это, нужно обратить особое внимание на второй и третий параметры этой функции. Если вы передаете в параметр fuFlags значение MF_BYCOMMAND, то тем самым сообщаете Windows, что idltem является идентификатором. Передача MF BYPOSITION сообщает Windows, что второй параметр является смещением от начала меню. Третий параметр также можно использовать для указания того, является ли аргумент IpNcwftem строкой или растровым изображением. Например, следующая команда определяет второй параметр как идентификатор, а не как позицию, а последний — как строку: ModifyMenu(GetMenu(hwnd), CM_MYID, MF_BYCOMMANC | MF_STRING, CM_MYID, (LPCSTR)"My New Menultem"); Программа MenuTest использует команду ModifyMenu для замены опции Exit в меню File на растровое изображение: ModifyMenu(GetMenu(hwnd), CM_EXIT, MF_BYCOMMAND | MF_BITMAP, CM EXIT, (LPCSTR)MAKELONG(BMPExit, 0)) ; Ключевые части этого вызова находятся в третьем параметре, где помещается флажок MF_BIT- МАР, и в пятом, где дескриптор растрового изображения переводится в указатель и передается Windows. Разумеется, BMPExit есть не что иное, как обычное растровое изображение, сконструи- рованное с помощью специальной программы и загруженное с помощью обращения к LoadBitmap. Вот что я думаю о команде ModifyMenu в порядке резюме: “Иногда программисты желают удалить меню с помощью команды DeleteMenu и добавить меню с помощью команды AppendMenu. Еще одна альтернатива состоит в том, чтобы модифицировать существующее меню с помощью команды ModifyMenu”. Иными словами, когда вы хотите изменить содержание существующего меню, пользуйтесь командой ModifyMenu. ModifyMenu and MF_OWNERDRAW Истинная мощь команды ModifyMenu особенно ясно видна в выскакивающем меню BitCursors, которое определяет три пользовательских меню, как показано на рисунке 17.1. Если говорить начистоту, я считаю, что после всех этих лет стандартная система меню Windows иногда надоедает, и я хотел бы хоть как-нибудь разнообразить ее. К счастью, на помощь приходит пользовательское меню. Этот маленький инструмент можно использовать для создания изумительных меню, которые могут сделать вашу программу выдающейся. Ниже перечислены шаги, необходимые для создания собственного растрового изо- бражения: Вызвать ModifyMenu и установить флажок MF_OWNERDRAW. Сообщить Windows, насколько большим следует сделать окно выскакивающего меню с помощью ответа на сообщения WM_MEASUREITEM.
Ответить на сообщения WM_DRAWITEM, нарисовав выбранный или невыбранный пункт меню, в зависимости от состояния флажка ODS_SELECTED. Остаток этого раздела посвящен подробному объяснению приведенных понятий. Для начала просто вызовите ModifyMenu, что выглядит примерно так: ModifyMenu(GetMenu(hwnd), СМ_BITMENU1, MF_BYCOMMAND I MF_OWNERDRAW, CMJBITMENUl, (LPCSTR)MAKELONG(Bitmapl, 0) ) ; Как видите, этот вызов похож на тот, с помощью которого растровое изображение помещается в меню. Правда, здесь вместо флажка MF_BITMAP используется MF_OWN- ERDRAW. Флажок MF_OWNERDRAW означает, что основному окну программы требуется начать прием сообщений WM_MEASUREITEM и WM_DRAWITEM. Первое из этих сообщений приходит, когда меню появляется на экране впервые и предоставляет MenuTest возможность определить размер выскакивающего окна, в котором будут содержаться растровые изображения вашего меню. Второе сообщение позволяет MenuTest действительно высветить растровое изображение по запросу, что должно быть проделано явно внутри программы. (Вот почему это называется пользовательским меню; его вычерчивание обеспечивается приложением, а не самой Windows). Во-первых, может показаться, что ответ на сообщения WM_MEASUREITEM должен быть прост. Однако загвоздка состоит в том, что Windows отводит место для галочек в каждом соответствующем пункте меню. (См. рис. 17.3, где показан пример того, как галочка появляется в нормальном меню). Впрочем, при работе с пользовательскими меню, программа MenuTest полностью игнорирует идею вставки галочек. Следовательно, она должна запросить Windows, сколько места отведено под галочки, а затем вычесть это значение из общей ширины растрового изображения. Весь этот процесс выполняется благодаря функции Get- MenuCheckMarkDemensions: 365: void MenuTest_OnMeasureItem(HWND hwnd, MEASUREITEMSTRUCT 366: ~ FAR* IpMeasureltem) 367: { 368: WORD Checkwidth; 369: 370: Checkwidth = LOWORD (GetMenuCheckMarkDimensions()); 371: switch (lpMeasureItem->itemID) 372: ( 373: case CM_BITMENU1: 374; case CM_BITMENU2: 375: case CM_BITMENu3: 376: lpMeasureItem->itemWidth = BStruct.bmWidth - Checkwidth - 3; 377: lpMeasureItem->itemHeight = BStruct.bmHeight - 1; 378: break; 379: ) 380: ) Этот код показывает, как программа обрабатывает сообщения WM MEASUREITEM. Первый шаг состоит в том, чтобы получить ширину области, отведенной под галочку, а затем отнять ее от ширины растрового изображения. Windows использует эту информа- цию, чтобы установить размер окна, содержащего пункт меню. BStract (см. последующее объяснение) представляет собой структуру BITMAP, содер- жащую размеры текущего растрового изображения. MenuTest получает эти размеры посредством обращения к GetObject. Функция GetObject int GetObject(HGDIOBJ, HGDIOBJ hgdiobj; int, void FAR *) Дескриптор растрового изображения, шрифта, кисти или пера int cbBuffer; Размер буфера в третьем аргументе void FAR* IpvObject; Буфер, в котором должна храниться информация, най- денная функцией GetObject
Осуществляя поиск информации о растровых изображениях, структура использует третий параметр, который выглядит следующим образом: typedef struct tagBITMAP ( /* bra •/ int braType; int bmWidth; int bcnHeight; int bmWidtbBytcs; BYTE bmPlanes; BYTE bmBitsPixel; void FAR* bmBits; ) BITMAP; Пример: GetObject(Bitmapl, sizeof(BITMAP) , &BStruct); После отклика на сообщение WM MEASUREITEM в ответ на сообщения WM_DRAWITEM вычерчивается растровое изображение. Приведенный ниже фрагмент функции MenuTest_OnDrawItem показывает, как это делается: 316: void MenuTest_OnDrawItem(HWND hwnd, 319: const DRAWITEMSTRUCT FAR* IpDrawltern) 320: { 321: switch (lpDrawItem->iter.IDl * 322: ( 323: case CMBITMENUl: 324: if (IpDrawItem-xitemState & ODSSELECTED) 325: DrawBitmap(lpDrawItem->hDC, Bitmapla, 0); 326: else 327: DrawBitmap(lpDrawItem->hDC, Bitmapl, 0); 328: break; ... // Код для обработки других пунктов меню Центральный момент состоит в том, что запрашиваемые пункты меню могут нахо- диться в одном из двух состояний; выбранном или невыбранном. Каждое из этих состояний должно быть нарисовано отдельно, как показано на рисунке 17.6 Рис. 17.6. Слева обычный пункт меню, справа выбранный пункт меню Как только пользователь выбирает пункз меню, Windows вежливо информирует MenuTest об этом, помещая флажок CDS SELECTED. MenuTest реагирует посылкой соответствующего растрового изображения в функгщю DrawBitmap. 301: void DrawBitmap(HDC PaintDC, HBITMAP Bitmap, int YVal) 302: ( 303: HDC MemDC; 304: HBITMAP OldBitmap; 305: 306: MemDC • CreateCompatibleDC(PaintDC) ; 307: OldBitmap ~ SelectBitmap(MemDC, Bitmap); 308: BitBlt(PaintDC, 0, YVal * BStruct.bmHeight, BStruct.bmWidth, 309: BStruct.bmHeight, MemDC, 0, 0, SRCCOPY); 310: SelectObject (MemDC, OldBltniap) ; 311: DeleteObject(MemDC); 312: ) Эта функция подобна стандартной функции рисования, за исключением того, что контекст устройства доставляется непосредствсшю самой Windows (пользователь не обязан обращаться ни к BeginPaint, ни к GetDC). Вот и все об этом. После того как программа MenuTest передала изображение на экран, она может забыть обо всех своих пользовательских меню, по крайней мере, до следующего сообщения WM DRAWITEM.
Ниже следует быстрое повторение шагов, необходимых для создания пользователь- ских меню: Установить флажок MF_OWNERDRAW в аргументе fuFlags функции ModifyMenu. Ответить на сообщения WMMEASUREITEM, чтобы Windows узнала, насколько велико создающееся выскакивающее меню. Ответить на сообщения WM_DRAW1TEM передачей растровою изображения на экран (обратите особое внимание на флажок ODS SELFCT FD). Несмотря на наличие нескольких скользких моментов, работа с пользовательским меню, в общем-то, не сложна. Надеюсь, это средство будет включено во многие программы в ближайшем будущем. Думаю, что любой программист, разрабатывающий программу для юной аудитории, должен использовать меню собственного изготовления Эти меню могут придать программе забавный дружеский интерфейс, который был бы очень привлекателен для детей. Замечание. Пользовательские меню представляют собой классический пример того, как Windows перекладывает дополнительную тяжесть на плечи программиста с тем, чтобы сделать приложение более удобным и привлекательным для пользователя. Модифицирование системного меню Программа MenuTest удаляет опцию Close из системного меню (см. рис. 17.7 и 17 8). Рис. 17.8. Системное меню программы MenuTest Конечный результат этого действия имеет целью заставить пользователя обратиться к опции Exit из меню файлов, а не выходить из программы с помощью системного меню. Кроме того, вы должны заметить, что больше невозможно выйти из программы посредством двойного щелчка кнопкой мыши на пиктограмме системного меню.
Следующий ниже код показывает, как получить дескриптор системы с помощью обращения к GetSystemMenu. Вы также можете передать этот дескриптор в функцию DeleteMenu, которая удаляет элементы из меню, как показано далее. Конечный результат состоит в том, что системное меню модифицируется таким образом, что оно уже не может больше использоваться для выхода из программы. 159: HMENU SysMenu = GetSystemMenu(hwnd, FALSE); 160: 161: DeleteMenu(SysMenu, 6, MF_BYPOSITION); 162: DeleteMenu(SysMenu, 6, MF_BYPOSITION); Этот код из MenuTest_OnCreate показывает, как получить системное меню посред- ством обращения к GetSystemMenu, а затем удалить элемент меню, вызвав Deletemenu. Функция DeleteMenu BOOL DeleteMenu(HMENU, UINT, UINT) HMENU hmenu; UINT idltem; UINT fuFlags; Дескриптор меню, содержащего элемент, подлежащий удалению Идентификатор или позиция элемента, подлежащего удалению Флажок, указывающий MF BYPOSITION или MF_BYCOMMAND Вызов DeleteMenu очень прост. Важно лишь помнить, что после того как вы удалите пункт, указав позицию, следующему пункту в меню присваивается номер того пункта, который вы только что удалили. Вот почему показанный код удаляет элементы 6 и 7 из меню, удаляя элемент 6 дважды. В предыдущем примере два удаляемых пункта — это Close и разделитель. Пример: DeleteMenu(hMenu, ID_MYMENUITEM, MFJBYCOMMAND); Помещение “галочки” перед пунктом меню Как только пользователь выбирает новый курсор для программы MenuTest, перед вновь выбранной опцией выскакивающего меню Cursors появляется “галочка”. Это действие реализует следующий код: HMENU Menu = GetMenu(hwnd); CheckMenuItem(Menu, CM_ROUNDCURSOR, MF_BYCOMMAND | MFCHECKED); Как видите, MenuTest получает дескриптор меню программы с помощью обращения к GetMenu, а затем посылает сообщение, запрашивающее пометку конкретного пункта меню. К настоящему моменту детали того, как работает команда этого типа должны быть очевидны вам без какого-либо подробного объяснения. Впрочем, в третьем параметре CheckMenuItem могут быть переданы следующие флажки: MF_BYCOMMAND MF_BYPOSITION MF_CHECKED MF_UNCHECKED Второй параметр является идентификатором Второй параметр является позицией (позиции нумеруются с нуля) Поместить галочку перед пунктом меню Удалить галочку перед пунктом меню Выбор нового курсора Каждое находящееся на экране окно имеет ассоциированный с ним курсор. Напри- мер, основное окно программы NotePad использует I-образный курсор, в то время как меню программы NotePad использует курсор в виде стрелки. Если вы откроете диалог File|Open из программы NotePad, то можете увидеть, что курсор изменяется, проходя по окну через редактируемое поле.
Кажущаяся несущественной установка нового курсора для окна, на самом деле важна, поскольку дает пользователю ясную информацию о текущем состоянии или назначении окна. В отличие от пиктограмм курсоры несут пользователю много весьма полезной информации чаще всего на подсознательном уровне. Похоже, люди инстинктивно догадываются, что курсором в виде стрелки нужно что-то указывать, 1-образным курсором что-то писать и ждать при появлении курсора в виде песочных часов. Никому не требуется сообщать пользователю смысл этих курсоров, а пользователю не нужно об этом задумываться. Замечание. Некоторые пугаются в вопросах отличия курсора от каре. Курсор всегда ассоциируется с мышью. Он двигается по экрану, когда перемещается мышь. Каре обычно ассоциируется с окном, таким, как редактируемое поле, которое позволяет вводить и редактировать информацию. Существует целый ряд команд, не освещаемых в этой главе, для управления каре. Это функции CreateCaret, DestroyCaret, SetCaretBlinkTime, HideCaret и ShowCaret. Короче говоря, курсор — это то, что пользователи DOS обычно называют курсором мыши, а каре — то, что пользователи DOS обычно называют курсором. Существует два общепринятых способа замены курсора в окне. Первый состоит в том, чтобы залезть внутрь Windows и изменить структуру оконного класса с помощью SetClassWord: SetClassWord(hwnd, GCW_HCURSOR, (WORD)Cursor1); SetCursor(Cursori); Этот код использует процедуру SetClassWord, чтобы запихнуть байты GCW_HCUR- SOR во внутреннюю структуру данных Windows, определяющую атрибуты основного окна программы MenuTest. SetClassWord находит там старый курсор основного окна программы и заменяет его пользовательским курсором. Затем новый курсор делается видимым с помощью вызова SetCursor. Важно понимать, что это двухшаговый процесс: изменить курсор класса, а затем сделать курсор видимым. Прежде чем перейти к обсуждению второго способа замены курсора, следует упомя- нуть, что можно заменить курсор окна только с помощью SetCursor (без SetClassWord). Впрочем, эта замена будет недолгой, если вы сначала не установите курсор для класса в нуль. И даже тогда замена действительна лишь до тех пор, пока курсор не покинет текущего окна. Следовательно, вы должны вызывать SetCursor в комбинации с SetClass- Word, за исключением того случая, когда они используются вместе в одном сложном операторе (см. следующее описание). Второй прием смены курсора — тот, что используется, когда программист желает высветить курсор в виде песочных часов, пока идет какой-то процесс. Например, когда в базе данных идет длительный поиск, программисты обычно выводят на экран курсор в виде песочных часов и закрывают все остальные опции. Это вынуждает пользователя ожидать завершения поиска. Если вы желаете заменить текущий курсор на песочные часы и оставить их до момента завершения операции, вызовите SetCursor и SetCapture друг за другом (см. следующий далее код). Когда закончите, восстановите прежний вид курсора и вызовите ReleaseCap- ture. SetCapture(hwnd); hCursor OldCursor = SetCursor(LoadCursor(0, IDC_HOURGLASS); ...// Выполнение длительной операции SetCursor(oldCursor); Releasecapture(); Обычно программисты вызывают SetCapture для неподвижного окна, такого, как статический текст, или для кнопки с идентификатором вроде IDABORT или IDCANCEL. В случае неподвижного окна пользователь ничего не сможет сделать, пока не будет вызвана ReleaseCapture. В случае кнопок пользователь может только прервать или отменить текущую операцию. Функция SetCapture HWND SetCapture(HWND)
Функция SetCapture зависит от одного параметра. Этот параметр — окно, в которое вы должны направлять всю информацию от мыши до тех пор, пока не будет вызвана ReleaseCapture. SetCapture возвращает HWND окна, которое имело фокус, или NULL, если такого окна не было. ReleaseCapture не имеет аргументов. Пример: Setcapture(IDCANCEL); ReleaseCapture(); Ниже приводится список стандартных курсоров, имеющихся в системе: IDC_ARR0W Курсор в виде стрелки IDC_CROSS Перекрестье IDC_IBEAM I-образный курсор IDC_ICON Пустая пиктограмма IDC_SIZE Четырехнаправленная стрелка IDC_SIZENESW Двунаправленная стрелка (Северо-Восток — Юго-Запад) IDC_SIZEENS Двунаправленная стрелка (вверх-вниз) IDC_SIZENWSE Д вунаправленная стрелка (Северо-Запад — Юго-Восток) IDC_SIZEWE Двунаправленная стрелка (лево-право) IDC_UPARROW Большая стрелка вверх I DC WAIT Песочные часы Любой из этих курсоров можно загрузить, вызвав LoadCursor с нулем в качестве первого параметра (как показано выше). Противоположность системного курсора — курсор, определяемый пользователем. Программа MenuTest демонстрирует ряд таких курсоров, которые могут быть разрабо- таны как с помощью Resource Workshop, так и с помощью Арр Studio. Достаточно лишь осуществить соответствующий выбор в меню, а затем начать рисовать с Помощью мыши. Имея набор предопределенных курсоров, MenuTest загружает их в ответ на сообще- ние WM_CREATE: 130: Cursorl - LoadCursor(hlnstance, "CURSOR_1"); 131: Cursor2 - LoadCursor(hlnstance, "CURSOR_2"); 132: Cursor3 “ LoadCursor(hlnstance, "CURSoR_3">; Документация фирмы Microsoft утверждает, что для любого пользовательского кур- сора, загружаемого в вашу программу, в отличие от системного курсора вам следует вызывать DestroyCursor (см. строчки 192-194 MENUTEST.CPP). Отладочная версия Windows не возмутится, если вы этого не сделаете, однако я советую от греха подальше придерживаться документации фирмы Microsoft. На этом завершается наше обсуждение курсоров. В данном разделе вы изучили два основных момента: Для того чтобы связать курсор непосредственно с окном, вызовите SetClassWord и SetCursor. Я Если вы хотите своевременно установить курсор (в течение выполнения операции, которую нельзя прервать), вызовите SetCursor. Затем вызовите SetCapture. Когда закончите, не забудьте восстановить исходный курсор и вызвать ReleaseCapture. Более сложные пиктограммы Если вы отобразите диалог Help программы MenuTest, то увидите, что он содержит две пиктограммы (см. рис. 17.9).
Q Help Dialog Choose ROUND CURSOR or DIAMOND CURSOR to see new cursors. Ch ose DRAW ICON to draw on th, screen. Choose GO or SLOW to set background, choose BYE to reset screen. The close option has been removed from the system menu, so Close Рис. 17.9. Диалоговая панель Help Dialog имеет две встроенные пиктограммы Создавая КС-файл этого диалога, вы можете придать статическом полю способность вмещать пиктограмму. Для этого просто придайте статическому элементу управления стиль SS_ICON и снабдите его именем пиктограммы. Icon_l ICON "icon.lco" CONTROL ’Icon 1", -1, "STATIC", SSJtCCN | WS CHILD I WS VISIBLE I WS GROUP, 137, 9, 16, 16 Заметьте, что этот код ссылается на пиктограмму по присвоенному имени, а нс по имени файла. Кроме того, последние два параметра, определяющие ширину и высоту статического текста, игнорируются, поскольку статическое поле автоматически масшта- бируется так, чтобы вместить пиктотрамму. Второй трюк, проделываемый Mcnulcsl с иикпираммами, позволяет вам рисовать по поверхности основного окна пиктограммой (как показано на рис. 17.10). Рис. 17.10. Программа MenuTest использует функцию Drawicon и сообщение l¥M MOSEMOVE для рисования произвольных линий в своем основном окне Для рисования пиктограммы па экране используется следующий код: 385: void MenuTest_OnMous«iMove (HWND hwnd, int x, Int y, UINT keyFlags) 386: ( 387: if(((keyrings s MK_LBUTTON) KK_LBUTTON) st (Painticon)) 388: { 389: HDC PaintDC = GetDC(hwnd); 390: Drawlcor.(PaintDC, x, y, Iconl); 391: ReleaseDC(hwnd, PaintDC); 392: ) 393: ) Всякий раз, когда мышь движется по поверхности основного окна, программа проверяет, нажата ли левая ее кнопка и установлена ди булева переменная Paintlco равной TRU Е. Если выполнены оба эти условия, MenuTest выбирает контекст устройства
основного окна и рисует (с помощью функции Drawicon) пиктограмму на экране на месте текущего положения мыши. Загружайте пиктограммы в память вызовом Loadicon, передавая нуль в качестве первого параметра, если пиктограмма системная, например, IDI_APPLICATION. Не забывайте очищать память, ассоциированную с пиктограммой, вызывая Destroylcon. Коротко об ускорителях Наконец дошла очередь и до ускорителей. Ускорители, или горячие клавиши, позво- ляют вам определять привычные комбинации клавиш так, чтобы пользователь мог быстро получить доступ к определенным средствам программы. Например, программа MenuTest позволяет вам переключать курсоры, нажимая Alt-1, Alt-2 или Alt-З. Поскольку вас может заинтересовать определение более сложных комбинаций клавиш, MenuTest также предлагает доступ к тем же самым пиктограммам с помощью Alt-Fl, Ctrl-F2 и Shift-F3. Каждая из этих последних комбинаций показывается пользователю в меню. Ускорители просты в использовании. Чтобы определить их, просто вызовите Resource Workshop или Аоо Studio и воспользуйтесь стандартными инструментами для создания ускорителей. Также очень легко определить ускорители с помощью текстового процес- сора: BEGIN VK_F1, CM_ROUNDCURSOR, VIRTKEY, ALT VK_F2, CM_DIAMONDCURSOR, VIRTKEY, CONTROL VK_F3, CM_ICONCURSOR, VIRTKEY, SHIFT "1", CM_ROUNDCURSOR, VIRTKEY, ALT "2", CM_DIAMONDCURSOR, VIRTKEY, ALT "3", CM_ICONCURSOR, VIRTKEY, ALT END Замечание. Обычно горячие клавиши определяются с помощью Alt и любой другой буквенно- цифровой клавиши. Впрочем, программа MenuTest также приводит примеры того, как можно использовать клавиши Alt, Ctrl и Shift в комбинации с одной из функциональных клавиш. Создав таблицу ускорителей, вы должны загрузить ее в память: static HACCEL, hAccel hAccel = LoadAccelerators(hlnstance, "MYKEYS"); if (hAccel == NULL) MessageBox(MainWindow, "No Accelerators", “Warning", MB_OK); Программа MenuTest исполняет эту простую операцию в ответ на сообщения WM_CREATE. Впрочем, существует аргумент в пользу переноса всего процесса в WinMain, поскольку значение hAccel, возвращаемое из LoadAccelerators, используется в программном цикле опроса сообщений (см. следующее ниже объяснение). Оба пути одинаково хороши. Я предпочитаю загружать ускорители в MenuTest_OnCreate, посколь- ку производил там все программные инициализации и хочу оставаться последователь- ным. (Преимущество выполнения всех ваших инициализаций в ответ на WM CREATE в tqm, что такой способ действий оставляет функции WinMain, Create и Register почти абсолютно неизменными при переходе от одной программы к другой, давая, таким образом, вам возможность игнорировать их, за исключением быстрой проверки струк- туры WNDCLASS и цикла опроса сообщений). Последний шаг в использовании ускорителей — просто добавить TranslateAccelerator в цикл опроса сообщений, так же, как вы делали при вызове IsDialogMessage в программе FileBox: while (GetMessage(SMsg, NULL, 0, 0)) { if (!TranslateAccelerator(MainWindow, hAccel, SMsg)) ( TranslateMessage(SMsg); DispatchMessage(SMsg); > )
Очевидная цель функции TranslateAccelerator — обрабатывать любые горячие клави- ши, определенные в вашей программе прежде, чем они будут переданы в соответствую- щую оконную процедуру с помощью DispatchMessage. Иначе говоря, Windows проверяет, нажал ли пользователь горячую клавишу; если да, то Windows переводит нажатие клавиши в сообщение, в противном случае она просто передает сообщение непосредст- венно в вашу процедуру главного окна. Вызывайте LoadAccelerators, если хотите загрузить ускорители в память. Не беспокойтесь об уничтожении ускорителей. Windows выполняет это самостоятельно. Резюме Сегодня было мало сюрпризов. Большая часть кода имела прикладную направлен- ность, но не была особенно сложной для понимания. Ниже перечислены основные моменты: И Вы можете разнообразить меню, добавив выскакивающие меню или воспользовав- шись операторами SEPARATOR, MENUBARBREAK, GRAYED, CHECKED или UNCHECKED. И Для того чтобы действительно украсить меню, модифицируйте его с помощью стилей MFBITMAP или MFOWNERDRAW. И Вы можете заменить курсор, ассоциированный с окном, чтобы пользователь смог догадаться о назначении и текущем состоянии окна. Пиктограммы могут быть помещены в диалоги или нарисованы непосредственно на экране. И Интерфейс клавиатуры с программой может быть усилен с помощью горячих клавиш. Весь этот материал полезен и даже жизненно необходим, но по-настоящему увлека- тельный код, показанный в этой главе, связан с созданием пользовательского меню. Подобно правой кнопке мыши, меню относительно открытая область Windows-програм- мирования. Любой, кто захочет проделать немного творческой работы, легко может привнести в эту область массу интересных вещей. Вопросы и ответы 1. Я все еще ие понимаю взаимосвязи между MFOWNERDRAW, WM_MEASUREITEM и WM_DRAWITEM. Поясните, пожалуйста. Устанавливая флажок MF OWNERDRAW, вы сообщаете Windows, что хотите обра- ботать изображение запрошенного пункта меню. Windows отвечает: “Прекрасно, только скажите мне, насколько велико должно быть окно, в котором будет содержаться ваше растровое изображение?”. Вы отвечаете на этот вопрос, реагируя на сообщения WM_MEASUREITEM. Теперь, когда все приготовления завершены, Windows пункту- ально посылает вам сообщение WM DRAWITEM всякий раз, когда требуется нарисовать или обновить пункт меню. 2. Еще один раз, просто для верности: если я устанавливаю курсор, то когда мне следует вызывать SetCapture, а когда SetClassWord? Вызывайте SetClassWord, когда вы хотите сменить курсор окна в течение длительного времени, не влияя на производительность. Эта замена останется в силе до тех пор, пока вы снова не вызовите SetClassWord или пока запрошенное окно не закроется. Вызывайте SetCapture, когда вы хотите временно направлять всю информацию от мыши в какое- нибудь конкретное окно, одновременно удостоверяясь, что курсор не изменится, в каком бы окне он не находился. Обычно вещи такого рода выполняются, когда вы хотите заменить курсор на песочные часы.
Вопросы для самопроверки 1. Программа MenuTest указывает горячие клавиши в пунктах выпадающего меню Cursors (рис. 17.3). Как она отделяет их от собственно текста меню? 2. Как подчеркнуть букву в меню? Каков будет эффект? 3. Какой вызов требуется вставить в программный цикл опроса сообщений, если программа пользуется ускорителями? 4. Как понять, выбран ли пункт меню или нет, когда вы получаете сообщение WMDRAWITEM? 5. Воспользуйтесь своим справочным материалом, чтобы указать, по крайней мере, семь различных флажков, использующихся в третьем параметре (fuFlags) функции ModifyMenu. 6. В чем разница между MF_BYPOSITION и MF_BYCOMMAND? 7. Если вы используете флажок MFBYPOSITION, то первый элемент меню имеет номер 0 или 1? 8. Каково назначение стиля SS_ICON? 9. Какую функцию нужно вызывать при каждом обращении к SetCapture? (Намек: не SetCursor!) 10. Как получить размеры растрового изображения на этапе выполнения? Упражнения 1. Создайте пользовательское меню, которое издает звук автомобильного сигнала и/или изменяет цвет фона основного окна всякий раз, когда пользователь фокусируется на нем клавишей-стрелкой. 2. Продемонстрируйте использование функций SetCursor и SetCapture для глобаль- ного изменения курсора на песочные часы. Оставьте это изменение до тех пор, пока пользователь не щелкнет левой кнопкой мыши на основном окне программы.
День 18 ИНТЕРФЕЙС ГРАФИЧЕСКИХ УСТРОЙСТВ И МЕТАФАЙЛЫ Сегодня вы изучите интерфейс графических устройств (GDI) более подробно. Исходный код для этой главы демонстрирует, как создать зачатки простого графического редактора, который можно использовать для рисования цветных геометрических фигур и воспроизведения метафайлов. В частности, мы рассмотрим следующие вопросы: Как работать с основными GDI-командами, предназначенными для создания таких геометрических форм, как линии, эллипсы и прямоугольники. И Как позволить пользователю вычерчивать эти фигуры на экране по принципу “резинки”, когда видно, как будет выглядеть фигура, если ее растягивают или сжимают с помощью мыши. С точки зрения пользователя, это то же, что и растягивание или сжатие окна. Как отображать на экране два различных вида метафайлов. Н Как создавать, воспроизводить и сохранять стандартные метафайлы. Как загружать и сохранять файлы, используя стандартные диалоговые панели. Тема этой главы касается работы с геометрическими фигурами на экране и в памяти, а также записи их на диск в виде метафайлов. Метафайлы представляют альтернативу медленным, интенсивно использующим диск операциям, которые вам требуется выпол- нять при работе с растровыми изображениями. В работе с растровыми образами “разменной монетой” является пиксел, который должен быть определен и спроектиро- ван в деталях. При работе с метафайлами основной рабочей единицей является геомет- рическая фигура, такая, как прямая, прямоугольник, многоугольник или эллипс. Хотя и в этом случае требуется кое-что соразмерять, в целом это может оказаться более быстрой, более гибкой и гораздо менее тяжкой, с точки зрения использования диска, техникой работы с изображением. Работа с фигурами Исходный код сегодняшней программы сосредоточен на вызовах GDI-функций, позволяющих рисовать геометрические фигуры (см. табл. 18.1). Это те же самые фигуры, которые вы обнаруживаете в таких графических библиотеках DOS, как Borland BGI.
Таблица 18.1 Некоторые важные функции, рисующие фигуры Имя функции Результат Chord Дуги, конечные точки которых соединены прямой Ellipse Pie Окружности или эллипсы Секторы круга Polygon Rectangle RoundRect Многоугольники Квадраты или прямоугольники Квадраты или прямоугольники со скругленными углами Функция ответа на сообщение WM_PAINT программы, генерирующей фигуру, приводится в листинге 18.1. Примеры каждой из фигур показаны на рисунке 18.1. Рис. 18.1. Сидят слева направо: Фред (прямоугольник), Джойс (эллипс), Лесли (скругленный прямоугольник), Сара (сектор), Робин (сегмент), Джед (многоугольник) Листинг 18.1. Фрагмент FIGS.CPP для вычерчивания шести наиболее распространенных геометрических фигур 1: void Figs_OnPaint(HWND hwnd) 2: { 3: HDC PaintDC; 4: PAINTSTRUCT PaintStruct; 5: 6: PaintDC = BeginPaint(hwnd, SPaintStruct); 7: 8: HBRUSH GreenBrush = CreateSolidBrush(RGB(0, 255, 63)); 9c HPEN RedPen = CreatePen(PS_INSIDEFRAME, 10, RGB(255, 0, 0)); 10: HBRUSH OldBrush = SelectBrush(PaintDC, GreenBrush); 11: HPEN OldPen = SelectPen(PaintDC, RedPen); 12: 13: Rectangle(PaintDC, 10, 10, 100, 100); 14: Ellipse(PaintDC, 150, 10, 250, 100); 15: RoundRect(PaintDC, 300, 10, 450, 180, 40, 80); 16: Pie(PaintDC, 10, 150, 100, 240, 10, 150, 50, 200); 17: Chord(PaintDC, 150, 150, 250, 240, 150, 150, 200, 200); 18: 19: const int NumPoints = 3; 20: 21: POINT P[NumPoints]; 22: P[0].x = 300; 23: P[0] .y = 240; 24: P[l] ,x = 375; 25: P[l] .y = 150;
26: Р(2).х = 450;* 27: Р(2).у - 240; 28: 29: Polygon(PaintDC, Р, NuniPoints); 30; 31: SelectBrush(Paint DC, OldBrush); 32: SelectPen(PaintDC, OldPen); 33: DeleteObject(RedPen); 34: Deleteobject(GreenBrush); 35: 36: EndPaint(hwnd, SPaintStruct), 37: ) Каждая из фигур, показанных на рис. 18.1, раскрашивается текущей кистью и обводится текущим пером. Чтобы подчеркнуть этот факт, я создал кисть и перо для Figs_OnPaint и скопировал их в контекст устройства пршраммы. Кисть была создана с помощью функции CreateHatchBrush, которая может исполь- зовать в качестве первого параметра одну из следующих констант: HS_bdiaGONAL Диагональная штриховка (под углом 45 градусов слева направо) hs_crcSs Штриховка в клеточку горизонтальными и вертикальными линиями HSDIAGCRCSS Штриховка в клеточку по диагонали HSFDIAGONAL Диагональная штриховка справа налево HS_HORIZONTAL Горизонтальная штриховка HS_VERTICAL Вертикальная штриховка Естественно, если вы используете CreateSolidBrush, а не CreateHatchBrush, то вы получите цветные фигуры, закрашенные полностью, как показано на рисунке 18.2. Рис. 18.2. Прямоугольник, эллипс, скругленный прямоугольник, сектор, сегмент и многоугольник со сплошными штриховками В FigsOnPaint использовано ярко-красное перо толщиной в 10 пикселов. Толстые перья способны придать вашим фигурам массивность. Функция CreatePen HPEN CreatePen(int, int, COLORREF) int fnPenStyle; int nWidth; CCLORREF clrref; Стиль пера Толщина пера Цвет пера
При создании пера вы можете использовать в первом параметре любой из следующих стилей: PS_SOLID PS_DASH PS_DOT PS_DASHDOT PSDASHDOTDOT PSNULL PS_INSIDEFRAME Сплошная линия Пунктир черточками при единичной толщине пера Пунктир точками при единичной толщине пера Штрих-пунктирная линия при единичной толщине пера Пунктир черточками через две точки при единичной толщине пера Пустое (или бесцветное) перо Линия внутри рамки замкнутой фигуры Вторым параметром является толщина пера, измеренная в логических единицах. Третий параметр — COLORREF — 32-битовое значение, обычно создаваемое с помощью макроса RGB. В действительности мало что осталось добавить о создании основных геометрических фигур с помощью GDI. Используемые операции очень просты и обычно не вызывают затруднений. Метафора графического редактора Программа Metaphor позволяет динамически вычерчивать фигуры с помощью мыши и сохранять коллекции этих фигур в некоем образовании, под названием метафайл. Метафайл может быть воспроизведен в любое время с помощью нескольких несложных функций. В основе всех САПР лежит идея автоматизации процесса черчения путем выделения ряда геометрических фигур, которые могут быть, сохранены в отдельном файле. Ряд занятных графических редакторов вроде CorelDRAW! основывается на подобной схеме. На самом деле CorelDRAW! допускает экспорт своих рисунков в форме метафайлов. Программа Metaphor является основой, которую с небольшой долей терпения и упорства вы можете превратить в очень мощный графический редактор. Листинг 18.2. METAPHOR.CPP 1: ///////////////////////////////////////////////////// 2: // Программа: METAPHOR.CPP 3: // Автор: Чарли Калверт 4: // Описание: Программа Meta for Windows 5: // Дата: 4/17/93 6; ///////////////////////////////////////////////////// 7: #define STRICT 8: #include <windows.h> 9: #include <windowsx.h> 10: ((pragma hdrstop 11: ((include <string.h> 12. #include <direct.h> 13 ((include "metaphor.h" 14: #include "metautil.h" 15: ttinclude "metaenum.h" 16: ((pragma warning (disable: 4068) 17: // -=—=-=============== 18 // Интерфейс 19: // -------============== 20: 21: // Переменные 22: static HBRUSH FBrush; 23. static char szAppName[] = "Metaphor"; 24: static HWND MainWindow; 25: static HINSTANCE hlnstance; 26: static TDATA Dat; 27: static RECT OldRect; 28: static HMETAFILE GooberMeta; 29: static HDC GooberDC; 30: HMETAFILE hmf;
31: char TempName[256]; 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45; 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: 85: 86: 87: 88: 89: 90: 91: 92: 93: 94: 95: 96: 97: 98: 99: 100: 101: 102: 103: 104: 105: // ======================= // Инициализация ц ==== //////////////////////////////////////////////// // Точка входа //////////////////////////////////////////////// #pragma argsused int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInstance, LPSTR IpszCmdParam, int nCmdShow) { MSG Msg; if (’.hPrevInstance) if ((Register(hlnst)) return FALSE; if (! (MainWindow = Create(hlnst, nCmdShow))) return FALSE; while (GetMessage(&Msg, NULL, 0, 0)) { TranslateMessage(&Msg); DispatchMessage(SMsg); } return Msg.wParam; > ////////////////////////////////////// // Регистрация окна ////////////////////////////////////// BOOL Register(HINSTANCE hlnst) { WNDCLASS WndClass; WndClass.style - CS_HREDRAW I CS_VREDRAW; WndClass.IpfnWndProc = WndProc; WndClass.cbClsExtra - 0; WndClass.cbWndExtra - 0; WndClass.hlnstance = hlnst; WndClass.hIcon = 0; WndClass-hCursor “ LoadCursor(NULL, IDC_ARROW); WndClass.hbrBackground “ GetStockBrush(WHITE_BRUSH); WndClass. IpszMenuName = ’’MetaMenu"; WndClass.IpszClassName = szAppName; return Registerclass (&WndClass); > ///////////////////////////////// // Создание окна ///////////////////////////////// HWND Create (HINSTANCE hlnst, int nCmdShow) ( hlnstance = hlnst; HWND hWindow = CreateWindow(szAppName, szAppName, WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW USEDEFAULT, NULL, NULL, hlnst, NULL); if (hWindow == NULL) return hWindow; ShowWindow(hWindow, nCmdShow); UpdateWindow(hWindow); return hWindow; )
106: /IIIIIIIIHIIIIIIIIIIIIIIIIIIIIII 107: // Реализация 108: ///////////////////////////////// 109: 110: ///////////////////////////////// 111: // Оконная процедура 112: / Z / / / / / Z / / / / / / / / / / / / / / / / / / / / / / / / / 113: LRESULT CALLBACK export WndProc(HWND hwnd, UINT Message, 114: WPARAM wParam, LPARAM IParam) 115: ( 116: switch(Message) 117: ( 118: HANDLE—MSG(hwnd, WM CREATE, MetaOnCreate); 119: HANDLE—MSG(hwnd, WM_DESTROY, MetaOnDestroy); 120: HANDLE_MSG (hwnd, WM_COMMAND, Meta_OnCommand); 121: HANDLE_MSG (hwnd, WM_LBUTTONDOWN, Meta_OnLButtonDown) ; 122: HANDLE—MSG (hwnd, WM_LBUTTONUP, Meta_OnLButtonUp); 123: HANDLE_MSG (hwnd, WM_MOUS EMOVE, Me ta_OnMou s eMove) ; 124: HANDLE_MSG(hwnd, WM_PAINT, Meta_OnPaint); 125: 126: default: return Meta_DefProc(hwnd. Message, wParam, IParam); 127: } 128: ) 129: 130: Z////////Z//ZZZZ///////////////////// 131: // Обработчиксообщения WM_CREATE 132: ///////////////////////////////////// 133: #pragma argsused 134: BOOL Meta_OnCreate (HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) 135: ( 136: Dat.Color = RGB(0, 0, 0) ; 137: FBrush = CreateSolidBrush(RGB(255, 255, 255)); 138: Dat.Thickness = 10; 139: PostMessage(hwnd, WM_COMMAND, CM_STARTMETA, 0) ; 140: _getdcwd(0, TempName, MAXSIZE); 141: strcat (TempName, "Wgoober.$$$"); 142: hmf = NULL; 143: 144: return TRUE; 145: ) 146: 147: Z/////////Z/////////////////////// 148: Z/ Обработчик сообщения WM_DESTROY 149: Z////Z//////////////////////////// 150: #pragma argsused 151: void Meta_OnDestroy(HWND hwnd) 152: ( 153: if (hmf) 154: DeleteMetaFile(hmf); 155: DeleteObject(FBrush); 156: PostQuitMessage(0); 157: ) 158: 159: ZZ/Z///Z////////////////////////// 160: ZZ Обработчик сообщения WM_COMMAND 161: /ZZZZZZ///Z/////////////////////// 162: ((pragma argsused 163: void Meta_OnCommand(HWND hwnd, int id, HWND hwndctl, UINT codeNotify) 164: ( 165: switch (id) 166: ( 167: case CM_STARTMETA: 168: GooberDC = CreateMetaFile(TempName); 169: break; 170: 171: case CM_ENDMETA: 172: TurnOffSave(hwnd); 173: if (hmf) 174: DeleteMetaFile(hmf) ; 175: hmf = CloseMetaFile(GooberDC) ; 176: SaveFile(hwnd, TempName); 177: break; 178: 179: case CM_NEWMETA: 180: CreateMeta(hwnd);
181: break; 182: 183: 184: 185: 186: 187: 188: 189: 190: 191: case CM—LOAD: TurnOffSave(hwnd); • LoadFile(hwnd); break; case CM_EXIT: DestroyWindow(hwnd) ; break; 192: 193: 194: 195: case CM_RECTANGLE: Dat-Shape = RECTANGLE; break; 196: 197: 198: 199: 200: 201: 202: 203: 204: 205: 206: 207: 208: 209: 210: 211: 212: 213: 214: 215: 216: 217: 218: 219: 220: 221: 222: 223: 224: 225: 226: 227: 228: 229: 230: 231: 232: 233: 234: 235: 236: 237: 238: 239: 240: 241: 242: 243: 244: 245: 246: 247: 248: 249: 250: 251: 252: 253: 254: 255: case CM_ERECTANGLE: Dat.Shape = ERECTANGLE; break; case CM_ELLIPSE: Dat.Shape = ELLIPSE; break; case CMJLINE: Dat.Shape = LINE; break; case CM_RED: Dat.Color = RGBJ255, 0, 0) ; break; case CM_GREEN: Dat.Color = RGB(0, 255, 0); break; case CM_BLUE: Dat.Color = RGB(0, 0, 255); break; case CM_FRED: DeleteBrush(FBrush); FBrush = CreateSolidBrush(RGB(255, 0, 0)); break; case CM_FGREEN: DeleteBrush(FBrush); FBrush = CreateSolidBrush(RGB(0, 255, 0)); break; case CM_FBLUE: DeleteBrush(FBrush) ; FBrush == CreateSolidBrush(RGB(0, 0, 255)); break; case CM_ONE: Dat.Thickness = 1; break; case CM_FIVE: Dat-Thickness - 5; break; case CM_TEN: Dat.Thickness = 10; break; case CM-TWENTY: Dat.Thickness = 20; break; case CM-FORTY: Dat.Thickness = 40; break; case CM EIGHTY: 12 Чарльз Калверт
256: Dat.Thickness = 80; 257: break; 258: } 259: } 260: 261: ///////////////////////////////////// 262: // DRAWSHAPE 263: ///////////////////////////////////// 264: ttpragma argsused 265: void DrawShape(HWND hwnd, HDC PaintDC, RECT R) 266: ( 267: switch(Dat.Shape) 268: ( 269: 270: case ELLIPSE: 271: Ellipse(PaintDC, R.left, R.top, R.right, R.bottom); 272: break; 273: 274: case LINE: 275: MoveTo(PaintDC, R.left, R.top); 276: LineTo(PaintDC, R.right, R.bottom); 277: break; 278: 279: case ERECTANGLE: 280: case RECTANGLE: 281: Rectangle(PaintDC, R.left, R.top, R.right, R.bottom); 282: break; 283: } 284: ) 2 85 * 286: /////./////////////////////////// 287: II DrawFinalShape 288: llllllllllllllllllllllllllllllll 289: ftpragma argsused 290: void DrawFinalShape(HWND hwnd, HDC PaintDC, RECT R) 291: ( 292: HBRUSH B, OldBrush, OldGBrush; 293: 294: HPEN Pen = CreatePen(PS_INSIDEFRAME, Dat.Thickness, Dat.Color); 295: HPEN OldPen = SelectPen(PaintDC, Pen); 296: HPEN OldGPen - SelectPen(GooberDC, Pen); 297: 298: switch(Dat.Shape) 299: ( 300: case ELLIPSE: 301: OldBrush = SelectBrush(PaintDC, FBrush); 302: OldGBrush « SelectBrush(GooberDC, FBrush); 303: Ellipse(PaintDC, R.left, R.top, R.right, R.bottom); 304: Ellipse(GooberDC, R.left, R.top, R.right, R.bottom); 305: SelectObject(PaintDC, OldBrush); 306: SelectBrush(GooberDC, OldGBrush); 307: break; 308: 309: case LINE: 310: MOveTo(PaintDC, R.left, R.top); 311: LineTo(PaintDC, R.right, R.bottom); 312: MoveTo(GooberDC, R.left, R.top); 313: LineTo(GooberDC, R.right, R.bottom); 314: break; 315: 316: case RECTANGLE: 317: OldBrush = SelectBrush(PaintDC, FBrush); 318: OldGBrush = SelectBrush(GooberDC, FBrush); 319: Rectangle(PaintDC, R.left, R.top, R.right, R.bottom); 320: Rectangle(GooberDC, R.left, R.top, R.right, R.bottom); 321: SelectObject(PaintDC, OldBrush); 322: SelectBrush(GooberDC, OldGBrush); 323: break; 324: 325: case ERECTANGLE: 326: В = GetStockBrush(NULLJBRUSH); 327: OldBrush = SelectBrush(PaintDC, B); 328: OldGBrush = SelectBrush(GooberDC, B); 329: Rectangle(PaintDC, OldRect.left, 330: OldRect.top, OldRect.right, OldRect.bottom);
331: Rectangle(GooberDC, OldRect.left, 332: OldRect.top, OldRect.right. OldRect.bottom); 333: SelectObject(PaintDC, OldBrush); 334: SelectBrush(GooberDC, OldGBrush); 335: break; 336: ) 337: SelectObject(PaintDC, OldPen); 338: SelectObject(GooberDC, OldGPen); 339: DeleteObject(Pen); 340: ) 341: 342: /////////////////////////////////////////// 343: // Обработчик сообщения WM_MOUSEMOVE 344: lllllllllllllllllllllllllllllllllllllllllll 345: itpragma argsused 346: void Meta_OnMouseMove(HWND hwnd, int x, int y, UINT keyFlags) 347: ( 348: if (Dat.ButtonDown) 349: ( 350: Dat.Drawing = TRUE; 351: 352: HDC PaintDC = GetDC(hwnd); 353: 354: SetROP2 (PaintDC, R2_NOTXORPEN) ; 355: if (OldRect.left != -32000) 356: DrawShape(hwnd, PaintDC, OldRect); 357: OldRect.left = Dat.DownX; 358: OldRect.top = Dat.DownY; 359: OldRect.right = x; 360: OldRect.bottom = y; 361: DrawShape(hwnd, PaintDC, OldRect); 362: ReleaseDC(hwnd, PaintDC); 363: ) 364: ) 365: 366: //////////////////////////// 367: // WM_LBUTTONDOWN 368: //////////////////////////// 369: йргадта argsused 370: void Meta_OnLButtonDown(HWND hwnd, BOOL fDoubleClick, int x, 371: int y, UINT keyFlags) 372: ( 373: Dat.ButtonDown = TRUE; 374: Dat.Drawing = FALSE; 375: OldRect.left = -32000; 376: Dat.DownX = x; 377: Dat.DownY = y; 378: Setcapture(hwnd); 379: ) 380: 381: ////////////////////////////////////////////// 382: U WMLBUTTONUP 383: ////////////////////////////////////////////// 384: itpragma argsused 385: void Meta_OnLButtonUp(HWND hwnd, int x, int y, UINT keyFlags) 386: ( 387: if ((Dat.ButtonDown) && (Dat.Drawing)) 388: ( 389: Dat.Drawing = FALSE; 390: HDC PaintDC = GetDC(hwnd); 391: DrawFinalShape(hwnd, PaintDC, OldRect); 392: ReleaseDC(hwnd, PaintDC); 393: ReleaseCapture(); 394: ) 395: Dat.ButtonDown = FALSE; 396: ) 397: 398: /////////////////////////////////////////////// 399: // WMPAINT 400: /////////////////////////////////////////////// 401: void Meta_OnPaint(HWND hwnd) 402: ( 403: HDC PaintDC; 404: PAINTSTRUCT PaintStruct; 405: RECT R;
406. 407: GetClientRect(hwnd, SR); 408: 409: PaintDC = BeginPaint(hwnd, SPaintStruct); 410: 411. if (IsAldusFile()) 412: ( 413: SetMapMode (PaintDC, MM_ANISOTROPIC) ; 414: SetWindowExt(PaintDC, 1000, 1000); 415: SetViewportExt(PaintDC, R.right, R.bottom); 416: SetWindowOrg(PaintDC, R.right / 2, R.bottom / 2); 417: PlayMetaFile(PaintDC, hmf); 418: ) 419: else 420: if(hmf) EnumTheMeta(hwnd, hmf); 421: 422: EndPaint(hwnd, SPaintStruct); 423: ) Листинг 18.3. META.H 1: ////////////////////////////////////// 2: И Модуль: META.H 3: // Автор: Чарли Калверт 4: II Описание: Часть проекта Meta 5: ///////////////////////////////////// 6: 7: // Константы 8: «define CMEXIT 101 9: «define CM LOAD 102 10: «define CMNEWMETA 103 11: «define CM_STARTMETA 104 12: «define CM_ENDMETA 105 13: 14: «define CM_LINE 201 15: «define CMELLIPSE 202 16: «define CM_RECTANGLE 203 17: «define CM ERECTANGLE 204 18: 19: «define CMRED 301 20: «define CM GREEN 302 21: «define CMBLUE 303 22: 23: «define CM_FRED 401 24: «define CM_FGREEN 402 25: «define CMFBLUE 403 26: 27: «define CMONE 501 28: «define CMFIVE 502 29: «define CMTEN 503 30: «define CMTWENTY 504 31: «define CM_FORTY 505 32: «define CMEIGHTY 506 33: 34: «define MAXSIZE 256 35: 36: // Типы 37: enum TShape (ELLIPSE, LINE, RECTANGLE, ERECTANGLE); 38: 39: struct TDATA ( 40: int DownX, DownY; 41: BOOL ButtonDown; 42: BOOL Drawing; 43: TShape Shape; 44: int Thickness; 45: COLORREF Color; 46: ); 47: 48: // Объявления для класса Meta 49: «define Meta_DefProc DefWindowProc - 50: BOOL Meta_OnCreate (HWND hwnd, CREATESTRUCT FAR* IpCreateStruct); 51: void Meta_OnDestroy(HWND hwnd); 52: void Meta_OnCommand(HWND hwnd, int id, HWND hwndctl, UINT codeNotify); 53: void Meta_OnLButtonDown(HWND hwnd, BOOL fDoubleClick, int x, int y, 54: UINT keyFlags);
55: void MetaOnLButtonUp(HWND hwnd, int x, int y, UINT keyFlags); 56: void Meta_OnMouseMove(HWND hwnd, int x, int y, UINT keyFlags); 57: void Meta_OnPaint(HWND hwnd); 58: 59: // Функции 60: LRESULT CALLBACK _export WndProc(HWND hwnd, UINT Message, 61: WPARAM wParam, LPARAM IParam) ; 62: BOOL Register(HINSTANCE hlnst); 63: HWND Create(HINSTANCE hlnst, int nCmdShow); Листинг 18.4. METAUTIL.CPP 1: ////////////////////////////////////// 2: // Программа: METAUTIL.CPP 3: // Автор: Чарли Калверт 4: // Описание: Часть проекта Meta 5: // Дата: 4/17/93 6: ////И И И И И И И И ////И И И И И / И / 7: 8: «define STRICT 9: «include <windows.h> 10: «include <windowsx.h> 11: «pragma hdrstop 12: «include <commdlg.h> 13: «include <string.h> 14: «include <direct.h> 15: «include <stdio.h> 16: «include <stdlib.h> 17: «include "metaphor.h" 18: «include "metautil.h" 19: «pragma warning (disable: 4068) 20: extern HMETAFILE hmf; 21: static METAHEADER mfHeader; 22: static BOOL bMetalnRam; 23: static BOOL IsAldus; 24: 25: ////////////////////////////////////////////// 26: // CreateMeta 27: ////////////////////////////////////////////// 28: «pragma argsused 29: void CreateMeta(HWND hwnd) 30: ( 31: HDC MetaDC; 32: HPEN OldPen; 33: char FName[256]; 34: 35: _getdcwd(0, FName, MAXSIZE); 36: strcat (FName, "Wquickmet.wmf"); 37: MetaDC = CreateMetaFile(FName); 38: if (MetaDC != NULL) 39: ( 40: HPEN Pen = CreatePen(PS_SOLID, 10, RGB(0, 255, 127)); 41: OldPen = SelectPen(MetaDC, Pen); 42: Ellipse(MetaDC, 200, 200, 100, 100); 43: SelectObject(MetaDC, OldPen); 44: DeleteObject(Pen); 45: Pen = CreatePen(PS_SOLID, 10, RGB(255, 0, 0)); 46: OldPen = SelectPen(MetaDC, Pen); 47: Rectangle(MetaDC, 20, 20, 100, 100); 48: SelectObject(MetaDC, OldPen); 49: DeleteObject(Pen); 50: hmf = CloseMetaFile(MetaDC); 51: ) 52: ) 53: 54: //////////////////////////////////////// 55: // IsAldusFile 56: //////////////////////////////////////// 57: BOOL IsAldusFile(void) 58: ( 59: return Is Aldus; 60: ) 61: 62: /////////////////////////////////////////// 63: // ReadPlaceableHeader
64: /////////////////////////////////////////// 65: BOOL ReadPlaceableHeader(HWND hwnd, HFILE fh) 66: ( 67: char ‘ErrString = "Error reading placeable header"; 68: int wBytesRead; 69: ALDUSMFHEADER AldusMFHeader; 70: 71: wBytesRead = _ltead(fh, (LPSTR) SAldusMFHeader, sizeof (ALDUSMFHEADER) ) ; 72: if (wBytesRead == -1 I I wBytesRead < sizeof(ALDUSMFHEADER)) 73: ( 74: MessageBox (hwnd, ErrString, NULL, MB_OK I MB_ICONHAND) ; 75: return FALSE; 76: ) 77: return TRUE; 78: } 79: 80: ///////////////////////////////////////////// 81: // Чтение заголовка метафайла 82: ///////////////////////////////////////////// 83: BOOL ReadHeader(METAHEADER ‘mfHeader, HWND hwnd, HFILE fh) 84: { 85: int wBytesRead; 86: char * ErrString = "Error reading metafile header"; 87: 88: _llseek(fh, sizeof(ALDUSMFHEADER), 0); 89: wBytesRead = _lread(fh, (LPSTR)mfHeader, sizeof(METAHEADER))I 90: 91: if(wBytesRead == -1 II wBytesRead < sizeof(METAHEADER)) 92: ( 93: MessageBox(hwnd, ErrString, NULL, MB_OK I MB_ICONHAND); 94: return(FALSE); 95: ) 96: 97: return TRUE; 98: } 99: 100: //////////////////////////////////////////// 101: // Выделите память для метафайла 102: //////////////////////////////////////////// 103: HANDLE AllocMetaMemory(HWND hwnd, METAHEADER *mfHeader) 104: ( 105: char *ErrStringl = "Memory allocation error"; 106: HANDLE hMem; 107: 108: if (!(hMem = GlobalAlloc(GHND, (mfHeader->mtSize * 2L)))) 109: ( 110: MessageBox(hwnd, ErrStringl, NULL, MB_OK I MB_ICONHAND); 111: return hMem = 0; 112: } 113: return hMem; 114: ) 115: 116: BOOL ReadMetafileBits(HWND hwnd, HFILE fh, METAHEADER mfHeader, 117: LPSTR IpMem, HANDLE * hMem) 118: ( 119: int wBytesRead; 120: char *ErrString « "Unable to read metafile bits"; 121: 122: _llseek(fh, sizeof(ALDUSMFHEADER), 0); 123: wBytesRead = _lread(fh, IpMem, (WORD)(mfHeader.mtSize *2)); 124: 125: if (wBytesRead == -1) 126: ( 127: MessageBox(hwnd, ErrString, NULL, MB_OK I MB_ICONHAND); 128: GlobalUnlock(*hMem); 129: GlobalFree(*hMem); 130: return FALSE; 131: ) 132: return TRUE; 'ЗЗ: } ' /////////////////////////////////////////// .// RenderMeta .37://///////////////////////////////////////// 138: BOOL RenderPlaceableMeta(HWND hwnd, HFILE fh)
139: { 140: LPSTR IpMem; 141: HANDLE hMem; 142: 143: if ((bMetalnRam) St (hmf)) 144: DeleteMetaFile(hmf); 145: _llseek(fh, 0, 0); 146: 147: if ('ReadPlaceableHeader(hwnd, fh)) return FALSE; 148: if ('ReadHeader(smfHeader, hwnd, fh)) return FALSE; 149: if (!(hMem = AllocMetaMemory(hwnd, KmfHeader))) return FALSE 150: IpMem = (LPSTR)GlobalLock(hMem); 151: if(!ReadMetafileBits(hwnd, fh, mfHeader, IpMem, &hMem)) 152: return FALSE; 153: if(!(hmf = SetMetaFileBits(hMem))) return(FALSE); 154: GlobalUnlock(hMem); 155: return(TRUE); 156- ) 157: 158: ///////////////////////////////////////// 159: // OpenMetaFile 160: lllllllllllllllllllllllllllllllllllllllll 161: BOOL OpenMetaFile(HWND hwnd, char * IpFileName) 162: ( 163: HFILE fh; 164: int wBytesRead; 165: LONG dwIsAldus; 166: 167: fh = _lopen(lpFiieName, OF_READ); 168: 169: if (fh != -1) 170: ( 171: // See if it is a placeable wmf 172: wBytesRead = 173: _lread(fh,(LPSTR)SdwIsAldus, sizeof(dwIsAldus)); 174: if (wBytesRead == -1 I I wBytesRead < sizeof(dwIsAldus)) 175: ( 176: _lclose (fh); 177: MessageBox(hwnd, "unable to read file", NULL, 178: mb_ok | mbiconexclamation); 179: return (FALSE); 180: ) 181: 182: if (dwIsAldus != ALDUSKEY) 183: ( 184: IsAldus = FALSE; 185: hmf = GetMetaFile(IpFileName); 186: ) 187: else 188: ( 189: IsAldus = TRUE; 190: RenderPlaceableMeta(hwnd, fh); 191: ) 192: Iclose(fh); 193: ) 194: return TRUE ; 195: ) 196: 197: /////////////////////////////////////// 198: // GetFileName 199: /////////////////////////////////////// 200: char * GetFileName(HWND hwnd, char * szFile, int Stringsize) 201: ( 202: OPENFILENAME ofn; 203: char szDirName[256]; 204: char szFileTitle[256]; 205: char szFilter[256] ; 206: 207: memset(sofn, 0, sizeof(OPENFILENAME)); 208: strepy(szFilter, "Metafiles"); 209: strepy(SszFilter [strlen(szFilter) + 1], "*.wmf"); 210: 211: ofn.istructsize = sizeof(OPENFILENAME); 212: ofn.hwndOwner = hwnd; 213: ofn.IpstrFilter = szFilter;
214: ofn.nFilterlndex = 1; 215: ofn.lpstrFile= szFile; 216: ofn.nMaxFile = stringsize; 217: ofn.IpstrFileTitle = szFileTitle; 218: ofn.nMaxFileTitle = sizeof(szFileTitle); 219: ofn.IpstrlnitialDir = szDirName; 220: ofn.Flags = OFN_FILEMUSTEXIST; 221: 222: GetOpenFileName(Sofn); 223: 224: return szFile; 225: } 226: 227: /////////////////////////////////////// 228: // LoadFile 229: llllll/lllllllllllllllll/lllllllll/llll 230: void LoadFile(HWND hwnd) 231: ( 232: char S[100]; 233: bMetalnRam = TRUE; 234: rnemsetfSS, 0, 100); 235: 236: GetFileName(hwnd, S, 100); 237: 238: OpenMetaFile (hwnd, S) ; 239: 240: if (!hmf) 241: MessageBox (hwnd, "No Meta", "sdf", MB_OK); 242: 243: InvalidateRect(hwnd, NULL, TRUE); 244: 245: } 246: 247: //////////Z//////////////////////////// 248: // GetSaveName 249: ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ 250: char *GetSaveName(HWND hwnd, char *SaveName) 251: ( 252: OPENFILENAME ofn; 253: char szDirName (256]; 254: char szFile(256], szFileTitle(256]; 255: UINT i; 256: char chReplace; 257: char szFilter(256]; 258: 259: _getdcwd(0, szDirName, 255); 260: 261: strcpy(szFilter, 262: "Metafiles(*.wmf) |*.wmfI Bitmap Files(*.bmp) I *.bmp|"); 263: chReplace = szFilter[strlen(szFilter) - 1]; 264: for (i = 0; szFilter(i) != '\0'; i++) 265: ( 266: if (szFilter[i] chReplace) 267: szFilterfi] = '\0'; 268: ) 269: 270: Z* Обнуление всех полей структуры */ 271: 272: memset(4ofn, 0, sizeof(OPENFILENAME)); 273: 274: /* Инициализация полей OPENFILENAME */ 275: 276: szFilefO] = '\0'; 277: 278: ofn.IStructSize = sizeof(OPENFILENAME); 279: ofn.hwndOwner = hwnd; 280: ofn.IpstrFilter = szFilter; 281: ofn.lpstrFile= szFile; 282: ofn.nMaxFile = sizeof(szFile); 283: ofn.IpstrFileTitle = szFileTitle; 284: ofn.nMaxFileTitle = sizeof (szFileTitle); 285: ofn.IpstrlnitialDir = szDirName; 286: 287: ofn.Flags = OFN_OVERWRITEPROMPT; 288:
289: if (GetSaveFileName(&ofn)) 290: strepy(SaveName, ofn.IpstrFile); 291: else 292: strepy(SaveName, ""); 293: 294; return SaveName; 295: } 296: 297: int FileExists(const char *path) 298: ( 299: FILE *f = fopenfpath, "r"); 300; if (If) 301: return FALSE; 302: else 303: ( 304; fclose(f); 305: return TRUE; 306: ) 307: ) 308: 309; void SaveFile(HWND hwnd, char * OldName) 310: ( 311: char Name[256]; 312: int i; 313: 314: GetSaveName(hwnd, Name); 315: 316: if (strlen(Name) == 0) return; 317: 318: if (FileExists(Name)) 319: ( 320: i = remove(Name); 321: if (i != 0) 322: MessageBox(hwnd, "Error deleting", "No", MB_OK); 323: ) 324: 325: i = rename(OldName, Name); 326: if (i != 0) 327: MessageBox (hwnd, "Error renaming", "No", MB__OK) ; 328: 329: OpenMetaFile(hwnd. Name); 330: ) 331: 332: void TurnOffSave(HWND hwnd) 333: ( 334: HMENU hMenu = GetMenu (hwnd) ; 335: EnableMenuItem (hMenu, CM_ENDMETA, MF_BYCOMMAND | MF_GRAYED) ; 336: ) Листинг 18.5. METAUTIL.H 1: 2; 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: /////////////////////////////////////////// // Модуль: METAUTIL.H // Автор: Чарли Калверт // Описание: Часть проекта Meta /////////////////////////////////////////// tfdefine ALDUSKEY // Типы typedef struct ( DWORD key; HANDLE hmf; RECT bbox; WORD inch; DWORD reserved; WORD checksum; ) ALDUSMFHEADER; 0x9AC6CDD7L 19: // Процедуры 20: void CreateMeta(HWND hwnd); 21: void LoadFile(HWND hwnd); 22: BOOL IsAldusFile(void) ; 23: void SaveFile(HWND hwnd, char * OldName); 24: void TurnOffSave(HWND hwnd);
Листинг 18.6. METAENUM.CPP 1: //////////////////////////////////////////////////////// 2: // Программа: METAENUM.CPP 3: // Автор: Чарли Калверт 4: // Описание: Часть проекта Meta 5: // Дата: 7/23/93 6: //////////////////////////////////////////////////////// 7: В: «define STRICT 9: «include <windows.h> 10: «include <windowsx.h> 11: «pragma warning (disable: 4068) 12: int CALLBACK EnumMetaFileProc (HDC hdc, HANDLETABLE FAR* IpHTable, 13: METARECORD FAR* IpMFR, int cOb j , BYTE FAR* IpClientData); 14: 15: /////////////////////////////////// 16: // EnumTheMeta 17: /////////////////////////////////// 18: void EnumTheMeta (HWND hwnd, HMETAFILE AMeta) 19: { 20: MFENUMPROC IpEnumMetaProc; 21: HDC PaintDC; 22: HINSTANCE hlnst; 23: 24: PaintDC = GetDC(hwnd); 25: hlnst = (HINSTANCE) GetClassWord (hwnd, GCWHMODULE); 26: IpEnumMetaProc = (MFENUMPROC) MakeProcInstance( 27: (FARPROC) EnumMetaFileProc, hlnst); 28: EnumMetaFile(PaintDC, AMeta, IpEnumMetaProc, NULL); 29: FreeProcInstance((FARPROC) IpEnumMetaProc); 30: 31: ReleaseDC(hwnd, PaintDC); 32: ) 33: 34: // 35: // Обработчики перечисляемых объектов и т.д. 36: // 37: 38: /////////////////////////////////// 39: // EnumMetaFileProc 40: /////////////////////////////////// 41: «pragma argsused 42: int CALLBACK EnumMetaFileProc(HDC hdc, HANDLETABLE FAR* IpHTable, 43: METARECORD FAR* IpMFR, int CObj, BYTE FAR* IpClientData) 44: ( 45: PlayMetaFileRecord(hdc, IpHTable, IpMFR, cObj); 46: return 1; 47: ) Листинг 18.7. METAENUM.H 1: ////////////////////////////////////////////////////// 2: // Программа: METAENUM.H 3: // Автор: Чарли Калверт 4: // Описание: Часть проекта Meta5: 5: // Дата: 7/23/93 6: ////////////////////////////////////////////////////// 7: 8: void EnumTheMeta (HWND hwnd, HMETAFILE AMeta); Листинг 18.8. METAPHOR.RC 1: /////////////////////////////////////////////// 2: // Файл: METAPHOR.RC 3: // Описание: Файл ресурсов для проекта Metaphor 4: /////////////////////////////////////////////// 5: «include "metaphor,h" 6: 7: // Head2 METAFILE "head2.wmf" 8: 9: MetaMenu MENU 10: BEGIN 11: POPUP "SFile"
12: BEGIN 13: MENUITEM "Load", CM_LOAD; 14: MENUITEM SEPARATOR; 15: MENUITEM "Save Meta", CM_ENDMETA; 16: MENUITEM SEPARATOR; 17: MENUITEM "Quick Meta", CM_NEWMETA; 18: MENUITEM SEPARATOR; 19: MENUITEM "Exit", CM_EXIT; 20: END 21: 22: POPUP "SShape" 23: BEGIN 24: • MENUITEM "Line", CM_LINE; 25: MENUITEM "Ellipse" , CM_ELLIPSE; 26: MENUITEM "Rectangle", CM_RECTANGLE; 27: MENUITEM "Empty Rectangle", CM_ERECTANGLE; 28: END 29: 30: POPUP "SPenColor" 31: BEGIN 32: ' MENUITEM "Red" , CM_RED ; 33: MENUITEM "Green" , CM_GREEN ; 34: MENUITEM "Blue" , CM_BLUE ; 35: END 36: 37: POPUP "sFillColor" 38: BEGIN 39: MENUITEM "Red", CM_FRED; 40: MENUITEM "Green", CM_FGREEN; 41: MENUITEM "Blue", CM_FBLUE; 42: END 43: 44: POPUP "Pen_SSize" 45: BEGIN 46: MENUITEM "1", CM_ONE; 47: MENUITEM "5", CM_FIVE; 48: MENUITEM "10”, CM_TEN; 49: MENUITEM "20", CM_TWENTY; 50: MENUITEM ”40", CM_FORTY; 51: MENUITEM "80", CM_EIGHTY; 52: END 53: END Листинг 18.9. METAPHOR.DEF 1: ; METAPHOR.DEF 2: 3: NAME Metaphor 4: DESCRIPTION 'Metaphor Windpw' 5: EXETYPE WINDOWS 6: STUB 'WINSTUB.EXE' 7: HEAPSIZE 4096 8: STACKSIZE 5120 9: CODE PRELOAD MOVEABLE DISCARDABLE 10: DATA PRELOAD MOVEABLE MULTIPLE Листинг 18.10. METAPHOR.MAK (Borland) 1: # METAPHOR.MAK 2: 3: # Макросы 4: APPNAME = Metaphor 5: OBJS = MetaUtil.obj MetaEnum.obj 6: INCPATH = C:\BC\INCLUDE 7: LIBPATH = C:\BC\LIB 8: FLAGS = -H -ml -W -v -w4 -ml -1$ (INCPATH) -L$ (LIBPATH) 9: 10: * Компоновка 11: $ (APPNAME) .exe: $ (APPNAME) .obj $(OBJS) $ (APPNAME) .def $ (APPNAME) .res 12: bcc $ (FLAGS) $ (APPNAME) . obj $ (OBJS) 13: brc $ (APPNAME) 14: 15: # Компиляция 16: .cpp.obj:
17: bcc -с SIFl.AGS) ( S< ) 1ft: 19: # Ресурсы 20: $ (APPNAME) .RES: $ (APPNAME) .rc 21: brc -r -i$(INCPATH) $(ЛРГКАМЕ).rc Листинг 18.11. METAPIIOR.MAK (Microsoft) 1: #— 2: D METAPIIOR.MAK 3: 4: 5: APPNAME - Metaphor 6: OBJS — MetaUtil.obj MetaEr.um.obj 7: 8: ft Ксмпоногка 9: S (APPNAME) . exe : $ (APPNAME) .obj $ (CBJS) $ (APPNAME) .def $ (APPNAME) .res 10: link S (APPNAME) S(CBJS), /align: 16, KUL,\ 11: /nod ll-bcew libw ccmmdlg, $(APPNAME) 12: rc $(APPNAME).res 13: ft Компиляция 14: .cpp.obj: 15: cl -c AL -Gsw GA -Cw -W3 -AL -Zp { 5< ) 16: 17: ft Компиляция ресурсов 18: $(APPNAME).res: S (APPNAME). rc 19: rc -r $(APPNAME).rc Гис. 18.3. Программа Metupl or может использоваться для построения простых геометрических фигур Программа Metaphor позволяет вычерчивать мышью прямые лин1 и, прямоугольники и эллипсы в основном окне. С помощью меню вы можете изменять цве1 и толщину пера, обводящего каждую фигуру, а также цвет сплошной заливки каждой фигуры. Программа Metaphor позволяет сохранять созданные вами изображения и перезагру- жать их вновь. Из соображений упрощения Metaphor разрешает создавать только одну фигуру за сеанс, и вы должны создать эту фигуру прежде чем загрузите какие-либо другие файлы. Вы не сможете редактировать свои конструкции, однако эту способность можно будет добавить Кроме создания метафайлов, программа Metaphor также предусматривает возмож- ность загрузки и показа этих графических изображений. Программа способна читать и визуально отображать так называемые “Aldus-метафайлы”, имеющие заголовки, слегка отличающиеся от стандартных метафайлов Windows. Metaphor проверяет каждый мета- файл, который вы собираетесь прочитать и выбирает подходящие методы загрузки и отображения на экране.
Остаток этой главы разделяется на три части: 1. Исследование резинки — техники, использующейся для динамического вычерчи- вания фигур на экране мышью. 2. Исследование создания, чтения и записи метафайлов. 3. Краткое введение в стандартные диалоги — тема, продолжающаяся и в следующей главе. Принцип резинки Прежде чем читать эту главу, погоняйте программу Metaphor и попрактикуйтесь в рисовании на экране эллипсов и прямоугольников, чтобы посмотреть, как действует принцип резинки. Если по какой-то причине вы не можете запустить программу Metaphor, откройте Windows Paintbrush и нарисуйте несколько квадратов и кругов с помощью соответствующих средств из меню Tools. Понаблюдайте за способом, которым эти программы создают эластичные квадраты или круги, которые можно таскать по рабочей поверхности стола. Поиграйте с этими фигурами, пока не определите, какие размеры и положения предпочесть для ваших геометрических форм. Создание подобных средств может показаться довольно сложным, но благодаря Windows API исходный код относительно прост. Ниже приводятся основные шаги этого процесса, каждый из которых будет подробнее разобран далее в этом разделе: 1. Когда пользователь щелкает левой кнопкой мыши, Metaphor запоминает коорди- наты х и у из сообщения WM LBUTTONDOWN. 2. Когда пользователь тянет мышь по экрану, не отпуская левую кнопку, Metaphor рисует квадрат или круг всякий раз, когда получает сообщение WMJMOUSEMOVE. Прежде чем изобразить новую фигуру, программа стирает предыдущий круг или квадрат. Размеры новой фигуры вычисляются посредством комбинирования координат исходно- го сообщения WM_LBUTTONDOWN с текущими координатами, передающимися в сообщении WM_MOUSEMOVE. 3. Когда пользователь генерирует сообщение WM_LBUTTONUP, Metaphor форми- рует окончательное изображение фигуры с учетом цвета и размера пера, указанных пользователем. Хотя очевидно, что в этом описании пропущены некоторые важные детали, очерта- ния алгоритма должны оформиться в вашем сознании в виде нескольких относительно простых логических ходов. При дальнейшем обдумывании все может показаться не- сколько сложнее, но основные шаги должны быть относительно ясны. Начнем разбор деталей с рассмотрения ответа на сообщение WM LBUTTONDOWN (строчки 370-379): 370: void Meta_OnLButtonDown(HWND hwnd, BOOL fDoubleClick, int x, 371: int y, UINT keyFlags) 372: { 373: Dat.ButtonDown = TRUE; 374: Dat.Drawing = FALSE; 375; OldRect.left = -32000; 376: Dat.DownX = x; 377: Dat.DownY = y; 378: SetCapture(hwnd); 379: ) После инициализации некоторых переменных конечные шаги в Meta OnLButton- Down заключаются в запоминании места события и “захвате” мыши. Обращение к SetCapture необходимо, поскольку пользователь может вывести мышь за пределы окна в процессе рисования фигуры. В этом-случае смена фокуса была бы нежелательна. После того как левая кнопка мыши нажата, программа улавливает все сообщения WM_MouseMove, направляющиеся в Metaphor (строчки 346-364): 346: void MetaOnMouseMove(HWND hwnd, int x, int y, UINT keyFlags) 347: ( 348: if (Dat.ButtonDown) 349: ( 350: Dat.Drawing = TRUE; 351:
352: HDC PaintDC = GetDC(hwnd); 353: 354: SetR0P2(PaintDC, R2 N0TX0RPEN) ; 355: if (OldRect.left != -32000) 356: Drawshape(hwnd, PaintDC, OldRect); 357: OldRect.left = Dat.DownX; 358: OldRect.top = Dat.DownY; 359: OldRect.right = x; 360: OldRect.bottom = y; 361: Drawshape(hwnd, PaintDC, OldRect); 362: ReleaseDC(hwnd, PaintDC); 363: ) 364: } В первой строчке этой функции используется один из нескольких возможных способов проверки, нажата ли левая кнопка мыши. Если кнопка не нажата, то функция игнорирует сообщение. Если кнопка нажата, функция берет контекст устройства, устанавливает режим рисования R2_NOTXORPEN, запоминает текущие размеры фигу- ры, рисует ее и освобождает контекст устройства. Функция SetR0P2 устанавливает текущий режим рисования таким же способом, каким устанавливается текущий режим визуального отображения в последнем параметре функции BitBlt. В данном случае Metaphor использует логические операции XOR и NOT для передачи на экран эластичного изображения. Эти логические операции выбираются потому, что рисуют старую фигуру непосредственно по исходному изображению, тем самым эффективно стирая каждую фигуру: Если вы передадите на экран квадрат с помощью XOR, то он будет отчетливо виден. Если вы снова передадите с помощью этой же операции тот же самый квадрат в то же самое место, то квадрат исчезнет. Таковы достоинства простых логических операций в режиме графики. Замечание. Фанаты графической логики заметят, что логическая операция, использующаяся в Metaphor, является вариацией исключающего ИЛИ. Эта вариация гарантирует, что заливка в центре рисуемой фигуры не “замажет” того, что находится под ней. В документации фирмы Microsoft разница объяснена следующим образом: R2_XOR: final pixel = реп л screen pixel R2 NOTXORPEN: final pixel = -(pen л screen pixel) He стоит терять слишком много времени на осмысливание того, что такое логические операции и как они работают. Если они интересуют вас, то это хорошо; если нет, тоже неплохо. Предмет этой книги составляет программирование, а не логика. Функция SetROP2 int SetROP2(HDC, int) hdc hdc; Контекст устройства int fnDrawMode; Режим рисования SetROP2 определяет свойства текущего режима рисования. Точнее, она определяет, как перо и внутренность объекта должны сочетаться с текущим содержимым экрана. Второй параметр может содержать широкий ряд возможных операций, которые перечислены в WINDOWS.H и в ваших интерактивных файлах помощи. Приведем некоторые из них: R2JBLACK R2_WHITE R2_NOP R2_NOT r2_COPYPEN Рисует фигуру черными пикселами Рисует фигуру белыми пикселами Не меняет пикселов Инвертирует цвет пиксела по отношению к цвету экрана Придает пикселу цвет текущего пера
Пример: SetROP2(PaintDC, R2_N0T); Заметьте, что Meta_OnMouseMove вызывает DrawShape дважды. В первый раз передаются размеры старой фигуры, которую требуется стереть. Это означает, что выполняется операция исключающего ИЛИ исходного изображения с самим собой, то есть стирание. Затем Meta_OnMouseMove записывает место последнего сообщения WM_MOUSEMOVE и передает эту новую информацию в DrawShape, которая рисует новое изображение на экране. Весь этот процесс повторяется вновь и вновь (с неверо- ятной скоростью), пока пользователь не отпустит левую кнопку мыши. В функции Drawlmage (строчка 265) Metaphor сначала проверяет, какую фигуру выбрал пользователь, а затем изображает эту фигуру на экране, используя перо и цвет заливки, установленные по умолчанию. Последний шаг этой операции происходит, когда пользователь отпускает кнопку мыши: 385: void Meta_OnLButtonUp(HWND hwnd, int x, int y, UINT keyFlags) 386: ( 387: if ((Dat.ButtonDown) && (Dat.Drawing)) 388: ( 389: Dat.Drawing = FALSE; 390: HDC PaintDC = GetDC(hwnd); 391: DrawFinalShape(hwnd, PaintDC, OldRect); 392: ReleaseDC(hwnd, PaintDC); 393: ReleaseCapture!); 394: ) 395: Dat.ButtonDown = FALSE; 396: ) Этот код проверяет, нажата ли кнопка мыши и рисует ли пользователь фигуру. Если это так, то происходит следующее: Устанавливается флажок, говорящий о том, что пользователь решил прекратить рисование. И Окончательная фигура визуально отображается на экране. “Захваченная” мышь освобождается. Код, визуально отображающий результирующую фигуру, принимает во внимание цвет и толщину пера, выбранные пользователем из меню. Следующий фрагмент Draw- FinalShape (строчка 290) показывает, что происходит: 294: HPEN Pen = CreatePen(PSINSIDEFRAME, Dat.Thickness, Dat.Color); 295: HPEN OldPen = SelectPen(PaintDC, Pen); 296: HPEN OldGPen = SelectPen(GooberDC, Pen); 297: 298: switch(Dat.Shape) 299: ( 300: case ELLIPSE: 301: OldBrush = SelectBrush(PaintDC, FBrush); 302: OldGBrush = SelectBrush(GooberDC, FBrush); 303: Ellipse (PaintDC, R.left, R.top, R.right, R.bottom); 304: Ellipse(GooberDC, R.left, R.top, R.right, R.bottom); 305: SelectObject(PaintDC, OldBrush); 306: SelectBrush(GooberDC, OldGBrush); 307: break; ... // код для вычерчивания прямоугольников, прямых и т.д. Metaphor создает перо указанного цвета и толщины, а затем копирует выбранную пользователем кисть в контекст устройства. Вслед за этим происходит вычерчивание фигуры, и, наконец, программа тщательно убирает все за собой. Этот код можно рассматривать, как противоположный коду, рисующему эластичную форму. Рисуя “резин- ку” Metaphor полагается на кисть и перо, установленные по умолчанию, но использует тот же самый оператор switch и те же самые обращения к Ellipse, Rectangle и т.д..
Boi как вычерчиваются фигуры на экране с помощью столь популярного принципа резинки. Вообще говоря, если рассматривать этот процесс последовательно, то он нс кажется сложным. Однако дня того чтобы четко запомнить все его шаги, я повторю их снова: Запомнить, 1де произошло событие WM_LBUTTONDOWN. Постоянно рисовать фигуру при получении сообщения WM MOUSEMOVE. Начертить окончательную фшуру, получив сообщение WMLBUTTONUP. Ну вот, пожалуй, и все. Что такое метафайлы? Сочиняя программы для подобной книги, принимаешь конструктивные решения, основанные на нуждах читателей, а не пользователей. Например, в программе Metaphor содержится очень простая функция, создающая конструирующая и записывающая простейший метафайл QUICKMET.WMF на диск. Этот код не играет какой-либо функциональной роли в программе, а служит лишь образовательным целям. 29: void CreateMeta(HWKD hwnd) 30. ( 31: НЕС Hetarc; 32: HPF.N OldPen, 33: char FNar>e[256]; 34: 35: _getdcwd(0, FKamc, MAXSIZE); 36: strcat (FName, "Wquickmet.wmf"); 37: MetaDC = CreaieMetaFrle(FWane); 38: if (MetaDC NULL) 39: ( 40: HPEN Pen - CreatePen(PSSOLID, 10, RGB(0, 255, 127)); 41: OldPen - SelectPen(MetaDC, Pen); 42 : Ellipse (MetaDC, 2CC, 200, )0C, 100); 43: SelectObject(MetaDC, OldPen); 44: DeleteObject(Pen); 45: Pen - CreatePen(PS_SOLID, 10, FOB(255, O, 0)); 46: OldPen “ SelectPen(MetaDC, Pen); 47: Rectangle(MetaDC, 20, 20, ICO, 100); 48: SelectObject(MetaDC, OldPen); 49: DeleteObject(Pen); 50. hmf = CloseMetaFlJe(MetaDC), 51: ) 52: ) Если вы этого еще не сделали, запустите Metaphor, выберите из меню пункт Qinck Meta и загрузите файл QUICKMETA.WMF в основное окно. Результирующее изображение показано на рисунке 18 4 Рнс, 18.4. Метафайл, созданный функцией CreateMeta, состоит из двух простых геометрических фигур
В действительности предыдущий код содержит лишь одну-две новых идеи, хотя поначалу он может выглядеть слегка пугающим. Сперва по мановению руки создается правильное имя файла, а затем вызывается CreateMetaFile. Функция CreateMetaFile HOC CreateMetaFile (LPCSTR) lpcstr IpszFile: Строка, указывающая имя метафайла Функция CreateMetaFile возвращает подходящий контекст устройства для метафайла. Пример: MyMetaDC = CreateMetaFile ("с: WMetafile.wmf") ; После того как вы получили контекст устройства для метафайла, осталось лишь скопировать туда фигуры, перья и кисти так же, как вы делали бы это в случае работы с дисплейным контекс'гом. Затем вызовите CloseMetafile, передав в качестве единствен- ного параметра контекст устройства. Эта функция записывает файл на диск и возвращает дескриптор HMETAFILE копии метафайла в памяти. HMETAFILE — это что-то вроде HINSTANCE, HBITMAP или HPEN. Последний шаг состоит в том, чтобы показать метафайл пользователю с помощью несложной функции PlayMetaFile. Функция PlayMetaFile BOOL PlayMetaFile(hdc, hmf) HDC hdc; Контекст устройства для экрана или принтера HMETAFILE hmf; Дескриптор метафайла Функция PlayMetaFile воспроизводит метафайл на экране или на принтере. Заметьте, что контекст устройства в ее первом параметре не является контекстом устройства, содержащего метафайл; это контекст устройства, где файл будет визуально отображаться. Пример: PlayMetaFile(PaintDc, hmf); Словом, метафайл — это не что иное, как список структур, каждая из которых содержит информацию о вызовах таких основных GDI-функций, как Rectangle, Selec- tObject или Ellipse. Команда PlayMetaFile просто пробегает этот список, визуально отображая все фигуры по очереди, как определено. Наибольшее преимущество метафайлов — их чрезвычайная компактность. Полное растровое изображение 800x600 SuperVGA может использовать при записи на диск в качестве BMP свыше 200000 байтов. Эквивалентный метафайл будет занимать 200 или 300 байтов. Из соображений экономии диска вам следует всегда проверять, можно ли использо- вать метафайл вместо растрового изображения. В частности, это справедливо, если вы желаете работать с растровым изображением, имеющим размер свыше 64x64 пиксела. Повторим простейшие действия для создания метафайла: Вызвать функцию CreateMetaFile и запомнить возвращаемый контекст ею устройст- ва. Скопировать перья, кисти и фигуры, которые вы собираетесь использовать в контекст устройства. Вызвать CloseMetaFile для записи изображения на диск и получения дескриптора метафайла. Показать метафайл пользователю, вызвав PlayMetaFile.
Создание метафайлов в интерактивном режиме Из CreateMeta можно легко перейти в интерактивную систему, позволяющую поль- зователю проектировать собственные метафайлы. Фактически это цель кода, лежащего в основе программы Metaphor. Сперва Metaphor вызывает CreateMetaFile в ответ на определенное пользователем сообщение CMJSTARTMETA: 167: case CMJSTARTMETA: 168: GooberDC = CreateMetaFile(TempName); 169: break; Контекст устройства, полученный функцией CreateMetaFile. является глобальным по отношению к основному модулю программы; все указанные пользователем фигуры и цвета будут копироваться в него. Фактические фигуры, которые должны быть помещены в файл, определяются пользователем с помощью кода “резинки”. Когда выбранная пользователем фигура окончательно нарисована, ее тип, цвет и размеры также копируются в контекст устрой- ства метафайла. Чтобы посмотреть, как это работает, загляните вновь в функцию DrawFinalShape (строчка 290 METAPHOR.CPP): 290: void DrawFinalShape (HWND hwnd, HDC PaintDC, RECT R) 291: ( 292: HBRUSH B, OldBrush, OldGBrush; 293: 294: HPEN Pen = CreatePen(PS_INSIDEFRAME, Dat.Thickness, Dat.Color); 295: HPEN OldPen = SelectPen(PaintDC, Pen); 296: HPEN OldGPen = SelectPen(GooberDC, Pen); 297: 298: switch(Dat.Shape) 299: ( 300: case ELLIPSE: 301: OldBrush = SelectBrush(PaintDC, FBrush); 302: OldGBrush = SelectBrush(GooberDC, FBrush); 303: Ellipse(PaintDC, R.left, R.top, R.right, R.bottom); 304: Ellipse(GooberDC, R.left, R.top, R.right, R.bottom); 305: SelectObject(PaintDC, OldBrush); 306: SelectBrush(GooberDC, OldGBrush); 307: break; Здесь Metaphor копирует геометрическую фигуру непосредственно и в дисплейный контекст, и в контекст устройства для метафайла. Та же самая операция повторяется всякий раз, когда пользователь формирует на экране новую фигуру по принципу резинки. После этого пользователь может выбрать Save из меню File, и тогда контекст устройства будет передан в CloseMetaFile. Тем самым Итоговый файл записывается на диск и возвращается дескриптор HMETAFILE метафайла, который может быть выведен на экран, как только появится сообщение WM_PAINT. (Очевидно, что Metaphor недостаточно мощна, чтобы перерисовывать образ во время его создания). Фактические сохранение и загрузка файла обсуждается в разделе, посвященном стандартным диалогам. От метафоры к реальности Если вы хотите превратить программу Metaphor в реальный графический редактор, то, очевидно, нужно найти какой-то способ, чтобы осуществить полный перебор записей метафайла. Программа Metaphor не имеет такой возможности, однако в ней содержатся некоторые наметки одного из возможных направлений следования. На помощь приходит наш старый приятель — обработчик перечисляемых объектов (callback function). В данном случае такими объектами являются записи метафайла, а функция, осуществляющая их полный перебор, называется EnumMetaFile. Прежде чем перейти к деталям этой функции, рассмотрим, как она работает. Как вы помните, функция EnumFontFamilies посылает копии всех шрифтов системы в обработ- чик перечисляемых шрифтов. Последний может передать описание шрифтов обратно в
основную программу. То же самое происходит и в данном случае. То есть, когда вы передаете в функцию EnumMetaFile дескриптор метафайла, та начинает перебирать записи метафайла, передавая каждую из них по очереди в ваш обработчик, адрес которого передается в третьем аргументе EnumMetaFile. Эти записи определяют GDI-функцию, которая будет вызвана, и параметры, которые будут ей переданы. Функция EnumMetaFile BOOL EnumMetaFile (HDC, HLOCAL, MFENUMPROC, LPARAM) HDC hdc; HLOCAL hmf; MFENUMPROC mfenmprc; LPARAM IParam; Контекст устройства экрана Дескриптор метафайла Обработчик перечисляемых записей метафайла Пользовательские данные, которые должны быть переда- ны функции-обработчику Эта функция осуществляет полный перебор структур, содержащих информацию о вызовах GDI-команд, использующихся в метафайле. Ключевым параметром в EnumMetaFile является третий, содержащий адрес обработчика перечисляемых записей. Последний параметр может быть установлен равным NULL или содержать любые данные, которые пользователь желает передать в EnumMetaFileProc. Пример: EnumMetaFile(PaintDC, MyMetafile, IpMyMetaProc, MyData); Ниже приведен фактически используемый в программе Metaphor обработчик пере- числяемых записей метафайла: 42: int CALLBACK EnumMetaFileProc(HDC hdc, HANDLETABLE FAR* IpHTable, 43: METARECORD FAR* IpMFR, int cObj, BYTE FAR* IpClientData) 44: ( 45: PlayMetaFileRecord(hdc, IpHTable, IpMFR, cObj); 46: return 1; 47: ) Как видите, этот обработчик просто передает получаемые записи в функцию Play- MetaFileRecord, визуально отображающую их на экран. Параметры EnumMetaFileProc перечислены в таблице 18.2. Таблица 18.2 Пять параметров EnumMetaFileProc HDC hdc; Контекст устройства, на котором осуществляется визуаль- ное отображение HANDLETABLE FAR* Ipht; METARECORD FAR* Ipmr; int cobj; Адрес таблицы дескрипторов объектов Адрес записи метафайла Номер объекта в таблице дескрипторов LPARAM IParam; Данные, определяемые пользователем Ключевым параметром в таблице 18.2 является METARECORD, представляющий собой указатель структуры, содержащей три поля: struct ( DWORD rdSize; WORD rdFunction; WORD rdParm[]; 1 rdSize определяет размер целой записи, которая может варьироваться в зависимости от длины последнего поля. rdFunction указывает GDI-функцию (например, Ellipse,
Rectangle или SelectObject), находящуюся в структуре. Последний аргумент перечисляет параметры, передающиеся в эту функцию. Рассмотрим следующее обращение к Rectangle: Rectangle(PaintDC, 0, 0, 96, 46); Запись, описывающая этот вызов будет выглядеть следующим образом: rdSize: 7 rdFunction: 041В // Код функции Rectangle rdParm 0046, 0096, 0000, 0000 // Параметры в обратном порядке Коды, определенные во втором поле, перечислены в справочнике программиста по Microsoft Windows 3.1, Том 4: Ресурсы. Например, Bit Blit имеет функциональный номер 0x0922 или 0x0940. TextOut ассоциируется с функцией номер 0x0521. Metaphor использует EnumMetaFileProc только для того, чтобы быстро и эффективно воспроизводить изображения на экране. Тем не менее я затронул METARECORDS, потому что они раскрывают преимущества метафайлов и демонстрируют, как легко и просто с ними обращаться. Чтение метафайлов с диска Как уже упоминалось, существует два различных вида метафайлов. Первый — стандартный метафайл Windows, созданный программой Metaphor. Второй — это Aldus, или размещаемый (placeable) метафайл, производимый программами, повсюду исполь- зующимися в промышленности. При работе со стандартными метафайлами достаточно лишь вызвать GetMetaFile, которая всосет данные с диска и перешлет их обратно в форме дескриптора HMETAFILE. Это гораздо проще, чем задача, с которой вы сталкивались при работе с размещаемыми метафайлами. Чтобы идентифицировать Aldus-метафайл, просто прочитайте первый блок размера DWORD из файла и сравните его с константой 0x9AC6CDD7L. Если совпадет, то это размещаемый метафайл. Его следует обрабатывать следующим образом: Вырезать 22-байтный заголовок, начинающий файл. И Воспользоваться функцией SetMetaFileBits, чтобы передать то, что осталось, в обычный метафайл. Если вы желаете изучить этот процесс более подробно, исследуйте соответствующий код в файле METAUTIL.CPP (строчки 66—243). В частности, вы должны заметить, что функция OpenMetaFile определяет, является ли файл Aldus-метафайлом. В случае положительного ответа вызывается RenderPlaceableMeta. В противном случае программа полагается на функцию GetMetaFile. Вся фактическая работа по чтению размещаемого метафайла выполняется RenderPlaceableMeta (см. строчку 138). Если хотите, можете рассматривать весь этот процесс как черный ящик. Иначе говоря, наиболее простой способ работы состоит в том, чтобы подсоединить к вашей программе модули MetaUtil. Затем следует вызвать LoadFile и не забыть передать в свою программу HWND активного окна. LoadFile поднимает стандартный диалог, позволяю- щий вам выбрать файл. Когда вы сделаете это, он инициализирует глобальную перемен- ную hmf, являющуюся дескриптором выбранного вами метафайла. Стандартные диалоги Начиная с версии 3.1 Windows содержит набор стандартных диалогов, предназначен- ных для того, чтобы облегчить определенные часто встречающиеся задания. Например, программа Metaphor использует стандартные диалоги GetOpenFileName (рис. 18.5) и GetSaveFileName (рис. 18.6) для облегчения загрузки и записи файлов. Собственно чтение и запись файлов все еще требуется программировать вручную. Эти диалоги разработаны только для того, чтобы формировать интерфейс с пользователем.
Рис. 18.5. Диалог GetOpenFileNome позволяет выбрать файл для загрузки Рис. 18.6. Диалог GetSaveFUeName внешне полностью идентичен предыдущему Разница между этими двумя диалогами заключается не в том, как они выглядят, а в том, как они себя ведут. Например, диалог GetSaveFileName имеет возможность предуп- редить пользователя, до того как тот перезапишет файл. Обе этих функции имеют дело с одной большой структурой типа OPENFILENAME, которая описывается в интерактивном HELP-файле или в COMMDLG.H, который является для стандартных диалогов тем же, что и WINDOWS.H для всей остальной Windows. То есть Библией и основным источником информации. Вот как выглядит в COMMDLG.H структура OPENFILENAME, с несколькими редкими комментариями, определяющими каждое поле: typedef struct tagOFN ( DWORD iStructSize; //Длина структуры OPENFILENAME HWND hwndOwner; //Владелец диалога HINSTANCE hlnstance; //Программа, владеющая диалогом LPCSTR IpcsrtFilter; //Типы просматриваемых файлов LPSTR IpstrCustomFilter; ;//Специальные фильтры DWORD nMaxCustFilter; //Длина специального фильтра DWORD nFilterIndex; //Индекс для работы с фильтрами LPSTR IpstrFile; //Имя файла в случае успеха DWORD nMaxFile; //Длина IpstrFile LPSTR IpstrFileTitle; //Маршрут и имя файла в случае успеха DWORD nMaxFile; //Длина IpstrFileTitle LPCSTR IpcstrlnitialDir; //Начальный каталог файлов LPCSTR IpcstrTitle; //Текст заголовка DWORD Flags; //Флажки инициализации UINT nFileOffset; //Смещение внутри IpstrFile UINT nFileExtension; //Смещение внутри IpstrFile LPCSTR IpcstrDefExt; //Расширение по умолчанию LPARAM iCustData; //Для функций-обработчиков UINT (CALLBACK *lpfnHook) (HWND, UINT, WPARAM, LPARAM) ; LPCSTR Ip Tempi a teNante; //Заменяющие ресурсы для диалога ) OPENFILENAME; typedef OPENFILENAME FAR* LPOPENFILENAME;
11ри работе со стандартными диалогами вам потребуется пройти следующие три шага: 1. Обнулить запись, ассоциированную со стандартным диалогом и заполнить его первое поле размером самой структуры. OFENFILENAME ofn; incmset (Sofn, 0, sizeof(OPENFILENAME)); ofn.IStructSize = sizeof(OPENFILENAME); 2. Заполнить любое из остальных полей структуры, которая либо требуется, либо представляет особый интерес для вашей программы. Особенно важно поле Flag. Оно включает и выключает определенные свойствадиалога. Например, будет ли он содержать кнопку HELP или нет, и будет или нет он предупреждать пользователя перед записью па место существующего файла 3. Передать эту структуру в функцию, запускающую диалог и обрабатывающую пользовательский ввод. Например, если вы желаете загрузить файл с диска, выполните следующий вызов: GetOpenFileNarae(4ofn); В нижнем левом углу стандартных диалогов располагается выпадающий комбиниро- ванный перечень (combo box), содержащий типы файлов, обычно использующихся конкретным диалогом Например, в диалоге GctSaveRleName перечисляются как WMF-, так и BMP-файлы (см. рис. 18.7). Как видите, в этом перечне присутствуют как расширения файла, так и краткие описания. Save Tile at Type: |Metafilet(*.wnif) | Metalilesp wmt| [Bitmap FUesf-bnip) Рис. 18.7. Комбинированный перечень типов файлов Текст, который должен быть помещен в комбинированный перечень, передается в поле IpstrFiltci структуры OPENFILENAME. Существует два способа заполнения этого поля Первый опюсительно прост, с точки зрения понимания, но немного неуклюж для выполнения Второй — прост для выполнения, но выгладит несколько запутанным на первый взгляд. Код для первого метода работает, только если IpstiRlter заполнено нулями. Это важно, поскольку это поле содержит пары ASClIZ-строк. Первая содержит описание типа файла, а вторая — собстснно расширение. Конец списка должен содержал, два нуля подряд Вот пример: riomset (zofn, 0, sizeof(OPENFILENAME)); strepy(szFilter, "Metafiles"); strepy(tszFilter[stxlen(szFiltcr) ♦ 1], "».nmf"); Второй способ работает с символьной строкой, содержащей метки-заполнители, определяющие места, в которые должны быть вставлены символы NULL. Чтобы , приведенный ниже код работал, последний символ этой строки должен представлять собой метку-заполнитель. Цикл for в этом коде заменяет каждую из меток-заполнителей символом NULL. strepy(szFilter, Metafiles(*. wmf)I*•.«ml(Bitmap Files(‘.bmp)I*.bmpI"); cBP.e^xace = szFilter [strlen (szFilter) - 11; for (i - 0; szFilter(i) !- '\0*; lit) ( if lszFilter[i] -- ct.Replacc) szFilter(i) - *\0'; I Если вы хоти тс рассмотреть стандартные диалоги на более глубоком уровне, обрати- тесь к следующей главе, в которой исследуется стандартный диалог ChooscFont. К настоящему времени вы уже должны быть в состоянии запустить и выполнить свои собственные программы, используя функции GetFileName и GetSavcName (см строчки 200 и 250 METAUT1L.CPP).
Резюме В этой главе был освещен достаточно обширный материал. Основные моменты касались следующих вопросов: М Как рисовать основные геометрические фигуры, например, эллипсы и прямоуголь- ники. Как сохранить запись об этих фигурах в метафайле. И Как визуально отобразить метафайл (двумя методами). И Как читать размещаемые метафайлы. 11 Как работать со стандартными диалогами GetSaveFileName и GetOpenFileName. Хотя метафайлы не так важны, как растровые образы, они все-таки могут играть видную роль во многих приложениях благодаря своей компактности и быстроте. Они также могут служить удобным средством передачи графической или текстовой (не забудьте, что TextOut является GDI-функцией!) информации между двумя приложения- ми или окнами. Вопросы и ответы 1. МАКЕ-файл для этой программы выгладит по-другому. В чем дело? Программа Metaphor содержит три отдельных CPP-файла, которые требуется ском- поновать. Написание явных правил компоновки каждого из этих файлов становится монотонным заданием, вопиющем хотя бы о какой-нибудь форме автоматизации. Решение, предусмотренное создателями Маке, состоит в том, чтобы написать нечто, называемое неявным правилом, говорящем: “Всякий раз, когда вам требуется выполнить задание конкретного типа, вот как это сделать”. Например, следующий код говорит: “Всякий раз, когда вы видите файл с расширением OBJ, вы можете создать его, запустив CPP-файл посредством борландовского компилятора командной строки”. .cpp.obj: Ьсс -с $(FLAGS) { $< ) А вот соответствующая строчка для компилятора фирмы Microsift: .cpp.obj: cl -c -Gsw -Ow —W3 -AL -Zp ( $< ) Синтаксический элемент $< в конце этого оператора представляет собой встроенный макрос, автоматически подставляющий имя запрашиваемого файла вместе с его расши- рением. 2. Как вы окрасили в серый полутон пункт Save в меню File? Иногда программист хочет предохранить пользователя от выбора конкретного пункта меню. Чтобы добиться этого, нужно просто вызвать EnableMenuItem следующим обра- зом: HMENU hMenu = GetMenu(hwnd); EnableMenuItem) hMenu, CMENDMETA, MF_BYCOMMAND | MF_GRAYED); Функция EnableMenuItem зависит от трех параметров. Первый представляет собой дескриптор меню; второй — идентификатор или позицию запрашиваемого пункта меню; третий — набор флажков, указывающих, является ли второй параметр позицией или командой и желаете ли вы окрасить пункт меню в серый полутон и сделать его недоступным (MF_GRAYED), сделать недоступным, не окрашивая в серое (MF DIS- ABLED), или сделать доступным (MF_ENABLE). 3. Для чего используются NULL-кисти? NULL-кисти делают конкретный набор пикселов невидимым. Например, если вы раскрашиваете внутренность прямоугольника NULL-кистью, то сможете увидеть, что находится за ним.
Вопросы для самопроверки 1. Какие нечисловые параметры являются стандартными для всех GDI-функций? 2. Назовите шесть GDI-функций, предназначенных для создания геометрических фигур. 3. Как изменить цвет внутри эллипса? 4. Как изменить цвет контура прямоугольника? 5. В чем разница между размещаемым и стандартным метафайлом Windows? 6. Назовите два способа визуального отображения метафайла. 7. Что возвращает CreateMetaFile и что с этим делать? 8. Что возвращает CloseMetaFile и что с этим можно делать? 9. Что содержит второе поле в METARECORD, как найти перечисленные в нем значения и как можно получить содержимое первого поля METARECORD? 10. Что содержит первое поле структуры OPENFILENAME и что вам следует с ним делать? Упражнения 1. Напишите программу, визуально отображающую шестиугольник. 2. Создайте метафайл, содержащий три эллипса и три прямоугольника. Модифици- руйте функцию EnumMetaFileProc так, чтобы она окрашивала каждый встреченный ею эллипс в зеленый цвет. (Совет: номер функции Ellipse — 0x0418. Его параметры хранятся так же, как параметры функции Rectangle, как показано в предыдущем примере). 3. Номера функций LineTo и MoveTo равны соответственно 0x0213 и 0x214. Создайте метафайлы, содержащие около десяти геометрических фигур, а затем высветите окно сообщений, содержащее порядковые номера фигур и их типы. Получите эту информа- цию только из самого метафайла. Пример вывода: Figure 1: Rectangle Figure 3: Ellipse Figure 5: LineTo ... и т.д.
День 19 МУЛЬТИДОКУМЕНТНЫЙ ИНТЕРФЕЙС (MDI) Из этой главы вы узнаете, как программировать приложение, формирующее муль- тидокументный интерфейс (MDI). Программы, использующие MD1, позволяют откры- вать более одного документа внутри приложения одновременно. Примером может служить интегрированная среда разработки в компиляторах фирм Borland и Microsoft, а также менеджер программ, Quattro Pro for Windows и Word for Windows. Ниже дан обзор основных моментов, освещаемых в этой главе: Объяснение сути MDI и его пелей. И Регистрация и создание MDI-okoh. Работа с меню MDI. Использование поля cbWndExtra структуры WNDCLASS для хранения данных. Использование сообщения WM_QUERYENDSESSION. И Использование специальных сообщений MD1. Разделение времени ЦП с другими окнами или приложениями. Различия между ММ ANISOTROPIC и MM ISOTROPIC. Для того чтобы продемонстрировать все эти вещи, мы рассмотрим программу MDIPaint, показывающую 4 различных типа дочерних окон. Это приложение было разделено на 6 модулей: один для основной программы, один для набора стандартных подпрограмм, и по одному для каждого из дочерних окон. Такой подход дает простую и ясную конструкцию, где каждый из содержащихся модулей является относительно самостоятельным и легким для понимания фрагментом целого. Вообще говоря, я нахожу, что MDI-интерфейс представляет собой более сложный материал, нежели какой-либо другой предмет, освещаемый в этой книге. Впрочем, он не является каким-то невероятно трудным, просто вам нужно уделить этому некоторое время и немного поднапрячься. Что такое MDI Прежде всего необходимо понять, что MDI является стандартом. Давным-давно, в доисторические времена развития компьютеров, то есть в 1989 году, фирма IBM выпустила спецификацию для так называемого многодокументного интерфейса. Это стандартное средство объясняется в книге Systems Application Architecture Common User Acces Advanced Interface Design Guide или, как ее чаще называют, SAA CUA Interface Design Guide. Эта книга была впервые издана фирмой IBM в июне 1989 года. Ей был
присвоен номер SY0328-300-R00-1089. MDI Windows удовлетворяет стандарту, описан- ному в этой книге. Пример приложения с MDI показан на рисунке 19.1. Рис. 19.1. Менеджер файлов является MDI-приложением Это не только программистский стандарт, но и пользовательский. MDI — не просто техническая спецификация для хакеров, а интерфейс, который пользователи знают, понимают и с которым они считаются. Точнее говоря, пользователи принимают во внимание тот факт, что поведение всех MDI-программ похоже. Это дает возможность пользователям легко найти наилучший способ работы с приложением. Для приложения, использующего MDI, характерно поведение, описываемое ниже: I Приложение состоит из основного окна и ряда дочерних окон. Все дочерние окна находятся в границах родительского окна. И Приложение и каждое дочернее окно допускает максимизацию и минимизацию. Минимизированные дочерние окна остаются в рамках основного окна. I Список всех дочерних окон содержится в выпадающем подменю, как правило, имеющим название File или Window. (Спецификация предписывает последний выбор, но многие программисты считают, что список файлов относится к меню File.). Приложение закрывается комбинацией Alt-F4, а дочернее окно — с помощью Ctrl-F4. Клавиши Ctrl-F6 используются для переключения между документами. Если вы корректно реализовали приложение с MDI, то все перечисленное выше выполняется автоматически. Проделав некоторую дополнительную работу, вы можете научить свое MDI-приложение следующим вещам: В Располагать дочерние окна в главном окне без перекрытия или каскадно. В Упорядочивать пиктограммы, остающиеся в основном окне. В Предупреждать пользователя о закрытии дочернего окна. Даже если все приложение закрывается сразу (с помощью системного меню или какого-либо другого механиз- ма), вы должны быть в состоянии предупредить пользователя об этом до закрытия окна. Перечисленные выше моменты указывают основные свойства любого MDI-прило- жения. Конечно, все это может быть вам знакомо из вашего программистского опыта или из опыта использования интегрированной среды разработки в компиляторах фирм Borland или Microsoft.
С технической точки зрения вам следует запомнить две ключевые идеи: 1. Если вы хотите создать дочернее MDI-окно, то должны послать сообщение WM_MDICREATE вместо вызова CreateWindow. 2. Основное окно MDI-приложения на самом деле состоит из двух окон: фрейма и рабочего окна. Сообщение WM_MDICREATE подробно обсуждается после представления кода. Но сперва важно разобраться с терминами фрейм (frame window) и рабочее окно (client window). Каждое MDI-приложение создает свое основное окно (фрейм) точно таким же образом, как создается нормальное основное окно. Но вдобавок MDI-приложение должно создавать рабочее окно в ответ на сообщение WM_CREATE. Это окно является дочерним и использует заранее зарегистрированный класс MDICLIENT- Рабочее окно — это ключ ко всем MDI-приложениям. Оно управляет всем перечис- ленным выше, всегда оставаясь за кулисами, будучи скрытым от пользователя и программиста. Замечание. На большинстве машин в случае назначения вами рабочему окну и фрейму разных цветов можно заметить, как рабочее окно накрывает основное. Программа MDIPaint создает кисть для своего основного окна, используя константу COLOR_UPWORLSPACE (строчка 87), которая также используется классом MDICLIENT. Если вы воспользуетесь встроенными кистя- ми BLACK._BRUSH или WHITE_BRUSH для фрейма, вы сможете увидеть оба окна в момент, когда приложение впервые появляется на экране: wndclass.hbrBackgrotind = GetStockBrush(BlACK BRUSH) Фактический вызов, предназначенный для создания рабочего окна достаточно прост, за исключением того, что вам требуется передать CLIENTCREATESTRUCT в последнем параметре CreateWindow. Ниже следует фрагмент MDIPAINT.CPP, демонстрирующий код для создания рабочего окна: 174: hMenuInit = LoadMenu(hlnstance, "MdiMenuInit"); 175: hMenuMultiple = LoadMenu(hlnstance, "MDIMultiple"); 176: SetMenu(hwnd, hMenuInit); 177: 178: // Load accelerator table 179: hWndClient = GetWindow (hwnd, GW_CHILD); 180: hAccel = LoadAccelerators (hlnstance, "MdiAccel"); 181: 182: hMenuFilelnit = GetSubMenu(hMenuInit, 0); 183: hMenuFileMultiple = GetSubMenu(hMenuMultiple, 0); 184: i 185: clientcreate.hWindowMenu = hMenuFilelnit; 186: clientcreate.idFirstChild = IDM_FIRSTCHILD; 187: 188: hWndClient - CreateWindow ("MDICLIENT", NULL, 189: WS_CHILD I WS_CLIPCHILDREN I WS_VISIBLE I 190: MDIS_ALLCHILDSTYLES, 191: 0, 0, 0, 0, hwnd, HMENU(1), hlnstance, 192: (LPSTR) Sclientcreate); Как видите, CLIENTCREATESTRUCT имеет два поля: И В первом поле содержится меню. В этом меню располагается список текущих дочерних окон. (Меню MDI мы обсудим позже в этой главе после кода). Во втором поле, idFirstChild, содержится идентификатор первого дочернего окна MDI, создаваемого приложением. Здесь требуется указать числовой идентификатор, который выше любого другого идентификатора, использованного в вашем приложе- нии. Когда вы создаете дочерние окна MDI, Windows автоматически присваивает им идентификаторы на основе idFirstChild. Она использует эти идентификаторы для того, чтобы определить число, которое должно быть соотнесено с каждым дочерним окном. Эти числа отображаются в меню, которое берется из первого поля структуры CLIENTCREATESTRUCT (см. рис. 19.2).
Рис. 19.2. Меню программы MDIPaint содержит пронумерованный список дочерних окон Заметьте, что при обращении к CreateWindow в параметре szClass указывается MDICLIENT. Как уже упоминалось, MDICLIENT представляет собой заранее зареги- стрированный класс, отвечающий на многие ключевые сообщения, посылаемые в MDI-приложение. Несмотря на то, что это отличие от прочих вызовов CreateWindow выглядит мелким, значение его очень велико! Листинг 19.1 демонстрирует программу MDIPaint, рисующую геометрические формы и несложное фрактальное изображение в четырех отдельных классах MDI-okoh. Листинг 19.1. MDIPAINT.CPP 1: /////////////////////////////////////////////////////////////// 2: // Программа: MDIPAINT.CPP 3: // Автор: Чарли Калверт 4: // Описание: Пример MDI-приложения 5: // Замечание: Используйте "умные" обработчики перечисляемых окон 6: И Дата: 07/25/93 7: / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / 8: 9: ((define STRICT 10: #include <windows.h> 11: ((include <windowsx.h> 12: ((include "mdipaint. h" 13: ((pragma warning (disable : 4068) 14: 15: // Глобальные переменные 16: static HWND hWndFrame, hwndclient; 17: static char szFrameClass[] = "MDI_Frame"; 18: static char szlsotropic[] = "MDIAnlsotropic"; 19: static char szAnlsotropic[] = "MDI_Isotropic"; 20: static char szNormal[] = "MDI_Normal"; 21: static char szFern[] = "MDI_Fern"; 22: static HINSTANCE hlnstance; 23: HMENU hMenuInit, hMenuMultiple; 24: HMENU hMenuFilelnit, hMenuFileMultiple; 25: HACCEL hAccel; 26: 27: //((define Frame_DefProc DefFrameProc 28: BOOL Frame_OnCreate (HWND hwnd, CREATESTRUCT FAR* IpCreateStruct); 29: void Frame_OnDestroy(HWND hwnd); 30: void Frame_OnClose(HWND hwnd); 31: void Frame_OnConunand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify) ; 32: BOOL Frame_OnQueryEndSession(HWND hwnd); 33:
34; 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47; 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60; 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80; 81: 82: 83: 84: 85; 86: 87: 88: 89: 90: 91: 92: 93: 94: 95: 96: 97: 98: 99: 100: 101: 102: 103: 104: 105: 106: 107; 108: llllllllllllllllllllllllllllllllllllllllllll // "Умолчательная" процедура для фрейма //////////////////////////////////////////// LRESULT Frame_DefProc (HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM IParam) { return(DefFrameProc(hwnd, hWndClient, uMsg, wParam, IParam)); } ///////////////////////////// // Точка входа ///////////////////////////// Spragma argsused int PASCAL WinMain (HINSTANCE hinst, HINSTANCE hPrevInstance, LPSTR IpszCmdLine, int nCmdShow) ( MSG msg ; if (!hPrevInstance) if ([Register(hinst)) return FALSE; if (!(hWndFrame = Create(hinst, ncmdShow))) return FALSE; while (GetMessage (smsg, NULL, 0, 0)) ( if ([TranslateMDISysAccel (hWndClient, Smsg) ss ITranslateAccelerator (hWndFrame, hAccel, Smsg)) ( TranslateMessage (Smsg); DispatchMessage (Smsg); ) ) return msg.wParam; ) ///////////////////////////////// // Регистрация классов ///////////////////////////////// BOOL Register(HINSTANCE hinst) ( WNDCLASS wndclass; // Регистрация класса wndclass.style wndclass.IpfnWndProc wndclass.cbClsExtra wndclass.cbWndExtra wndclass.hlnstance wndclass.hlcon wndclass.hCursor фрейма = CS HREDRAW | CS_VREDRAW; = FrameWndProc; = 0; = 0; = hinst; = Loadicon (NULL, IDI_APPLICATION); = LoadCursor (NULL, IDC_ARR0W); wndclass.hbrBackground = CreateSolidBrush(GetSysColor(COLOR_APPWORKSPACE)); wndclass.IpszMenuName — NULL; wndclass.IpszClassName = szFrameClass; if(!Registerclass (&wndclass)) return FALSE; // Регистрация класса окна Isotropic wndclass.IpfnWndProc = IsotropicWndProc; wndclass.hlcon = Loadicon (NULL, IDIAPPLICATION); wndclass.hbrBackground = GetStockBrush(WHITE_BRUSH); wndclass.IpszMenuName «= NULL; wndclass.IpszClassName = szlsotropic; if(’Registerclass (&wndclass)) return FALSE; // Регистрация класса окна Anisotropic wndclass.IpfnWndProc = AnlsotropicWndProc; wndclass.hlcon = NULL; wndclass.IpszClassName = szAnlsotropic;
109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132. 133: 134: 135: 136 137. 138: 139: 140: 141. 142: 143: 144: 145: 146: 147: 148: 149: 150: 151: 152: 153: 154: 155: 156: 157: 158: 159: 160. 161: 162: 163: 164. 165: 166: 167: 168: 169- 170: 171: 172: 173: 174: 175: 176: 177: 178: 179: 180: 181: 182: 183: if (.'Registerclass (Swndclass) ) return FALSE; // Регистрация класса окна Normal wndclass.IpfnWndProc = NormalWndProc; wndclass.IpszClassName = szNormal; if(!RegisterClass (Swndclass)) return FALSE; // Регистрация класса окна Fern wndclass.IpfnWndProc - FernWndProc; wndclass.hbrBackground = GetStockBrush(BLACK_BRUSH); wndclass.IpszClassName = szFern; return Registerclass(Swndclass) ; ) //////////////////////////////////// // Создание основного окна llllllllllllllllllllllllllllllllllll HWND Create(HINSTANCE hlnst, int nCmdShow) { hlnstance = hlnst; HWND hwnd = CreateWindow (szFrameClass, "MDI Paint", WS_OVERLAPPEDWINDOW I WSCLIPCHILDREN, CW_USEDEFAULT, CWUSEDEFAULT, CW_USEDEFAULT, CWUSEDEFAULT, NULL, hMenuInit, hlnstance, NULL); if (hwnd == NULL) return hwnd; ShowWindow (hwnd, nCmdShow); UpdateWindow (hwnd); return hwnd; ) LRESULT CALLBACK export FrameWndProc (HWND hwnd, UINT message, WPARAM wParam, LPARAM IParam) ( switch (message) ( HANDLE—MSG(hwnd, WMCREATE, Frame_OnCreate); HANDLE_MSG (hwnd, WM_DESTROY, FrameOnDestroy) ; HANDLE—MSG(hwnd, WMCLOSE, Frame OnClose) ; HANDLE_MSG(hwnd, WM_COMMAND, Frame_OnCommand); HANDLEMSG(hwnd, WM_QUERYENDSESSION, Frame_OnQueryEndSession) ; default: return(DefFrameProc(hwnd, hWndClient, message, wParam, IParam)); ) ) ////////////////////////////////////////////////////// // WM_CREATE Создание рабочего окна MDI ////////////////////////////////////////////////////// #pragma argsused BOOL Frame—OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) ( CLIENTCREATESTRUCT clientcreate; hMenuInit — LoadMenu(hlnstpnce, "MdiMenuInit"); hMenuMultiple = LoadMenu(hlnstance, "MDIMultiple"); SetMenu(hwnd, hMenuInit); // Load accelerator table hWndClient = GetWindow (hwnd, GW_CHILD); hAccel = LoadAccelerators (hlnstance, "MdiAccel"); hMenuFilelnit = GetSubMenu(hMenuInit, 0); hMenuFileMultiple = GetSubMenu(hMenuMultiple, 0);
184: 185: clientcreate.hWindowMenu = hMenuFilelnit; 186: clientcreate.idFirstChild = IDM_FIRSTCHILD; 187: 188: hWndClient = CreateWindow ("MDICLIENT", NULL, 189: WS_CHILD I WS_CLIPCHILDREN | WS_VISlBLE I 190: MDIS_ALLCHILDSTYLES, 191: 0, 0, 0, 0, hwnd, HMENU(l), hlnstance, 192: (LPSTR) Sclientcreate); 193: if (hWndClient == NULL) 194: return FALSE; 195: 196: return TRUE; 197: } 198: 199: //////////////////////////////////////////// 200: // Обработчик сообщения WM_DESTROY 201: ////III III///////////III//////Illi ИНН НИ 202: ((pragma argsused 203: void Frame_OnDestroy(HWND hwnd) 204: { 205: DestroyMenu(hMenuMultiple) ; 206: SetMenu(hwnd, NULL); 207: DestroyMenu(hMenuInit) ; 208: PostQuitMessage(0); 209: ) 210: 211: nilllllllllllllHHIIIHIIIIIIIIIIIIIIHIII 212: // Обработчик сообщения WM_CL0SE 213: iiihhiiiiiiihiiiiiiiiiiiiiiiiiiiihiihh 214: void Frame_OnClose(HWND hwnd) 215: ( 216: if (NULL != GetWindow (hWndClient, GW_CHILD)) 217: SendMessage (hwnd, WM_COMMAND, CM_CLOSEALL, 0L); 218: 219: if (NULL != GetWindow (hWndClient, GW_CHILD)) 220: return; 221: 222: DestroyWindow(hwnd); 223: ) 224: 225: lllllinilHIlinillllllllllllllllllllHIIIIIIIHIIIIIHHIHIHI 226: // Создание дочернего окна MDI. Обработчик сообщения WM_MDICREATE 227: ///////////////////////////////////////////////////////////////// 228: HWND CreateMDIChildfLPCSTR szClass, LPCSTR szTitle) 229: 230: 231: 232: 233: 234: 235: 236: 237: 238: 239: 240: 241: 242: 243: 244: ( MDICREATESTRUCT MCS; MCS.szClass = szClass; MCS.szTitle = szTitle; MCS.hOwner = hlnstance; MCS.x = CWJUSEDEFAULT; MCS.у = CW_USEDEFAULT; MCS.ex = CW_USEDEFAULT; MCS.cy = CW USEDEFAULT; MCS.style = WS_CHILD 1 WS_CLIPSIBLINGS 1 WS_CLIPCHILDREN I WS_SYSMENU 1 WS_CAPTION I WS_VISIBLE; MCS.IParam = NULL; return FORWARD WM MDICREATE(hWndClient, SMCS, SendMessage); ) 245: ///////////////////////////////////////// 246: // Обработчик сообщения WM COMMAND 247: ///////////////////////////У///////////// 248: ftpragma argsused 249: void Frame_OnCommand(HWND hwnd, int id, HWND hwndctl, UINT codeNotify) 250: ( 251: WNDENUMPROC IpfnEnum; 252: HWND hwndchild; 253: MDICREATESTRUCT MCS; 254: 255: // Выполнить обработку no умолчанию для любой системной команды (SC_*). 256: if ((unsigned) id >= OxFOOOu) goto DWP; 257: 258: switch (id)
259: 260: 261: 262: 263: 264: 265: 266: 267: 268: 269: 270: 271: 272: 273: 274: 275: 276: 277: 278: 279: 280: 281: 282: 283: 284: 285: 286: 287: 288: 289: 290: 291: 292: 293: 294: 295: 296: 297: 298: 299: 300: 301: 302; 303: 304: 305: 306: 307: 308: 309: 310: 311: 312: 313: 314: 315: 316: 317: 318: 319: 320: 321: 322: 323: 324 : 325: 326: 327: 328: 329: 330: 331: 332: 333: case CM_ANISOTROP: CreateMDIChildlszAnlsotropic, "Anisotropic"); break; case CM_ISOTROP: CreateMDIChild(szlsotropic, "Isotripic"); break; case CM_N0RMAL: CreateMDIChild(szNormal, "Normal Ratio"); break; case CMFERN: CreateMDIChild(szFern, "Lar Fern"); break; case CM_CLOSE: // Закрыть активное окно hwndChild = (HWND)LOWORD(SendMessage(hWndClient, WM MDIGETACTIVE, 0, OL) ) ; if (SendMessage(hwndChild, WM_QUERYENDSESSION, 0, OL)) SendMessage(hWndClient, WMMDIDESTROY, (WPARAM) hwndChild, OL) ; break; case CMEXIT: // Выход из программы SendMessage (hwnd, WM_CLOSE, 0, OL); break; case CM_TILE: SendMessage (hWndClient, WM_MDITILE, 0, 0L); break; case CM_CASCADE: SendMessage (hWndClient, WM_MDICASCADE, 0, 0L); break; case CM_ARRANGE: SendMessage (hWndClient, WM_MDIICONARRANGE, 0, OL); break; case CM_CLOSEALL: // Закрытие всех дочерних окон IpfnEnum = (WNDENUMPROC)MakeProcInstance( (FARPROC)EnumChildWnds, hlnstance); EnumChildWindows (hWndClient, IpfnEnum, 0L); FreeProcInstance ((FARPROC)IpfnEnum); break; default:- // Передать в активное окно hwndChild = (HWND)LOWORD(SendMessage(hWndClient, WM_MDIGETACTIVE, 0, 0L)); if (IsWindow (hwndChild)) SendMessage (hwndChild, WMCOMMAND, id, codeNotify); break; // and then to DefFrameProc ) DWP: FORWARD_WM_COMMAND(hwnd, id, hwndCtl, codeNotify, Frame_DefProc); ) /////////////////////////////////////////// // Обработчик сообщения WM_QUERYENDSESSION /////////////////////////////////////////// ((pragma argsused Frame_OnQueryEndSession(HWND hwnd) ( if (NULL != GetWindow (hWndClient, GW_CHILD)) SendMessage (hwnd, WM_COMMAND, CM_CLOSEALL, 0L) ; if (NULL != GetWindow (hWndClient, GW_CHILD) ) return FALSE; else return TRUE;
334: //------------------------------------ 335: // Обработчики перечисляемых объектов 336: И ================----------===----==== 337: 338: /////////////////////////////////////////// 339: // Обработчик перечисляемых дочерних окон 340: /////////////////////////////////////////// 341: If pragma argsused 342: BOOL CALLBACK EnumChildWnds (HWND hwnd, LONG IParam) 343: ( 344: if (GetWindow(hwnd, GW_OWNER)) // Заголовок пиктограммы? 345: return TRUE; 346: 347: SendMessage (GetParent(hwnd), WM_MDIRESTORE, (WPARAM)hwnd, OL) ; 348: if (.'SendMessage (hwnd, WM_QUERYENDSESSION, 0, OL) ) 349: return TRUE; 350: 351: SendMessage (GetParent (hwnd) , WM_MDIDESTROY, (WPARAM) hwnd, OL) ; 352: return TRUE; 353: ) Листинг 19.2. MDIPAINT.H 1: //////////////////////////////////////////////////////// 2: // Программа: MDIPAINT.H 3: // Автор: Чарли Калверт 4: // Описание: Пример MDI-приложения 5: // Date: 07/25/93 6: //////////////////////////////////////////////////////// 7: 8: «define CM_ISOTROP 100 9: «define CM ANISOTROP 101 10: «define CM_NORMAL 112 11: «define CM_FERN 113 12: «define CM_CLOSE 114 13: «define CM_EXIT 115 14: 15: «define CM_TILE 130 16: «define CM_CASCADE 131 17: «define CM_ARRANGE 132 18: «define CM_CLOSEALL 133 19: 20: «define IDM_FIRSTCHILD 150 21: 22: // Функции 23: LRESULT CALLBACK _export AnlsotropicWndProc (HWND, UINT, 2 4: WPARAM, LPARAM) ; 25: LRESULT CALLBACK _export IsotropicWndProc(HWND, UINT, 26: WPARAM, LPARAM); 27: LRESULT CALLBACK _export NormalWndProc (HWND, UINT, 28: WPARAM, LPARAM); 29: LRESULT CALLBACK _export FernWndProc (HWND, UINT, WPARAM, LPARAM); 30: LRESULT CALLBACK _export FrameWndProc (HWND, UINT, 31: WPARAM, LPARAM); 32: BOOL CALLBACK _export EnumChildWnds(HWND, LONG); 33: BOOL Register(HINSTANCE hlnst); 34: HWND Create (HINSTANCE hlnst, int nCmdShow); Листинг 19.3. ANISOTROP.CPP 1: ////////////////////////////////////////////////////////// 2: // Программа: ANISOTRP.CPP 3: // Автор: Чарли Калверт 4: // Описание: Пример MDI-приложения 5: // Дата: 07/25/93 6: ////////////////////////////////////////////////////////// 7: 8: #define STRICT 9: ^include <windows.h> 10: #include <windowsx.h> 11: ^pragma hdrstop 12: ftinclude <stdlib.h> 13: ttinclude "draw.h" 14: ^pragma warning(disable : 4068) 13 Чарльз Калверт
extern HMENU hMenuMultiple, hMenuInit; extern HMENU hMenuFileMultiple, hMenuFilelnit; static HWND hwndClient, hwndFrame; 15: 16: 17: 18: 19: 20: // Объект AnIsotrop_Play 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: 85: 86: 87: 88: 89: #define AnIsotrop_DefProc DefMDIChildProc BOOL AnIsotrop_OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct); void AnIsotrop_MDIActivate (HWND hwnd, BOOL fActive, HWND hwndActivate, HWND hwndDeactivate); void AnIsotrop_OnPaint(HWND hwnd); llllllllllllllllllllllllllllllllll H Оконная процедура ////////////////////////////////// LRESULT CALLBACK AnlsotropicWndProc (HWND hwnd, UINT message, WPARAM wParam, LPARAM IParam) ( switch (message) ( HANDLE_MSG (hwnd, WM_CREATE, AnIsotrop_OnCreate) ; HANDLE_MSG (hwnd, WM_MDIACTIVATE, AnIsotrop_MDIActivate); HANDLE_MSG (hwnd, WM_PAINT, AnIsotrop_OnPaint) ; default: return Anlsotrop DefProc(hwnd, message, wParam, IParam); ) ) ///////////////////////Z/////////// // Обработчик сообщения WM CREATE ZZZZZZZZZZZZZZZZ/ZZZZZZZZZ7ZZZZZZZZ #pragma argsused BOOL AnIsotrop_Oncreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) ( hwndClient = GetParent (hwnd); hwndFrame = GetParent (hwndClient) ; return TRUE ; ) ZZZ/////Z///ZZZZZZ////Z///ZZZ///ZZZZ// // Обработчик сообщения WM ACTIVATE ////////////////////////////////////// #pragma argsused void AnIsotrop_MDIACtivate (HWND hwnd, BOOL fActive, HWND hwndActivate, HWND hwndDeactivate) ( if (fActive) SendMessage (hwndClient, WM_MDISETMENU, 0, MAKELONG(hMenuMultiple, hMenuFileMultiple)); if (!fActive) SendMessage (hwndClient, WM_MDISETMENU, 0, MAKELONG(hMenuInit, hMenuFilelnit)); DraWMenuBar (hwndFrame); ) /////////////////////////////////// // Обработчик сообщения WM PAINT /////////////////////////////////// void Anlsotrop_OnPaint(HWND hwnd) ( HDC PaintDC; PAINTSTRUCT PaintStruct; RECT R; PaintDC = BeginPaint (hwnd, SPaintStruct); SetMapMode (PaintDC, MM_ANISOTROPIC) ; GetClientRect(hwnd, SR); SetWindowExt(PaintDC, 210, 210); SetViewportExt(PaintDC, R.right, R. bottom) ; SetViewportOrg(PaintDC, R.right / 2, R.bottom /2); DoDraw(PaintDC);
90: 91: EndPaint (hwnd, SPaintStruct); 92: ) Листинг 19.4. FERN.CPP 1: //////////////////////////////////////////////////////// 2: II Программа: FERN.CPP 3: // Автор: Чарли Калверт 4: // Описание: Пример MDI-приложения 5: // Дата: 07/25/93 6: //////////////////////////////////////////////////////// 7: «define STRICT 8: «include <windows.h> 9: «include <windowsx.h> 10: «include <stdlib.h> 11: «include "draw.h" 12: «pragma warning(disable : 4068) 13: 14: int FernTimer = 1; 15: 16: // Константы 17: double a[4] = (0, 0.85, 0.2, -0.15}; 18: double b[4] = (0, 0.04, -0.26, 0.28); 19: double c[4] = (0, -0.04, 0.23, 0.26); 20: double d[4] = (0.16, 0.85, 0.22, 0.24); 21: double e[4] = (0, 0, 0, Ob- 22: double f[4] = (0, 1.6, 1.6, 0.44); 23: double x = 0; 24: double у = 0; 25: 26: // Переменные 27: static double TempX, TempY; 28: static int MaxX, MaxY, k; 29: static long Maxiterations, Count; 30: static HWND hWndClient, hWndFrame; 31: 32: // Внешние ресурсы 33: extern HMENU hMenuMultiple, hMenuInit; 34: extern HMENU hMenuFileMultiple, hMenuFilelnit; 35: extern HACCEL hAccel; 36: 37: «define FernPlay_DefProc DefMDIChildProc 38: BOOL FernPlay_OnCreate(HWND hwnd, 39: CREATESTRUCT FAR* IpCreateStruct); 40: void FernPlay_OnClose(HWND hwnd); 41: void FernPlayOnTimer(HWND hwnd, UINT id); 42: void FernPlay_MDIActivate (HWND hwnd, BOOL fActive, 43: HWND hwndActivate, 44: HWND hwndDeactivate) ; 45: BOOL FernPlayOnQueryEndSession(HWND hwnd); 46: void FernPlay_OnPaint(HWND hwnd); 47: void FernPlay_OnSize(HWND hwnd, UINT state, int ex, int cy); 48: 49: ////////////////////////////////// 50: // Оконная процедура 51: / И И И И И И И И И И//И///////// 52: LRESULT CALLBACK FernWndProc(HWND hwnd, UINT message, 53: WPARAM wParam, LPARAM IParam) 54: ( 55: switch (message) 56: ( 57: HANDLE_MSG(hwnd, WM_CREATE, FernPlayOnCreate); 58: HANDLEMSG(hwnd, WMCLOSE, FernPlay_OnClose); 59: HANDLE MSG (hwnd, WM_TIMER, FernPlay OnTimer) ; 60: HANDLE_MSG (hwnd, WM_MDIACTIVATE, FernPlay MDIActivate) ; 61: HANDLEJMSG (hwnd, WM_PAINT, FernPlay OnPaint) ; 62: HANDLE_MSG (hwnd, WM_QUERYENDSESSION, 63: FernPlay_OnQueryEndSession); 64: HANDLE_MSG(hwnd, WMSIZE, FernPlay_OnSize); 65: default: 66: return FernPlay_DefProc(hwnd, message, wParam, IParam); 67: ) 68: } 69:
70: //////////////////////////////////// 71: // Обработчик сообщения WM_CREATE 72: //////////////////////////////////// 73: ((pragma argsused 74: BOOL FernPlay_OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) 75: ( 76: hWndClient = GetParent (hwnd); 77: hWndFrame = GetParent (hWndClient); 78: Count = 0; 79: SetTimer(hwnd, FernTimer, 0, NULL); 80: return TRUE; 81: ) 82: 83: ////////////////////////////////////// 84: // Обработчик сообщения WM_MDIACTIVATE 85: ////////////////////////////////////// 86: ((pragma argsused 87: void FernPlay_MDIActivate(HWND hwnd, BOOL fActive, HWND 88: hwndActivate, HWND hwndDeactivate) 89: ( 90: if (fActive) 91: SendMessage(hWndClient, WM_MDISETMENU, 0, 92: MAKELONG(hMenuMultiple, hMenuFileMultiple)); 93: 94: if (!fActive) 95: SendMessage(hWndClient, WM_MDISETMENU, 0, 96: MAKELONG(hMenuInit, hMenuFilelnit)); 97: DrawMenuBar (hWndFrame); 98: ) 99: 100: ///////////////////////////////// 101: // Обработчик сообщения WM_CLOSE 102: ///////////////////////////////// 103: void FernPlay_OnClose(HWND hwnd) 104: ( 105: Count = Maxiterations; 106: if (IDOK != MessageBox (hwnd, "OK to close window?'', 107: "Fern", MB_ICONQUESTION I MB_OKCANCEL) ) 108: return; 109: else 110: FORWARD_WM_CLOSE(hwnd, FernPlay_DefProc); 111: } 112: 113: ////////////////////.////////////////////// 114: // Обработчик сообщения WM_QUERYENDSESSION 115: ////////////////////////////////////////// 116: BOOL FernPlay_OnQueryEndSession(HWND hwnd) 117: ( 118: Count = Maxiterations; 119: if (IDOK != MessageBox (hwnd, "OK to close window?”, 120: "Fern”, MB_ICONQUESTION I MB_OKCANCEL) ) 121: return FALSE; 122: else 123: return TRUE; 124: ) 125: 126: ///////////////////////////////////////// 127: // Обработчик сообщения WM_SIZE 128: ///////////////////////////////////////// 129: ((pragma argsused 130: void FernPlay_OnSize(HWND hwnd, UINT state, int ex, int cy) 131: ( 132: RECT R; 133: GetClientRect(hwnd, SR); 134: MaxX = R.right; 135: MaxY = R.bottom; 136: Maxiterations = long(MaxY) * 50; 137: if (state == SIZE_MINIMIZED) 138: Maxiterations = 175; 139: 140: // ОБЯЗАТЕЛЬНО передать сообщение WM_SIZE для обработки по умолчанию 141: FORWARD_WM_SIZE(hwnd, state, сх, су, FernPlay_DefProc); 142: } 143:
144: /////////////////////////////////// 145: // Обработчик сообщения WM_PAINT 146: /////////////////////////////////// 147: void FernPlay_OnPaint(HWND hwnd) 146: ( 149: Count = 0; 150: KillTimer(hwnd, FernTimer); 151: SetTimer(hwnd, FernTimer, 0, NULL); 152: FORWARD_WM_PAINT (hwnd, FernPlay_DefProc) ; 153: ) 154: 155: //////////////////////////////////// 156: // Нарисовать папоротник 157: //////////////////////////////////// 158: void DoPaint(HWND hwnd) 159: ( 160: HDC PaintDC; 161: k = rand () % 100; 162: if ((k > 0 ) SS (k <= 85)) 163: k = 1; 164: if ((k > 85) && (k <= 92)) 165: k = 2; 166: if (k >92) k = 3; 167: TempX = a[k] * x + b[k] * у + e[k]; 168: TempY = c[k] * x + d[k] * у + f[k]; 169: x = TempX; 170: у = TempY; 171: if ((Count >= Maxiterations) I I (Count != 0)) 172: ( 173: PaintDC = GetDC(hwnd); 174: SetPixel(PaintDC, (x * MaxY / 11 + MaxX / 2), 175: (y * -MaxY / 11 + MaxY), RGB(0, OXFF, 0)); 176: ReleaseDC(hwnd, PaintDC); 177: ) 178: Count++; 179: ) 180: 181: ////////////////////////////////// 182: // Обработчик сообщения WM TIMER 183: //////////////////////////7/////// 184: ftpragma argsused 185: void FernPlay_0nTimer(HWND hwnd, UINT id) 186: ( 187: if (Count >= Maxiterations) 188: KillTimer(hwnd, FernTimer); 189: 190: for (int i = 0; i < 200; i++) 191: ( 192: if (Count >= Maxiterations) 193: return; 194: DoPaint(hwnd); 195: ) 196: ) Листинг 19.5. ISOTROP.CPP 1: ////////////////////////////////////////// 2: // Программа: ISOTROP.CPP 3: // Автор: Чарли Калверт 4: // Описание: Пример MDI-приложения 5: // Дата: 07/25/93 6: ////////////////////////////////////////// 7: 8: fldefine STRICT 9: flinclude <windows.h> 10: flinclude <windowsx.h> 11: flinclude "draw.h" 12. - flpragma warning (disable : 4068) 13: 14: extern HMENU hMenuMultiple, hMenuInit; 15: extern HMENU hMenuFileMultiple, hMenuFilelnit; 16: static HWND hwndClient, hwndFrame; 17: 18: fldefine Isotrop_DefProc DefMDIChildProc 19: BOOL Isotrop_OnCreate(HWND hwnd.
20: CREATESTRUCT FAR* IpCreateStruct); 21: void Isotrop_MDIActivate(HWND hwnd, BOOL fActive, HWND 22: hwndActivate, HWND hwndDeactivate); 23: void Isotrop_OnPaint(HWND hwnd); 24: BOOL Isotrop_OnQueryEndSession(HWND hwnd); 25: 26: ///////////////////////////// 27: // Оконная процедура 28: ///////////////////////////// 29: LRESULT CALLBACK IsotropicWndProc(HWND hwnd, UINT message, 30: WPARAM wParam, LPARAM IParam) 31: { 32: switch (message) 33: ( 34: HANDLE_MSG(hwnd, WM_CREATE, Isotrop_OnCreate); 35: HANDLE_MSG(hwnd, WM_MDIACTIVATE, Isotrop_MDIActivate) ; 36: HANDLE_MSG(hwnd, WM_PAINT, Isotrop_OnPaint) ; 37: HANDLE_MSG (hwnd, WM_QUERYENDSESSION, 38: Isotrop_OnQueryEndSession); 39: default: 40: return Isotrop_DefProc(hwnd, message, wParam, IParam); 41: ) 42: ) 43: 44: ////////////////////////////////////////// 45: // Обработчик сообщения WM QUERYENDSESSION 46: //////////////////////////7/////////////// 47: BOOL Isotrop_OnQueryEndSession(HWND hwnd) 48: ( 49: if (IDOK != MessageBox (hwnd, "OK to close window?", 50: "Isotropic", MB_ICONQUESTION | MB_OKCANCEL)) 51: return FALSE; 52: else 53: return TRUE; 54: ) 55: 56: /////////////////////////////////// 57: // Обработчик сообщения WM CREATE 58: //////////////////////////7//////// 59: #pragma argsused 60: BOOL Isotrop_OnCreate(HWND hwnd, 61: CREATESTRUCT FAR* IpCreateStruct) 62: ( 63: hwndclient = GetParent(hwnd); 64: hwndFrame = GetParent(hwndclient); 65: return TRUE; 66: ) 67: 68: ////////////////////////////////////// 69: // Обработчик сообщения WM MDIACTIVATE 70: //////////////////////////7/////////// 71: ftpragma argsused 72: void Isotrop_MDIActivate(HWND hwnd, BOOL fActive, 73: HWND hwndActivate, HWND hwndDeactivate) 74: ( 75: if (fActive) 76: SendMessage(hwndclient, WM_MDISETMENU, 0, 77: MAKELONG(hMenuMultiple, hMenuFileMultiple)); 78: if (!fActive) 79: SendMessage(hwndclient, WM_MDISETMENU, 0, 80: MAKELONG(hMenuInit, hMenuFilelnit)); 81: DrawMenuBar (hwndFrame); 82: ) 83: 84: //////////////////////////////////// 85: // Обработчик сообщения WM_PAINT 86: //////////////////////////////////// 87: void Isotrop_OnPaint(HWND hwnd) 88: ( 89: HDC PaintDC; PAINTSTRUCT PaintStruct; RECT R; = 3: 94: PaintDc = BeginPaint (hwnd, SPaintStruct);
95: SetMapMode(PaintDC, MMISOTROPIC); 96: GetClientRect(hwnd, SR) ; 97: SetWindowExt(PaintDC, 210, 210); 98: SetViewportExt(PaintDC, R.right, R.bottom); 99: SetViewportOrg(PaintDC, R.right / 2, R.bottom / 2); 100: DoDraw(PaintDC); 101: 102: EndPaint (hwnd, SPaintStruct); 103: ) Листинг 19.6. NORMAL.CPP 1: ///////////////////////////////////////////////////////// 2: // Программа: NORMAL.CPP 3: // Автор: Чарли Калверт 4: // Описание: Пример MDI-приложения 5: // Дата: 07/25/93 6: ///////////////////////////////////////////////////////// 7: ((define STRICT 8: #include <windows.h> 9: ((include <windowsx.h> 10: ((include "draw.h" 11: ((pragma warning (disable : 4068) 12: 13: extern HMENU hMenuMultiple, hMenuInit; 14: extern HMENU hMenuFileMultiple, hMenuFilelnit; 15: static HWND hwndClient, hwndFrame; 16: 17: ((define NormalPlay DefProc DefMDIChildProc 18: BOOL NormalPlay_OnCreate (HWND hwnd, 19: CREATESTRUCT FAR* IpCreateStruct); 20: void NormalPlay_MDIActivate(HWND hwnd, BOOL fActive, 21: HWND hwndActivate, 22: HWND hwndDeactivate); 23: void NormalPlay_OnPaint(HWND hwnd); 24: 25: //////////////////////////////////// 26: // Оконная процедура 27: //////////////////////////////////// 28: LRESULT CALLBACK NormalWndProc (HWND hwnd, UINT message, 29: WPARAM wParam, LPARAM IParam) 30: { 31: switch (message) 32: { 33: HANDLE_MSG(hwnd, WM_CREATE, NormalPlay_OnCreate); 34: HANDLE MSG (hwnd, WM_MDIACTIVATE, NormalPlay_MDIActivate) ; 35: HANDLE_MSG(hwnd, WM_PAINT, NormalPlay_OnPaint) ; 36: default: 37: return NormalPlayDefProc(hwnd, message, wParam, IParam); 38: ) 39: ) 40: 41: //////////////////////////////////// 42: // Обработчик сообщения WM_CREATE 43: //////////////////////////////////// 44: ((pragma argsused 45: BOOL NormalPlay_OnCreate(HWND hwnd, 46: CREATESTRUCT FAR* IpCreateStruct) 47: { 48: hwndClient = GetParent (hwnd); 49: hwndFrame = GetParent (hwndClient); 50: return TRUE; 51: ) 52: 53: ////////////////////////////////////// 54: // Обработчик сообщения WM_MDIACTIVATE 55: ////////////////////////////////////// 56: ((pragma argsused 57: void NormalPlay_MDIActivate (HWND hwnd, BOOL fActive, 58: HWND hwndActivate, 59: HWND hwndDeactivate) 60: { 61: // Установить меню Normal, если получен фокус 62: if (fActive) 63: SendMessage (hwndClient, WM_MDISETMENU, 0,
64: MAKELONG(hMenuMultiple, hMenuFileMultiple)); 65: 66: 67: 66: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: 85: 86: if (’fActive) SendMessage(hwndClient, WM_MDISETMENU, 0, MAKELONG(hMenuInit, hMenuFilelnit)); DrawMenuBar(hwndFrame); > //////////////////////////////////// // Обработчик сообщения WM NORMAL //////////////////////////7///////// void NormalPlay OnPaint(HWND hwnd) { HDC PaintDC; PAINTSTRUCT PaintStruct;' RECT R; PaintDC = BeginPaint (hwnd, SPaintStruct) ; GetClientRect(hwnd, SR); SetViewportOrg(PaintDC, R.right / 2, R.bottom /2); DoDraw(PaintDC); EndPaint (hwnd, SPaintStruct); ) Листинг 19.7. DRAW.CPP 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: /////////////////////////////////////////////////////////// // Программа: DRAW.CPP // Автор: Чарли Калверт // Описание: Пример MDI-приложения // Дата: 07/25/93 /////////////////////////////////////////////////////////// fldefine STRICT flinclude «windows.h> flinclude <windowsx.h> flinclude <math.h> flinclude "draw.h" fldefine PI 3.14159265358979323846 //////////////////////////////////// // Построение фигуры //////////////////////////////////// void Drawsquare(HDC PaintDC, double Scale, int Theta) ( int xl,yl; int xt,yt; int i; HPEN Pens[5], OldPen; TCDS CDS; Pens[2] = CreatePen(PS_SOLID, 1, RGB(255, 0, 0)); Pens[2] = CreatePenfPS SOLID, 1, RGB(0, 255, 0)); Pens[3] = CreatePen(PS_SOLID, 1, RGB(0, 0, 255)); Pens[4] = CreatePen(PS_SOLID, 1, RGB(255, 0, 255)); CDS[0]-x = -100; CDS[0].y = -100; CDS[1].x = 100; CDS[1] ,y = -100; CDS[2].x = 100; CDS[2].у = 100; CDS[3].x = -100; CDS[3],y = 100; CDS[4].x = -100; CDS[4].y = -100; for (i — 0; i < 5; i++) { xl = CDS[i].x; yl = CDS[i].y; xt = xl; yt = yl; xt = Scale * (xl * cos(Theta * PI / 180) + yl *
50: sin(Theta * PI/180)); 51: yt = Scale * (yl * cos(Theta * PI / 180) - xl * 52: sin(Theta * PI/180)); 53: if (i => 0) 54: MoveTo(PaintDC, xt, yt); 55: else 56: ( 57: OldPen = SelectPen(PaintDC, Pens[i]); 58: LineTo(PaintDC, xt, yt) ; 59: SelectPen(PaintDC, OldPen); 60: ) 61: ) 62: for (i = 1; i < 5; i++) 63: DeleteObject(Pens[ij); 64: ) 65: 66: ////////////////////////////////// 67: // Цикл построений фигур 68: ////////////////////////////////// 69: void DoDraw(HDC PaintDC) 70: ( 71: double Scale; 72: int Theta; 73: int Square; 74: 75: Scale = 1.0; 76: Theta = 0; 77: 78: for (Square = 1; Square < 25; Square++) 79: ( 80: Drawsquare(PaintDC, Scale, Theta); 81: Theta = Theta + 10; 82: Scale = scale * 0.85; 83: ) 84: ) Листинг 19.8. DRAW.H 1: ////////////////////////////////////////////////////////// 2: // Программа: DRAW.H 3: // Автор: Чарли Калверт 4: // Описание: Пример MDI-приложения 5: // Дата: 07/25/93 6: ////////////////////////////////////////////////////////// 7: 8: «define WM_FERNPAINT (WM_USER + 0) 9: /* void Cls_OnFernPaint(HWND hwnd); */ 10: «define HANDLE_WM_FERNPAINT (hwnd, wParam, IParam, fn) \ 11: ((fn)(hwnd), 0L) 12: «define FORWARD_WM_FERNPAINT(hwnd, fn) \ 13: (void)(fn)((hwndl, WM_FERNPAINT, 0, 0L 14: 15: // Типы 16: typedef POINT TCDS[5J; 17: 18: // Функции 19: void DoDraw(HDC PaintDC); Листинг 19.9. MDIPAINT.RC 1: /////////////////////////////////////////////////////// 2: // Программа: MDIPAINT.RC 3: // Автор: Чарли Калверт 4: // Описание: Пример MDI-приложения 5: // Дата: 07/25/93 6: /////////////////////////////////////////////////////// 7: 8: «include <windows.h> 9: «include "MDIРаint.h" 10: 11: MdiMenuInit MENU 12: BEGIN 13: POPUP "SFile" 14: BEGIN
15: MENUITEM "&Isotropic\tAlt+I", CM_ISOTROP 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: MENUITEM "&AnIsotropic\tAlt+A", CM ANISOTROP MENUITEM "&Norma1\tAlt+N", CM_NORMAL MENUIТЕМ "&Fern\tAlt+R", CM FERN MENUIТЕМ SEPARATOR MENUITEM "E&xit", CM_EXIT END END MDIMultiple MENU BEGIN POPUP "&File" BEGIN MENUITEM "&Isotropic\tAlt+I", CM_ISOTROP MENUITEM ”&AnIsotropic\tAlt+A", CM ANISOTROP MENUIТЕМ "&Normal\tAlt+N", CM NORMAL MENUIТЕМ SEPARATOR MENUITEM "E&xit", CM_EXIT END POPUP "&Window" BEGIN MENUIТЕМ "&Cascade\tShift+C", CM CASCADE MENUITEM "&Tile\tShift+T", CM TILE MENUITEM "Arrange &Icons", CM_ARRANGE MENUIТЕМ "Close &A11", CM_CLOSEALL END END MdiAccel ACCELERATORS BEGIN "C", CM_CASCADE, VIRTKEY, SHIFT "T", CM TILE, VIRTKEY, SHIFT "I", CM_ISOTROP, VIRTKEY, ALT "A", CM_ANISOTROP, VIRTKEY, ALT "N", CM_NORMAL, VIRTKEY, ALT "R", CM_FERN, VIRTKEY, ALT END Листинг 19.10. MDIPAINT.DEF 1: NAME MDIPaint 2: DESCRIPTION 'MDIPaint program (c) Charlie Calvert' 3: EXETYPE WINDOWS 4: STUB 'WINSTUB.EXE' 5: HEAPSIZE 1024 6: STACKSIZE 8192 7: CODE PRELOAD MOVEABLE DISCARDABLE 8: DATA PRELOAD MOVEABLE MULTIPLE Листинг 19.11. MDIPAINT.MAK (Borland) 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: # МАКЕ-файл для MDIPaint # Используйте переключатель /WE MAIN = MDIPaint OBJS = $(MAIN).obj Isotrop.obj Anlsotrp.obj Normal.obj \ Fern.obj Draw.obj INCPATH = C:\BC\INCLUDE LIBPATH = C:\BC\LIB CFLAGS = -WE -ml -v -w4 -1$(INCPATH) -L$(LIBPATH) # Компоновка $(MAIN).exe: $(OBJS) $(MAIN).def $(MAIN).res bcc $(CFLAGS) $(OBJS) brc $(MAIN).res # Компиляция .cpp.obj: bcc -c $(CFLAGS) { $< ) # Ресурсы $(MAIN).res : $(MAlN).rC brc —r -i$(INCPATH) $(MAlN).rc
Листинг 19.12. MDIPAINT.MAK (Microsoft) 1: t ИАКЕ-файл длл MDI Paint 2: t Используйте переключатель /СА 3: 4: MAIN - MDIPaint 5: OBJS = $(MAIN).obj Tsotrop.obj Anlsotrp.obj Normal.obj \ 6: Fern.obj Draw.obj 7: 8: # Компоновка 9: $(HAIN).exe . $(OBJS) $ (MAIN).def $(MAIN),res IC: link/CO 5(OBJS), /align:lC, NUL, /nod llibcew libw, $(MAIN) 11: rc $(MAIN).res 12: 13: (t Компиляция 14: .cpp.obj: 15: cl —c -AL -GA -Ow -W2 -Zp -Zi ( $< j 16: 17: H Ресурсы 18: $ (MAIN).res : $(MAIN).rc 19: ic —r $ (MAIN) -rc Рис. 19.3. Программа MDIPaint имеет дочерние окна различного типа Программа MDIPaint имеет четыре различных дочерних MDI-окна, три из которых демонстрируют одну и ту же фигуру, изображенную в различных режимах отображения. В частности, окно Normal использует режим отображения по умолчанию (ММ_ТЕХТ), окно Isotropic — режим MM ISOTROPIC и Anisotropic — cooi ветствснно MM_ANISOT- ROPIC. Эти три окна я включил сюда для того, чтобы 1рафичсски проиллюстрировать разницу между этими часто используемыми режимами отображения. Четвертое окно демонстрирует ветку папоротника, нарисованную с помощью стандартными фракталь- ными методами. MDJPaint имеет два различных меню. Первое появляется в начале работы программы, а второе — после того как пользователь откроет дочернее окно. Если все дочерние окна закрываются, вновь появляется первое меню. Разница между этими двумя меню в следующем: Первое меню имеет одно выпадающее подменю bile и позволяет пользователю открыть любое из четырех дочерних окон или выгни из приложения. В У второго меню два элемента. Первый, File, позволяет пользователю открыть окна Normal, Isotropic и Anisotropic. Второй, Window, даст пользователю возможность упорядочивать пиктограммы, а также располагать без перекрытия (tile), каскадно накладывать друг на друга или закрывать все дочерние окна.
MDIPaint допускает наличие лишь одной копии окна Fem на рабочем столе. Следуя тому правилу, программа помещает опцию, открывающую окно Fem, только в меню File, появляющемся вначале, или когда все окна закрываются. Это означает, что вы должны вывести окно Fem сразу же или вообще потеряете возможность открыть его. Прежде чем окно Fern будет закрыто, оно предупреждает об этом пользователя. Окно Isotropic предупреждает пользователя, когда приложение закрывается целиком (см. рис. J 9-4). Как правило, при этом пользовате, я спрашивают, хочет ли он сохранить файл. Впрочем, в данном случае предупреждение вставлено просто для того, чтобы показать, как осуществить полный перебор всех дочерних окон и как ответить на сообщения WM_QUERYENDSESSION. Рис. 19.4. Окно Isotropic предупреж чет гюлыооителя о закрытии приложения Поля WNDCIass.hlcon некоторых из дочерних окон программы MDIPa nt полагаются равными NULL. Поэтому при минимизации они сворачиваются в пиктограмму, дубли- рующую пиктограмму основного окна. Замечание. МАКГ-ф1 л для этой программы использует неявное правило для автоматич кой компиляции всех Cl’P-файлов в OBJ-файлы Кроме того, очень важно, чтобы вы использовали п рсключатсль /WE (компилятор фирмы Borland) или /GA (Microsoft) дтя того, чтобы удосто- вериться в правильном экспорте оконных проце iyp этих приложений Чтобы сделать это в среде Borland, выберите Options | Compiler | Entry/Exit Code, а в среде MSVC—Options | Project | Compiler | Windows Prolog/Epilog. Суп, всего этого в том, чтобы гарантировать, что функции, явно помеченные как _export, действительно экспортируются Если вы не предпримите этих шагов, программа может пройти нормально, но отладочная версия Windows будет жаловаться на пропуск. Создание дочерних окон Каждое из дочерних окон может быть запущено как с помощью меню, так и с помощью горячей клавиши (Alt-A для Anisotropic, Alt-I для Isotropic и тл.). В каждом случае сообщение посылается вместе с WM COMMAND, а ответ на него формируется следующим образом (строчка 260 MDI PAINT. СРР): 260: case CK_ANISOTB.OF: 261: CreateMDIChlld(szAnIsotropic, "Anisotropic"); 262: break; CreateMDIChild определяется пользователем и несет в себе известную степень сложности. Механизм создания дочерних окон MDI включает использование SendMessage
для отправки сообщения WM_MDICREATE вместе со структурой MDICREATESTRUCT, содержащей большинство полей, которые можно видеть в обращении к CreateWindow. Структура MDICREATESTRUCT Структура MDICREATESTRUCT выглядит следующим образом: typedef struct tagMDICREATESTRUCT { LPCSTR LPCSTR szClass; szTitle; // Имя класса // Текст полосы заголовка HINSTANCE hOwner; // Экземпляр приложения int x; // Х-координата верхнего левого угла int y* // Н-координата верхнего левого угла int ex; // Х-координата нижнего правого угла int cy; // Y-координата нижнего правого угла DWORD style; // Приложение минимизировано, максимизировано и т.д LPARAM IParam // Пользовательские данные. Обычно NULL } MDICREATESTRUCT; В интеллектуальном плане заполнение этой структуры не представляет большого труда. Впро- чем, в поле стиля можно заносить комбинацию следующих стилей: WS_MINIMIZE WS_MAXIMIZE wsjhscroll WS VSCROLL Создать окно в минимизированном виде Создать окно в максимизированном виде Создать окно с горизонтальной линейкой прокрутки Создать окно с вертикальной линейкой прокрутки Следующий код демонстрирует, как могут выглядеть типичные действия для создания окна (заметьте, что параметр WPARAM в SendMessage должен быль равен нулю). MDICREATESTRUCT MDICreate; MDICreate.szClass MDICreate.szTitle MDICreate.hOwner MDICreate.x MDICreate.у MDICreate. ex MDICreate.cy MDICreate.style MDICreate.IParam = szMyMDIClass = "MyMDIClass" = hlnstnce ; = CW_USEDEFAULT = CW_USEDEFAULT = CW_USEDEFAULT = CW_USEDEFAULT = 0 ; = NULL ; hwndChild = SendMessage{hWndClient, WM MDICREATE, 0, (LPARAM} (LPMDICREATESTRUCT)SMDICreate) ; В только что приведенном описании синтаксиса излагаются основные факты, касающиеся создания дочерних окон MDI. Впрочем, реальный синтаксис, который вы будете использовать можно сравнительно легко упростить. Например, MDIPaint содер- жит следующую функцию, которую можно использовать всякий раз, когда вам требуется создать дочернее окно. 228: HWND CreateMDIChild{LPCSTR szClass, LPCSTR szTitle) 229: { 230: MDICREATESTRUCT MCS; 231: 232: MCS.szClass = szClass; 233: MCS.szTitle = szTitle; 234: MCS.hOwner = hlnstance; 235: MCS.x = CW_USEDEFAULT; 236: MCS.у • = CW_USEDEFAULT; 237: MCS.ex = CW_USEDEFAULT; 238: MCS.cy = CW_USEDEFAULT; 239; MCS. style = WS_CHILD I WS_CLIPSIBLINGS |WS_CLIPCHILDREN| 240: WS S YSMENUI WS_CAPT ION I WS_VISIBLE ; 241: MCS.IParam = NULL; 242: return FORWARD_WM_MDICREATE(hwndClient, SMCS, SendMessage); 243: )
Вызов CreateMDIChiki использует один из макросов WINDOWSX — FOR WARD WM_X На самом деле это программистский трюк, а нс стандартное использо- вание WINDOWSX в том виде, как оно определено в документации фирмы Microsoft Я употребил сю здесь потому, что оп показывает, как избежал» зависания во многих неочевидных случаях приведения типов, например, таких, как тот, что был показан в последнем примере вызова функции SendMessage. Если вы воспользуетесь CrcateMDIChild, создание дочернего окна MDI сведется просто к передаче двух строковых параметров: CreateBDlChildfsy.Fern, "Lar Fern"); из которых первый представляет собой имя класса, а второй — текст для линейки заголовка. Вы можете скопировать CreateM DIChild в ваши собственные программы, но если вы держите его в отдельном модуле, вам, вероятно, потребуется передать HIN- STANCE в качестве третьего параметра. Изменение стиля дочерних окон MDI По собственному опыту я знаю, что самое лучшее — поддерживать поведение MDI-приложений и их дочерних окон, принятое по умолчанию. Впрочем, иногда программистам требуется изменить внешний вид дочернего окна. Если вы решили, что это необходимо, то следует передать MDIS ALLCHILDSTYLES в параметр dwStyle функции CreateWindow при создании рабочего окна MD1: hWr.dCliert - CreateWindow ("HDICLIENT”, KULL, WS_CHILD I WS CLIPCHIJLDBEN I WS VISIBLE I MDISALICHTLDSTYLES, С, C, 0, 0, tiwnd, HMENU(L), hlnstance, (TFSTR) tclientcreatc): На практике при создании дочерних окон вам следует добавить в стилевое поле структуры WM_MDICREATESTRUCT некоторую комбинацию следующих стилей. WS_CHILD, WS CLIPSIBLINGS, WSCLIPCHILDREN, WS SYSMENU, WSCAPTION, WS1 HICKFRAME, WS_MINIHIEEBOX, WSMAXIMIZEBOX, WS VISIBLE Если вы добавите все эти стили, то в конечном итоге получится окно, которое будет выглядеть в точное) и, как стандартное окно MDI Удалите WS_THICKFRAME, WS MAXIMIZEBOX и WS MINIM1ZEBOX, и вы получите дочернее окно MDI, подоб- ное тому, что показано на рисунке 19.5. Рис. 19.5. У данного дочернего окна MDI отсутствуют пиктограммы минимизации и максимизации, а также рамка
Замечание. Запомните, что в тот момент, когда вы используете флажок MDIS_ALLCH1LDSTY- LES, вы должны начинать с указания всех или некоторых из перечисленных выше стилей всякий раз, когда создаете дочернее окно MDI. Один из возможных путей состоит в том, чтобы создать единый стиль, содержащий все перечисленные выше флажки, наподобие стиля WS_OVER- LAPPEDWINDOW из WINDOWS.H. Затем воспользуйтесь логическими поразрядными-хятера- торами для выполнения любых изменений, которые считаете необходимыми. Сообщения MDI, которые должны обрабатываться по умолчанию Существует два набора сообщений, на которые требуется обратить особое внимание при работе с MDI-приложениями. Первый включает сообщения, которые должны быть возвращены из оконной процедуры дочернего окна MDI обратно в Windows: WM_CHILDACTIVATE Управляет размерами, визуальным отображением и перемещением дочерних окон WM_GETMINMAXINFO WM_MENUCHAR WM_MOVE WM^SETFOCUS WM_SIZE Вычисляет размер максимизированного окна Передает в основное окно сообщения о нажатиях клавиш Требуется для линеек прокрутки, если они есть Активизирует дочерние окна, когда они попадают в фокус Существенно при максимизации или восстановлении дочерних окон до прежних размеров WM_SYSCOMMAND Осуществляет управление по умолчанию различными горячими клавишами и командами Большинство этих сообщений вы уже встречали прежде. Фактически описания, которыми я снабдил каждое из этих сообщений, мало что дают для понимания их как таковых. Мои замечания предназначены скорее для того, чтобы показать, почему необходимо передавать эти сообщения в Windows, если вы хотите, чтобы ваши MDIChild работали так, как ожидает пользователь. Ключевой момент, о котором необходимо помнить, состоит в том, что дочерние окна MDI имеют особую “умолчательную” функцию DefMDIChildProc, которую они должны использовать вместо DefWindowProc. Чтобы понять, какое из сообщений должно быть передано транзитом, посмотрите DefMDIChildProc в интерактивном файле помощи, и вы обнаружите копию списка, представленного выше. Замечание. Запомните, что пользуясь WINDOWSX, вы должны явно передавать сообщения в DefMDIChildProc с помощью одного из макросов FORWARD_WM_X вроде того, что использо- вался в предыдущем разделе. Чтобы вы лучше поняли, как это работает, ниже приводится фрагмент FERN.CPP. 130: void FernPlay_OnSize{HWND hwnd, UINT state, int ex, int cy) 131: ( 132: RECT R; 133: GetClientRect(hwnd, SR); 134: MaxX ~ R.right; 135: MaxY = R. bottom; 136: Maxiterations = long{MaxY) * 50; 137: if (state == SIZE_MINIMIZED) 138: Maxiterations « 175; 139: 140: // ОБЯЗАТЕЛЬНО передать сообщение WMJSIZp для обработки по умолчанию 141: FORWARD_WM__SIZE (hwnd, state, ex, cy, FernPlay_DefProc) ; 142: ) FemPlay DefProc, присутствующая в обращении к FORWARD_WM_SIZE, объявля- ется следующим образом: ^define FernPlay_DefProc DefMDIChildProc
Все остальные параметры, посылаемые в FORWARDWMSIZE, копируются из списка аргументов к FemPlayOnSize. Той же самой модели следуют все макросы FORWARD_WM_X. Поэтому ими удобно пользоваться. Специфические сообщения для MDI-приложений Теперь, когда вы знаете некоторые основы, касающиеся дочерних окон MDI, можно обратить внимание на следующие сообщения. Эти сообщения в значительной степени определяют поведение, присущее дочерним окнам MDI. Я сгруппировал эти сообщения в четыре отдельные категории. Первая категория включает сообщения, использующиеся для создания и уничтожения дочерних окон MDI: WM_MDICREATE WM_MDIDESTROY Создает дочернее окно MDI Используется для закрытия дочернего окна MDI Сообщение WM_MDICREATE я уже разобрал подробно. Сообщения WM MDIDESTROY просты в использовании, поскольку они не требуют ничего, кроме дескриптора окна в WPARAM, подлежащего закрытию. Следующие сообщения можно использовать, чтобы найти окно, находящееся в фокусе, а также для изменения фокуса. WM_MDIACTIVATE WM_MDINEXT WM_MDIGETACTIVE Активизирует окно, указанное в WPARAM Устанавливает фокус на следующее окно списка дочерних окон Находит активное окно Сообщение WMMDIACTIVATE играет в программировании под Windows двойную роль. Сначала приложение посылает это сообщение в рабочее окно. На этом этапе своей карьеры WM_ACTFVATE несет в параметре WPARAM дескриптор окна, которое должно быть активизировано. Получив это сообщение, рабочее окно передает его в два дочерних окна: активизируемое и деактивизируемое. Программистам редко требуется явно посылать сообщения WM MDIACTIVATE, но отвечать на них приходится часто: WM_MDIMAXIMIZE: Максимизирует окно WM_MDIRESTORE: Восстанавливает окно в прежних размерах В приложении MDIPaint ответ на эти сообщения является важным, поскольку они сообщают приложению, когда сменить меню. Следующее сообщение, WM_NEXT, посылается в рабочее окно. Это-сообщение активизирует дочернее окно MDI, находящееся позади текущего активного окна. А окно, которое было активным, помещается назад. Список дочерних окон, которыми манипу- лирует данное сообщение, поддерживается Windows и выводится в меню программы. Последнее сообщение этой категории, WM MDIGETACTIVE, представляет собой чрезвычайно полезное сообщение, которое рано или поздно непременно потребуется каждому программисту. При использовании этого сообщения установите WPARAM и LPARAM равными нулю, и ждите дескриптор активного дочернего окна в младшем слове возвращаемого значения. Старшее слово устанавливается равным единице, если запра- шиваемое окно максимизируется. Вы должны посылать это сообщение в рабочее окно. Следующие три сообщения не нуждаются в пространных пояснениях, хотя их важность очевидна: wm_mditile Располагает дочерние окна внутри рабочего окна без перекрытия (мозаично) WM_MdicascadE Располагает дочерние окна каскадно WM MDIICONARRANGE Упорядочивает пиктограммы дочерних окон внутри рабочего окна.
При мозаичном расположении окон вы можете упорядочить их по горизонтали или вертикали, в зависимости от значения флажка, передаваемого в параметре WPARAM. Например, флажок MDITILE_HORIZONTAL создает картинку, изображенную на ри- сунке 19.6, в то время как результат применения MDITILEVERTICAL показан на рисунке 19.7. Рис. 19.6. Горизонтальное мозаичное расположение дочерних окон MDI получается благодаря флажку MDITILE_HORIZONTAL Рис. 19.6. Вертикальное мозаичное расположение дочерних окон MDI получается благодаря флажку MDITILEVERTICAL Последнее сообщение, характерное для дочерних окон MDI, — WM_MDISETMENU. Оно используется в комбинации с сообщениями WM_MDIACTIVATE, как показано в следующем разделе. WM_MDISETMENU Заменяет либо меню, содержащее список дочерних окон, либо основное меню MDI, либо оба этих меню
Управление меню MDI Программа MDIPaint имеет только два меню, но некоторые MDI-программы имеют пять или десять различных меню. Примером подобной программы может служить Borland’s Resource Workshop. Основной момент, о котором необходимо помнить, состоит в том, что меню, показываемое пользователю, должно отражать опции, доступные в данный момент. В нормальных приложениях это не имеет места, поскольку эти приложения выполняют только одну функцию. Однако MDI-приложения могут исполнять несколько различных функций, в зависимости от того, на каком из дочерних окон пользователь установит фокус. Например, пользователям, работающим с Арр Studio, при создании таблицы символьных строк не требуется тот же набор меню, который нужен при создании пиктограммы или растрового изображения. Возникает следующий очевидный вопрос: как узнать, когда пользователь активизи- рует конкретное окно. Прочитав последний раздел, проницательные читатели, вероятно, предположили, что решение этой проблемы состоит в сообщении WM_MDIACTIVATE, которое выходит на сцену, когда окно собирается получить или потерять фокус. Как вы помните, сообщение WMMDIACTIVATE играет в программировании под Windows двойную роль. В своей второй ипостаси оно посылается в дочернее окно, когда последнее собирается получить или потерять фокус. Сообщение WM.MDIACTIVATE При получении сообщения WM_MDIACTIVATE: WParam Не равен нулю, если окно активизировано LPARAM Содержит в своем младшем слове дескриптор активизированного дочернего окна, а в старшем слове дескриптор деактивизированного дочернего окна. При передаче WM_MDIACTIVATE: WPARAM Содержит дескриптор окна, которое должно быть активизировано lparam Должно быть равен нулю Когда это сообщение посылается в дочернее окно, WINDOWSX.H расщепляет его таким образом, что WPARAM оказывается в булевой переменной fActive, а дескрипторы активизирован- ного и деактивизированного окон — в переменных hwndActivate и hwndDeactivate. Пример: SendMessage(hwnd, WM_MDIACTIVATE, hMyMDIChild, 0) ; Следующий код демонстрирует, как окно Fern обрабатывает сообщение WMMDIACTIVATE: 87: void FernPlay_MDIActivate(HWND hwnd, BOOL fActive, HWND 88: hwndActivate, HWND hwndDeactivate)' 89: ( 90: if (fActive) 91: SendMessage (hwndclient, WM_MDISETMENU, 0, 92: MAKELONG(hMenuMultiple, hMenuFileMultiple)); 93: 94: if (!fActive) 95: SendMessage(hwndclient, WM_MDISETMENU, 0, 96: MAKELONG(hMenuInit, hMenuFilelnit)); 97: DrawMenuBar (hwndFrame); 98: ) Как видите, в центре внимания параметр fActive. Он равен TRUE, когда окно получает фокус, и FALSE, когда оно теряет фокус. Это позволяет окну Fem, попадая в фокус, установить свое собственное меню и восстановить основное меню при потере фокуса. MDIPaint использует сообщение WM_MDISETMENU для манипуляции своими меню.
Сообщение WM_MDISETMENU При получении сообщения WMMDISETMENU: WPARAM Указывает, требуется ли актуализировать текущее меню или использовать новое меню, определяемое параметром LPARAM. Актуализация меню включает в себя обновление текущего списка дочерних окон. lparam Младшее слово указывает новое основное меню (меню фрейма). Старшее слово указывает новое меню, в котором должен содержаться список дочерних окон, показываемых пользователю. Используйте WM MDISETMENU для манипуляций с меню MDI-приложения и для указания, какой из пунктов меню должен содержать список доступных дочерних окон. Пример: SendMessage(hWndClient, WM_MDISETMENU, 0, MAKELONG(hMyMenu, hMySubmenu)); M DIPaint использует это сообщение для замены основного меню на то, которое будет действова гь, как только откроется дочернее окно. Это достигается посредством хранения дескрипторов обоих меню в памяти как глобальных переменных с последующей передачей одного из них в качестве параметра сообщения WM_MDISETMENU всякий раз, когда приходит сообщение WMMDIACTIVATE. Вместо использования SendMessage непосредственно (что влечет за собой приведение типов), вы можете использовать макросы из WINDOWSX: FORWARD_WM_MDISETMENU(hwndClient, 0, hMenuMultiple, hMenuMultiple, SendMessage); Каждое приведение типа, выполняемое программистом, таит в себе возможность совершения ошибок, связанных с невниманием, поэтому всякий раз, когда вам требуется использовать сообщение SendMessage, определенно стоит задуматься о целесообразности использования макросов WINDOWSX. Запомните, что эти макросы помогут вам гаран- тировать, что ваш код пойдет как на 16-битовый, так и на 32-битовой платформе. Замечание. MDIPaint устанавливает новое меню всякий раз, когда активизируется дочернее окно. Это делается посредством посылки сообщений WM_SETMENU непосредственно в рабочее окно. Эта проверенная временем и всеми используемая техника еще не вызывала у меня никаких затруднений. Впрочем, фирма Microsoft недавно выпустила документацию, рекомендующую помещать сообщение в очередь фрейма и предоставлять ему возможность самому уведомить свое рабочее окно о том, что пора установить новое меню. Хочу подчеркнуть, что сообщение следует посылать в очередь фрейма. Не пользуйтесь SendMessage. Завершение работы Следующий ключевой момент, который вам необходимо знать в отношении MDI- приложений, — это подходящий способ их закрытия. В этом разделе констатируется следующее: При закрытии MDI-приложения вы можете использовать сообщения WM_QUERYENDSESSION и WM_CLOSE, чтобы программа дала пользователю шанс сохранить сделанную работу. Если дочернему окну нужно предложить пользователю сохранить работу, оно отве- чает на сообщение WM_CLOSE всякий раз, когда может закрыться. Каждое дочернее окно может реагировать на сообщения WM_QUERYEN DSESSION, которые посылаются программой MDIPaint, когда пользователь хочет закрыть все приложение. MDIPaint может обойти все свои дочерние окна, посылая каждому из них сообщение WM_QUERYENDSESSION. Для этого используется функция EnumChildWindows.
Ниже каждый их этих тезисов разбирается подробно, так что вы сможете получить полный обзор вопросов, касающихся закрытия дочерних окон или всего MDI-приложения. Когда наступает пора закрыть приложение или окно, вам требуется проследить два различных сообщения: WM_QUERYENDSESSION и WM_CLOSE. Вы должны отвечать на эти сообщения так, чтобы у пользователя была возможность сохранить свою работу. (Программе MDIPaint не требуется отвечать на эти сообщения, поскольку ни в одном из ее окон нет никаких наработок, которые надо было бы сохранять. Впрочем, я все равно сделал это, чтобы вы могли видеть, как происходит этот процесс). Сообщения WM_QUERYENDSESSION обычно посылаются менеджером программ или другой оболочкой Windows, когда наступает пора закрываться. Если в ответ на это сообщение приложение возвращает значение TRUE, выполняется закрытие; иначе сеанс продолжается. Для MDI-приложений стало обычным посылать сообщение WM_QUERYENDSES- SION в свои дочерние окна, чтобы убедиться, что они готовы закрыться. Иначе говоря, если пользователь желает закрыть целое приложение, MDIPaint посылает это сообщение каждому из своих дочерних окон. Если они возвращают TRUE, MDI-приложение закрывается; в противном случае сеанс продолжается. Теперь уже вы должны быть в состоянии предположить, каким образом окно может отреагировать на это сообщение. Например, ниже приводится фрагмент, показывающий, как окно Isotrop реагирует на получение сообщения WM_QUERYENDSESSION: 47: BOOL Isotrop_OnQueryEndSession(HWND hwnd) 48: ( 49: if (IDOK != MessageBox (hwnd, "OK to close window?", 50: "Isotropic", MB^ICONQUESTION I MB_OKCANCEL)) 51: return FALSE; 52: else 53: return TRUE; 54: ) Если пользователь выбирает мышью системную пиктограмму дочернего окна, то это окно получает сообщение WM_CLOSE. Таким образом, вы должны реагировать на сообщение WM_CLOSE так же, как вы реагируете на сообщение WM_QUERYENDSES- SION. В качестве примера рассмотрите функцию Fem OnClose (строчка 101 FERN.CPP). Во-первых, вас может смутить разница между сообщениями WM_CLOSE и WM_QUERYENDSESSION в случае MDI-приложений. Для того чтобы графически проиллюстрировать затронутые вопросы, я снабдил окно Fern ответами на оба сообще- ния (в то время как окно Isotrope реагирует только на сообщения WM_QUERYEND- SESSION). Попробуйте по-разному закрыть оба окна: через дочерние системные пиктограммы, закрытием приложения MDIPaint и закрытием всей Windows. Различные реакции, которые вы увидите, помогут вам уяснить для себя, как именно работают эти два сообщения. В частности: Окно Fem реагирует на все три способа закрытия, поскольку оно обрабатывает как WM_CLOSE, так и WM_QUERYENDSESSION. Окно Isotrop закрывается без проблем с помощью системной пиктограммы. Однако, если вы закрываете все приложение или Windows, оно отображает окно сообщения. Это происходит потому, что окно Isotrop реагирует на WM_QUERYENDSESSION, а не на WM_CLOSE. Когда пользователь запрашивает закрытие MDIPaint, программа может пройти по всем своим дочерним окнам посредством вызова EnumChiidWindows. Например, если пользователь щелкает мышью на системной пиктограмме основного окна MDIPaint, вызывается WM_CLOSE. Затем WM_CLOSE высылает стандартное сообщение CM_CLOSEALL, которое вызывает следующую реакцию MDIPaint: 300; case CM_CLOSEALL: // Закрытие всех дочерних окон 301: IpfnEnum = (WNDENUMPROC)MakeProcInstance( 302: (FARPROC)EnumChildWnds, hlnstance); 303: EnumChiidWindows (hWndClient, IpfnEnum, 0L); 304: FreeProcInstance ((FARPROC)IpfnEnum); 305: break;
Этот код описывает классический полный перебор объектов, неоднократно виден- ный вами в этой книге. В частности, EnumChildWindows проходит по всем дочерним окнам, принадлежащим конкретному родителю, как то: диалог, основное окно или рабочее окно MDI. В MDIPaint обработчик перечисляемых дочерних окон, вызываемый из функции EnumChildWindows, выглядит следующим образом: 342: BOOL CALLBACK EnumChildWnds(HWND hwnd, LONG IParam) 343: ( 344: if (GetWindow(hwnd, GWOWNER)) // Заголовок пиктограммы? 345: return TRUE; 346: 347: SendMessage (GetParent(hwnd), WM_MDIRESTORE, (WPARAM)hwnd, 0L); 348: if ((SendMessage (hwnd, WMQUERYENDSESSION, 0, 0L)) 349: return TRUE; 350: 351: SendMessage (GetParent (hwnd), WM_MDIDESTROY, (WPARAM) hwnd, 0L) ; 352: return TRUE; 353: } Эта функция вызывается по одному разу для каждого из дочерних окон, находящихся в рабочем окне MDI, и получает дескриптор дочернего окна в качестве своего первого параметра. Код сначала проверяет, является ли запрашиваемое дочернее окно заголовком пиктограммы. Если это так, он прекращается без каких-либо дальнейших действий. Если окно является действительным дочерним окном MDI, то следующий шаг состоит в восстановлении этого окна до прежних размеров и посылки ему сообщения WM_QUERYENDSESSION. Если окно не желает закрываться, EnumChildWindows об- рывается. В противном случае EnumChildWindows закрывает его с помощью сообщения WM_MDIDESTROY. После того как приложение осуществило полный перебор своих дочерних окон, управление возвращается исходной функции ответа на сообщение WMCLOSF (строчка 212 MDIPAINT.CPP). Затем MDIPaint может проверить, все ли дочерние окна уже закрыты. Если это не так, то приложение знает, что завершаться пока рано; в противном случае оно закрывается сразу. Очевидно, существует сотня вариаций, которые можно было бы проделать в связи с последним заданием, некоторые из которых значительно более элегантны, нежели относительно упрощенный подход, реализованный в программе MDIPaint. Однако приведенный пример достаточен, чтобы показать, как следует закрывать MDI-приложе- ния, гарантируя, что пользователь не потеряет актуальную информацию. Дополнительные байты и разделение ЦП Прежде чем перейти к обсуждению MM_ISOTROPIC и MM ANISOTROIPIC, я хочу задержаться, чтобы осветить два момента: Если вам требуется сохранить специфическую оконную информацию, используйте поле cbWndExtra структуры WNDCLASS. Окно Fem интересно, поскольку оно демонстрирует один из способов разделения времени ЦП между остальными окнами и приложениями во время вычислений. Первый момент на самом деле чрезвычайно важен. Дело в том, что у вас может быть несколько копий конкретного типа окна, открытых внутри рабочего окна MD1, и каждая из них может иметь определенное количество ассоциированных с ним специфических данных. Например, если у вас есть три окна редактирования, открытых одновременно в программе MDI, каждое из них может иметь свой блок ассоциированного с ним текста. Для того чтобы обработать подобную ситуацию, вам следует воспользоваться полем cbWndExtra, как было показано в программе дочернего окна, которую вы видели в главе 14. Как вы помните, ключами к этому процессу являются функции SetWindowWord, SetWindowLong и GetWindowLong.
Следующим моментом, который требует обсуждения, является цикл, рисующий фрактальное изображение папоротника в окне Fem. Этот код является переводом программы на языке Паскаль, написанной Ларом Мэйдером, инженером технической поддержки и классным Windows-хакером, работающим в фирме Borland. Оригинальный код Лара использовал функцию PeekMessage, чтобы гарантировать, что программа не будет воровать время ЦП у остальных приложений. Дело в том, что окно Fem может потребовать значительного периода времени для завершения прори- совки. Если она будет делать это, не отдавая управления Windows, то могут возникнуть определенные неприятности. Полагаю, что разумный выход из этой ситуации — воспользоваться PeekMessage. Другое решение, которое обычно легче для реализации, заключается в посылке сообще- ний WM_TIMER в функцию. Всякий раз, когда приходит сообщение, функция может немного поработать, а затем вернуть управление обратно Windows. Поскольку таймеры обычно довольно медлительны, лучший способ — выполнить две или три сотни итераций цикла, а затем передать управление обратно Windows. Выполнение по одной итерации за раз может сделать этот процесс невыносимо долгим. MdIPaint использует для рисования папоротника сообщение WM_TIMER. Впрочем, если приложения должны удовлетворять более изощренным требованиям, следует ис- пользовать PeekMessage. Так или иначе ключевой момент состоит в том, что никакое первосортное приложение Windows не украдет у ЦП слишком много времени, разве что при очень стесненных обстоятельствах. Отображение папоротника на экране определен- но таковым не является. Isotropic и Anisotropic Программа MDIPaint позволяет мне выполнить обещание, которое я дал вам в главе 18. Там объяснялись режимы отображения ММ_ТЕХТ, MM_LOENGLISH, MM_HIENGLISH, MM_LOMETRIC, MM_HIMETRIC и MM_TWIPS. Осталось разо- брать еще два режима отображения: MM_ISOTROPIC и MM_ANISOTROPIC. Програм- ма MDIPaint демонстрирует их, рисуя одну и ту же картинку с неизменными размерами в каждом из этих режимов отображения и один раз в режиме ММ_ТЕХТ (см. рис. 19.8). Рис. 19.8. Результат изменения режима отображения при неизменных размерах рисунка Оба этих режима отображения используются в основном, когда программисту требуется построить максимально большое изображение внутри окна, которое будет часто изменять свои размеры. Классическими примерами приложения этого типа являются программы Clock и Paintbrush, поставляемые вместе с Windows. Когда окно
приложения Clock мало, то и сами часы малы. Если пользователь увеличивает размер окна приложения, то часы вырастают, занимая все возможное пространство. Ниже предельно кратко показана разница между MM_ISOTROPTC, ММ ANISOTROPIC и стандартными режимами отображения: Используйте М M ISOTROPIC, если вы хотите, чтобы ваша картинка сохраняла свои пропорции, как это делается в программе часов. Используйте MM ANISOTROPIC, если вы хотите растянуть свой рисунок так, чтобы он занимал все доступное пространство, как в программе Paintbrush. Используйте любой другой режим отображения, если вы хотите, чтобы ваш рисунок сохранял свои размеры независимо от размера окна. Например, таким образом работает менеджер программ. Исследуя программу MDIPaint, вы должны заметить, что геометрические фигуры, изображенные в окне Anisotropic, искажаются, чтобы максимально заполнить доступное пространство (см. рис. 19.9). Все это имеет очень много общего с функцией StretchBlt. Рис. 19.9. Изображение внутри окна со стилем MM_ANISOTROPJC пытается заполнить все доступное пространство независимо от величины окна С другой стороны, фигура внутри окна MM_ISOREOPIC, всегда сохраняет свои пропорции. Принятые здесь концепции очень напоминают те, с которыми вы встреча лись при вычислении подходящего коэффициента сжатия в типичной графической программе DOS (см. рис. 19.10). Рис. 19.10. Изображение внутри окна со стилем MM_ISOTROPIC всегда сохраняет свои первоначальные пропорции Наконец заметьте, что фигура в окне Normal никогда не изменяется, как бы вы не изменяли размеры окна, в котором она располагается. В итоге части этой фигуры могут потемнеть, если окно сжимается слишком сильно. Следующий код используется для загрузки окна Isotropic: 95: SetMapMode (PaintDC, MM_ISOTROPIC); 96: GetClientRect(hwnd, SR); 97: SetWindowExt(PaintDC, 210, 210); 98: SetViewportExt(PaintDC, R.right, R.bottom) ; 99: SetViewportOrg(PaintDC, R.right / 2, R.bottom /2); Программа MDIPaint сначала устанавливает режим отображения, а затем размер отображения окна. Загляните в модуль DRAW. СРР и вы увидите, что наибольший прямоугольник, изображенный в окне Isotrop, имеет размер 200x200. Следовательно,
окно Isotrop устанавливает себя так, чтобы всегда быть немного больше 200x200 логических единиц измерения. Обращения к SetWindowExt и SetViewportExt обязательны при работе с окнами MM_ISOTROPIC. Цель этих двух вызовов заключается в том, чтобы дать Windows достаточно информации для преобразования физических координат устройства в логи- ческие и наоборот. Окно Isotrop размером 420x420 будет имеет два физических пиксела на каждый логический пиксел, указанный пользователем. Дело в том, что окно Isotrop всегда будет иметь 210x210 логических пикселов независимо от того, каким образом пользователь изменит его размер. Следовательно, если пользователь задает размеры окна так, что его физические координаты будут равны 420x420, Windows должна визуально отобразить два физических пиксела для каждого логического пиксела, или находящаяся внутри фигура не заполнит подходящим образом окно. Заключительный шаг состоит в том, чтобы передвинуть исходную картинку в центр экрана посредством вызова SetViewportOrg. Этот вызов необязателен, но MDIPaint выполняет его, чтобы упростить построение поворачивающихся квадратов. Код установки для окна Anisotropic выглядит в точности так же, как и код, показанный ранее, за исключением того, что вместо режима отображения MM_ISO- TROPIC выбран MM_ANISOTROPIC. Если вы хотите сравнить их, смотрите строчку 77 файла ANISOTRP.CPP. Резюме В данной главе вы изучили окна MDI и режимы отображения MM_ISOTROPIC и MMANISOTROPIC. В частности, были освещены следующие моменты: И Окна MDI следуют стандарту CUA, установленному фирмой IBM. Окно MDI можно создать посредством передачи сообщений WM_MDICREATE. И Чтобы установить дочернее меню MDI, требуется ответить на сообщения WM_MDIACTIVATE. Для хранения данных, относящихся к данному окну, используйте поле дополнитель- ных байтов структуры WNDCLASS. Для того чтобы выдать пользователю соответствующее предупреждение прежде, чем закроется дочернее окно, необходимо ответить на сообщения WM_QUERYENDSESSION и WM_CLOSE. Существуют некоторые сообщения, которые MDI-приложения обязаны передавать в DefMDIChildProc. Н Удостоверьтесь, что разделяете время ЦП с остальными окнами или приложениями. Если хотите, чтобы картинка автоматически расширялась или сжималась вместе с окном, где она располагается, используйте MM ANISOTROPIC и MM_ISOTROPIC. Следует сказать, что спецификации MDI представляют собой довольно головолом- ную часть работы, которой любому Windows-программисту рано или поздно придется овладеть. Хотя работа с приложениями такого рода не особенно трудна, при програм- мировании следует быть внимательными. Наградой вам будет интерфейс, одновременно и мощный, и легкий в использовании. Вопросы и ответы 1. Я все еще не понимаю разницы между фреймом и рабочим окном. В чем тут дело? Фрейм — это стандартное основное окно MDI-приложения. У него есть дочернее окно, которое называется рабочим. Класс MDIClient предопределен в Windows и содержит большинство характеристик, ассоциированных с приложениями MDI. Рабочее окно буквально накрывает фрейм и знает, как отвечать на большинство специфических
для MDI сообщений. Пользователь должен позаботиться об оконной процедуре для фрейма, но не для рабочего окна. Вместо DefWindowProc фреймы MD1 должны вызывать DefFrameProc. Не забывайте передавать сообщения WM_COMMAND в DefFrameProc! 2. В чем разница между PeekMessage и GetMessage? Функция PeekMessage отслеживает очередь сообщений Windows. Если сообщение присутствует в очереди, то эта функция возвращает его; в противном случае функция завершается и дает вам возможность продолжать работу. Функция GetMessage не завершится до тех пор, пока не получит сообщение, которое она должна доставить. Поскольку PeekMessage использует циклы часов, эту функцию следует применять только в случае крайней необходимости и возвращаться к стандартному циклу опроса сообще- ний Windows как можно скорее. Вопросы для самопроверки 1. Какой класс вы используете для создания рабочего окна MDI? 2. Какая функция используется для перебора дочерних окон, находящихся внутри рабочего окна MDI? 3. Какое сообщение можно послать, чтобы выяснить, какое из дочерних окон MDI находится в фокусе? 4. Какое сообщение посылается, когда какое-либо дочернее окно MDI получает или теряет фокус? 5. Какова цель поля LPARAM, сопровождающего сообщение WMMDISETMENU? 6. Как узнать, что программа Clock, распространяемая вместе с Windows, использует стиль MMJSOTROPIC? 7. Какую структуру вы должны заполнять всякий раз, когда создаете дочернее окно MDI? 8. Какое сообщение посылает оболочка Windows, когда пользователь хочет закрыть всю среду? 9. Откуда при полном переборе дочерних окон вы сможете узнать, является ли окно настоящим окном или просто заголовком пиктограммы? 10. Если в рабочем окне MDI имеется несколько копий дочернего окна конкретного класса, как вам сохранить данные, ассоциированные с каждым экземпляром этого класса? Упражнения 1. Измените обращения к CreateWindow и MDICreateChild таким образом, чтобы претрамма MDIPaint создавала дочерние окна, которые не имели бы окантовки и не могли бы быть минимизированы. 2. Добавьте в меню М DIPaint опцию, позволяющую пользователю располагать окна без перекрытия по вертикали или горизонтали.
День 20 МУЛЬТИМЕДИА Сегодня вы узнаете о динамически присоединяемых библиотеках (DLL) и мульти- медийных расширениях Windows. Сердцевину этой главы составляет программа Har- mony, использующая DLL для демонстрации простых в использовании приемов воспроизведения CD-ROM, MIDI- и WAVE-файлов. Попутно вы также узнаете о создании так называемого диалогового окна, которое на самом деле является стандартным диалогом, использующимся в качестве основного окна программы. Список тем, которые будут затронуты сегодня, включает в себя: Интерфейс управления носителями (MCI), формирующий одно из ключевых связу- ющих звеньев в мультимедийных расширениях Windows. Функцию mciSendCommand, играющую центральную роль в MCI. Утилиту ImpLib и ключевое слово export, которые можно использовать для упро- щения создания DLL. Использование CreateDialog вместо CreateWindow в том случае, когда вы хотите, чтобы диалог находился в центре внимания Windows-программы. Покрутив на языке фразы “Библиотека динамической компоновки” и “Мультиме- дийное расширение Windows”, можно предположить, что этот материал чрезвычайно труден. Однако на самом деле обоими этими предметами на удивление легко овладеть. Фактически даже технический прием использования диалога в качестве основного окна оказывается настолько простым, что на его объяснение требуется лишь несколько абзацев. Так что можете немного расслабиться. Весь материал, включенный в эту главу, доступен и понятен. Настало время пожинать плоды своего труда. Вы проделали тяжелую работу и теперь (в этой и следующей главах) будете собирать урожай. Поиск определения для мультимедиа Средства мультимедиа настолько новы, что полезно будет потратить несколько минут на прояснение самого этого понятия. Первый термин, который необходимо себе уяснить, — МРС, или мультимедийная PC Эго стандарт аппаратного обеспечения, определяющий конфигурацию персональ- ного компьютера, способного воспроизводить мультимедийные программы. Ключевыми элементами стандарта МРС являются 386-й или лучший компьютер с видеосистемой VGA, мышью, звуковой картой и CD-ROM. Программа, приведенная в этой главе, была протестирована на двух 486-х компью- терах, один из которых был снабжен картой Sound Blaster Pro фирмы Creative Labs, a другой — приводом CD-ROM фирмы NEC. Звуковая карта, подобная той, которую я использовал, является необходимым средством для воспроизведения MIDI- и WAVE-
файлов с помощью кода, представленного в этой книге, и уж конечно, вы не сможете воспроизводить компакт-диски без привода CD-ROM или какого-либо аналогичного устройства. Замечание. Если у вас нет какого-либо из перечисленных средств, то вы не сможете выполнить код, приведенный в этой главе. Важно понимать, что широко распространенного файла SPEAKER.DRV недостаточно для работы с включенной в эту главу программой. Причина этого в том, что вызовы, использующиеся в этой главе, представляют собой слишком низкий уровень для ограниченной поддержки WAV-файла драйвером SPEAKER.DRV Теперь, когда вы узнали о необходимых требованиях к аппаратному обеспечению, можно перейти к обсуждению различных устройств, перечисленных в этой главе. Вполне можно допустить, что всякий знает, что такое CD-ROM. Однако WAV- и MIDI-файлы для многих могут оказаться новинкой. WAV-файл — это стандарт фирмы Microsoft на формат файла, обычно использую- щегося для записи немузыкальных звуков вроде человеческого голоса или автомобиль- ного гудка. Нужно знать, что в WAV-файле может храниться около 1 секунды звука на 11К дискового пространства или 1 минута звука на 1 мегабайт. Поэтому это средство можно рассматривать как чрезвычайно интенсивно использующее диск, из-за чего оно применяется большей частью для хранения коротких звуковых эффектов. Слово MIDI представляет собой аббревиатуру названия Musical Instrument Digital Interface (цифровой интерфейс музыкальных инструментов). Грубо говоря, MIDI-файлы содержат ряд нот (ми диез, до бемоль и т.п.), которые могут быть направлены в синтезатор с указанием воспроизведения каждой из них “голосом” определенного инструмента, например, пианино, рожка или гитары. Синтезатор, который я использовал при написании программы Harmony, является стандартной частью карты Sound Blaster Pro. Большая часть звуковых карт и MIDI-фай- лов может проигрывать от 6 до 16 нот за раз и имитировать от 3 до 9 инструментов. MIDI-файлы могут сохранять 1 минуту достаточно высококачественного музыкального звука на 5К дискового пространства. Очевидно, что MIDI-файлы гораздо эффективнее WAV-файлов во многих отношениях. Сужение фокуса Теперь, когда вы кое-что знаете об использующихся средствах, можно сосредото- читься на приемах программирования, предназначенных для создания генерируемых компьютером звуков. Фирма Microsoft предусматривает три отдельных интерфейса, с помощью которых вы можете получить доступ к устройствам мультимедиа. Два из них являются частью MCI, третий представляет собой низкоуровневый интерфейс, чрезвы- чайно суровый и требовательный. Интерфейс низкого уровня не соответствует этой книге, так что нам остается рассмотреть только два оставшихся технических приема программирования. Первый — строковый интерфейс, предназначенный в основном для поддержки языков очень высокого уровня, таких, как Visual Basic. Поскольку у нас книга по программированию на языке Си, лучше всего, пожалуй, рассмотреть третий прием — мощный интерфейс, основанный на сообщениях. Интерфейс командных сообщений MCI очень сильно зависит от стандартной под- программы mciSendCommand, имеющей 4 параметра. Функция mciSendCommand DWORD mciSendCoinmand (UINT, IUNT, DWORD, DWORD); lUNf dDevicelD UINT wMessage DWORD dwParaml IjW<51<D dwParam2 Идентификатор текущего устройства Сообщение, указывающее требуемое действие Флажки, характеризующие поле wMessage Указатель структуры, содержащей дополнительные данные
Функция mciSendCommand возвращает 0 в случае успешного завершения. В противном случае она возвращает информацию об ошибке, которая может быть передана в mciGetErrorString, а та, в свою очередь, посылает команду в MCI, автоматически выполняющий требуемое действие. Пример: MCI_STATUS_PARMS Info; DWORD ErrorNum, Flags; inemset (blnfo, 0, sizeof (MCI_STATUS_PARM) ) ; Info.dwltem = MCI_STATUS_LENGHT; Flags = MCI_STATUS_ITEM; mciSendCommand (wDevicelD, MCI_STATUS, Flags, DWORD(&Info)); Первый параметр, передающийся в mciSendCommand — это дескриптор или число- вой идентификатор, использующийся для идентификации конкретного запрашиваемого устройства. Когда Harmony первый раз открывает устройство CD-ROM, она передает в качестве этого параметра 0, поскольку у нее еще нет идентификатора для устройства. Однако впоследствии она передает идентификатор, возвращенный Windows. Ключом к этому интерфейсу является второй параметр, представляющий собой сообщение, переправляющее конкретную команду. Ниже приведен список 12-и наибо- лее часто применяемых сообщений и их смысловые значения. MCI_GETDEVCAPS MCI_CL0SE MCI_INFO MCI_OPEN mci_play MCI_RECORD Запрашивает возможности устройств Закрывает устройство Запрашивает тип использующегося аппаратного обеспечения Открывает устройство Воспроизводит мелодию или какой-либо ее отрывок на устройстве Записывает на устройство MCI_RESUME Возобновляет воспроизведение или запись MCI_SEEK Прокручивает носитель вперед или назад MCI_SET MCI_STATUS Изменяет настройку устройства Находится ли устройство в режиме паузы, воспроизведения и т.д. MCI_STOP Останавливает воспроизведение или запиеь Эти команды дополняет набор флажков и записей, дающих программисту своего рода звуковой контроль (как при записи на магнитофон), необходимый для правильного выполнения работы. Например, сообщение MCI PLAY имеет четыре важных флажка, которые могут сформировать третий параметр, будучи объединенными посредством логического ИЛИ: MCI_NOTIFY MCI_WAIT Помещает сообщение MM_MCINOTIFY в очередь по завершении Завершает операцию до возвращения MCI_FR0M MCI_TO Указывает начальную позицию Указывает конечную позицию Последние два флажка, представленные здесь, могут быть объединены посредством логического ИЛИ следующим образом: MCI_FROM | МС1_ТО Тем самым они информируют MCI, что начальная и конечная позиции будут указаны в последнем параметре.
Четвертый параметр — это указатель структуры, поля которой изменяются в зависи- мости от посылаемого сообщения. Структура, соответствующая MCI_PLAY, выглядит следующим образом: typedef struct { DWORD dwCallback; DWORD dwFrom; DWORD dwTo; } MCI_PLAY_PARMS; • Замечание. Соблюдается следующее соглашение об именовании: MCI_STATUS работает с MCI_STATUS_PARMS, a MCI_OPEN работает с MCI_OPEN_PARMS. Все структуры мультимедиа или константы, обсуждающиеся в этой книге, перечислены в интерактивном файле помощи и в MMSYSTEM.H. Вам определенно следует найти время для ознакомления с этими файлами. Иногда требуется заполнять все три поля этой структуры, а бывает, что только одно из них или вообще ни одного. Например, если вы устанавливаете во втором параметре функции mciSendCommand флажок MCI_NOTIFY, то, возможно, потребуется устано- вить dwCallback равным дескриптору окна, которое вы хотите известить об MCI-команде. В частности, если в момент начала воспроизведения WAV-файла вы находитесь внутри диалога, то должны передать в поле dwCallback дескриптор HWND диалога, чтобы этот диалог информировался сообщением MM_NOTIFY об окончании воспроизведения WAV-файла. Разумеется, если вы установите оба флажка, MCIFROM и МС1_ТО, то вам придется заполнить поля dwFrom и dwTo записи MCI_PLAY_PARMS (и т.д.). Единственный из главных аспектов функции mciSendCommand, еще не обсуждав- шихся мною, — это возвращаемое ею значение, которое представляет собой номер ошибки, хранящийся в младшем слове длинного целого. Фирма Microsoft предусмотрела функцию mciGetErrorString, формирующую готовую строку, в которой поясняется ошибка. Функция mciGetErrorString даже посылает вам маленькое приятное сообщение, что все прошло нормально, если это действительно так. Функция mciGetErrorString UINT mciGetErrorString(DWORD, LPSTR, UINT) DWORD dwError Код ошибки, возвращаемый mciSendCommand LPSTR IpstrBuffer Буфер, в котором хранится сообщение об ошибке Iunt wLenght: Длина буфера IpstrBuffer mciGetErrorString возвращает TRUE в случае успеха mciSendCommand возвращает список ошибок, имевших место. Функция mciGetEr- rorString возвращает строку, описывающую ошибку, как показано на рисунке 20.1. Пример: char S[MsgLen]; if (!mciGetErrorString(RC, S, MsgLen)); stcpy(S, "No message available"); Рис. 20.1. Описание ошибки, возвращаемое функцией mciGetErrorString
Нахождение общего языка с MCI Если вы никогда не сталкивались ни с чем, подобным интерфейсу MCI, потребуется в нескольких словах объяснить суть дела. MCI содержит внутри системы, основанной на сообщениях, мультимедийный API, избавляющий программиста мультимедиа от деталей фактического кода. Иначе говоря, при использовании этого интерфейса среднего уровня не приходится вызывать реальные функции мультимедийного API. Причина этого в том, что аппаратное обеспечение и операционные системы быстро меняются. В результате API вынуждены изменяться вместе с ними. Когда API изменя- ется, основа существующего кода устаревает и прошлогоднюю работу приходится делать сначала. Основанный на командных сообщениях интерфейс MCI защищает программиста от любых изменений API. На практике вы лишь посылаете сообщения в “черную дыру”. Что происходит внутри нее, вас не касается. (Чтобы лучше понять это, запустите программу Harmony с помощью отладочной версии Windows.) За пять лет CD могут измениться неузнаваемо, но это не должно повлиять на код. Для нас важно только воспроизведение конкретной звуковой дорожки. Как она будет воспроизводиться, не наше дело. \ Другое существенное преимущество этого стиля программирования в том, что он дает пользователю стандартный интерфейс с абсолютно разной аппаратурой. Например, командный интерфейс MCI работает со следующими типами устройств: anima tion cdaudio dat digitalvideo scanner sequencer ver videodisk waveaudio Анимационное устройство CD-аудио » Цифровой магнитофон Цифровой видеомагнитофон Сканер MIDI Видеомагнитофон Проигрыватель видеодисков Устройство воспроизведения WAV-файлов MCI старается найти вещи, общие для всех перечисленных выше устройств, и использовать их для объединения устройств по сходным признакам. В частности, всем этим устройствам свойственны режим воспроизведения, остановки, паузы, поиска конкретного места на носителе и т.д. Словом, все они реагируют на набор команд, перечисленных выше, т.е. на основные сообщения MCI. Поговорим о независимости от устройства. Мультимедийные расширения Windows не только защищают вас от деталей, связанных с работой конкретного устройства, но также позволяют вам обращаться со всеми устройствами одним и тем же образом. Например, в программе Harmony один и тот же код используется для воспроизведения WAV- и MIDI-файлов. Единственная разница в том, что в одном случае вы говорите MCI, что хотите работать с устройством waveaudio, а во втором случае с устройством sequencer. Программа Harmony Листинг 20.1. HARMONY.CPP 1: /////////////////////////////////////////// 2: // Программа: HARMONY.CPP 3: // Автор: Чарли Калверт 4: // Описание: Harmony — программа для WINDOWS 5: // Дата: 08/07/93 6: ///////////////////////////////////////////
7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78; 79: 80: 81: «define STRICT «include <windows.h> «include <windowsx.h> «include <mmsystem.h> «include <stdio.h> «include <string.h> «include "harmony.h" «include "playinfo.h" «include "cdinfo.h" «include "cdutil.h" «include "wavemidi.h" «pragma warning (disable: 4068) /////////////////////////////////////// // Интерфейс ////////////////////////////////////// static char szAppNamet] = "Harmony"; static HWND MainWindow; static HINSTANCE hlnstance; BYTE State; BYTE PlayType; char DirStr[DIRSTRSIZE]; char DeviceString[DEVICESTRSIZE]; static char NoCDOnSystern; // ---========== // Инициализация // ===------====: /////////////////////////////////////////////////////// // Точка входа lll/IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIHIIIIII «pragma argsused int PASCAL WinMain(HINSTANCE hinst, HINSTANCE hPrevInstance, LPSTR IpszCmdParam, int ncmdShow) ( MSG Msg ; if ((hPrevInstance) if ((Register(hinst)) return FALSE; if (((MainWindow = Create(hinst, nCmdShow))) return FALSE; while (GetMessage(SMsg, NULL, 0, 0)) ( TranslateMessage(SMsg); DispatchMessage(SMsg); ) return Msg.wParam; ) /////////////////////////////////////////////////// // Регистрация окна /////////////////////////////////////////////////// BOOL Register(HINSTANCE hinst) ( WNDCLASS WndClass; Wndclass. style = CS_HREDRAW | CS VREDRAW; WndClass.IpfnWndProc = WndClass.cbClsExtra = WndClass.cbWndExtra = Wndclass.hlnstance = WndClass.hlcon WndClass.hCursor = WndClass.hbrBackground = Wndclass.IpszMenuName = Wndclass.IpszClassName = WndProc; 0; DLGWINDOWEXTRA; hinst; Loadicon(NULL, IDI_APPLICATION); LoadCursor(NULL, IDC_ARROW); GetStockBrush(WHITE_BRUSH); NULL; szAppName; return Registerclass (&WndClass);
82: ) 83: 84: ///////////////////////////////////////////////////////// 85: // Создание окна 86: ///////////////////////////////////////////////////////// 87: HWND Create (HINSTANCE hlnst, int nCmdShow) 88: { 89: 90: hlnstance = hlnst; 91: 92: HWND hwnd = CreateDialog(hlnst, szAppName, 0, NULL); 93: 94: if (hwnd = NULL) 95: return hwnd; 96: 97: if (NoCDOnSystem) 98: EnableWindow (GetDlgltemfhwnd, CM_COMPACT) , FALSE); 99: 100: Showwindow(hwnd, nCmdShow); 101: 102: return hwnd; 103: ) 104: 105: ////////////////////////////////////////// 106: // Реализация 107: ////////////////////////////////////////// 108: 109: ////////////////////////////////////////// 110: // Оконная процедура 111: ///////////////////////////////////////// 112: LRESULT CALLBACK _export WndProc (HWND hwnd, UINT Message, WPARAM 113: wParam, LPARAM IParam) 114: ( 115: switch(Message) 116: { 117: HANDLE_MSG(hwnd, WM_CREATE, Harmony_OnCreate); 118: HANDLE_MSG(hwnd, WM_DESTROY, Harmony_0nDestroy); 119: HANDLE_MSG(hwnd, WM_FILLLISTBOX, Harmony_OnFillListBox); 120: HANDLE_MSG(hwnd, WM_COMMAND, Harmony_0nCommand); 121: HANDLEJ4SG(hwnd, MM_MCINOTIFY, Harmony_OnMCINotify); 122: HANDLE_MSG(hwnd, WM_TIMER, Harmony_OnTimer) ; 123: default: return Harmony_DefProc(hwnd, Message, wParam, IParam); 124: ) 125: ) 126: 127: flpragma argsused 128: BOOL Harmony_OnCreate (HWND hwnd, CREATESTRUCT FAR* IpreateStruct) 129: { 130: PlayType = WAVE; 131: State = CLOSED; 132: strcpy(DeviceString, ''waveaudio"); 133: GetWindowsDirectory(DirStr, 200); 134: FORWARD_WM_FILLLISTBOX (hwnd, PostMessage); 135: if (!DoesDeviceExistOnSystem(''cdaudio") ) 136: NoCDOnSystem = TRUE; 137: else 138: NoCDOnSystem = FALSE; 139: return TRUE; 140: ) 141: 142: //////////////////////////////////////// 143: // Обработчик сообщения WM_DESTROY 144: //////////////////////////////////////// 145: ((pragma argsused 146: void Harmony _OnDestroy(HWND hwnd) 147: ( 148: PostQuitMessage(0); 149: ) 150: 151: //////////////////////////////////////// 152: // Обработчик сообщения WM COMMAND 153: //////////////////////////7///7///////// 154: ftpragma argsused 155: void Harmony_OnCommand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify) 156: {
157: char S [100]; 158: 159: switch (id) 160: { 161: case CM_MIDI: 162: CheckForClose() ; 163: strepy ( DeviceString, "sequencer"); 164: PlayType = MIDI; 165: FORWARD_WM_FILLLISTBOX(hwnd, Pos tMessage); 166: break; 167: 168: case CM_WAVE: 169: CheckForClose() ; 170: strepy(DeviceString, "waveaudio"); 171: PlayType = WAVE; 172: FORWARD_WM_FILLLISTBOX(hwnd, PostMessage); 173: break; 174: 175: case CM_COMPACT: 176: if (PlayType != COMPACT) 177: ( 178: CheckForClose(); 179: PlayType = COMPACT; 180: strepy (DeviceString, "edaudio"); 181: FORWARD WM FILLLISTBOX(hwnd, PostMessage); 182: ) 183: break; 184: 185: case CM_DIRECTORY: 186: LoadFile(hwnd); 187: FORWARD_WM_FILLLISTBOX(hwnd, PostMessage); 188: break; 189: 190: case IDOK: 191: CheckForClose(); 192: FORWARD_WM_CLOSE(hwnd, Harmony_DefProc); 193: break; 194: 195: case CM_PAUSE: 196: case CM_STOP: 197: switch (PlayType) 198: ( 199: case MIDI: HandleMIDIPAndS(hwnd, id); break; 200: case WAVE: HandleWAVEPAndS(hwnd, id); break; 201: case COMPACT: HandleCDPAndS(hwnd, id); break; 202: ) 203: break; 204: 205: case CM WAVEPLAY: 206: if (State == PLAYING) 207: return; 208: 209: if (PlayType == COMPACT) 210: ( 211: PlayCD(hwnd); 212: return; 213: ) 214: 215: if (FileOpen(hwnd)) 216: { 217: State = PLAYING; 218: SetWindowText(GetDlgltem(hwnd, ID_MODE), "Playing"! 219: SetTimeFormatMs(); 220: DWORD Result = GetLen(); 221: sprintf(S, ”%ld ms". Result); 222: SetWindowText(GetDlgltem(hwnd, IDLENGTH), S); 223: SetWindowText(GetDlgltem(hwnd, ID NUMTRACKS), 224: Getlnfo(S)); 225: if (PlayMCIO) 226: SetTimer (hwnd, HARMONYJTIMER, 10, NULL); 227: else 228: ( 229: CloseMCI (); 230: State = CLOSED; 231: SetWindowText(GetDlgltem(hwnd, IDMODE), "CLOSED' 14 Чарльз Калверт
232: ) 233: ) 234: break; 235: 236: case ID_FILELIST: 237: if (codeNotify — LBNDBLCLK) 23B: MessageBox(hwnd, "They're talking to me!", NOLI, MB_OK); 239: break; 240: 241: case CM_RECORD: 242: if ((PlayType — MIDI) II (PlayType “ COMPACT)) 243: return; 244: if (OpenMCI(hwnd, "", DeviceString)) 245: ( ’ 246: DoRecord{10000); 247: State - RECORDING; 248: SetTimer {hwnd, HARMONYJTIMER, 10, NULL); 249: ) 250: break; 251: ) 252: ) 253: 254: llllllllllllllllllllllllllllllllllllllllll 255: // Обработчик сообщения WM FILLLISTBOX 256: 1111111111111111IIIIIIIIII7HIIIIIIIII UH 257: ((pragma argsused 258: void Harmony jDnFillListBox(HWND hwnd) 259: ( 260: if (PlayType »- COMPACT) 261: ( 2 62: FillCDTrackBox(hwnd); 263: return; 264: ) 265: 266: char S[200); 267: . 268: strepy (S, Dirstr); 269: switch (PlayType) 270: ( 271: case MIDI: strcat(S, "\\*.mid"); break; 272: case WAVE: strcat(S, ”\\*.wav"); break; 273: ) 274: 275: if{!DlgDirList(hwnd, S, ID_FILELIST, 0, DDL_ARCHIVE)) 276: MessageBox(hwnd, "No way", NULL, MB_OK); 277: 278: switch (PlayType) 279: { 280: case COMPACT: 281: Button_SetCheck{GetDlgItem(hwnd, CM_COMPACT), TRUE); break; 282: case MIDI: 283: ButtonJSetCheck(GetDlgltem(hwnd, CM_MIDI), TRUE); break; 284: case WAVE: 285: ButtonJSetCheck(GetDlgltem(hwnd, CM_WAVE), TRUE); break; 286: ) 287: SetWindowText(GetDlgltem(hwnd, ID_DIREDIT), DirStr); 288: 289: ListBoxJSetCurSel(GetDlgltem(hwnd, ID_FILELIST), 0) ; 290: ) 291: 292: IIIIIIIIIIIIUIIIIIIIIIIIIIIIIIIIIIIUII 293: II Обработчик сообщения MM MCINOTIFY 294: Illlllllllllllllllllllllll7llllllllllll 295: ((pragma argsused 296: void Harmony OnMCINotify(HWND hwnd, UINT status, int DevicelD) 297: { 298: char S[100); 299: 300: if {State ” ERRORJDCCURED) 301: return; 302: 13 switch (status) 104: ( 305: case MCI_NOTIFY_ABORTED: 306: strcpy{S, "Aborted");
307: break; 308: 309: case MCI_NOTIFY_SUCCESSFUL: 310: if (State == RECORDING) 311: ( 312: SaveFile("Albert.wav"); 313: DlgDirList (hwnd, S, ID_FILELIST, 0, DDL ARCHIVE); 314: ) 315: State = CLOSED; 316: if (PlayType == COMPACT) 317: CloseCDMCI(); 318: else 319: CloseMCK); 320: strcpy(S, "Success"); 321: break; 322: 323: case MCI_NOTIFY_SUPERSEDED: 324: strcpy(S, "Superseded"); 325: break; 326: 327: case MCI_NOTIFY_FAILURE: 328: State = CLOSED; 329: if (PlayType == COMPACT) 330: CloseCDMCI(); 331: else 332: CloseMCK); 333: strcpy(S, "Failure"); 334: break; 335: } 336: SetWindowText(GetDlgltem(hwnd, ID_MODE), S); 337: SetWindowText(GetDlgltemthwnd, ID_LENGTH), "..."I; 338: SetWindowText(GetDlgltem(hwnd, ID_POSITION), "..."); 339: SetWindowText(GetDlgltemthwnd, .ID_NUMTRACKS), "..."); 340: // MessageBox(hwnd, S, "MCI_NOTIFY", MB OK); 341: ) 342: 343: ///////////////////////////////////////// 344: // Обработчик сообщения WM_TIMER 345: ///////////////////////////////////////// 346: #pragma argsused 347: void Harmony_OnTimer(HWND hwnd, UINT id) 348: ( 349: char S[100); 350: 351: switch (State) 352: ( 353: case PAUSED: 354: KillTimer (hwnd, HARMONY_TIMER) ; 355: break; 356: 357: case STOPPED: 358: KillTimer (hwnd, HARMONY_TIMER) ; 359: break; 360: 361: case RECORDING: 362: case PLAYING: 363: if (PlayType == COMPACT) 364: ( 365: HandleCDTimer(hwnd); 366: return; 367: ) 368: 369: DWORD Result = GetLocation(); 370: if (Result == -1) 371: ( 372: KillTimer (hwnd, HARMONY_TIMER) ; 373: State = ERROR_OCCURED; 374: SetWindowText (GetDlgltem (hwnd, ID_MODE), "ERROR"); 375: return; 376: ) 377: sprintftS, "%ld ms". Result); 378: SetWindowText (GetDlgltem(hwnd, ID POSITION.), S) ; 379: break; 380: ) 381: )
Листинг 20.2. HARMONY.H 1: /////////////////////////////////////////// 2: // Модуль: HARMONY. СРР 3: // Автор: Чарли Калверт 4: // Описание: Harmony — программа для WINDOWS 5: // Дата: 08/07/93 6: /////////////////////////////////////////// 7: 8: // Сообщения, определяемые пользователем 9: «define WM_FILLLISTBOX (WMUSER + 0) 10: 11: // Кнопки, которые может нажимать пользователь 12: «define CM_WAVEPLAY 101 13: «define CM_PAUSE 102 14: «define CM_STOP 103 15: «define CM_DIRECTORY 104 16: «define CM_RECORD 105 17: «define CM_HELP 106 18: 19: // Перечни и комбинированные перечни 20: «define ID_FILELIST 120 21: «define IDPLAYLIST 121 22: 23: // Controls that report to user 24: «define ID_MODE 140 25: «define ID_NUMTRACKS 141 26: «define ID_POSITION 142 27: «define IDLENGTH 143 28: «define ID_DIREDIT 145 29: 30: // Кнопки-селекторы режимов 31: «define IDGROUP 5000 32: «define CMCOMPACT 5001 33: «define CM_WAVE 5002 34: «define CM MIDI 5003 35: 36: // Состояния 37: «define PAUSED 1 38: «define PLAYING 2 39: «define STOPPED 3 40: «define CLOSED 4 41: «define OPENED 6 42: «define RECORDING 7 43: «define ERROROCCURED 8 44: 45: // Устройства 46: «define WAVE 1 47: «define COMPACT 2 48: «define MIDI 3 49: 50: // Прочее 51: «define DIRSTRSIZE 200 52: «define DEVICESTRSIZE 50 53: «define HARMONY_TIMER 1 54: 55: // Макрорасширения из WindowsX 56: «define HANDLE_MM_MCINOTIFY (hwnd, wParam, IParam, fn) \ 57: ((fn)((hwnd), (UINT)(wParam), (int)LOWORD(IParam)), 0L) 58: «define FORWARD_MM_MCINOTIFY(hwnd, status, DevicelD, fn) \ 59: (void)(fn)((hwnd), MM_MCINOTIFY, (WPARAM)(status), \ 60: MAKELPARAMf (UINT) (DevicelD), 0)) 61: 62: «define HANDLE_WM_FILLLISTBoX(hwnd, wParam, IParam, fn) \ 63: ((fn)(hwnd), 0L) 64: «define FORWARD_WM_FILLLISTBOX(hwnd, fn) \ 65: (void)(fn)((hwnd), WM_FILLLISTBOX, 0, 0L) 66: 67: // Объявления для класса Harmony 68: «define Harmony_DefProc DefWindowProc 69: BOOL Harmony_OnCreate(HWND hwnd, 70: CREATESTRUCT FAR* IpCreateStruct); 71: void Harmony_OnDestroy(HWND hwnd); 72: void Harmony_OnFillListBox(HWND hwnd); 73: void Harmony_OnCommand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify);
74: void Harmony_OnMCINotifу(HWND hwnd, UINT status, int DevicelD); 75: 76: 77: 78: 79: 80: 81: void Harmony__OnTimer (HWND hwnd, UINT id); // Итог расстройств и крушений LRESULT CALLBACK export WndProc(HWND hwnd, UINT Message, WPARAM wParam, LPARAM IParam); BOOL Register(HINSTANCE hlnst); HWND Create(HINSTANCE hlnst, int nCmdShow); Листинг 20.3. HARMONY.DEF 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: ; HARMONY.DEF NAME Harmony DESCRIPTION 'Harmony Music (c) 1993 by Charlie Calvert' EXE^YPE WINDOWS S TUB 'WINSTUB.EXE ' CODE PRELOAD MOVEABLE DISCARDABLE DATA PRELOAD MOVEABLE MULTIPLE HEAPSIZE 409-6 STACKSIZE 5120 Листинг 20.4. CDUTIL.CPP 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: /////////////////////////////////////////// // Модуль: CDUTIL.CPP // Автор: Чарли Калверт // Описание: Harmony — программа для WINDOWS // Дата: 08/07/93 /////////////////////////////////////////// ((define STRICT ((include <windows.h> ((include <windowsx.h> ((include <mmsystem.h> ((include "harmony.h" ((include "cdinfo.h" ((include "stdio.h" ((include "playinfo.h" extern BYTE State; extern BYTE PlayType; ///////////////////////////////////////// // HandleCDPAndS ///////////////////////////////////////// void HandleCDPAndS(HWND hwnd, int id) ( switch(id) ( case CM_PAUSE: State = PAUSED; SetWindowText(GetDlgltem(hwnd, ID_MODE), "Paused"); PauseCDMCI(); break; case CM_STOP: State = STOPPED; SetWindowText(GetDlgltem(hwnd, ID_MODE), "Stopped"); StopCDMCI(); break; ) ) //////////////////////////////////////////// // OpenCDFile //////////////////////////////////////////// BOOL OpenCDFile (HWND hwnd) ( if ((State == PAUSED) I I (State == STOPPED) I I (State == OPENED)) return TRUE ; if (OpenCD(hwnd)) (
50: State - OPENED; 51: SetTMSFasFormat(); 52: return TRUE ; 53: ) 54: else 55: return FALSE; 56: } 57: 58: /////////////////////////////////////////// 59: // GetTrackString 60: /////////////////////////////////////////// 61: LPSTR GetTrackString(LPSTR S, DWORD i, BOOL LongString) 62: { 63: BYTE Min, Sec, Frame; 64: 65: GetCDTrackLength(i, &Min, &Sec, &Frame); 66: Min - Min; 67: Sec = Sec; 68: Frame " Frame; 69: if (LongString) 70: sprintf(S, "Track: %ld » Time: *d:%d", i, Min, Sec); 71: else 72: sprintf(S, "4d:%d", Min, Sec); 73: return S; 74: ) 75: 76: ///////////////////////////////////////// 77: // PlayCD 78: ///////////////////////////////////////// 79: void PlayCD(HWND hwnd) 80: ( 81: char S[100] ; 62: 83: if (OpenCDFile(hwnd)) 84: ( 85: SetTimer(hwnd, HARMONY_TIMER, 10, NULL); 86: // PlayMciCD(4, 5) ; 87: DWORD Index = 88: ListBox_GetCurSel(GetDlgltem(hwnd, ID_FILELIST)); 89: if (Index ”= LB_ERR) 90: ( 91: MessageBox (hwnd, "You must select a file", NULL, MB__OK) ; 92: return; 93: } 94: PlayCDOneTrack(Index + 1) ; 95: State = PLAYING; 96: SetWindowText (GetDlgltemthwnd, ID_MODE)"Playing"); 97: GetTrackString(S, Index + 1, FALSE); 98: SetWindowText (GetDlgltemthwnd, ID_LENGTH), S) ; 99: ) 100: ) 101: 102: ///////////////////////////////////////// 103: // HandleDCPTimer 104: ///////////////////////////////////////// 105: void HandleCDTimer (HWND hwnd) 106: ( 107: DWORD Track; 108: DWORD Time; 109: int TimeAry[2J; 110: char S[50] ; 111: 112: Track = GetCurrentCDTrack(); 113: sprintf(S, "%ld". Track); 114; SetWindowText (GetDlgItem(hwnd, ID NUMTRACKS), S) ; 115: SetTMSFasFormat(); 116: Time = GetCDLocation() ; 117: sprintffS, "%d:%d", MCI_TMSF_MINUTE(Time), 118 : MCI_TMSF_SECOND(Time) ) ; 119: SetWindowText(GetDlgltemthwnd, ID_POSITION), S); 120: } 121: 122: ////////////////////////////////////////// 123: // FillCDTrackBox 124: llllllllllllllllllllllllllllllllllllllllll
125: void FillCDTrackBox(HWND hwnd) 126: { 127: DWORD i; 128: char S[100); 129: 130: if (iOpenCDFile(hwnd)} 131: return; 132: 133: ListBox_ResetContent(GetDlgltem(hwnd, ID_FILELIST)); 134: DWORD NumTracks = GetCDNumTracks(); 135: if (NumTracks =“ -1} return; 136: 137: HCURSOR Cursorl = Loadcursor(0, IDC_WAIT); 138: SetCursor(Cursorl); 139: HCURSOR OldCursor - (HCURSOR)SetClassWord(hwnd, GCW_HCURSOR, 140: (WORD)Cursorl); 141: .Setcapture(GetDlgltem(hwnd, ID_LENGTH)); 142: for (i “ 1; i <- NumTracks; i++) 143: ( 144: GetTrackString(S, i, TRUE); 145: ListBoxAddString (GetDlgltem (hwnd, ID_FILELIST) , S); 146: ) 147: ListBox_SetCurSel(GetDlgltem(hwnd, ID_FILELIST), 0); 148: SetCursor(OldCursor) ; 149: SetClassWord(hwnd, GCW_HCURSOR, (WORD)OldCursor); 150: ReleaseCapture(); 151: ) 152: 153: lirillltlllllllllllllllllllllllllllHItll 154: // CloseCompact 155: ///////////////////////////////////////// 156: void Closecompact(void) 157: ( 158: if (State = CLOSED) return; 159: if (State == PLAYING) 160: StopCDMCIf); 161: CloseCDMCI(); 162: ) 163: 164: ////////////////////////////////////////// 165: // CheckForClose 166: ////////////////////////////////////////// 167: void CheckForClose(void) 168: ( 169: if (State !- CLOSED) 170: if (PlayType “ COMPACT) 171: Closecompact(); 172: else 173: CloseMCIO; 174: 175: State - CLOSED; 176: ) Листинг 20.5. CDUTIL.H 1: /////////////////////////////////////////// 2: // Модуль: CDUTIL.H 3: // Автор: Чарли Калверт 4: // Описание: Harmony — программа для WINDOWS 5: // Дата: 08/07/93 6: /////////////////////////////////////////// 7: 8: // Функции для утилит 9: void HandlecoPAndS(HWND hwnd, int id); 10: void HandleCDTimer(HWND hwnd); 11: void FillCDTrackBox(HWND hwnd); 12: void CheckForClose(void); Листинг 20,6. WAVEMIDLCPP 1: /////////////////////////////////////////// 2: // Программа: WAVEMIDI.CPP 3: // Автор: Чарли Калверт 4: // Описание: Harmony — программа для WINDOWS
5: // Дата: 08/07/93 6: /////////////////////////////////////////// 7: «define STRICT 8: «include <windows.h> 9: «include <windowsx.h> 10: «include <commdlg.h> 11: «include «direct.h> 12: «include <mmsystem.h> 13: «include «string.h> 14: «include "harmony.h" 15: «include "cdinfo.h" 16: «include "stdio.h" 17: «include "playinfo, h" 18: 19: extern BYTE State; 20: extern BYTE PlayType; 21: extern char DirStr[DIRSTRSIZE]; 22: extern char DeviceString[DEVICESTRSIZE] ; 23: 24: ///////////////////////////////////////// 25: // FileOpen 26: ///////////////////////////////////////// 27: BOOL FileOpen(HWND hwnd) 28: ( 29: char S[100); 30: char SI[200]; 31: 32: if (State == PAUSED) 33: return TRUE ; 34: 35: S[l] = '\0' ; 36: int Index - 37: ListBox_GetCurSel (GetDlgItem(hwnd, ID_FILELIST) ) ; 38: if (Index == LBERR) 39: { 40: MessageBox(hwnd, "Select a valid file", 41: NULL, MB_OK I MB_ICONSTOP) ; 42: return FALSE; 43: ) 44: ListBox_GetText(GetDlgltem(hwnd, ID_FILELIST), Index, S); 45: strepy(SI, DirStr); 46: strcat(SI, "\\"); 47: strcat(SI, S); 48: 49: if (!OpenMCI(hwnd, SI, DeviceString)) 50: return FALSE; 51: else 52: return TRUE; 53: ) 54: 55: lllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllll 56: // GetFileName 57: /////////////////////////////////////////////////////////////// 58: char * GetFileName(HWND hwnd, char * pzFile, int StringSize) 59: ( 60: OPENFILENAME ofn; 61: char szDirName[256]; 62: char szFileTitle[256]; 63: char szFilter[256]; 64: char chReplace; 65: 66: memset(Sofn, 0, sizeof(OPENFILENAME)); 67: 68: strepy(szFilter, 69: "Wave Files(*.wav)I *.wavIMIDI Files(*.mid)I *.midi"); 70: chReplace = szFilter[strlen(szFilter) - 1]; 71: for (int i = 0; szFilter[i] !~ '\0*; i++) 72: { 73: if (szFilter[i) == chReplace) 74; szFilter[i] = ’ \0'; 75: ) 76: 77: ofn.IStructSize = sizeof(OPENFILENAME); 78: ofn.hwndOwner = hwnd; 79: ofn.IpstrFilter = szFilter;
80: ofn.nFilterlndex = 1; 81: ofn.lpstrFile= szFile; 82: ofn.nMaxFile = StringSize; 83: ofn.IpstrFileTitle = szFileTitle; 84: ofn.nMaxFileTitle = sizeof{szFileTitle); 85: ofn.IpstrlnitialDir = szDirName; 86: ofn. Flags = OFN_FILEMUSTEXIST; 87: 88: GetOpenFileName(&ofn); 89: 90: return szFile; 91: } 92: 93: /////////////////// 94: // LoadFile 95: /////////////////// 96: void LoadFile(HWND hwnd) 97: ( 98: char S[100J; 99: 100: memset(SS, 0, 100); 101: 102: if (PlayType == WAVE) 103: strcpy(S, "*.wav"); 104: else 105: if (PlayType == MIDI) 106: strcpy(S, ”*.mid"); 107: 108: GetFileName(hwnd, S, 100); 109: getdcwd(0, DirStr, DIRSTRSIZE); 110: ) 111: 112: //////////////////////////////////////////// 113: // HandleMIDIPAndS 114: IIIHIIIllllllllllllllllllllllllllllllllllll 115: void HandleMIDIPAndS(HWND hwnd, int id) 116: ( 117: switch(id) 118: ( 119: case CM-PAUSE: 120: State - PAUSED; 121: SetWindowText(GetDlgltemthwnd, ID_M0DE}, "Paused"); 122: PauseMCl ().; 123: break; 124: 125: case CM_STOP: 126: State = CLOSED; 127: SetWindowText(GetDlgItem(hwnd, ID_M0DE), "Stopped"); 128: StopMCI(); 129: CloseMCI () ; 130: break; 131: ) 132: } 133: 134: //////////////////////////////////// 135: // HandleWAVEPAndS 136: //////////////////////////////////// 137: void HandleWAVEPAndS (HWND hwnd, int id) 138: ( 139: switch(id) 140: ( 141: case CM_PAUSE: 142: State = PAUSED; 143: SetWindowText(GetDlgltem(hwnd, ID_M0DE), "Paused"); 144: PauseMCl(); 145: break; 146: 147: case CMSTOP: 148: State = CLOSED; 149: SetWindowText (GetDlgltem (hwnd, ID_MODE), "Stopped"); 150: StopMCI(); 151: CloseMCI() ; 152: break; 153: } 154: )
Листинг 20.7. WAVEMIDI.H 1: /////////////////////////////////////////// 2: И Модуль: WAVEMIDI.H 3: II Автор: Чарли Калверт 4: II Описание: Harmony — программа для WINDOWS 5: И Дата: 08/07/93 6: /////////////////////////////////////////// 7: 8: BOOL FileOpen(HWND hwnd); 9: void PlayCD(HWND hwnd); 10: void HandleMIDIPAndS(HWND hwnd, int id); 11: void HandleWAVEPAndS(HWND hwnd, int id); 12: void LoadFile(HWND hwnd); Листинг 20.8. HARMONY.RC 1: /////////////////////////////////////////// 2: // Модуль: HARMONY.RC 3: // Автор: Чарли Калверт 4: // Описание: Harmony — программа для WINDOWS 5: // Дата: 08/07/93 6: /////////////////////////////////////////// 7: «include «windows.h> 8: «include "harmony.h" 9: 10: Harmony DIALOG 18, 23, 246, 208 11: STYLE DS_M0DALFRAME I WS_OVERLAPPED I WS_CAPTION I WS_SYSMENU I WS_MINIMIZEBOX 12: CLASS "Harmony" 13: CAPTION "Harmony" 14: BEGIN 15: CONTROL "", ID_GROUP, "BUTTON", BS_GROUPBOX I 16: WS_CHILD I WS_VISIBLE, 6, 5, 107, 93 17: CONTROL "Mode", -1, "STATIC", SS_LEFT I WS CHILD I 18: WS_VISIBLE, 17, 15, 39, 11 19: CONTROL "...", ID_MODE, "STATIC", SS_LEFT I WS_CHILD I 20: WS_VISIBLE, 56, 15, 53, 11 21: CONTROL "Track", -1, "STATIC", SS_LEFT I WS_CHILD I 22: WS_VISIBLE, 17, 37, 39, 11 23: CONTROL ~..." , ID_NUMTRACKS , "STATIC", SS-_LEFT I 24: WS_CHILD | WS_VISIBLE, 56, 37, 53, 11 25: CONTROL "Position", -1, "STATIC", SS_LEFT I WS_CHILD | 26: WS_VISIBLE, 17, 59, 39, 11 27: CONTROL "...", IDPOSITION, "STATIC", SS_LEFT I 28: WS_CHILD I WS_VISIBLE, 56, 59, 53, 11 29: CONTROL "Length", -1, "STATIC", SS_LEFT I WS_CHILD I 30: WS_VISIBLE, 17, 81, 39, 11 31: CONTROL "...", ID_LENGTH, "STATIC", SS_LEFT | 32: WS_CH1LD | WS_VISIBLE, 56, 81, 53, 11 33: CONTROL "", ID_FILELIST, "LISTBOX", LBS_NOTIFY I 34: LBS_USETABSTOPS I WS_CHILD I WS_VISIBLE I 35: WS_BORDER | WS_VSCROLL, 132, 9, 107, 94 36: CONTROL "", ID_PLAYLIST, "COMBOBOX", CBSJDROPDOWNLIST | 37: WS_CHILD | WS_VISIBLE I WS_TABSTOP, 6, 115, 107, 12 38: CONTROL "", ID DIREDIT, "EDIT", ES_LEFT I WS CHILD I 39: WS_VISIBLE |~WS_BORDER I WS_TABSTOP, 132, T15, 107, 12 40: CONTROL "", 102, "button", BS_GROUPBOX I WS_CHILD I 41: WS_VISIBLE, 7, 156, 71, 45 42: CONTROL "Help", CM_HELP, "BUTTON", BS_PUSHBUTTON I 43: WS_CHILD | WS_VISIBLE I WS_TABSTOP, 7, 135, 71, 17 44: CONTROL "Compact Disk", CM_COMPACT, "BUTTON", 45: BS_AUTORADIOBUTTON I WS CHILD | WS_VISIBLE I 46: WS_GROUP I WSTABSTOP, Тз, 162, 58, 12 47: CONTROL "WAVE", CM_WAVE, "BUTTON", BS_AUTORADIOBUTTON I 48: WS_CHILD | WS_VISIBLE | WS_TABSTOP, 13, 174, 28, 12 49: CONTROL "MIDI", CM_MIDI, "BUTTON", BS_AUTORADIOBUTTON I 50: WS_CHILD | WS VISIBLE I WS_TABSTOP, 13, 186, 28, 12 51: CONTROL "Directory", CM DIRECTORY, "BUTTON", 52: BS PUSHBUTTON I WS CHILD I WS VISIBLE I WS_GROUP I 53: WS_TABSTOP, 88, 135, 71, 17 54: CONTROL "Play", CM WAVEPLAY, "BUTTON", BS_PUSHBUTTON I 55: WS_CHILD I WS_VISIBLE | WS_TABSTOP, 88, 160, 71, 17 56: CONTROL "Close", IDOK, "BUTTON", BS_PUSHBUTTON I 57: WS_VISIBLE | WS_TABSTOP, 88, 184, 71, 17
58: CONTROL "Record", CM_RECORD, "BUTTON", BS_PUSHBUTTON I 59: WS_CHILD I WSVISIBLE I WSTABSTOP, 169, 135, 71, 17 60: CONTROL "Pause", CM_PAUSE, "BUTTON", BS_PUSHBUTTON I 61: WS_CHILD I WS_VISIBLE I WS_TABSTOP, 169, 160, 71, 17 62: CONTROL "Stop", CM_STOP, "BUTTON", BS_PUSHBUTTON I 63: WS_CHILD I WS_VISIBLE | WS_TABSTOP, 169, 184, 71, 17 64: CONTROL "Now Playing", -1, "STATIC", SS_LEFT | WSCHILD I 65: WS_VISIBLE | WS_GROUP, 6, 105, 57, 8 66: CONTROL "Current Directory", -1, "STATIC", SSLEFT I 67: WS_CHILD | WS_VISIBLE | WSGROUP, 132, 105, 99, 8 68: END Листинг 20.9. PLAYINFO.CPP 1: /////////////////////////////////////////// 2: // Модуль: PLAYINFO.CPP 3: // Автор: Чарли Калверт 4: // Описание: DLL для программы Harmony 5: // Дата: 08/07/93 6: /////////////////////////////////////////// 7: 8: «define STRICT 9: «include <windows.h> 10: «include <windowsx.h> 11: «include <mmsystem.h> 12: «include <stdio.h> 13: «include <string.h> 14: «include "playinfo.h" 15: «pragma warning (disable : 4068) 16: «pragma argsused 17: 18: /////////////////////////////// 19: // LibMain 20: /////////////////////////////// 21: int CALLBACK LibMain(HINSTANCE hlnstance, WORD wDataSeg, 22: WORD wHeapSize, LPSTR IpszCmdLine) 23: { 24: if (wHeapSize > 0) 25: UnlockData(0); 26: 27: return 1; 28: ) 29: 30: /////////////////////////////////////////// 31: // WEP 32: /////////////////////////////////////////// 33: «pragma argsused 34: int CALLBACK WEP(int nParameter) 35: ( 36: return 1; 37: ) 38: 39: ///////////////////////////////////////// 40: // GetDevicelD 41: ///////////////////////////////////////// 42: WORD CALLBACK _export GetDevicelD(void) 43: ( 44: return wDevicelD; 45: ) 46: 47: ///////////////////////////////////////////// 48: // GetErrorMessage 49: ///////////////////////////////////////////// 50: LPSTR GetErrorMessage(DWORD RC, LPSTR S) 51: ( 52: if (ImciGetErrorString(RC, S, MsgLen)) 53: strcpy(S, "No message available"); 54: return S; 55: ) 56: 57: /////////////////////////////////////////// 58: // ErrorMsg 59: /////////////////////////////////////////// 60: BOOL CALLBACK _export ErrorMsg(DWORD Error, LPSTR CallingFunc) 61: (
62: char S[MsgLen + 50]; 63: 64: char SI[MsgLen]; 65: GetErrorMessage(Error, SI); 66: sprintfls, "Calling Func: %s\n Return Code: %ld\n Is", 67: CallingFunc, Error, SI); 68: if (Error) 69: ( 70: MessageBox(0, S, "Information", MB_0K I MB_ICONINFORMATION); 71: return FALSE ; 72: ) 73: return TRUE ; 74: 75: ) 76: //////////////// 77: // CloseMCI 78: //////////////// 79: BOOL CALLBACK export CloseMCI(void) 80: ( 81: 82: DWORD ErrorNum; 83: ErrorNum = mciSendCommand(wDevicelD, MCI_CL0SE, 0, 0); 84: if (ErrorNum) 85: ( 86: ErrorMsg(ErrorNum, "CloseMCI"); 87: return FALSE; 88: ) 89: wDevicelD = 0; 90: return TRUE; 91: 92: ) 93: ZZZZZZZZZZZZZZZZZZZZZZZZZZZZ/ZZZZZZZZZZZZZZ 94: // Getlnfo 95: /////////////////////////////////////////// 96: LPSTR CALLBACK export Getlnfo(LPSTR S) 97: ( 98: MCI_INF0_PARMS Info; 99: 100: DWORD'Flags, ErrorNum; 101: Info.dwCallback = 0; 102: Info.lpstrReturn - S; 103: Info.dwRetSize “ MsgLen; 104: Flags = MCI_INF0_PR0DUCT; 105: ErrorNum = 106: mciSendCommand(wDevicelD, MCI_INF0, Flags, DWORD(&Info)); 107: if (ErrorNum) 108: ( 109: ErrorMsg(ErrorNum, "Getlnfo"); 110: return NULL; 111: ) 112: return S ; 113: 114: ) 115: ZZZZZZZZZZZZZZZZZZZZZZ/ZZZZZZZZZZZZZZZZZZZZ 116: ZZ GetLen 117: ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ 118: DWORD CALLBACK export GetLen(void) 119: ( 120: MCI_STATUS_PARMS Info; 121: 122: DWORD ErrorNum, Flags; 123: memset (& Info, 0., sizeof (MCI_STATUS_PARMS)); 124: Info.dwltern - MCI_STATUS_LENGTH; 125: Flags = MCI_STATUS_ITEM; 126: ErrorNum " 127: mciSendCommand(wDevicelD, MCI_STATUS, Flags, DWORD(slnfo)); 128: if (ErrorNum) 129: ( 130: ErrorMsg(ErrorNum, "GetLen"); 131: return -1; 132: ) 133: return Info.dwReturn; 134: 135: )
136: ZZ/Z/ZZ//Z/Z/Z/ZZ//Z//ZZ//Z///Z/////////Z// 137: Z/ GetLocation 138: Z/Z///Z/////Z////////////////////////////// 139: DWORD CALLBACK _export GetLocation(void) 140: ( 141: MCI_STATUS_PARMS Info; 142: DWORD Flags, ErrorNum; 143: 144: Info.dwltem = MCI_STATUS_POSITION; 145: Flags = MCI_STATUS_ITEM; 146: ErrorNum = mciSendCommand(wDevicelD, MCI_STATUS, 147: Flags, DWORD(Slnfo)); 148: if (ErrorNum) 149: ( 150: ErrorMsg(ErrorNum, "GetLocation"); 151: return -1; 152: ) 153: return Info.dwReturn; 154: ) 155: 156: ZZZ//////////////ZZ//////////////////////// 157: // GetMode 158: Z////Z///////////////////////////////////// 159: DWORD CALLBACK _export GetMode (void) 160: ( 1, 61: MCI_STATUS_PARMS Info; 162: DWORD ErrorNum, Flags; 163: 164: memset (Slnfo, 0, sizeof (MCI_STATUS_PARMS) ) ; 165: Info.dwltem = MCI_STATUS_MODE; 166: Flags = MCI_STATUS_ITEM; 167: ErrorNum « mciSendCommand(wDevicelD, MCI_STATUS, 168: Flags, DWORD(Slnfo)); 169: if (ErrorNum) 170: ( 171: ErrorMsg(ErrorNum, "GetMode"); 172: return -1; 173: ) 174: return Info.dwReturn; 175: ) 176: 177: ZZ//Z//Z//////////////////////////////////// 178: Z/ OpenMCI 179: Z/Z////////////////Z///////Z//////////////// 180: BOOL CALLBACK _export OpenMCI (HWND PWindow, LPSTR FileName, 181: LPSTR DeviceType) 182: ( 183: MCI_OPEN_PARMS OpenParms; 184: DWORD Style, ErrorNum; 185: 186: PlayWindow - PWindow; 187: OpenParms.IpstrDeviceType ” DeviceType; 188: OpenParms.IpstrElementName = FileName; 189: Style = MCI_OPEN_TYPE I MCI_OPEN_ELEMENT; 190: ErrorNum = mciSendCommand(0, MCI_OPEN, 191: Style, DWORD(sOpenParms)); 192: if (ErrorNum) 193: ( 194: ErrorMsg(ErrorNum, "OpenMCI"); 195: return FALSE; 196: ) 197: wDevicelD = OpenParms.wDevicelD; 198: return TRUE; 199: ) 200: 201: Z/////////////////////////////////////////// 202: Z/ PauseMCI 203: Z/////////////Z///////////////////////////// 204: BOOL CALLBACK _export PauseMCI (void) 205: ( 206: MCI_GENERIC_PARMS Info; 207: DWORD ErrorNum; 208: char Sl[MsgLen]; 209: 210: memset (Slnfo, 0, sizeof (MCI_GENERIC_PARMS) );
211: ErrorNum = mciSendCommand(wDevicelD, MCI_PAUSE, 212: 0, DWORD(SInfo)); 213: if (ErrorNum) 214: ( 215: ErrorMsg(ErrorNum, "PauseMCI"); 216: return FALSE; 217: ) 218: return TRUE ; 219: ) 220: 221: ////////////////////////////////////////// 222: // PlayMCI 223: ////////////////////////////////////////// 224: BOOL CALLBACK _export PlayMCI(void) 225: ( 226: DWORD ErrorNum; 227: MCI_PLAY_PARMS Info; 228: 229: Info.dwCallback = DWORD(PlayWindow); 230: ErrorNum = mciSendCommandfwDevicelD, MCI_PLAY, 231: MCI_NOTIFY, DWORD(SInfo)); 232: if (ErrorNum) 233: ( 234: ErrorMsg(ErrorNum, "PlayMCI"); 235: return FALSE; 236: ) 237: return TRUE ; 238: ) 239: 240: /////////////////////////////////////////// 241: // SetTimeFormatMS 242: /////////////////////////////////////////// 243: BOOL CALLBACK _export SetTimeFormatMS (void) 244: ( 245: MCI_SET_PARMS Info; 246: DWORD ErrorNum, Flags; 247: 248: Info.dwTimeFormat = MCI_FORMAT_MILLISECONDS; 249: Flags = MCI_SET_TIME_F0RMAT; 250: ErrorNum = mciSendCommandfwDevicelD, MCI_SET, 251: Flags, DWORD(SInfo)); 252: if (ErrorNum) 253: ( 254: ErrorMsg(ErrorNum,"SetTimeFormatMS"); 255: return FALSE; 256: ) 257: return TRUE ; 258: ) 259: 260: /////////////////////////////////////////// 261: // StopMCI 262: /////////////////////////////////////////// 263: BOOL CALLBACK _export StopMCI (void) 264: ( 265: DWORD ErrorNum; 266: MCI_GENERIC_PARMS Info; 267: 26$: Info.dwCallback = 0; 269: ErrorNum = mciSendCommand(wDevicelD, MCI_STOP, 270: MCI_NOTIFY, DWORD(SInfo)); 271: if (ErrorNum) 272: ( 273: ErrorMsg (ErrorNum, "StopMCI"); 274: return FALSE; 275: ) 276: return TRUE ; 277: ) 278: 279: 280: //////////////////////////////////////// 281: // Может ли устройство выполнить такую 282: // функцию, как запись, пауза и т.д. 283: //////////////////////////////////////// 284: BOOL CALLBACK _export CanPerformFunction(DWORD Test) 285: (
286: DWORD ErrorNum, Flags; 287: MCI_GETDEVCAPS_PARMS Info; 288: 289: memset(&Info, 0, sizeof (MCI_GENERIC_PARMS) ) ; 290: Info.dwltem = Test; 291: Flags - MCI_GETDEVCAPS_ITEM; 292: ErrorNum = mciSendCommand(wDevicelD, MCI_GETDEVCAPS, 293: Flags, DWORD(SInfo)); 294: if (ErrorNum) 295: { 296: ErrorMsg(ErrorNum, "CanPerformFunction" ); 297: return FALSE; 298: } 299: 300: return Info.dwReturn > 0; 301: ) 302: 303: ////////////////////////////////////////////////// 304: // Имеется ли в данной системе такие устройства, 305: // как "waveaudio", "cdaudio", "sequencer" и т.д. 306: ////////////////////////////////////////////////// 307: BOOL CALLBACK _export DoesDeviceExistOnSystem(LPSTR DeviceType) 308: ( 309: DWORD ErrorNum, Flags; 310: MCI_OPEN_PARMS Info; 311: 312: Info.lpstrDeviceType = DeviceType; 313: Flags = MCI_OPEN_TYPE; 314: ErrorNum = mciSendCommand(0, MCI_OPEN, Flags, DWORD(Slnfo)); 315: 316: if (ErrorNum) 317: return FALSE; 318: else 319: { 320: wDevicelD - Info.wDevicelD; 321: CloseMCI(); 322: . return TRUE ; 323: ) 324: } 325: 326: ////////////////////////////////////////// 327: // DoRecord 328: ////////////////////////////////////////// 329: DWORD CALLBACK _export DoRecord(DWORD MMSecs) 330: ( 331: MCI_RECORD_PARMS Info; 332: DWORD Result, Flags; 333: 334: Info.dwCallback = (DWORD) PlayWindow; 335: Info.dwTo = MMSecs; 336: Flags = MCI_TO I MCI NOTIFY; 337: Result — mciSendCommand(wDevicelD, MCI_RECORD, 338: Flags, DWORD(&Infо)); 339: if (Result) 340: ( 341: ErrorMsg(Result, "DoRecord"); 342: return FALSE; 343: ) 344: return TRUE ; 345: } 346: 347: /////////////////////////////////////// 348: // SaveFile 349: /////////////////////////////////////// 350: BOOL CALLBACK _export SaveFile(char *FileName) 351: { 352: MCI_SAVE_PARMS MCISave; 353: DWORD Result, Flags; 354: char SI[MsgLen]; 355: 356: MCISave.Ipfilename - FileName; 357: Flags - MCIJSAVE FILE I MCI WAIT; 358: Result - mciSendCommand(wDevicelD, MCI_SAVE, 359: Flags, DWORD(fiMCISave) ) ; 360: if (Result)
361: ( 362: ErrorMsg(Result, "SaveFile"); 363: return FALSE; 364: ) 365: return TRUE; 366: ) Листинг 20.10. PLAYINFO.H 1: /////////•////////////////////////////////// 2: // Модуль: PLAYINFO.H 3: // Автор: Чарли Калверт I 4: // Описание: DLL для программы Harmony 5: // Дата: 08/07/93 6: /////////////////////////////////////////// 7: 8: // Этот файл демонстрирует применение extern "С", необходимого 9: // для компоновки DLL с программами на Паскале и Си. 10: 11: ((define MsgLen 200 12: 13: static HWND PlayWindow; 14: static WORD wDevicelD; 15: 16: extern "C" ( 17: BOOL CALLBACK _export CloseMCI (void) ; 18: BOOL CALLBACK _export ErrorMsg (DWORD Error, LPSTR CallingFunc); 19: WORD CALLBACK _export GetDevicelD(void); 20: LPSTR CALLBACK export Getlnfo (LPSTR S) ; 21: DWORD CALLBACK _export GetLen (void) ; 22: DWORD CALLBACK export GetLocation(void); 23: DWORD CALLBACK _export GetMode(void); 24: BOOL CALLBACK _export OpenMCI(HWND PWindow, 25: 26: BOOL CALLBACK _export LPSTR FileName, LPSTR DeviceType); PauseMCI(void); 27: BOOL CALLBACK _export PlayMCI(void); 28: BOOL CALLBACK _export SetTimeFormatMs(void); 29: BOOL CALLBACK _export StopMCI(void); 30: BOOL CALLBACK _export DoesDeviceExistOnSystem(LPSTR DeviceType) 31: DWORD CALLBACK export DoRecord(DWORD MMSecs); 32: 33: BOOL ) CALLBACK ^export SaveFile(char ‘FileName); Листинг 20.11. PLAYINFO.DEF 1: ; PLAYINFO.DEF 2: 3: LIBRARY Playinfo 4: DESCRIPTION 'Playinfo (C) 1993 Charlie Calvert' 5: EXETYPE WINDOWS 6: CODE PRELOAD MOVEABLE DISCARDABLE 7: DATA PRELOAD MOVEABLE SINGLE 8: HEAPSIZE 5200 Листинг 20.12. CDINFO.CPP 1: /////////////////////////////////////////// 2: // Модуль: CDINFO.CPP 3: // Автор: Чарли Калверт 4: // Описание: DLL для программы Harmony 5: // Дата: 08/07/93 6: /////////////////////////////////////////// 7: 8: ((define STRICT 9: ((include <windows.h> 10: ((include «windowsx.h> 11: ((include <mmsystern.h> 12: ((include <stdio.h> 13: ((include «string.h> 14: ((pragma warning (disable : 4068) 15: 16: static HWND PlayWindow; 17: static WORD wDevicelD;
18: ((define MsgLen 200 19: 20: 21: ///////////////////////////////////////////// 22: // LibMain 23: ///////////////////////////////////////////// 24: ((pragma argsused 25: int CALLBACK LibMain(HINSTANCE hlnstance, WORD wDataSeg, 26: WORD wHeapSize, LPSTR IpszCmdLine) 27: { 28: if (wHeapSize > 0) 29: UnlockData(0); 30: 31: return 1; 32: ) 33: 34: /////////////////////////////////////////// 35: // Wep 36: /////////////////////////////////////////// 37: ((pragma argsused 38; int CALLBACK WEP (int nParameter) 39: ( 40: return 1; 41: ) 42: 43: /////////////////////////////////////////// 44: // GetErrorMessage 45: /////////////////////////////////////////// 46: LPSTR GetErrorMessage(DWORD RC, LPSTR S) 47: ( 48: if (ImciGetErrorString(RC, S, MsgLen)) 49: strcpy(S,"No message available"); 50: return S; 51: ) 52: 53: //////////////////////////////////////////// 54: // ErrorMsg 55: //////////////////////////////////////////// 56: BOOL CALLBACK _export ErrorMsg(DWORD Error, 57: LPSTR CallingFunc) 58: ( 59: char S[MsgLen + 50); 60: char SI[MsgLen]; 61: t 62: GetErrorMessage(Error, SI); * 63: sprintf(S, "Calling Func: %s\n Return Code: %ld\n %s", 64: CallingFunc, Error, SI); 65: if (Error) 66: ( 67: MessageBox(0, S, "Information", 68: MB OK I MB_ICONINFORMATION) ; 69: 70: return FALSE; 71: ) 72: return TRUE ; 73: ) 74: 75: //////////////////////////////////////Z////// 76: // OpenCD 77: ///////////////////////////////////////////// 78: BOOL CALLBACK export OpenCD(HWND PWindow) 79: ( 80: MCI_OPEN_PARMS Info; 81: DWORD Result, Flags; 82: 83: memset(SInfo, 0, sizeof(MCI_OPEN_PARMS)); 84: Info.dwCallback = DWORD(PWindow); 85: Info.IpstrDeviceType = 8 6: MAKEINTRESOURCE (MCI DEVTYPE_CD_AUDIO) ; 87: Flags = MCI OPEN TYPE | MCI_OPEN_TYPE_ID; 88: Result = mciSendCommand(0, MCI_OPEN, Flags, DWORD(SInfo)); 89: 90: wDevicelD = Info.wDevicelD; 91: 92: if (Result) 15 Чарльз Калверт
93: { 94: ErrorMsg(Result, "OpenCD"); 95: return FALSE; 96: ) 97: return TRUE; 98: ) 99: 100: ///////////////////////////////////////// 101: // CloseCDMCI 102: //////////////////////////////////////// 103: BOOL CALLBACK _export CloseCDMCI(void) U>4: < 105: DWORD ErrorNum; 106: MCI_GENERIC_PARMS Info; 107: 108: memset(blnfo, 0, sizeof (MCI_GENERIC_PARMS) ) ; 109: ErrorNum = mciSendCommand(wDevicelD, MCI_CLOSE, 110: MCI_NOTIFY, DWORD(SInfo)) ; 111: if (ErrorNum) 112: { 113: ErrorMsg(ErrorNum, "CloseCDMCI"); 114: return FALSE; 115: } 116: return TRUE; 117: ) •118: 119: //////////////////////////////////////////// 120: // StopCDMCI 121: //////////////////////////////////////////// 122: BOOL CALLBACK _export StopCDMCI (void) 123: { 124: DWORD ErrorNum; 125: MCI_GENERIC_PARMS Info; 126: 127: Info.dwCallback = 0; 128: ErrorNum = mciSendCommand(wDevicelD, MCI_STOP, 129: MCI_NOTIFY, DWORD(4Infо)); 130: if (ErrorNum) 131: { 132: ErrorMsg (ErrorNum, "StopCDMCI"); 133: return FALSE; 134: ) 135: return TRUE ; 136: ) 137: 4 138: //////////////////////////////////// 139: // PauseCDMCI 140: //////////////////////////////////// 141: BOOL CALLBACK _export PauseCDMCI(void) 142: { 143: MCI_GENERIC_PARMS Info; 144: DWORD ErrorNum; 145: char Sl[MsgLenJ; 146: 147: memset (SInfo, 0, sizeof (MCIJ3ENERIC_PARMS) ) ; 148: ErrorNum = mciSendCommand(wDevicelD, MCI_PAUSE, 149: 0, DWORD (SInfo)); 150: if (ErrorNum) 151: ( 152: ErrorMsg(ErrorNum, "Pause CDMCI"); 153: return FALSE; 154: } 155: return TRUE; 156: ) 157: 158: //////////////////////////////////// 159: // Set TMSFasFormat 160: //////////////////////////////////// 161: void CALLBACK _export SetTMSFasFormat (void) 162: ( 163: MCI_SET_PARMS Info; 164: DWORD Result; 165: 166: Info.dwCallback = 0; 167: Info.dwTimeFormat - MCI_FORMAT_TMSF;
168: Info.dwAudio — 0; 169: 170: 171: 172: 173: 174: 175: 176: 177: 178: 179: 180: 181: 182: 183: 184: 185: 186: 187: 188: 189: 190: 191: 192: 193: 194: 195: 196: 197: 198: 199: 200: 201: 202: 203: 204: 205: 206: 207: 208: 209: 210: 211: 212: 213: 214: 215: 216: 217: 218: 219: 220: 221: 222: 223: 224: 225: 226: 227: 228: 229: 230: 231: 232: 233: 234: 235: 236: 237: 238: 239: 240: 241: 242: Result = mciSendCommand(wDevicelD, MCI_SET, MCI_SET_TIME_FORMAT, DWORD (S Info) ) ; if (Result) ErrorMsg(Result, "SetTMSFasFormat"); ) ////////////////////////Z////////////////// // PlayCDOneTrack ZZZZZZZ/ZZZZZZZZZZZZZZZZZZZZZZZZZ/ZZZZZZZZZ void CALLBACK export PlayCDOneTrack (BYTE StartTrack) ( MCI_PLAY_PARMS Info; DWORD Flags, Result; memset (Slnfo, 0, sizeof (MCI_PLAY_PARMS)) ; Info.dwFrom = MCI_MAKE_TMSF( StartTrack, 0, 0, 0) ; Flags = MCI_FROM I MCI_NOTIFY; Result = mciSendCommand(wDevicelD, MCI_PLAY, Flags, DWORD(Slnfo)); if (Result) ErrorMsg(Result, "PlayCDOneTrack"); ) ///////////////////////////////////////////// // PlayMCICD ZZZZZZZZZ/ZZ//ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ void CALLBACK export PlayMciCD(BYTE StartTrack, BYTE EndTrack) ( MCI_PLAY_PARMS Info; DWORD Flags, Result; char Sl[MsgLen]; memset(Slnfo, 0, sizeof(MCI_PLAY_PARMS)); Info.dwFrom » MCI_MAKE_TMSF(StartTrack,0, 0,0); Info.dwTo = MCI_MAKE_TMSF(EndTrack, 0,0,0); Flags = MCI_FROM I MCI_TO I MCI_NOTIFY; Result = mciSendCommand(wDevicelD, MCI_PLAY, Flags, DWORD(SInfo)); if (Result) ErrorMsg(Result, "PlayCDMCI"); ) ZZ/ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ ZZ GetCDNumTracks ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ/ZZZZZZ DWORD CALLBACK export GetCDNumTracks (void) ( MCI_STATUS_PARMS Info; DWORD Result; Info.dwCallback =0; Info.dwReturn = 0; Info.dwltem = MCI_STATUS_NUMBER_OF_TRACKS ; Info.dwTrack = 0; Result = mciSendCommand(wDevicelD, MCI_STATUS, MCI_STATUS_ITEM, DWORD (Slnfo)); if (Result) ( ErrorMsg(Result, "GetCDNumTracks") ; return -1; ) return Info.dwReturn; ) //////////////////////////////////////////// // GetCDTrackLength //////////////////////////////////////////// void CALLBACK _export GetCDTrackLength (DWORD TrackNum,
243: BYTE *Min, BYTE ‘Sec, BYTE ‘Frame) 244: ( 245: MCI STATUSPARMS Info; 246: DWORD Result, MSF; 247: char MessageText[MsgLen]; 248: 249: memset(SInfo, 0, sizeof (MCI_STATUSJPARMS)) ; 250: Info.dwTrack = TrackNum; 251: Info.dwltem = MCI_STATUS_LENGTH; 252: 253: Result = mciSendCommand(wDevicelD, MCI_STATUS, 254: MCI_STATUS_ITEM I MCI_TRACK, 255: DWORD(&Info)); 256: 257: if (Result) 258: ( 259: ErrorMsg(Result, "GetCDTrackLength"); 260: return; 261: ) 262: 263: MSF = Info.dwReturn; 264: 265: *Min = MCI_MSF_MINUTE(MSF) ; 266: ‘Sec = MCI MSF SECOND(MSF) ; 267: ‘Frame = MCI_MSF_FRAME (MSF) ; 268: > 269: 270: Z/Z/Z///////////////////////////////////// 271: // GetLengthofEachTrack 272: ZZZZZZ///ZZZZZZZZZZZZZZZZZZZZZZ//ZZZZZZZZZ 273: void CALLBACK _export GetLengthofEachTrack(DWORD TrackNum, 274: BYTE *Min, BYTE ‘Sec, BYTE ‘Frame) 275: ( 276: MCI_STATUS_PARMS Info; 277: DWORD Result, Flags, MSF; 278: 279: memset (SInfo, 0, sizeof (MCI_STATUS_PARMS)) ; 280: Info.dwTrack = TrackNum; 281: Info.dwltem = MCI_STATUS_LENGTH; 282: Flags = MCI_STATUS_ITEM I MCI_TRACK; 283: Result = mciSendCommand(wDevicelD, MCI_STATUS, 284: Flags, DWORD(SInfo)); 285: 286: if (Result) 287: ( 288: ErrorMsg(Result, "GetLengthofEachTrack"); 289: return; 290: } 291: 292: MSF = Info.dwReturn; 293: *Min = MCI_MSF_MINUTE (MSF) ; 294: ‘Sec = MCI_MSF_SECOND (MSF) ; 295: ‘Frame = MCI_MSF_FRAME (MSF) ; 296: ) 297: 298: ZZZZZ////ZZZZZZZZZZZZZZ/ZZZZZZZZZZ//ZZZZ// 299: // GetCurrentCDTrack 300: ZZZZZZZZZZZZZZZ///ZZZZZZZZZZZZZZZZZZZZZZZZ 301: DWORD CALLBACK _export GetCurrentCDTrack(void) 302: ( 303: MCI_STATUS_PARMS Info; 304: DWORD Result; 305: 306: memset(SInfo, 0, sizeof (MCI_STATUS_PARMS)) ; 307: Info.dwltem = MCI_STATUSCURRENT_TRACK; 308: 309: Result = mciSendCommand(wDevicelD, MCI_STATUS, 310: MCI_STATUS_ITEM, DWORD(SInfo)); 311: 312: if (Result ) 313: { 314: ErrorMsg(Result, "GetCurrentCDTrack"); 315: return FALSE; 316: } 317: return Info.dwReturn;
318: ) 319: 320: //////////////////////////////////////// 321: // HasDisklnserted 322: //////////////////////////////////////// 323: BOOL CALLBACK _export HasDisklnserted(void) 324: ( 325: MCI_STATUS_PARMS Info; 326: DWORD Flags, Result; 327: 328: memset(SInfo, 0, sizeof (MCI STATUS_PARMS)) ; 329: Info.dwltem = MCI_STATUS_MEDIA_PRESENT; 330: 331: Flags = MCISTATUS ITEM; 332: Result = mciSendCommand(wDevicelD, MCISTATUS, 333: Flags, DWORD(SInfo)); 334: 335: if (Result) 336: ( 337: ErrorMsg(Result, "HasDisklnserted"); 338: return FALSE; 339: ) 340: 341: return Infо.dwReturn; 342: ) 343: 344: ///////////////////////?///////////////////// 345: // EjectCD 346: ///////////////////////////////////////////// 347: void CALLBACK _export EjectCD(void) 348: ( 349: MCI_SET_PARMS Info; 350: DWORD Flags, Result; 351: 352: memset(SInfo, 0, sizeof(MCI_SET_PARMS)); 353: Flags - MCI_SET_DOOR_OPEN; 354: Result = mciSendCommandfwDevicelD, MCI_SET, 355: Flags, DWORD(SInfo)); 356: if (Result) 357: ErrorMsg(Result, "EiectCD"); 358: ) 359: 360; ////////////////////////////////////////// 361: // GetCDLocation 362: ////////////////////////////////////////// 363: DWORD CALLBACK _export GetCDLocation(void) 364: ( 365: MCISTATUS-PARMS Info; 366: DWORD Flags, ErrorNum; 367: 368: Info.dwltem = MCI_STATUS_POSITION; 369: Flags = MCI_STATUS_ITEM; 370: ErrorNum = mciSendCommand(wDevicelD, MCI_STATUS, 371: Flags, DWORD(SInfo)); 372: if (ErrorNum) 373: ( 374: ErrorMsg(ErrorNum, "GetLocation"); 375: return -1; 376: ) 377: return Info.dwReturn; 378: ) Листинг 20.13. CDINFO.H 1: /////////////////////////////////////////// 2: // Модуль: CDINFO.H 3: // Автор: Чарли Калверт 4: // Описание: DLL для программы Harmony 5: // Дата: 08/07/93 6: /////////////////////////////////////////// 7: BOOL CALLBACK _export OpenCD(HWND PWindow); 8: BOOL CALLBACK _export CloseCDMCI(void); 9; BOOL CALLBACK _export PauseCDMCI (void) ; 10: void CALLBACK export PlayMciCD(BYTE StartTrack, 11: BYTE EndTrack);
12: void CALLBACK _export PlayCDOneTrack(BYTE StartTrack); 13: 14: 15: 16: 17: 18: 19: 20: 21: void CALLBACK _export SetTMSFasFormat (void); DWORD CALLBACK export GetCDNumTracks (void); void CALLBACK _export GetCDTrackLength (DWORD TrackNum, BYTE *Min, BYTE *Sec, BYTE *Frame); DWORD CALLBACK _export GetCurrentCDTrack(void); BOOL CALLBACK _export HasDisklnserted (void) ; void CALLBACK _export E jectCD (void) ; BOOL CALLBACK _export StopCDMCI(void) ; DWORD CALLBACK _export GetCDLocation(void) ; Листинг 20.14. CDINFO.DEF 1: LIBRARY CDInfo 2: 3: DESCRIPTION 'CDInfo (C) 1993 Charlie Calvert' 4: EXETYPE WINDOWS 5: CODE PRELOAD MOVEABLE DISCARDABLE 6: DATA PRELOAD MOVEABLE SINGLE 7: HEAPSIZE 5120 Листинг 20.15. HARMONY.MAK (Borland) 1: # HARMONY.MAK 2: 3: APPNAME = Harmony 4: PATHS = -IC:\BC\INCLUDE -LC:\BC\LIB 5: FLAGS = -H -ml -R -2 -W -v -w4 -vi -wpro -weas -wpre 6: DLLFLAGS = -ml -R -WDE -2 -v -wpro -weas -wpre 7: LIBS = Playinfo.lib CDInfo.lib B: OBJS = Harmony.obj WaveMidi.obj CDUtil.obj 9: 10: # Цель 11: ALL: Playlnfo.dll CDInfo.dll $ (APPNAME).exe 12: 13: # Компоновка ЕХЕ-файла 14: $ (APPNAME)-exe: $(OBJS) $ (APPNAME) .def $ (LIBS) $ (APPNAME) .res 15: bcc $(FLAGS) $(PATHS) $(OBJS) $(LIBS) 16: rc $(APPNAME).res 17: IB: # Компоновка DLL 19: playinfo.dll: playinfo.obj playinfo.def 20: bcc $(DLLFLAGS) $(PATHS) playinfo.obj 21: 22: cdinfo.dll: cdinfo.obj cdinfo.def 23: bcc $(DLLFLAGS) $(PATHS) cdinfo.obj 24: 25: # Компиляция 26: $ (APPNAME) . ob j : $ (APPNAME) . cpp 27: bcc -c $ (FLAGS) $ (PATHS) $ (APPNAME) .cpp 28: 29: # Компиляция 30: CDUtils.obj: CDUtils.cpp 31: bcc —c $(FLAGS) $(PATHS) CDUtils.cpp 32: 33: # Компиляция 34: WaveMidi.obj: WaveMidi.cpp 35: bcc —c $(FLAGS) $ (PATHS) WaveMidi.cpp 36: 37: # Компиляция 38: .cpp.obj: 39: bcc —c $(DLLFLAGS) $(PATHS) ( $< ) 40: 41: # Ресурсы 42: .rc.res: ’3: brc —r $(PATHS) ( $< ) 44: 15: # Библиотеки lb: .dll.lib: 47: implib $&.lib $&.dll
Листинг 20.16. HARMONY.MAK (Microsoft) 1: # HARMONY.MAK 2: 3: APPNAME = Harmony 4: DLLCOMPFLAGS = -c -ALw -Gsw -Ow -W2 -Zp 5: DLLLINKFLAGS = /align:16, NUL, /nod Idllcew libw mmsystem 6: COMPFLAGS = -C -Gsw -Ow -W3 -AL -Zp 7: LINKFLAGS = /align: 16, NUL, /nod llibcew libw 8: OBJS = Harmony.obj WaveMidi.obj CDUtil.obj 9: LIBS = PlayInfo.lib CDInfo.lib 10: 11: # Цель 12: ALL: $(APPNAME).exe Playlnfo.dll CDInfo.dll 13: 14: # Компоновка ЕХЕ-файла 15: $ (APPNAME) .exe: $ (OBJS) $ (APPNAME) .def $ (APPNAME) .res $ (LIBS) 16: link $(OBJS), $ (LINKFLAGS) $(LIBS) Comm Dig, $ (APPNAME) 17: rc $ (APPNAME) .res 18: 19: # Компоновка DLL 20: playlnfo.dll: playinfo.obj playinfo.def 21: link playinfo, playlnfo.dll $(DLLLINKFLAGS), playinfo 22: 23: cdinfo.dll: cdinfo.obj cdinfo.def 24: link cdinfo, cdinfo.dll $(DLLLINKFLAGS), cdinfo 25: 26: # Компиляция 27 : $ (APPNAME) . obj : S (APPNAME) . cpp 28: cl $ (COMPFLAGS) $ (APPNAME). cpp 29: 30: # Компиляция 31: CDUtils.Obj: CDUtils.Cpp 32: cl $(COMPFLAGS) CDUtils.cpp 33: 34: # Компиляция 3 5: WaveMidi.obj: WaveMidi.cpp 36: cl $ (COMPFLAGS) WaveMidi.cpp 37: 38: # Компиляция 39: .cpp.obj: 40: Cl S(DLLCOMPFLAGS) $(PATHS) ( $< ) 41: 42: Ресурсы 43: harmony.res: harmony.rc 44: rc -r harmony.rc 45: 46: # Библиотеки 47: playinfo.lib: playlnfo.dll 48: implib playinfo.lib playlnfo.dll 49: 50: cdinfo.lib: cdinfo.dll 51: implib cdinfo.lib cdinfo.dll Программа Harmony имеет две основные части: основной файл и набор DLL. В частности, среди них есть две DLL, одна из которых содержит MCI-код для воспроиз- ведения WAV- и MIDI-файлов (PLAYINFO.DLL), а вторая — MCI-код для проигрыва- ния компакт-дисков (CDINFO.DLL). Раздел, объясняющий DLL, находится ближе к концу этой главы. Сейчас я могу только сказать, что DLL весьма напоминают EXE-файлы, за исключением того, что они используют функцию LibMain вместо WinMain. Кроме того, функции DLL, вызываемые из основной программы, объявляются с помощью ключевых слов CALLBACK и export: BOOL CALLBACK _export CloseMCI (void) ; Запомните, что программа Harmony использует один и тот же код для воспроизве- дения, закрытия, остановки, паузы и вычисления длительности (в миллисекундах) как MIDI-, так и WAVE-файлов. Другая половина программы, не являющаяся DLL, написана в стандартном для Windows коде. Она выводит основное окно, которое представляет собой диалог, позво- ляющий пользователю воспроизводить файлы (см. рис. 20.2). Код, используемый для
воспроизведения MIDI-, WAVE- и CD-файлов, содержится в модуле HARMONY.CPP; код, соответствующий CD-файлам, находится в CDUTIL.CPP; а код, относящийся к WAVE- и MIDI-файлам - в WAVEMIDI.CPP. Рис. 20.2. Программа Harmony позволяет воспроизводить MIDI- и WAV-файлы, а также компакт-диски На старте Первый специфический код MCI, используемый в программе Harmony, проверяет, поддерживает ли текущая система CD-файлы. Если нет, то кнопка-селектор, переклю- чающая программу в режим CD, становится недоступной, что достигается посредством обращения к EnableWindow. Код, проверяющий возможности CD, находится в PLAY- INFO.CPP: 307: BOOL CALLBACK _export DoesDeviceExistOnSystem(LPSTR DeviceType) 308: { 309: DWORD ErrorNum, Flags; 310: MCI_OPEN_PARMS Info; 311: 312: Info.IpstrDeviceType = DeviceType; 313: Flags = MCI_OPEN_TYPE; 314: ErrorNum = mciSendCommand(0, MCI_OPEN, Flags, DWORD(SInfo) ) ; 315: 316: if (ErrorNum) 317: return FALSE; 318: else 319: ( 320: wDevicelD = Info.WDevicelD; 321: CloseMCI (); 322: return TRUE ; 323: ) 324: ) Как видите, вначале этот код проверяет, может ли быть открыт драйвер CD. Если нет, то функция возвращает значение FALSE.. В противном случае она вызывает CloseMCI, так что устройство не остается открытым, пока выполняется программа. Заметьте, что DLL аккуратно сохраняет идентификатор устройства в глобальной пере- менной, перед тем как вызвать CloseMCI. Иначе Windows возмутится, и вызов закон- чится неудачей. Конечный результат этих действий состоит в том* что пользователь немедленно информируется о доступности CD. Та же самая техника может быть использована для запроса Windows о возможности работы с WAVE- и MIDI-файлами или с каким-либо другим устройством.
Замечание. Можно специально проверить, установлен ли драйвер MIDI Mapper. Этот вызов может быть полезен, поскольку MIDI-драйверы для Windows часто являются причиной непри- ятностей. Если у вас будут проблемы при работе с MIDI, попытайтесь толкнуть MIDI Mapper из программы Drivers на управляющей панели (рис. 20.3). Кроме того, иногда достаточно просто изменить порядок, в котором MIDI-драйверы перечисляются в разделах “drivers” и “mci” файла SYSTEM.INI. К тому же вы можете воспользоваться утилитой Media Player, поставляемой вместе с Windows, чтобы проверить, все ли в порядке в вашем коде или в системе. jnrtalled Driven Sound Driver for PC-Speakei MIDI M<> jici (MCI] CD Audio [MCI] MIDI Sequencer [MCI] Sound ♦i Рис. 20.3. Использование драйверов управляющей панели Windows для реализации возможностей мультимедиа Общие стратегии MCI Программа Harmony проверяет, были ли попытки пользователя открыть устройство и/или файл успешны. Если хотя бы один шаг оказался неудачным, программа заверша- ется. Благодаря функции mciGetErrorString вы легко можете отправить пользователю соответствующие сообщения об ошибке. После открытия файла хорошо бы сообщить его длину и формат, прежде чем начать проигрывать его. Пока пользователь слушает файл, Harmony сообщает о количестве пройденных и оставшихся строк, что особенно важно в случае воспроизведения ком- пакт-дисков или MIDI-файлов (которое может длиться несколько минут или больше). Когда файл заканчивается или когда пользователь прерывает воспроизведение, программа закрывает устройство прежде, чем завершиться. Harmony всегда проверяет результаты конкретных вызовов, чтобы отреагировать соответствующим образом в случае обнаружения ошибок. Это в значительно большей степени касается программ, предназначенных для широкой публики, а не для профессиональных программистов. Детали Теперь осталось рассмотреть несколько деталей, которые могут вызвать у читателя затруднения. В частности, вам следует обратить внимание на функцию SetTimeFormatMS: 243: BOOL CALLBACK _export SetTimeFormatMs(void) 244: ( 245: MCI_SET_PARMS Info; 246: DWORD ErrorNum, Flags; 247: 248: Info. dwTimeFormat = MCI_FORMAT_MILLISECONDS; 249: Flags = MCI_SET_TIME_FORMAT; 250: ErrorNum = mciSendCommand(wDevicelD, MCI_SET, 251: Flags, DWORD(Slnfo)); 252: if (ErrorNum) 253: ( 254: ErrorMsg(ErrorNum, "SetTimeFormatMs"); 255: return FALSE; 256: ) 257: return TRUE ; 258: }
Этот код использует структуру MCI_SET_PARMS: typedef struct { DWORD dwCallback; DWORD dwTimeFormat; DWORD dwAudio; ) MCI_SET_PARMS ; Основной член этой структуры — dwTimeFormat, использующийся для выбора конкретного формата времени. Программа Harmony использует для измерения длины WAVE- и MIDI-файлов миллисекунды, а д ля CD-файлов — секунды и минуты. Заметьте, что mciSendCommand получает в качестве параметра флажок MCI_SET_TIME_FORMAT. Другие сообщения, которые могут быть переданы в этом месте, — это MCI_SET_DOOR_CLOSED и MCI_SET_DOOR_OPEN. Этот последний флажок можно использовать для выброса компакт-диска из устройства, как показано в CDINFO.CPP. Согласитесь, что обнаружить сообщение MCI_SET в том же месте, где выдается команда выброса кассеты, является немного странным. Это демонстрирует один из недостатков командного интерфейса MCI, а именно нехватку интуитивной ясности API, который мог бы выделить такую команду, как EjectCD. Финальный акт заключается в отправлении сообщений MM_NOTIFY объектам диалога главной программы. Эти сообщения направляются в стандартный обработчик сообщений, например, такой, как приводимый ниже фрагмент HARMONY.CPP 296: void Harmony_OnMCINotify(HWND hwnd, UINT status, int DevicelD) 297: ( 298: char S[100],- 299: 300: if (State == ERROR_OCCURED) 301: return; 302: 303: switch (status) 304: ( 305: case MCI_NOTIFY_ABORTED: 306: strcpy(S, "Aborted"); 307: break; ... // Дополнительный код 323: case MCI_NOTIFY_SUPERSEDED: 324: 325: 335: 336: strcpy(S, "Superseded"); break; ) SetWindowText(GetDlgltemthwnd, ID MODE), S) ; 341: ) Для полного понимания метода Harmony_OnMCINotify вы должны уяснить, что Harmony получает сообщение всякий раз, как только с воспроизводящимся файлом случается что-нибудь важное. Например, если файл заканчивается или пользователь нажимает кнопку Pause, то отправляется сообщение MM_NOTIFY. Замечание. Чтобы заполнить паузы между сообщениями MM NOTIFY, Harmony пользуется таймером для проверки статуса воспроизводящего устройства. Например, если проигрывается MIDI-файл, то таймер позволяет вам проверять его длительность в интервалах. В данной конкретной программе интервалы имеют длительность 10 миллисекунд. Когда заканчивается текущий воспроизводимый файл или пользователь требует прекратить воспроизведение, естественной реакцией является закрытие устройства. Разумеется, это не то же самое, что требуется сделать, если бы пользователь просто приостановил воспроизведение. Для того чтобы различать эти два события, программа Harmony использует переменную State, которая может принимать следующие значения: // States «define PAUSED 1 «define PLAYING 2 «define STOPPED 3
#define CLOSED 4 «define OPENED 6 «define RECORDING 7 «define ERROR_OCCURED 8 Установив значение переменной State, программа всегда может узнать, что случилось, и отреагировать соответствующим образом. Если хотите, можете управлять этой же задачей с помощью сообщения MCI STATUS. Введение в DLL Динамически присоединяемые библиотеки (DLL) представляют собой нечто очень похожее на библиотеки DOS или даже на стандартные OBJ-файлы. Цель DLL — предоставить программистам место для хранения подпрограмм, которые могут быть вызваны из одной или нескольких программ. Подпрограммы, хранящиеся в DLL, в отличие от OBJ- или LIB-файлов компонуются на этапе выполнения. Во время компи- ляции и компоновки программа просто информируется о наличии DLL, содержащей необходимые ей модули. После загрузки программы они компонуются динамически. Все DLL имеют функцию LibMain, весьма напоминающую WinMain, и функцию WEP — приблизительный аналог функции ClsOnDestroy. Функция LibMain int FAR PASCAL LibMain (HINSTANCE, WORD, WORD, LPSTR) ; HINSTANCE hlnstance WORD WDataSeg WORD cbHeapSize LPSTR IpCmdLine Содержит экземпляр дескриптора DLL Сегмент данных (DS) DLL Размер локальной динамической области Командная строка, передаваемая DLL LibMain вызывается автоматически при загрузке DLL в память. Вы должны поддерживать эту подпрограмму. Если она не существует, ваш файл не будет компилироваться. Пример: int CALLBACK LibMain(HINSTANCE hlnstance, WORD wDataSeg, WORD wHeapSize, LPSTR IpszCmdLine) ( if (wHeapSize > 0) UniockData(0); return 1; ) Непосредственно перед тем как DLL выгружается из памяти, Windows вызывает подпрограмму WEP, предоставляя таким образом прекрасный случай для высвобождения памяти, отведенной под DLL. Borland автоматически поддерживает WEP для DLL, однако пользователям компилятора Microsoft необходимо явно позаботиться об этом. Экспорт функций из DLL Сейчас для программистов стало стандартной практикой объявление подпрограмм, которые они хотят экспортировать из DLL, следующим образом: DWORD CALLBACK _export GetLOcation (void) Ключевым элементом этого объявления являются слова CALLBACK и _export. Как вы уже знаете, CALLBACK сообщает компилятору, что функция объявляется как FAR и использует соглашение о вызовах языка Паскаль. Ключевое слово _export также хорошо знакомо вам, поскольку вы уже использовали его с оконными процедурами и обработ- чиками перечисляемых объектов.
Объявив функцию из DLL таким образом, вы должны предпринять два дополнитель- ных шага, чтобы вызвать ее из вашей программы. Первый шаг состоит в том, чтобы включить заголовочный файл в ваш проект, содержащий объявления файлов, которые вы хотите скомпоновать со своей программой. Второй шаг — запустить утилиту ImpLib с именем библиотеки DLL, содержащей функцию, которую вы хотите вызвать. ImpLib запускается из DOS. Она зависит от двух параметров. Первый — имя библиотеки, которую вы хотите создать, а второй — имя запрашиваемой DLL: ImpLib MyFuncs.lib MyFuncs.dll Результатом является файл MyFuncsJib, который можно скомпоновать с вашей программой, как и любую другую библиотеку. Тем не менее существует отличие, состоящее в том, что этот библиотечный файл не содержит реального кода функций, которые вы желаете использовать. Вместо этого он просто ссылается на библиотеку DLL, которая будет присоединена на этапе выполнения. Другой борландовский файл, IMPLIPW, запускается из Windows. Замечание. Важно понимать, что при компоновке DLL указываются другие установки, нежели для обычных модулей вашей программы. Если вы работаете в интегрированной средой разра- ботки Borland или Microsoft, то можете воспользоваться предусмотренными меню для автомати- ческого получения этих установок, как описано в документации. Если вы пользуетесь МАКЕ-файлом, то следует воспользоваться установками, показанными в HARMONY.MAK. DLL и память Если вы сравните DEF-файл для динамической библиотеки CDInfo с остальными DEF-файлами, использующимися в этой книге, то увидите, что он: Использует оператор LIBRARY вместо оператора NAME. Объявляет свой сегмент данных единственным, а не множественным. Не имеет оператора STUB. Не имеет оператора STACKSIZE. Посмотрите на файл CDINFO.DEF: LIBRARY CDInfo DESCRIPTION 'CDInfo (C) 1993 Charlie Calvert' EXETYPE WINDOWS CODE PRELOAD MOVEABLE DISCARDABLE DATA PRELOAD MOVEABLE SINGLE HEAPSIZE 5120 Основной момент здесь состоит в том, что сегмент данных для DLL является единственным (по крайней мере, в 16-битовой Windows), поскольку только одна копия DLL загружается в память за один раз. Во-вторых, у DLL нет стека. Это означает, что она пользуется стеком вызывающей ее программы! Имейте этот факт в виду, когда вызываете DLL. Замечу также, что можно придумать методы экономии пространства для данных программы путем перемещения переменных из вашего локального сегмента DGROUP в DLL. Заключительный этап данного краткого обзора динамических библиотек касается возможности их загрузки в память во время выполнения программы с помощью LoadLibrary. И наоборот, библиотеку можно выгрузить из памяти, вызвав FreeLibrary. Если будете использовать этот прием, то отпадет необходимость компоновать свою программу с LIB-файлом, созданным утилитой ImpLib. Вместо этого вам следует обратиться к GetProcAddress для создания указателя функции. Иногда также потребуется знать индекс функции. Как его получить, вы узнаете из следующего раздела. Отличие в использовании ImpLib и LoadLibrary состоит в том, что в первом случае DLL загружается в память, когда загружена программа, и выгружается, когда программа завершается. Во втором случае (LoadLibrary и FreeLibrary) загрузка и выгрузка происхо- дит динамически.
Срывая покровы с DLL Библиотеки DLL не только позволяют вам хранить повторно используемый кол вне основного исполняемого модуля, но также открывают способ хранения всех подпро- грамм API Windows. Функции, подобные CreateWindow или BitBlt, на самом деле хранятся в библиотеках, имеющих имена USER.EXE, GDI.EXE и KRNLEXE Это означает, что вы пользуетесь DLL буквально с первого дня нашего обучения. Разница лишь в том, что теперь вы сами создаете собственные DLL. DLL — это здорово, но иногда они могут оказаться черным ящиком. Тогда единст- венный способ понять, что в них содержится, — запустить программу ImpDcf, сопро- вождающую компилятор фирмы Borland. Это позволит вам узнать, какие функции находятся в DLL и какие индексы ассоциируются с каждой из этих функций. Синтаксис ImpDef такой же, как и у InipLib, за исключением того, что во втором параметре указывается текстовый файл, который должен содержать результат. impdef MyDLL.txt MyDLL.dll Следующая командная строка выведет результат работы ImpDef на консоль, как показано на рис. 20.4. impdef con MyDLL.dll Замечание. При экспорте функции из DDL вам необходимо решить, будете ли ВЫ пользоваться сокращением имен (name mangling). На рис. 20.4 показана одна функция, использующая сокращение имен, в то время как остальные экспортируются в том виде, как они были бы в стандартном компиляторе Си или Паскаля. Сокращение имен, используемое компиляторами Си++ по умолчанию, затруднит компоновку вашей D1J. с программой на Си или Паскале. Заголовочный файл CD1NFO СРР оставляет сокращение имен активным; PLAY1NFO.H пока- зывает, как избежать его с помощью extern “С”. Единственный способ понять, пользуется ли DLL или другой двоичный файл сокращением имен, — обратиться к TDump или ExcHdr MS DOS Prompt :\B00KS\U2141 APHONY Hypo tUf&.def ГBRARY PLAYINFO | FSCRimoN 'Pl«ytnfo <С> Charlie Calutrt PORTS tap CLOS DIG I ERRORflSG GEIDEVICEID GET INFO GETLEN GETLOCATION GFTNODE OPENMGI PAUSEHCI PLAYNCI SFTTINEFORNATMS STOPNCI DOt DEVI CTEXISIONSYETErt DORFCORD 6AUEFILE еСЙМРНRFORNFUNCIION$QU L E:\BOOKS\W21\HARNONY > Pt 02 03 04 PS e? м w eie mi ei2 ян LH4 015 016 017 ; cnnp«i*rorn£unction(ил*iyned lons> Рис.20.4. Результат работы ImpDefc PLAYiNFO.DLL. В данном примере Can Perform Function имеет сокращение имени, в то время как остальные используют extern С Прекрасный способ узнать, что происходит внутри DLL — воспользоваться утилитой ExcHdr фирмы Microsoft или TDump фирмы Borland. Запустив TDump, вы можете узнать о структуре DLL и обо всех функциях, которые она экспортирует или импортирует. Рано или поздно все хорошие программисты под Windows обязательно потратят день или вечер, запуская ExeHdr или TDump с целью разобраться с KRNL386.EXE, GDI.EXE и USER.EXE. Вывод, который вы увидите, будет объемным, но послужит для снятия покрова тайны с внутренней работы Windows. В качестве приятного дополнения этот способ покажет вам несколько недокументированных функций, приведенных в следую- щем фрагменте KRNL386.EXE:
Name: GETPROCADDRESS Entry: 50 Name: _HWRITE Entry: 350 Name: A 00 OH Entry: 174 Name: LSTRLEN Entry: 90 Name: DIRECTRESALLOC Entry: 168 Name: GETSYSTEMDIRECTORY Entry: 135 Name: BUNNY 351 Entry: 351 Name: GETTEMPFILENAME Entry: 97 Name: GETWINFLAGS Entry: 132 Name: B000H Entry: 181 Вот и все, что я хотел рассказать о DLL в этой книге. Главное, что нужно запомнить, — это то, что работа с ImpLib, CALLBACK и _export сделает ваши библиотеки гибкими и легкими в использовании. Диалоговые окна Еще одним техническим приемом, которым вам нужно овладеть для понимания программы Harmony, является использование диалоговой панели в качестве основного окна. Это на удивление легкий трюк, выполняемый за три шага. Первый шаг состоит в том, что вам нужно использовать CreateDialog вместо CreateWindow при запуске основного окна программы: HWND hwnd ~ CreateDialog (hlnst , szAppName, 0, NULL); Вы уже видели эту подпрограмму прежде. Единственное отличие состоит в том, что на этот раз вы не передаете дескриптор родительского окна, поскольку такового нет у этого диалога. Второй шаг состоит в присвоении константы DLGWINDOWEXTRA полю cbWndEx- tra структуры WndClass диалоговой панели: WndClass.CbWndExtra = DLGWINDOWEXTRA; Эта константа объявляется в WINDOWS.H следующим образом: /* cbWndExtra needed by dialog manager for dialog classes */ «define DLGWINDOWEXTRA 30 Третий, и последний, шаг, необходимый для создания диалоговой панели, состоит в использовании оператора CLASS в определении диалога: Harmony DIALOG 18, 23, 246, 208 STYLE DS_MODALFRAME I WS_OVERLAPPED I WS_CAPTION I WS_SYSMENU CLASS "Harmony" CAPTION "Harmony" BEGIN CONTROL ID_GROUP, "BUTTON", BS_GROUPBOX I WS_CHILD | WSVISIBLE, 6, 5, 107, 93 ... // продолжение кода Заметьте, что имя класса Harmony соответствует содержимому параметра szAppName, передаваемого в CreateDialog. В случае несовпадения этих символьных строк ваша программа может выполняться, но сообщения не будут должным образом передаваться в оконную процедуру. Вот и все об этом. Диалоговые окна на самом деле гораздо удобнее обычных. В качестве приятного дополнения вы получаете возможность пользоваться Resource Work- shop иди Арр Studio для создания всех элементов управления в ваших окнах. Все эти элементы управления будут проинициализированы автоматически на старте. Это озна- чает, что вы сможете оформить внешний вид своей программы всего за несколько минут. Остаток программы Harmony выглядит так же, как любая Windows-программа. То есть там есть оконная процедура, отвечающая на те же сообщения и таким же образом, как любое стандартное основное окно. Единственное отличие заключается в функции Cls_OnCreate, которая не обеспечивает правильный HWND. Чтобы выйти из положения, функция Create автоматически создает все дочерние окна в вашем основном окне.
Резюме Эта глава познакомила вас с DLL и мультимедийными расширениями Windows. В частности, вы узнали: Как использовать mciSendComand для управления функциями мультимедиа. Как получить поясняющий ошибку текст с помощью mciGetErrorString. Как узнать о доступных возможностях мультимедиа на вашей системе. Как создать DLL и как экспортировать функции из них. Как использовать диалоговую панель в качестве основного окна программы. Если хотите узнать что-нибудь еще о мультимедиа, то лучше всего изучить приве- денную программу и интерфейсный модуль MMSYSTEM.H, сопровождающий ваш компилятор. Фирма Micrpsoft также поставляет дополнительную документацию по SDK и две книги: The Microsoft Windows Multimedia Programmer’s Reference и Microsoft Windows Multimedia Programmer’s Workbook. Оба тома изданы Microsoft Press. Вопросы и ответы 1. Есть ли еще какие-нибудь способы узнать о мультимедийных возможностях системы? Да. Вы можете воспользоваться сообщением MCI_GETDEVCAPS. Отправляя это сообщение, заполните MCI_GETDEVCAPS_PARMS.dwItem константами, спрашиваю- щими, может ли соответствующее устройство играть, делать паузу, записывать и т.д. Один из способов использования этого сообщения состоит в запросе о доступности соответствующего устройства (как показано в функции DoesDeviceExistOnSystem). Если устройство доступно, пошлите сообщение GETDEVCAPS. 2. Есть ли еще какой-либо метод экспорта функции из DLL, помимо использования ImpLib? Да. Вы также можете перечислить функции, объявленные как FAR и PASCAL, в разделе EXPORTS файла DEF: EXPORTS MyFuncl MyFuncZ Этот способ достаточно популярен. Впрочем, он не так прост, как ImpLib, поскольку вам требуется явно импортировать все функции в DEF-фаил вашей программы: IMPORTS MyDLL.MyFuncl MyDll.MyFunc2 Вопросы для самопроверки 1. Что обозначает MCI? 2. В чем разница между MIDI- и WAVE-файлами в смысле использования дискового пространства. 3. Что вы делаете с параметром идентификатора устройства, впервые открывая устройство мультимедиа? 4. Какое значение возвращает mciSendCommand? 5. Что делает флажок MCI_NOTIFY? 6. Какие два слова включаются в описание функции, экспортируемой из DLL? 7. Как информировать компоновщик о том, что некоторые функции, использующие- ся в вашей программе, расположены внутри DLL? 8. Программа Harmony использует PLAYINFO.H и CDINFO.H, чтобы узнать об объявлении подпрограмм в CDINFO.DLL и PLAYINFO.DLL. Откуда ваша программа знает об объявлениях подпрограмм в GDI.EXE и USER.EXE? 9. Каково назначение оператора CLASS в HARMONY.RC?
10. Пользуясь TDump и ExeHdr для исследования HARMONY.EXE и PLAYINFO.DLL, вы обнаружите, что эти файлы имеют очень похожую структуру и оба являются примерами так называемого нового исполняемого формата. Из этого сходства следует, что в DLL должен быть эквивалент WinMain. Какой? Упражнения 1. Используйте пустой комбинированный перечень в левой части основного окна программы Harmony для визуального отображения списка файлов, стоящих в очереди на воспроизведение. Пользователь должен быть в состоянии передать файл из перечня в правой части окна в комбинированный перечень посредством двойного щелчка кнопкой мыши. При нажатии кнопки воспроизведения WAV-файлы должны выбираться из комбинированного перечня последовательно друг за другом. 2. Программа Harmony позволяет пользователю записывать сообщение в WAV-файле только в течение заранее определенного времени. Используя такие элементы управле- ния, как кнопки-селекторы, редактируемые поля и линейки прокрутки, создайте диалог, позволяющий пользователю задавать продолжительность записи. При этом сделайте так, чтобы кнопкой записи можно было бы прервать процесс в любой момент.
День 21 SNAKO FOR WINDOWS Сегодня вы познакомитесь с последней версией программы Snako. Основная цель этой главы состоит в том, чтобы позволить вам немножко развлечься, используя приобретенные навыки, а также обсудить некоторые принципы, лежащие в основе создания Windows-программ. В этой главе вводится и несколько новых понятий. В частности, здесь обсуждаются: Организация памяти. Данные, стек и локальная динамическая область (local heap) сегмента DGROUP. Использование указателей для перемещения данных из локальной динамической области. Простой файловый ввод/вывод. Центрирование диалогов. Хотя указатели и являются чрезвычайно важным аспектом программирования под Windows, ни один из этих предметов не обременит ваш интеллект в сколько-нибудь серьезной степени. В основном здесь обсуждаются понятия, с которыми вы уже хорошо знакомы из опыта работы в DOS. Чаще всего программисты выбирают свою профессию потому, что любят програм- мировать. Несомненно, большинство из нас интересуется этой областью просто потому, что она очаровательна и занимательна. Уверен, что потеря этого ощущения игры, смертельна для любого хорошего программиста. Я чувствую, что программистам необ- ходимо получать удовольствие от инструментария, которым они овладевают. Если этого не происходит, никакие деньги не смогут компенсировать наших усилий. Snako Программа Snako состоит из восьми экранов, образующих два различных уровня. Постоянно растущая змея прокладывает свой маршрут по этим экранам, попутно поглощая все красные точки, чтобы в конечном итоге открыть дверь, ведущую к следующему экрану (см. рис. 21.1). В любое время змея может вернуться и посетить ранее пройденный экран текущего уровня. Опасности, присутствующие в этой игре, заключа- ются либо в выходе за границы экрана или на “траву”, либо в пересечении змеей своего хвоста. Цель состоит в том, чтобы пройти все восемь экранов и съесть все красные точки. Игра достаточно проста на первых нескольких экранах. И только после того как змея вырастет до размера порядка 50 секций, борьба обостряется. Если вы сконструируете достаточно сложные экраны, последние уровни могут оказаться чрезвычайно сложными, так что потребуется привлечь физические координаты, логические прогнозы и гибкость ума, чтобы найти путь к победе.
Рис. 21.1. Так выглядит змея в игре Snako for Windows Хотя программа Snako и представляет собой завершенную шру, но поскольку эта книга по программированию, полагаю, что вы захотите модифицировать код в соответ- ствии со своим вкусом Например, было бы неплохо, если бы пользователь мог соотносить скорость змеи со скоростью ее роста. Другие интересные улучшения могли бы позволить змее проползать более чем через два уровня, а также сохранять текущее состояние игры на диске. Так или иначе вы можете модифицировать игру, как пожелаете. Исходная версия, приведенная в этой книге, принадлежит мне. Однако вы вольны распространять копии этой игры по собственному усмотрению. Это средство обучения, а не товар. Исходный код Основная причина небольшого количества новых тем в этой главе состоит в том, что Snako — довольно длинная программа. Будучи таковой, она сама по себе достойна внимания и освещает почти все вопросы проектирования, с которыми может столкнуться программист в реальной работе под Windows. Исходный код представлен в следующих листингах, однако не меньше внимания требует внешний вид отдельных экранов. Иначе говоря, вы можете разработать экраны, которые превратят всю шру в легкую прогулку. С друтой стороны, создание сложных экранов может сделать невозможным прохождение даже первого уровня. Рисунки, приведенные в этой главе, дают примерное представление о сложности экранов, использу- ющихся в программе. Это просто рекомендации, и я yecpci i, что любой, кто заинтересуется игрой, захочет создать свои собственные экраны или, по крайней мере, модифицировать приведенные здесь. Листинг 21.1. SNAKO.CPP 1; /////////////////////////У////////////////////////// 2: // Программа: SHAKO. СРР 3: // Автор: Чарли Калверт 4: 7/ Описание: Игра лля Windows 5: И Дата; 06/05/93 6: /////////////////////////У/////////////////////////// 7: -9: «define STRICT 9: «include «windows.h> 10: «include «windowsx.h>
11: ((pragma hdrstop 12: ((include <string.h> 13: ((include <stdlib.h> 14: ((include "snako.h" 15: ((include "score.h" 16: ((include "grunt.h" 17: ((include "snakutil.h" 18: ((pragma warning (disable : 4068) 19: ((pragma warning (disable : 4100) 20: 21: static char szAppName[] = "Snako"; 22: static char szScoreClass[] = "ScoreKeeper"; 23: HWND hWindow; 24: 25: // Переменные 26: HINSTANCE hlnstance; 27: HWND hScoreWindow; 28: TSNAKEMAP SMap; 29: PGAMEINFO G, SaveGame; 30: ///////////////////////////////////////////// 31: // Инициализация 32: ///////////////////////////////////////////// 33: 34: ((pragma argsused 35: int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInstance, 36: LPSTR IpszCmdParam, int nCmdShow) 37: ( 38: MSG Msg ; 39: 40: if ('hPrevInstance) 41: if ((Register(hlnst)) 42: return FALSE; 43: 44: if (((hWindow = Create(hlnst, nCmdShow))) 45: return FALSE; 46: 47: while (GetMessage(SMsg, NULL, 0, 0)) 48: { 49: TranslateMessage(SMsg); 50: DispatchMessage(SMsg); 51: ) 52: return Msg.wParam; 53: } 54: 55: //////////////////////////////////////////// 56: // Сохранить дескриптор окна. Создать окно. 57: II Показать окно в максимизированном виде. 58: //////////////////////////////////////////// 59: HWND Create(HINSTANCE hlnst, int nCmdShow) 60: { 61: hlnstance = hlnst; 62: 63: HWND hWindow - CreateWindow(szAppName, 64: "A Snake and its Tail", 65: . WSPOPUP, CWUSEDEFAULT, CW_US EDEFAULT, 66: CW_USEDEFAULT, CWUSEDEFAULT, 67: NULL, NULL, hlnst, NULL); 68: 69: if (hWindow == NULL) 70: return hWindow; 71: 72: nCmdShow = SWSHOWMAXIMIZED; 73: 74: ShowWindow(hWindow, nCmdShow); 75: Updatewindow(hWindow); 76: 77: return hWindow; 78: ) 79: 80: //////////////////////////////////////// 81: // Регистрация окна 82: //////////////////////////////////////// 83: BOOL Register(HINSTANCE hlnst) 84: ( 85: WNDCLASS WndClass;
86: 87: 88: 89: 90: 91: 92: 93: 94: 95: 96: 97: 98: 99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: WndClass.style WndClass.IpfnWndProc WndClass.cbClsExtra WndClass.cbWndExtra WndClass.hlnstance WndClass.hlcon WndClass.hCursor = CS_HREDRAW I CSJVREDRAW; = WndProc; = 0; = 0; = hlnst; = Loadicon(NULL, IDI_APPLICATION); = Loadcursor(NULL, IDC_ARROtf) ; WndClass.hbrBackground = GetStockBrush(BLACK_BRUSH); WndClass. IpszMenuName NULL; WndClass.IpszClassName = szAppName; if (!Registerclass((WndClass)) return FALSE; WndClass.IpfnWndProc = ScoreWndProc; WndClass.hlcon — NULL; WndClass.hbrBackground = NULL; WndClass.IpszClassName = szScoreClass; > return Registerclass(4WndClass); ///////////////////////////////////// // Реализация ///////////////////////////////////// ///////////////////////////////////// 114: // Оконная процедура 115: ///////////////////////////////////// 116: LRESULT CALLBACK ___export WndProctHWND hwnd, UINT Message, 117: WPARAM wParam, LPARAM IParam) 118: ( 119: switch (Message) 120: ( 121: HANDLEMSGthwnd, WM_CREATE, Snake_OnCreate); 122: HANDLE_MSG(hwnd, WM DESTROY, Snake_OnDestroy); 123: HANDLEJMSG(hwnd, WM_CHAR, Snake_OnChar); 124: HANDLEJMSG(hwnd, WM_KEYDOWN, Snake_OnKey); 125: HANDLEJMSG(hwnd, WM_PAINT, Snake JSnPaint); 126: HANDLE_MSG(hwnd, WM_TIMER, SnakeJDnTimer); 127: HANDLE_MSG (hwnd, WM_START, SnakeOnStart); 128: HANDLE_MSG(hwnd, WM_SIZE, Snake_OnSize); 129: default: return Snake_DefProc(hwnd, Message, wParam, IParam); 130: ) 131: ) 132: 133: /////////////////////////////////////////// 134: // Обработчик сообщения WM CREATE 135: //////////////////////////7//////////////// 136: ttpragma argsused 137: BOOL Snake_OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) 138: ( 139: if((G = (PGAMEINFO)malloc(sizeof(TGAMEINFO))) == NULL) 140: ( 141: MessageBox(hwnd, "Memory is hosed!", "Closing Snako", MB_OK); 142: return FALSE; 143: ) 144: 145: InitializeSections(); 146: 147 : G->Dat. Speed •= 258; 148 : int XScreen = GetSysteniMetrics (SM_CXSCREEN); 149: 150: if (XScreen " 1024) 151: { 152: G->Dat.GrassX - G->Dat.SizeX = 32; 153: G->Dat.GrassY - G->Dat.SizeY = 32; 154: } 155: 156: if (XScreen •»= 800) 157: ( 158: G->Dat.GrassX - G->Dat.SizeX = 25; 159: G->Dat.GrassY = G->Dat.SizeY - 25; 160: )
161: 162: if (XScreen == 640) 163: ( 164: G->Dat.GrassX = G->Dat.SizeX = 20; 165: G->Dat.GrassY = G->Dat.SizeY = 20; 166: ) 167: 168: G->Dat.MaxScore = 3 * G->Dat.GrassX; 169: G->Dat.MenuSpace = 3; 170: G->Dat.Totalclicks = 0; 171: 172: SMap.Grass = LoadBitmap(hlnstance, “Grass"); 173: SMap.Road = LoadBitmap(hlnstance, “Road"); 174: SMap.Road2 = LoadBitmap(hlnstance, “Road2"); 175: if (((SMap.Grass) II ((SMap.Road) I I (!SMap.Road2)) 176: ( 177: MessageBox(hwnd, "No Grass! No Road! No Road2!", “Fatal Error", 178: MB_OK I MBICONSTOP); 179: return FALSE; 180: ) 181: 182: SMap.Head = LoadBitmap(hlnstance, "Head"); 183: if (.'SMap.Head) 184: ( 185: MessageBox (hwnd, “No head", “Fatal Error", MB OK); 186: return FALSE; 187: ) 188: 189: SMap.Body = LoadBitmap(hlnstance, "Body"); 190: if ((SMap.Body) 191: ( 192: MessageBox(hwnd, “No body", “Fatal Error", MB_OK); 193: return FALSE; 194: ) 195: 196: hScoreWindow = CreateWindow(szScoreClass, “Score", 197: WS_CHILD | WS_VISIBLE I WS_CLIPSIBLINGS, 198: 10, 10, 100, 100, hwnd, 199: HMENU158), hlnstance, NULL); 200: 201: if (1hScoreWindow) 202: return FALSE; 203: 204: G->ScoreRep.Level = 1; 205: ReadArray(hwnd) ; 206: SaveGame - NULL; 207: 208: return TRUE ; 209: ) 210: 211: ////////////////////////////////////////// 212: // Обработчик сообщения WM_DESTROY 213: НИ////////////////////////////////////// 214: fpragma argsused 215: void SnakeOnDestroy(HWND hwnd) 216: ( 217: if (SMap.Head) DeleteObject(SMap.Head); 218: if (SMap.Body) DeleteObject(SMap.Body); 219: if (SMap.Grass) DeleteObject(SMap.Grass); 220: if (SMap.Road) DeleteObject(SMap.Road); 221: if (SMap.Road2) DeleteObject(SMap.Road2); 222: free(G); 223: if (SaveGame) 224: free (SaveGame); 225: PostQuitMessage(0); 226: ) 227: 228: IIHIIIIIIIIIHIIIIIIIIHIIHIHIIHHIIHI 229: // Обработчик сообщения WM_CHAR — Заглушка 230: // для реализации паузы при нажатии клавиши р 231: ///ИН///И//////////////////И///И//И// 232: Upragma argsused 233: void Snake_OnChar(HWND hwnd, UINT ch, int cRepeat) 234: ( 235: switch (ch)
236: 237: ( case 'p': 238: 239: 240: 241: 242: 243: KillTimer (hwnd, SNAKETIMER); break; case 's': SendMessage(hwnd, WM_START, 0, 0L); break; case 'r’: 244: SendMessage(hScoreWindow, WM_COMMAND, ID_SCORE, 0); 245: 246: break; case ' f' : 247: SendMessage(hScoreWindow, WM_COMMAND, ID_FINI, 0); 248: 249: 250: 251: 252: 253: 254: 255: break; ) ) ////////////////////////////////////////// // Обработчик сообщения WM KEYDOWN //////////////////////////7/////////////// ((pragma argsused 256: void Snake_OnKey(HWND hwnd, UINT vk, BOOL fDown, int cRepeat, UINT flags) 257: { 258: switch(vk) 259: ( 260: case VK_DOWN: 261: SetNewDir(DOWN); 262: MoveBitMap(hwnd); 263: break; 264: case VK_UP : 265: SetNewDir(UP); 266: MoveBitMap (hwnd) ; 267: break; 268: case VK_LEFT: 269: SetNewDir(LEFT); 270: MoveBitMap(hwnd); 271: break; 272: case VK_RIGHT: 273: SetNewDir(RIGHT); 274: MoveBitMap(hwnd); 275: break; 276: ) 277: 278: // В случае, если вы нажали кнопку не случайно 279: if (G->Dat.NewScreenStarted -= 2) 280: ( 281: G->Dat.NewScreenStarted = FALSE; 282: SetTimer(hwnd, SNAKETIMER, G->Dat.Speed, NULL); 283: InvalidateRect(hwnd, NULL, TRUE); 284: ) 285: ) 286: 287: //////////////////////////////////////// 288: // — Snake_ OnPaint — 289: // Перерисовка игрового поля 290: //////////////////////////////////////// 291: void Snake_OnPaint(HWND hwnd) 292: { 293: PAINTSTRUCT PaintStruct; 294: 295: HDC PaintDC = BeginPaint(hwnd, SPaintStruct); 296: PaintPlayingField(PaintDC); 297: EndPaint(hwnd, SPaintStruct); 298: 299: G->SectInfo(0].DirChange = FALSE; 300: InvalidateRect(hScoreWindow, NULL, FALSE); 301: ) 302: 303: /////////////////////////////////////// 304: // Установка расположения окна рекордов 305: /////////////////////////////////////// 306: void Snake_OnSize(HWND hwnd, UINT state, int ex, int cy) 307: ( 308: MoveWindow(hScoreWindow, 0, 0, ex, G->Dat.MaxScore - 1, FALSE); 309: FORWARD WM SIZE(hwnd, state, ex, cy. Snake DefProc); 310: . )
311: 312: 313: /////////////////////////////////////////////////// 314: // Обработка пользовательского сообщения WM_START, 315: // когда нажимается кнопка "старт" 316: /Z//////////////////////////////////////////Z////// 317: void SnakeOnStart(HWND hwnd) 318: ( 319: HDC PaintDC ; 320: 321: SetFocus(hwnd); 322: InitializeSections(); 323: ReadArray(hwnd); 324: PaintDC = GetDC(hwnd); 325: PaintPlayingField(PaintDC); 326: ReleaseDC(hwnd, PaintDC); 327: SetUpWindow(hwnd); 328: InvalidateRect(hScoreWindow, NULL, TRUE); 329: ) 330: 331: ///////////////////////////////////////////// 332: // — SnakeOnTimer - 333: // Вызывается по истечении времени. 334: // Обращается к MoveBitMap для перемещения змеи. 335: // Если таймер вызывался 15 раз подряд, то 336: // змея удлиняется на одну секцию. 337: ZZ////Z/ZZ//////ZZZ/////Z////////Z/ZZ////////Z 338: «pragma argsused 339: void Snake_OnTimer(HWND hwnd, UINT id) 340: ( 341: MoveBi tMap(hwnd); 342: G->Dat.TotalClicks++; 343: // QuickScanO; // Отладочная процедура из SnakeUtil 344: SendMessage(hScoreWindow, WM_SETNUMSEGS, 0, (LPARAM)SG->ScoreRep); 345: 346: if (G->ScoreRep.NumPrizes > 60000) G->ScoreRep.NumPrizes = 0; 347: 348: «ifdef _DEBUG 349: if (G->ScoreRepNumPrizes <= 20) 350: if(G->Map[BRIDGEX1][G->Dat.MaxCols - 1] != ROADMAP) 351: MakeGateWay(hwnd); 352: Seise 353: if (G->ScoreRep.NumPrizes <= 0) 354: if((G->Map[BRIDGEX1] (G->Dat.MaxCols - 1] != ROADMAP) I I 355: (G->ScoreRep.ScreenNum == 4)) 356: MakeGateWay(hwnd); 357: Sendif 358: 359: if ((G->Dat.Totalclicks % 15) == 0) 360: AddSection(); 361: 362: G->ScoreRep.NumSects = G->Dat.Sections; 363: 364: if (G->Dat.NewScreenStarted == 2) 365: { 366: G->Dat.NewScreenStarted = FALSE; 367: SetTimer(hwnd, SNAKETIMER, G->Dat.Speed, NULL); 368: InvalidateRect(hwnd, NULL, TRUE); 369: ) 370: ) Листинг 21.2. SNAKO.H 1: //////////////////////////////////////////////////// 2: // Программа: SNAKO.CPP 3: // Автор: Чарли Калверт 4: // Описание: Игра для Windows 5: // Дата: 08/05/93 6: //////////////////Z//////////////////Z//////////////Z 7: 8: «if !defined _SNAKO_H 9: «define _SNAKO_H 10: 11: // Константы 12: «define SNAKETIMER 1
13: ♦define GRASSMAP 1 14: ♦define PRIZEMAP 2 15: ♦define ROADMAP 3 16: 17: ♦define MAXY 21 // Макс, число горизонталей в лабиринте уровня 18: #define MAXX 32 * 4 // Макс, число вертикалей в лабиринте уровня 19: ♦define JUMPSPACE 32 // Ширина экрана в секциях 20: ♦define XWIDTH 25 // Ширина секции 21: [[define YHEIGHT 25 // Высота секции 22: ♦define MAXSECTS 512 // Максимальная длина змеи 23: 24: [[define BRIDGEX1 0 // Горизонталь для мостика а следующему экрану 25: [[define BRIDGEX2 1 // Горизонталь для мостика а следующему экрану 26: 27: ♦define LEFT 0 28: ♦define RIGHT 1 29: ♦define UP 2 30: ♦define DOWN 3 31: 32: // Типы 33: struct TSCOREREP { 34: int NumSects; 35: WORD NumPrizes; 36: LONG TotalScore; 37: WORD ScreenNum; 38: WORD Level; 39: }; 40: 41: // Типы 42: typedef struct ( 43: HDC CompDC; 44: HDC TCompDC; 45: HBITMAP CompBmp; 46: HBITMAP OldBmp; 47: HBITMAP OldTBmp; 48: | TSAVEBITMAP; 49: typedef TSAVEBITMAP TSAVEBITMAPARY[6]; 50: 51: typedef struct 52: { 53: int MaxScore; 54: int MaxCols; 55: int MinCols; 56: int GrassX; 57: int GrassY; 58: int XPos; 59: int MenuSpace; 60: int SizeX ; 61: int SizeY; 62: long Totalclicks; 63: BOOL NewScreenStarted; 64: int Speed; 65: int NumTurns, Sections; 66: J TDATA; 67: 68: typedef struct TSNAKEMAP { 69: HBITMAP Head, Body, Grass, Road, Road2; 70: } SNAKEMAP; 71: 72: typedef struct TSECTINFO ( 7 3: BOOL DirChange; 74: int Dir; 75: int Col, Row; 76: int OldCol, OldRow; 77: J SECTINFO; 78: 79: typedef struct ( 80: TSCOREREP ScoreRep; 81: char Map [MAXY] [MAXX] ; 82: TDATA Dat; 83: TSECTINFO Sectinfo[MAXSECTS]; 84: ) TGAMEINFO; 85: typedef TGAMEINFO *PGAMEINFO; 86:
87: flendif 88: 89: // Макросы 90: fldefine HANDLE_WM_START(hwnd, wParam, IParam, fn) \ 91: ((fn)(hwnd), OL) 92: fldefine FORWARD_WM_START(hwnd, fn) \ 93: (void)(fn)((hwnd), WMjSTART, 0, OL) 94: 95: // Класс Snake 96: fldefine Snake_DefProc DefWindowProc 97: BOOL Snake_OnCreate(HWND hWindow, CREATESTRUCT FAR* IpCreateStruct); 98: void Snake_OnDestroy(HWND hwindow); 99: void Snake_OnChar(HWND hWindow, UINT ch, int cRepeat); 100: void Snake_OnKey(HWND hWindow, UINT vk, BOOL fDown, 101: int cRepeat, UINT flags); 102: void Snake_OnPaint(HWND hwindow); 103: void Snake_OnSize(HWND hwnd, UINT state, int ex, int cy); 104: void Snake_OnStart(HWND hwnd); 105: void SnakeOnTimer(HWND hwindow, UINT id); 106: 107: // Процедуры 108: HWND Create (HINSTANCE hinst, int nCmdShow); 109: BOOL Register(HINSTANCE hinst); 110: BOOL Setupwindow(HWND hwindow); 111: void PaintPlayingField(HDC PaintDC); 112: LRESULT CALLBACK _export WndProc(HWND, UINT, WPARAM, LPARAM); 113: void InitializeSections(HWND hwnd); 114: int ReadArray(HWND hwnd); Листинг 21.3. GRUNT.CPP 1: llllllllllllllllllllltlllllllllllllll/lllllllllllll 2: // Модуль: GRUNT.CPP 3: // Проект: Snake 4: // Автор: Чарли Калверт 5: // Дата: 29 мая 1993 6: // Описание: Отвечает за передвижение змеи 7: /////////////////////////////////////////////////// 8: 9: fldefine STRICT 10: flinclude <windows.h> 11: flinclude <windowsx.h> 12: flpragma hdrstop 13: flinclude <stdlib.h> 14: flinclude <string.h> 15: flinclude “grunt.h" 16: flinclude “snako.h" 17: flinclude “score.h" 18: flinclude “snakutil.h" 19: flinclude “snakopnt.h" 20: flpragma warning (disable : 4100) 21: 22: extern TSNAKEMAP SMap; 23: extern HWND hScoreWindow; 24: extern PGAMEINFO G; 25: 26: int FindSafe(HWND hwnd) 27: ( 28: int Result ; 29: 30: KillTimer(hwnd, SNAKETIMER); 31: if ((G->ScoreRep.Level != 1) II (G->ScoreRep.ScreenNum != 1)) 32: ( 33: Result = MessageBox(hwnd, 34: “Yes to try this level again, no to start over.", 35: “Snako by Charlie Calvert!", MB_YESNO I MB_ICONSTOP); 36: ) 37: else 38: ( 39: Result = MessageBox(hwnd, “Dead Snake!", 40: “Snako by Charlie Calvert!", MB_OK I MB_ICONSTOP); 41: ) 42: if ((Result == IDOK) II (Result == IDNO)) 43: SendMessage(hScoreWindow, WMSCORE, 0, 44: (LPARAM)G->ScoreRep.Totalscore);
45: if (Result != IDYES) 46: ( 47: DoSnakePainting(hwnd); 48: metnset (&G->SectInfo, ' \0', sizeof (G->SectInfo) ) ; 49: memset(&G->ScoreRep, ' \0', sizeof(TSCOREREP)); 50: G->ScoreRep.Level =1; 51: } 52: else 53: G->Dat.NewScreenStarted = 2; 54: return FALSE; 55: 1 56: 57: //////////////////////////////////////////// 58: // Уткнется ли змея сама в себя, если пойдет 59: II в заданном пользователем направлении? 60: //////////////////////////////////////////// 61: BOOL DidSnakeHitSnake(HWND hwnd) 62: ( 63: int C = G->SectInfo[0].Col; 64: int R = G->SectInfo(0]. Row; 65: 66: for (int i = 1; i <=,G->Dat.Sections; i++) 67: if ((C == G->SectInfo[i].Col) ss (R == G->SectInfo[i].Row)) 68: { 69: FindSafe(hwnd) ; 70: return TRUE ; 71: ) 72: 73: return FALSE ; 74: ) 75: 76: /////////////////////////////////////////////// 77: // Эта функция касается только головы змеи. 78: // Проверяет, собирается ли голова врезаться 79: //в тело или попасть на траву. 80: // В обоих случаях возвращает FALSE, иначе TRUE 81: /////////////////////////////////////////////// 82: BOOL FindNextSpace(HWND hwnd) 83: { 84: int Test; 85: 86: switch(G->Sect!nfo(0J.Dir) 87: ( 88: case UP: 89: if (G->SectInfo(0).Row <= 0) 90: return FindSafe{hwnd); 91: Test = G->Map(G->SectInfo[0].Row - 1][G->SectInfo(0].Col]; 92: if ((Test == GRASSMAP) || (G->SectInfo[0].Row <= 0)) 93: return FindSafe(hwnd); 94: G->SectInfo[0].Row -= 1; 95: break; 96: 97: case DOWN: 98: Test = G->Map[G->SectInfo(0].Row + 1][G->SectInfotO].Col]; 99: if (.(Test == GRASSMAP) || (G->SectInfo[0].Row >= MAXY - 1) ) 100: return FindSafe(hwnd); 101: G->SectInfo(0].Row += 1; 102: break; 103: 104: case LEFT: 105: Test = G->Map(G->SectInfo(0].Row][G->SectInfo[0].Col - 1]; 106: if ((Test == GRASSMAP) || (G->SectInfo[0].Col < 1)) 107: return FindSafe(hwnd); 108: G->SectInfo(0].Col -= 1; 109: break; 110: 111: case RIGHT: 112: Test = G->Map[G->SectInfo(0].Row][G->SectInfo[0].Col + 1]; 113: if ((Test -= GRASSMAP) || (G->SectInfo [0] . Col > MAXX)) 114: return FindSafe(hwnd); 115: G->SectInfo[0].Col += 1; 116: break; 117: ) 118: 119: if (Test == PRIZEMAP)
120: ( 121: G->ScoreRep.Totalscore += (LONG)100; 122: G->ScoreRep.NumPrizes—; 123: ) 124: 125: G->Map[G->SectInfo[0].Row][G->SectInfo[0].Col] = ROADMAP; 126: 127: if (DidSnakeHitSnake(hwnd)) 128: return FALSE; 129: else 130: return TRUE; 131: ) 132: 133: ////////////////////////////////////// 134: // Перемешает каждую секцию тела змеи 135: // на один шаг. Данная функция никогда 136: // не вызывается для головы. 137: ////////////////////////////////////// 138: void SetNextSection(int i) 139: ( 140: switch(G->SectInfo[i].Dir) 141: ( 142: case UP: G->SectInfo[i].Row -= 1; break; 143: case DOWN: G->SectInfo[i].Row += 1; break; 144: case LEFT: G->SectInfo[i].Col -= 1; break; 145: case RIGHT: G->SectInfo[i].Col += 1; break; 146: ) 147: ) 148: 149: ////////////////////////////////////////////////// 150: // Когда змея ходит туда-сюда по экрану, 151: // нам нужно знать номер этого экрана, 152: // чтобы можно было известить об этом пользователя 153: ////////////////////////////////////////////////// 154: void SetScreenNum(void) 155: ( 156: switch (G->Dat.MaxCols) 157: { 158: case JUMPSPACE: G->ScoreRep.ScreenNum = 1; break; 159: case JUMPSPACE * 2: G->ScoreRep.ScreenNum = 2; break; 160: case JUMPSPACE * 3: G->ScoreRep.ScreenNum = 3; break; 161: case JUMPSPACE * 4: G->ScoreRep.ScreenNum = 4; break; 162: ) 163: ) 164: 165: /////////////////////////////////////////////// 166: // Переместиться на экран влево или вправо, 167: // если достигнут конец текущего экрана 168: /////////////////////////////////////////////// 169: void CheckForEndScreen(HWND hwnd, int i) 170: { 171: if ((i == 0) 66 (G->SectInfo[i].Col >= G->Dat.MaxCols)) 172: ( 173: if (G->Dat.XPos != (MAXX - JUMPSPACE)) 174: ( 175: G->Dat.XPos += JUMPSPACE; 176: G->Dat.MaxCols += JUMPSPACE; 177: G->Dat.MinCols += JUMPSPACE; 178: G->ScoreRep.NumPrizes = 10000; 179: InvalidateRect(hwnd, NULL, TRUE); 180: SetScreenNum(); 181: G->Dat.NewScreenStarted = TRUE; 182: ) 183: ) 184: 185: if ((i == 0) 66 (G->SectInfo[i].Col < G->Dat.MinCols)) 186: { 187: if (G->Dat.XPos != 0) 188: ( 189: G->Dat.XPos -= JUMPSPACE; 190: G->Dat.MaxCols -= JUMPSPACE; 191: G->Dat.MinCols -= JUMPSPACE; 192: G->ScoreRep.NumPrizes = 10000; 193: InvalidateRect(hwnd, NULL; TRUE); 194: SetScreenNum();
195: ) 196: ) 197: ) 198: 199: /////////////////////////////////////////////////////////////// 200: // Перемещает всю змею вперед. Посредством вызова 201: // FindNextSpace перемещается голова и проверяется, был ли этот 202: // ход допустимым. Если да, то вслед за головой перемещается 203: // все тело с помощью SetNextSection. CheckForEndScreen 204: // осуществляет переход на экран вперед или назад 205: /////////////////////////////////////////////////////////////// 206: void SetColRow(HWND hwnd) 207: ( 208: int i; 209: BOOL Result; 210: 211: for (i = 0; i <= G->Dat.Sections; i++) 212: ( 213: G->SectInfo[i].OldCol = G->SectInfo[i].Col; 214: G->SectInfo[i].OldRow = G->SectInfo[i]-Row; 215: 216: if (i == 0) 217: ( 218: Result = FindNextSpace(hwnd); 219: if(G->Dat.NewScreenStarted == 2) 220: return; 221: ) 222: else 223: SetNextSection(i); 224: 225: if (Result) 226: CheckForEndScreen(hwnd, i); 227: ) 228: 229: if (Result) 230: for (i = G->Dat.Sections; i > 0; i—) 231: ( 232: if (G->SectInfo(i - 1].DirChange) 233: ( 234: G->SectInfo[i].DirChange = TRUE; 235: G->SectInfo(i].Dir = G->SectInfo[i - ll.Dir; 236: G->SectInfo(i - 1].DirChange = FALSE; 237: ) 238: ) 239: ) 240: 241: ////////X////////////////////////////////////// 242: // устанавливает новое направление при повороте 243: /////////////////////////////////////////////// 244: void SetNewDir(int NewDir) 245: ( 246: G->SectInfo[0].Dir = NewDir; 247: G->SectInfo[0]-DirChange = TRUE; 248: ) 249: 250: //////////////////////////////////////////// 251: // Делает змею чуть длиннее 252: //////////////////////////////////////////// 253: void AddSection(void) 254: ( 255: G->Dat.Sections++; 256: 257: G->SectInfо[G->Dat.Sections].Dir = 258: G->SectInfо(G->Dat.Sections - 1]-Dir; 259: G->SectInfо[G->Dat.Sections].DirChange = FALSE; 260: 261: switch (G->SectInfo[G->Dat.Sections].Dir) 262: ( 263: case LEFT: 264: ( 265: G->SectInfo[G->Dat.Sections].Col = 266: G->SectInfo[G->Dat.Sections - l].Col + 1; 267: G->SectInfo[G->Dat.Sections]-Row = 268: G->SectInfo[G->Dat.Sections - 1]-Row; 269: break;
270: ) 271: case RIGHT: 272: { 273: G->SectInfo[G->Dat.Sections].Col = 274: G->SectInfo[G->Dat.Sections - 1].Col - 1; 275: G->SectInfo[G->Dat.Sections].Row = 276: G->SectInfo[G->Dat.Sections - 1].Row; 277: break; 278: } 279: 280: case UP: 281: { 282: G->SectInfo[G->Dat.Sections].Col = 283: G->SectInfo[G->Dat.Sections - l].Col; 284: G->SectInfo[G->Dat.Sections].Row = 285: G->SectInfо(G->Dat.Sections - l].Row + 1; 286: break; 287: } 288: 289: case DOWN : 290: { 291: G->SectInfo[G->Dat.Sections].Col = 292: G->SectInfo[G->Dat.Sections - 1].Col; 293: G->SectInfo[G->Dat.Sections].Row = 294: G->SectInfo[G->Dat.Sections - 1].Row - 1; 295: break; 296: } 297: ) // конец switch 298: 299: G->SectInfo[G->Dat.Sections]-OldCol = 300: G->SectInfо[G->Dat.Sections - l].Col; 301: G->SectInfo[G->Dat.Sections].OldRow = 302: G->SectInfо[G->Dat.Sections - 1].Row; 303: ) 304: 305: 306: /////////////////////////////////////////////////// 307: // Конец игры 308: /////////////////////////////////////////////////// 309: void YouWinfHWND hwnd) 310: { 311: KillTimer(hwnd, SNAKETIMER); 312: MessageBox(hwnd , "You Win!", "Victory!", 313: MB_ICONEXCLAMATION I MBOK); 314: SendMessage(hScoreWindow, WM_SCORE, 0, 315: (LPARAM)G->ScoreRep.Totalscore); 316: ) 317: 318: /////////////////////////////////////////////// 319: // Построить мостик к следующему экрану, начать 320: // следующий уровень или провозгласить победу 321: /////////////////////////////////////////////// 322: void MakeGateWay(HWND hwnd) 323: ( 324: if (G->ScoreRep.ScreenNum == 4) 325: ( 326: if (G->ScoreRep.Level == 2) 327: { 328: YouWin(hwnd); 329: return; 330: ) 331: G->ScoreRep.Level++; 332: StartNewScreen(hwnd); 333: KillTimer (hwnd, SNAKETIMER); 334: MessageBox(hwnd, "Get Ready for a new Level", "Snako", 335: MB_OK I MB_ICONEXCLAMATION) ; 336: if {!SetTimer{hwnd, SNAKETIMER, G->Dat.Speed, NULL)) 337: MessageBox (hwnd, "No Timers Available", "Snako", MB_OK); 338: 339: SaveGameToMemory(hwnd); 340: return; 341: ) 342: MakeAndPaintBridge(hwnd); 343: ) 344:
345: ////////////////////////////////////////// 346: // Главная команда модуля Grunt 347: ////////////////////////////////////////// 348: void MoveBitMap(HWND hwnd) 349: ( 350: SetColRow(hwnd); 351: if (G->Dat.NewScreenStarted == 2) 352: ( 353: ReadGameFromMemory(); 354: G->Dat-NewScreenStarted = 2; 355: ) 356: DoSnakePainting(hwnd); 357: G->ScoreRep.TotalScore += 1; 358: G->SectInfо[0].DirChange == FALSE; 359: if (G->Dat.NewScreenStarted == 1) 360: ( 361: G->Dat-NewScreenStarted = FALSE; 362: SaveGameToMemory(hwnd); 363: ) 364: ) Листинг 21.4. GRUNT.H 1: /////////////////////////////////////////////////// 2: // Модуль: GRUNT.H 3: // Проект: Snake 4: // Автор: Чарли Калверт 5: llllllillllllllllllllllllllllllllllllllllllllllllll 6: 7: ((include "snako.h" 8: 9: // Процедуры 10: void AddSection(void); 11: void MoveBitMap(HWND hwnd); 12: void SetNewDir(int NewDir); 13: void MakeGateWay(HWND hwnd); Листинг 21.5. SNAKOPNT.CPP 1: /////////////////////////////////////////////////////// 2: // Программа: SNAKOPNT.CPP 3: // Автор: Чарли Калверт 4: // Описание: Визуально отображает игровое поле и змею 5: // Дата : 08/05/93 6: /////////////////////////////////////////////////////// 7: 8: ((define STRICT 9: #include <windows.h> 10: ((include <windowsx.h> 11: ((include "snako.h" 12: ((include "snakutil.h" 13: 14: extern PGAMEINFO G; 15: extern TSNAKEMAP SMap; 16: enum Bmps (EHead, EBody, EGrass, ERoad, ERoad2); 17: 18: // --------------===---=========== 19: // Раздел визуального отображения 20: //------=================== 21: 22: ///////////////////////////////////////////////////// 23: // Вычерчивание змеи 24: ///////////////////////////////////////////////////// 25: int PaintTheSnake(HDC PaintDC, HDC HeadDC, HDC BodyDC) 26: ( 27: BitBlt(PaintDC, 28: (G->SectInfo[0].Col - G->Dat.XPos) * G->Dat.SizeX, 29: (G->SectInfo[0J.Row + G->Dat.MenuSpace) * G->Dat.SizeY, 30: G->Dat.SizeX, G->Dat.SizeY, HeadDC, 0, 0, SRCCOPY); 31: 32: for (int i = 1; i <= G->Dat.Sections; i++) 33: BitBlt(PaintDC, 34: (G->SectInfo[i].Col - G->Dat.XPos) * G->Dat.SizeX, 35: (G->SectInfo[i].Row + G->Dat.MenuSpace) * G->Dat.SizeY,
36: G->Dat.SizeX, G->Dat.SizeY, BodyDC, 0, 0, SRCCOPY); 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: 69: 70: 71: 72: 73: 74: 75: 76: 77: 78: 79: 80: 81: 82: 83: 84: 85: 86: 87: 88: 89: 90: 91: 92: 93: 94: 95: 96: 97: 98: 99: 100: 101: 102: 103: 104; 105: 106: 107: 108: 109: return —i ; ) /////////////////////////////////////////////////////// // После того как' змея съела приз, удалить изображение // приза и заменить его на секцию дорожки /////////////////////////////////////////////////////// void FilllnWhereSnakeHasBeen(HDC PaintDC, int i) { TSAVEBITMAPARY SaveBmp; HDC RoadDC ; RoadDC = GetScaledDC(PaintDC, SaveBmp, SMap.Road, ERoad); BitBlt(PaintDC, (G->SectInfo[i).OldCol - G->Dat.XPos) * G->Dat.SizeX, (G->SectInfo[i).OldRow + G->Dat.MenuSpace) * G->Dat.SizeY, G->Dat.SizeX, G->Dat.SizeY, RoadDC, 0, 0, SRCCOPY); DisposeScaledDC(SaveBmp, ERoad); ) /////////////////////////////////////////////// // Главная команда визуального отображения змеи // GetScaledDC находится в SnakUtils /////////////////////////////////////////////// void DoSnakePainting(HWND hwnd) ( TSAVEBITMAPARY SB; HDC DC = GetDC(hwnd); HDC HeadDC = GetScaledDC(DC, SB, SMap.Head, EHead); HDC BodyDC = GetScaledDC(DC, SB, SMap.Body, EBody); int i = PaintTheSnake(DC, HeadDC, BodyDC); DisposeScaledDC(SB, EHead); DisposeScaledDC(SB, EBody); if ((G->SectInfо[i].OldRow > -1) && (G->SectInfo[iJ.OldCol > -1)) FilllnWhereSnakeHasBeen(DC, i); ReleaseDC(hwnd, DC); ) //////////////////////////////////////////////// // Используется функцией PaintBitmaps (см. ниже) //////////////////////////////////////////////// void BlitltfHDC PaintDC, HDC BmpDC, int i, int j) ( BitBlt(PaintDC, (j - G->Dat.XPos) * G->Dat.GrassX, (i * G->Dat.GrassY) + (G->Dat.GrassY * G->Dat.MenuSpace) G->Dat.GrassX, G->Dat.GrassY, BmpDC, 0, 0, SRCCOPY); ) //////////////////////////////////////////// // Используется для отображения фона, // но не змеи. //////////////////////////////////////////// void PaintBitmaps(HDC PaintDC, HDC GrassDC, HDC RoadDC, HDC Road2DC) ( G->ScoreRep.NumPrizes = 0; for (int i = 0; i < MAXY; i++) for (int j = G->Dat.MinCols; j < G->Dat.MaxCols; j++) ( switch (G->Map[i][j]) { case ROADMAP: Blitlt(PaintDC, RoadDC, i, j); break; 110: case GRASSMAP:
111: Blitlt(PaintDC, GrassDC, i, j); 112: break; 113: 114: case PRIZEMAP: 115: Blitlt(PaintDC, Road2DC, i, j); 116: G->ScoreRep.NumPrizes++; 117: break; 118: ) 119: ) 120: ) 121: 122: /////////////////////////////// 123: II Отображение игрового поля 124: lllllllllllllllllllllllllllllll 125: void PaintPlayingField(HDC PaintDC) 126: ( 127: TSAVEBITMAPARY SB; 128: 129: HDC GrassDC = GetScaledDC(PaintDC, SB, SMap.Grass, EGrass); 130: HDC RoadDC = GetScaledDC(PaintDC, SB, SMap.Road, ERoad); 131: HDC Road2DC = GetScaledDC(PaintDC, SB, SMap.Road2, ERoad2); 132: 133: PaintBitmaps(PaintDC, GrassDC, RoadDC, Road2DC); 134: 135: DisposeScaledDC(SB, EGrass); 136: DisposeScaledDC(SB, ERoad); 137: DisposeScaledDC(SB, ERoad2); 138: ) 139: 140: lllllllllllllllllllllllllllllllllllinillll 141: // Вычерчивание мостика к следующему экрану 142: IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIHIIIII 143: void MakeAndPaintBridge(HWND hwnd) 144: ( 145: TSAVEBITMAPARY SB; 146: 147: G->Map[BRIDGEX1][G->Dat.MaxCols - 1] = ROADMAP; 148: G->Map[BRIDGEX2] [G->Dat.MaxCols - 1] = ROADMAP; 149: 150: HDC PaintDC = GetDC(hwnd); 151: HDC RoadDC = GetScaledDC(PaintDC, SB, SMap.Road, ERoad); 152: 153: BitBlt (PaintDC, (JUMPSPACE - 1) * G->Dat.GrassX, 154: (BRIDGEX1 * G->Dat.GrassY) + 155: (G->Dat.GrassY * G->Dat.MenuSpace), 156: G->Dat.GrassX, G->Dat.GrassY, RoadDC, 0, 0, SRCCOPY); 157: BitBlt (PaintDC, (JUMPSPACE - 1) * G->Dat.GrassX, 158: (BRIDGEX2 * G->Dat.GrassY) + 159: (G->Dat.GrassY * G->Dat.MenuSpace) , 160: G->Dat.GrassX, G->Dat.GrassY, RoadDC, 0, 0, SRCCOPY); 161: 162: DisposeScaledDC(SB, ERoad); 163: ReleaseDC(hwnd, PaintDC); 164: ) Листинг 21.6. SNAKOPNT.H 1: /////////////////////////////////////////////////////// 2: // Программа: SNAKOPNT.H 3: // Автор: Чарли Калверт 4: // Описание: Визуально отображает игровое поле и змею 5: // Дата : 08/05/93 6: /////////////////////////////////////////////////////// 7: 8: void MakeAndPaintBridge(HWND hwnd); 9: void DoSnakePainting(HWND hwnd)i 10: void PaintPlayingField(HDC PaintDC); 11: void PaintNewSection(HWND hwnd); Листинг 21.7. SNAKUTIL.CPP 1: lllllllllllllllllllllllllininilllllllllllllllllllllll 2: // Программа: SNAKUTIL.CPP 3: // Автор: Чарли Калверт
4: // Описание: Вспомогательные подпрограммы 5: И Дата : 08/05/93 6: /////////////////////////////////////////////////////// 7: 8: #define STRICT 9: ([include <windows.h> 10: #include <windowsx.h> 11: #include <stdlib.h> 12: #include <string.h> 13: #include <stdio.h> 14: #include "snako.h" 15: 16: extern PGAMEINFO SaveGame; 17: extern PGAMEINFO G; 18: 19: ///////////////////////////////////// 20: // Чтение игры из памяти 21: ///////////////////////////////////// 22: BOOL ReadGameFromMemory (void) 23: { 24: memcpy(G, SaveGame, sizeof (TGAMEINFO)); 25: return TRUE ; 26: ) 27: 28: /////////////////////////////////// 29: // Сохранение игры в памяти 30: /////////////////////////////////// 31: BOOL SaveGameToMemory(HWND hwnd) 32: ( 33: if (!SaveGame) 34: ( 35: free(SaveGame); 36: SaveGame = NULL; 37: ) 38: 39: if ((SaveGame = (PGAMEINFO) ma Hoc (sizeof (TGAMEINFO)) ) == 40: MessageBox(hwnd, "Memory is hosed!", "Closing Snako", 41: return FALSE; 42: ) 43: memcpy(SaveGame, G, sizeof(TGAMEINFO)); 44: return TRUE; 45: ) 46: 47: 48: //////////////////////////////////////// 49: // Растянуть растровые изображения 50: //в соответствии с разрешением экрана 51: //////////////////////////////////////// 52: HDC GetScaledDC (HDC PaintDC, TSAVEBITMAPARY SB, 53: HBITMAP Bmp, int Num) 54: ( 55: SB[Num].CompDC = CreateCompatibleDC(PaintDC); 56: SB[Num].TCompDC = CreateCompatibleDC(PaintDC); 57: SB[Num].CompBmp = CreateCompatibleBitmap(PaintDC, 58: G->Dat.GrassX, G->Dat.GrassY); 59: SB[Num].OldBmp = SelectBitmap(SB[Num].CompDC, Bmp); 60: SB[Num].OldTBmp = SelectBitmap(SB[Num].TCompDC, 61: SB[Num].CompBmp) ; 62: 63: StretchBlt (SB [Num].TCompDC, 64: 0, 0, G->Dat.GrassX, G->Dat.GrassY, 65: SB[Num].CompDC, 0, 0, XWIDTH, YHEIGHT, SRCCOPY) 66: 67: return SB[Num].TCompDC; 68: ) 69: 70: ////////////////////////////////////////////// 71: // Освободить ресурсы, созданные в GetScaledDC 72: ////////////////////////////////////////////// 73: BOOL DisposeScaledDC(TSAVEBITMAPARY SB, int Num) 74: ( 75: SelectBitmap(SB[Num].CompDC, SB[Num].OldBmp); 7 6: SelectBitmap(SB[Num].TCompDC, SB[Num].OldTBmp); 77: DeleteBitmap(SB[Num].CompBmp); 78: DeleteDC(SB[Num]-CompDC); NULL) ( MB OK); 16 Чарльз Калверт
79: DeleteDC(SB[Num].TCompDC); 80: return TRUE; 81: ) 82 ’ 83\ //////////////////////////////////////// 84: // Вызывается при старте игры 85: //////////////////////////////////////// 86: void InitializeSections(void) 87: ( 88: int i. Started, StartRow; 89: 90: StartCol = -1; 91: StartRow = 0; 92: G->Dat.XPos = 0; 93: G->Dat.Sections = 1; 94: G->Dat.MaxCols = 32; 95: G->Dat.MinCds = 0; 96: G->Dat.NewScreenStarted = FALSE; 97: 98: G->ScoreRep.ScreenNum = 1; 99: G->ScoreRep.Totalscore = 0; 100: G->ScoreRep.NumPrizes = 0; 101: G->ScoreRep.Level = 1; 102: 103: for (i = 0; i < 2; i++) 104: ( 105: G->SectInfo[i].Dir = RIGHT; 106: G->SectInfo[i].DirChange = FALSE; 107: G->SectInfo[i]-Col = StartCol - i; 108: G->SectInfo[i].Row = StartRow; 109: G->SectInfo[i]-OldCol = G->SectInfo[i]-Col; 110: G->SectInfo[i].OldRow - G->SectInfo[i].Row; 111: ) 112: ) 113: 114: ///////////////////////////////////////// 115: // Переход на новый уровень 116: ///////////////////////////////////////// 117: void InitializeNewLevel(void) 118: ( 119: int i, StartCol, StartRow; 120: 121: StartCol = -1; 122: StartRow = 0; 123: G->Dat.XPos = 0; 124: G->Dat. MaxCols = 32; 125: G->Dat.MinCols = 0; 126: G~>ScoreRep.ScreenNum = 1; 127: 128: // Выстроить экраны друг за другом 129: for (i = 0; i <= G->Dat.Sections; i++) 130: { 131: G->SectInfo[i].Dir = RIGHT; 132: G->SectInfo[i].DirChange = FALSE; 133: G->SectInfo[i].Col = StartCol - i; 134: G->SectInfo[i].Row = StartRow; 135: G->SectInfo[i].OldCol = G->SectInfo[i].Col; 136: G->SectInfo[i].OldRow = G->SectInfo[i]-Row; 137: ) 138: ) 139: 140; ///////////////////////////////////////// 141: // Пересечение границы 142: ///////////////////////////////////////// 143: void StartNewScreen(HWND hwnd) 144: ( 145: InitializeNewLevel(); 146: ReadArray (hwnd); 147: InvalidateRect(hwnd, NULL, FALSE); 148: ) 149: 150: ////////////////////////////////////////////////////// 151: // Чтение массивом экранов в память 152: // Измените оператор case при добавлении новых уровней 153: //////////////////////////////////////////////////////
154: int ReadArray(HWND hwnd) 155: ( 156: FILE * fp; 157: char Filename[50]; 158: 159: switch (G->ScoreRep.Level) 160: ( 161: case 1: strcpy(Filename, “Screen.Dta"); break; 162: case 2: strcpy(Filename, “Screenl.Dta"); break; 163: ) 164: 165: if ((fp = fopen(Filename, “r") ) == NULL) 166: ( 167: MessageBox(hwnd, “По Stream", “HULL", MB_OK); 168: return FALSE; 169: ) 170: 171: if((fread(G->Map, sizeof(G->Map) , 1, fp)) == 0) 172: ( 173: MessageBox(hwnd, “По map", “Grunt" , MB_OK) ; 174: return FALSE; 175: ) 176: 177: fclose(fp); 178: 179: return TRUE ; 180: ) 181: 182: /////////////////////////////////////// 183: // Если вы прошли уровень и не можете 184: // выйти, даже несмотря на то, что 185: // съели все точки, вызовите эту процедуру 186: // из третьей строки Snako OnTimer 187: //////////////////////////7//////////// 188: void QuickScan(void) 189: ( 190: G->ScoreRep.NumPrizes = 0; 191: int TotalX = G->Dat.MinCols + JUMPSPACE; 192: 193: for (int i = 0; i < MAXY; i++) 194: for (int j = G->Dat.MinCols; j < TotalX; j++) 195: if(G->Map[i][j] == PRIZEMAP) 196: G->ScoreRep.numPrizes++; 197: ) 198: 199: ////////////////////////////////////////////////// 200: // Начальные установки => инициализировать таймер 201: ////////////////////////////////////////////////// 202: BOOL SetUpWindow (HWND hwnd) 203: ( 204: if (!SetTimer (hwnd, SNAKETIMER, 175, NULL)) 205: ( 206: MessageBox(hwnd, “No Timers Available", “Snako", MB_OK); 207: return FALSE; 208: ) 209: return TRUE; 210: ) Листинг 21.8. SNAKUTIL.H 1: /////////////////////////////////////////////////////// 2: // Программа: SNAKUTIL.H 3: // Автор: Чарли Калверт 4: // Описание: Вспомогательные подпрограммы 5: // Дата : 08/05/93 6: /////////////////////////////////////////////////////// 7: 8: #include "snako.h" 9: 10: BOOL ReadGameFromMemory(void); 11: BOOL SaveGameToMemory(HWND hwnd)/ 12: BOOL DisposeScaledDC(TSAVEBITMAPARY SB, int Num); 13: void StartNewScreen(HWND hwnd); 14: int ReadArray(HWND hwnd); 15: void InitializeSections(void);
16: 17: 18: 19: void QuickScan(void); BOOL Setupwindow(HWND hwnd); HDC GetScaledDC (HDC PaintDC, TSAVEBITMAPARY SB, HBITMAP Bmp, int Num); Листинг 21.9. SCORE.CPP 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: IB: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 67: 68: //////fZ/////////////////////////////////////////////// // Программа: SCORE.CPP // Автор: Чарли Калверт // Описание: Табло результата и диалог SaveScore // Дата : 08/05/93 /////////////////////////////////////////////////////// #define STRICT #include <windows.h> #include <windowsx. h> ((pragma hdrstop #include <stdlib.h> #include <stdio.h> #include <string.h> ((include "snako.h" ((include "score.h" #pragma warning(disable: 4068) #pragma warning(disable: 4100) ((define TOTALSCORES 16 struct TSCORESTRUCT ( char Name[SCORESIZE]; LONG Total ; ) SCORESTRUCT; // Переменные LONG NewScore; HBRUSH Pattern; TSCORESTRUCT Scores[TOTALSCORES] ; HWND hStaticWind, hStaticScore; HWND hStatScreen, hDotsLeftWin; HBITMAP Patternmap; BOOL ScoreRecorded = FALSE; extern BOOL ChangeScore = FALSE; FILE * fp; //////////////////////////////////////// // DoScoreDlg //////////////////////////////////////// void DoScoreDlg(HWND hwnd) ( HINSTANCE hlnstance; FARPROC ScoreBox; hlnstance = (HINSTANCE)GetWindowWord(hwnd, GWW HINSTANCE) ; ScoreBox = MakeProcInstance((FARPROC)ScoreDlgProc, hlnstance); DialogBox(hlnstance, "Scores", hwnd, (DLGPROC)ScoreBox); FreeProcInstance(ScoreBox); ChangeScore = FALSE; ) /////////////////////////////////////// // Оконная процедура /////////////////////////////////////// LRESULT CALLBACK export ScoreWndProc (HWND hwnd, UINT Message, WPARAM wParam, LPARAM IParam) { TSCOREREP * ScoreRep; char S[10]; switch(Message) ( case WMJSETNUMSEGS: ScoreRep = (TSCOREREP *)IParam; SetWindowText(hStaticWind,itoa(ScoreRep->NumSects,S,10)); SetWindowText(hDotsLeftWin,Itoa(ScoreRep->NumPrizes, S,10)); SetWindowText(hStaticScore, Itoa(ScoreRep->TotalScore,S,10))
69: SetWindowTextfhStatScreen, itoa (ScoreRep->ScreenNum,S, 10)) 70: 71: return 0; 72: case WM_SCORE: 73: ChangeScore = TRUE ; 74: NewScore = IParam; 75: DoScoreDlg(hwnd); 76: 77: return 0 ; 78: HANDLE_MSG(hwnd, WM_CREATE, Score_OnCreate); 79: HANDLE_MSG(hwnd, WM_DESTROY, Score_OnDestroy); 80: HANDLE_MSG(hwnd, WM_COMMAND, Score_OnCommand); 81: HANDLE_MSG(hwnd, WM_CTLCOLOR, Score_OnCtlColor) ; 82: default: return Score DefProc(hwnd. Message, wParam, IParam) 83: ) 84: 85: ) 86: ///////////////////////////////// 87: // Обработчик сообщения WM CREATE 88: //////////////////////////7/////Z 89: #pragma argsused 90: BOOL Score OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct) 91: ( 92: Int YTopRow = 5; 93: Int YSecRow = 30; 94: int SHeight =17; 95: 96: int BHeight = 22; 97: HINSTANCE hlnstance = 98: 99: (HINSTANCE) GetWindoWWord(hwnd, GWW_HINSTANCE) ; 100: Patternmap = LoadBitmap(hlnstance, "Pattern"); 1Q1: if (!Patternmap) 102: ( 103: MessageBox(hwnd, "No Pattern", "FatalError", MB_OK); 104: return FALSE; 105: ) 106: 107: Pattern = CreatePattemBrush(Patternmap); 108: 109: SetClassWord (hwnd, GCW_HBRBACKGROUND, (WORD) Pattern) ; 110: CreateWindow("static", "NumSections", 111: WS_CHILD I WSVISIBLE 1 SS_LEFT, 112: 10, YTopRow, 95, SHeight, hwnd, NULL, 113: 114: hlnstance, NULL); 115: hStaticWind = CreateWlndow("static", ”0”, 116: WS_CHILD I WS_VISIBLE 1 SS_LEFT, 117: 110, YTopRow, 95, SHeight, hwnd, NULL, 118: 119: hlnstance, NULL ) ; 120: CreateWindow("static", "Total Score", 121: WS_CHILD I WS_VISIBLE 1 SS_LEFT, 122: 10, YSecRow, 95, SHeight, hwnd, NULL, 123: 124: hlnstance, NULL); 125: hStaticScore = CreateWindow("static", "0", 126: WS_CHILD I WS_VISIBLE 1 SS_LEFT, 127: 110, YSecRow, 50, SHeight, hwnd, NULL, 128: 129: hlnstance, NULL) ; 130: 131: // Правый экран 132: 133: int XVal = GetSystemMetrics(SM_CXFULLSCREEN) - 160; 134: CreateWindow("static", "Screen Num", 135: WS_CHILD 1 WS_VISIBLE | SS_LEFT, 136: XVal, YTopRow, 95, SHeight, hwnd, NULL, 137: 138: hlnstance, NULL); 139: hStatScreen = CreateWindow("static", "0", 140: WS CHILD I WS_VISIBLE I SS_LEFT, 141: XVal + 100, YTopRow, 50, SHeight, hwnd, NULL, 142: 143: hlnstance, NULL);
144: CreateWindow("static", "DotsLeft", 145: WS_CHILD | WS_VISIBLE I SS_LEFT, 146: XVal, YSecRow, 95, SHeight, hwnd, NULL, 147: hlnstance, NULL); 148: 149: hDotsLeftWin = CreateWindow("static", "0", 150: WS_CHILD I WS_VISIBLE I SS_LEFT, 151: XVal + 100, YSecRow, 50, SHeight, hwnd, 152: hlnstance, NULL); 153: 154: int Width = GetSysteniMetrics (SM_CXSCREEN) / 2; 155: 156: CreateWindow("button", "SStart", 157: WS_CHILD I WS_VISIBLE I BS_PUSHBUTTON, 158: Width - 100, YTopRow, 60, BHeight, hwnd, 159: HMENU (ID_START) , hlnstance, NULL); 160: 161: CreateWindow("button", "SFini", 162: WS_CHILD I WS_VISIBLE I BS_PUSHBUTTON, 163: Width - 30, YTopRow, 60, BHeight, hwnd, 164: HMENU(ID_FINI), hlnstance, NULL); 165: 166: CreateWindow("button", "ScoSres", 167: WS_CHILD I WS_VISIBLE I BS_PUSHBUTTON, 168: Width + 40, YTopRow, 60, BHeight, hwnd, 169: HMENU(ID_SCORE), hlnstance, NULL); 170: 171: return TRUE; 172: ) 173: 174: lllllllllllllllinillllllllllllllllini 175: // Обработчик сообщения WM_DESTRpY 176: /////////////////////////////////////// 177: #pragma argsused 178: void Score_0nDestroy(HWND hwnd) 179: ( 180: SetClassWord(hwnd, GCW_HBRBACKGROUND, NULL); 181: DeleteBrush(Pattern); 182: DeleteBitmap(Patternmap); 183: PostQuitMessage(0) ; 184: ) 185: 186: lllllllllllllllllllllllllllllllllllllllll 187: // Обработчик сообщения WM COMMAND 188: IIIIIIIIIIIIHIIHIIIIIIinilllllllllllll 189: Kpragma argsused 190: void Score_OnCommand(HWND hwnd, int id, 191: HWND hwndCtl, UINT codeNotify) 192: ( 193: switch(id) 194: { 195: case ID_START : 196: SendMessage(GetParent(hwnd), WM_START, 0, 0L); 197: break; 198: 199: case ID_FINI: 200: SendMessage(GetParent(hwnd), WM_CLOSE, 0, 0L); 201: break; 202: 203: case ID_SCORE: 204: DoScoreDlg(hwnd); 205: break; 206: ) 207: ) 208: 209: //////////////////////////////////////////////////// 210: // Цвет элементов управления на информационном табло 211: IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII 212: HBRUSH Score_OnCtlColor(HWND hwnd, HDC hdc, 213: HWND hwndChild, int type) 214: ( 215: switch(type) 216: ( 217: case CTLCOLORJ5TATIC: 218: case CTLCOLOR_BTN: NULL,
219: case CTLCOLOR_EDIT: 220: SetTextColor(hdc, RGB(0, 127, 0)); 221: SetBkMode(hdc, TRANSPARENT); 222: return GetStockBrush(BLACK_BRUSH); 223: } 224: return FORWARD_WM_CTLCOLOR(hwnd, hdc, hwndChild, 225: type, Score_DefProc); 226: } 227 • 228: ////////////////////////////////////////// 229: // OpenScores 230: ////////////////////////////////////////// 231: int OpenScores(FILE * fp) 232: ( 233: if ( (fp = fopen("Scores.Dta", "r+")) == NULL) 234: ( 235: fp = fopen("Scores.Dta", "w+"); 236: memset(Scores, '\0', sizeof(Scores)); 237: ) 238: else 239: fread(sScores, sizeof(Scores), 1, fp); 240: 241: fclose(fp); 242: return 1; 243: ) 244: 245: ////////////////////////////////////////// 246: // CloseScores 247: ////////////////////////////////////////// 248: BOOL CloseScores(HWND hwnd, FILE * fp) 249: ( 250: int Result ; 251: 252: if ((fp = fopen("Scores.Dta", "w+")) == NULL) 253: ( 254: MessageBox(hwnd, "Error", "er", MB_0K) ; 255: return 0 ; 256: ) 257: 258: Result = fwrite(sScores, sizeof(Scores), 1, fp); 259: if(!Result) 260: ( 261: MessageBox(hwnd, "Error", "er", MB_0K); 262: return 0 ; 263: } 264: 265: fclose(fp); 266: return 1; 267: ) 268: 269: ////////////////////////////////////////// 270: // FillListBox 271: ///////////////////////////////////////// 272: void FillListBox(HWND hDlg) 273: ( 274: char S[150); 275: 276: for (int i = 1; i < TOTALSCORES; i++) 277: ( 278; if (strlen(Scores[i].Name) == 0) 279: strcpy(Scores[i]-Name, "Sammy"); 280: sprintf(S, "%2i) %-20s %101d", i, 281: Scores[i].Name, Scores[i].Total); 282: SendDlgltemMessage(hDlg, ID_SCOREBOX, 283: LB_ADDSTRING, 0, (LPARAM) S); 284: } 285: ) 286: 287: //////////////////////////////// 288: // Подпрограмма обмена 289: //////////////////////////////// 290: void Swap(int i, int j) 291: ( 292: TSCORESTRUCT temp; 293: temp = Scores[i];
•294: Scores [1] = Scores [j]; 295: Scores[j] = temp; 296: } 297: 298: /////////////////////////////////////// 299: // SortScores 300: /////////////////////////////////////// 301: void SortScores(void} 302: { 303: for (int i = TOTALSCORES; i >= 1; i-} 304: for (int j == 2; j <= i; j++) 305: if (Scoresfj - 1].Total < Scores[j].Total} 306: Swap(j-1, j); 307: } 308: 309: ////////////////////////////////////////// 310: // Recordscore 311: ////////////////////////////////////////// 312: void Recordscore(HWND hDlg) 313: { 314: SendDlgltemMessage(hDlg, ID_SCORENAME, WM_GETTEXT, SCORESIZE, 315: (LPARAM) Scores [TOTALSCORES - 1].Name); 316: Scores[TOTALSCORES-1].Total = NewScore; 317: SortScores)}; 318: SendDlgltemMessage(hDlg, ID_SCOREBOX, LB_RESETCONTENT, 0, 0) ; 319: FillListBox(hDlg}; 320: } 321: 322: ////////////////////////////////////////// 323: // Автоматическое центрирование диалога 324: ////////////////////////////////////////// 325: void CenterDialog(HWND hDlg) 326: { 327: RECT R; 328: int i = GetSystemMetrics(SM_CXSCREEN); 329: int j = GetSystemMetrics(SM_CYSCREEN); 330: int Height = GetSystemMetrics(SM_CYCAPTION); 331: Height += (GetSystemMetrics(SM_CYDLGFRAME) * 2); 332: int Width = GetSystemMetrics(SM_CXDLGFRAME) * 2; 333: GetClientRect(hDlg, SR); 334: MoveWindow(hDlg, (i / 2)-(R.right /2), (j / 2)-R.bottom/2, 335: R.right + Width, R.bottom + Height, FALSE); 336: } 337: 338: //////////////////////////////////////////////// 339: // Позволяет пользователю просматривать 340: // список рекордов и добавлять свои собственные 341: //////////////////////////////////////////////// 342: ((pragma argsused 343: BOOL CALLBACK ScoreDlgProc(HWND hDlg, WORD Message, 344: WPARAM wParam, LPARAM IParam) 345: { 346: switch(Message) 347: { 348: case WM_INITDIALOG: 349: SetWindowFont(GetDlgItem(hDlg, ID_SCOREBOX), 350: GetStockObject(SYSTEM_FIXED_FONT) , FALSE); 351: Edit_LimitText(GetDlgltem(hDlg, IDJSCORENAME}, 20}; 352: OpenScores(fp); 353: FillListBox(hDlg) ; 354: if (ChangeScore) 355: PostMessage(hDlg, WM_FOCUS, 0, 0) ; 356: else 357: { 358: MoveWindow(GetDlgItem(hDlg, ID_SCOREBOX}, 359: 10, 6, 365, 225, FALSE}; 360: MoveWindow(GetDlgltem(hDlg, IDOK), 361: 8, 240, 370, 25, FALSE); 362: ShowWindow(GetDlgItem(hDlg, ID_SCORENAME}, SW_HIDE); 363: ShowWindow(GetDlgItem(hDlg, IDJSCORESTAT), SW_HIDE); 364: ShowWindow(GetDlgItem(hDlg, ID_NEWNAME), SW_HIDE); 365: } 366: CenterDialog(hDlg) ; 367: return TRUE ; 368:
369: case WM_FOCUS: 370: SetFocus(GetDlgItem(hDlg, IDSCORENAME)); 371: break; 372: 373: case WM_COMMAND: 374: switch(wParam) 375: ( 376: case IDOK: 377: case IDCANCEL: 378: if ((ScoreRecorded) 379: Recordscore(hDlg); 380: if (Changescore) 381: CloseScores(hDlg, fp); 382: ScoreRecorded = FALSE; 383: EndDialog(hDlg, TRUE); 384: return TRUE; 385: 386: case ID_NEWNAME: 387: Recordscore(hDlg); 388: ScoreRecorded = TRUE; 389: return TRUE; 390: ) 391: ) 392: return FALSE; 393: ) Листинг 21.10. SCORE.H 1: //////////////////////////////////////////////////// 2: // SCORE.H 3: // Используется в SNAKE.CPP 4: // Автор: Чарли Калверт 5: /////////////////////////////////////////////////// 6: 7: «if 'defined _SCORE_H 8: «define _SCORE_H “ 9: 10: // Константы 11: «define SCORESIZE 75 12: «define WM_SETNUMSEGS (WM_USER + 0) 13: «define WM_START (WM_USER + 1) 14: «define WMFINI (WM_USER + 2) 15: «define WM_SCORE (WM USER + 3) 16: «define WM_FOCUS (WMUSER + 4) 17: «define ID_START 190 18: «define ID_FINI 191 19: «define IDSCORE 192 20: 21: «define ID_SCOREBOX 175 22: «define ID_SCORENAME 176 23: «define ID_SCORESTAT 177 24: «define ID NEWNAME 178 25: 26: // Класс Score 27: «define Score_DefProc DefWindowProc 28: BOOL Score_OnCreate(HWND hwnd, CREATESTRUCT FAR* IpCreateStruct); 29: void Score_OnDestroy(HWND hwnd); 30: void Score_OnCommand(HWND hwnd, int id, 31: HWND hwndCtl, UINT codeNotify); 32: HBRUSH ScoreOnCtlColor(HWND hwnd, HDC hdc, 33: HWND hwndChild, int type); 34: 35: «endif 36: 37: // Процедуры 38: LRESULT CALLBACK __export ScoreWndProc (HWND, UINT, 39: WPARAM, LPARAM); 40: BOOL CALLBACK ScoreDlgProc(HWND hDlg, WORD Message, 41; WPARAM wParam, LPARAM IParam) ; Листинг 21.11. SNAKO.RC 1: //////////////////////////////////////////////////// 2: // Программа: SNAKO.RC
3: // Автор: Чарли Калверт 4: // Описание: Игра для Windows 5: // Дата: 08/05/93 6: ///////////////////////////////////////////////////// 7: 8: #inelude <windows.h> 9: «include "score.h" 10: 11: Body BITMAP "body.bmp" 12: Head BITMAP "head.bmp" 13: Pattern BITMAP "pattern.bmp" 14: Grass BITMAP "grass.bmp" 15: Road BITMAP "road.bmp" 16: Road2 BITMAP "road2.bmp" 17: 18: «define NORMALSTY WS_CHILD I WS_VISIBLE I WS_TABSTOP 19: «define LISTBOXSTY LBS_NOTIFY I WS_CHILD I WS_VISIBLE I \ 20: WS_BORDER I WS_VSCROLL 21: 22: Scores DIALOG 18, 18, 193, 136 23: STYLE DS_MODALFRAME I WS_POPUP I WS_VISIBLE I WS_CAPTION I WSJSYSMENU 24: CAPTION "Score Dialog" 25: BEGIN 26: PUSHBUTTON "Close", IDOK, 8, 121, 176, 10, NORMALSTY 27: LISTBOX ID_SCOREBOX, 10, 6, 172, 91, LISTBOXSTY 28: LTEXT "Enter Name", ID_SCORESTAT, 13, 104, 41, 8 29: EDITTEXT ID_SCORENAME, 56, 102, 124, 12 30: END Листинг 21.12. SNAKO.DEF 1:;SNAKO.DEF 2: 3: NAME SNAKO 4: DESCRIPTION 'Snako (c) 1993 Charlie Calvert' 5: EXETYPE Windows 6: STUB 'WINSTUB.EXE' 7: CODE PRELOAD MOVEABLE DISCARDABLE 8: DATA PRELOAD MOVEABLE MULTIPLE 9: HEAPSIZE 20000 10: STACKSIZE 5120 Листинг 21.13. SNAKO.MAK (Borland) 1: « SNAKO.MAK 2: 3: APPNAME = Snako 4: INCPATH = C:\BC\INCLUDE 5: LIBPATH = C:\BC\LIB 6: OBJS = SNAKO. OBJ SCORE. OBJ GRUNT. OB J SNAKUTIL.OBJ SNAKOPNT.OBJ 7: CFLAGS = -ml -WE -v -w4 -1$ (INCPATH) -L$ (LIBPATH) 8: 9: « Компоновка 10: $ (APPNAME) . exe: $ (OBJS) $ (APPNAME) . def $ (APPNAME) . res 11: bcc $ (CFLAGS) S (OBJS) 12: brc $(APPNAME).res 13: 14: « Компиляция 15: -cpp-obj: 16: bcc —c $(CFLAGS) { $< ) 17: 18: # Ресурсы 19: $ (APPNAME). res: $ (APPNAME). rc 20: brc —r -IS (INCPATH) $ (APPNAME).rc Листинг 21.13. SNAKO.MAK (Microsoft) 1: « МАКЕ-файл для Snako 2: 3: MAIN = Snako 4: OBJS = SNAKO. OBJ SCORE. OBJ GRUNT. OB J SNAKUTIL.OBJ SNAKOPNT.OBJ 5: 6: « Компоновка
7: $ (MAIN) exe . $(OBJS) $(MAIN).def S(MAIN).res 8: link /CO$(OBJS), /align: 16, NUL, /nod Ibbcew libw oldnames, $(MAIN) 9: rc $ (MAIN) res 10: 11: И Компиляция 12: .cpp.obj: 13: cl -c -AL -CA -Ow -W4 -Zp -21 ( $< ) 14: IS: # Ресурсы 16: $ (MAIN).res : $(MAlN).rc 17: rc —r $(HAIN).rc Ha рисунке 21.2 показан окно сообщений об ошибках программы Snako Рис. 21.2. Сообщение, появляющееся при ошибке игрока Чтобы сделать программу более понятной и nci кой в эксплуатации, я разделил ее на пять модулей: SNAKO.CPP: это то место, где вы найдете весь материал, составляющий фундамент программирования под Windows. Здесь есть WndProc, WinMain и обработчики различных сообщений. SNAKOPNT.CPP: Это код, визуально отображающий змею на экране. Он вызывается в ответ на сообщения WM PAINT и WM_TIMER. GRUNT.CPP: Логика, определяющая движение змеи по экрану. SNAKUTIL.CPP: Место хранения подпрограмм, общих для предыдущих модулей. SCORE.CPP: Этот модуль управляет дочерними окнами, в которых отображаются набранные очки, а также диалогом, позволяющим пользователю записывать свои рекорды в опустошении игрового поля. Этот обзор должен стать для вас путеводителем по программе Snako. Главное, что нужно понять, — это то, что каждая важная функция пршраммы находится в своем собственном модуле. Как только вы уловите основные понятия, сразу будете знать, где искать конкретные подпрограммы. Заметьте, что программа Snako должна компилироваться в большой модели памяти. По-видимому, это лучшая модель для всех Windows-npoipaMM, но в данном случае она особенно полезна благодаря способу использования указателей.
Помните, программа Mapper, представленная в главе 16, применялась при проекти- ровании экранов для программы Snako? Вероятно, будет полезно перечитать то, что там сказано по поводу основополагающей структуры, стоящей за Snako. Стратегический обзор Вот логика программы в наиболее простой из возможных форм: 1. Все состояние игры хранится в единственной переменной G типа PGAMEINFO. PGAMEINFO представляет собой указатель структуры, определенной в SNAKO.Н. 2. Игра управляется единственным таймером. Snake OnTimer вызывает функцию MoveBitMap, которая находится в модуле GRUNT.CPP. 3. MoveBitMap сначала вызывает функцию SetColRow, являющейся указующим перстом модуля Grunt. Она вычисляет направление движения змеи и соответствующим образом обновляет программные данные. Если змея собирается погибнуть, то в этом месте фиксируется ошибка. 4. Затем MoveBitMap вызывает DoSnakePainting, расположенную в SNAKOPNT.CPP. Здесь происходит визуальное отображение. Заметьте, что змея отображается независимо от фона. Если бы змея и игровое поле рисовались в одной процедуре, то все поле нужно было бы перерисовывать по мере движения змеи. Такое решение было бы слишком расточительным в смысле времени. 5. Когда пользователь переходит к новому экрану, текущее состояние игры записы- вается по адресу, хранящемуся в указателе типа PGAMEINFO. Если пользователь совершает ошибку, то игра может быть восстановлена с помощью информации, записанной по этому указателю. Логика принятия решения о загрузке и перезагрузке игры находится в GRUNT.CPP. Собственно копирование указателя происходит в SNAKUTIL.CPP. 6. Всякий раз, когда пользователь зарабатывает право перейти к следующему экрану, вызывается функция MakeGateWay, находящаяся в GRUNT.CPP. Эта функция фикси- рует смену уровня, а также определяет, выиграл ли пользователь игру или нет. Как я уже сказал ранее, эта глава включена в книгу для того, чтобы развлечь вас игрой и перекраиванием программы Snako. Поэтому я не собираюсь тратить слишком много времени на обсуждение технических моментов. Однако я обещал описать указа- тели, ввод/вывод файлов и метод центрирования диалога. Первыми двумя из этих предметов относительно легко овладеть, но тем не менее они являются краеугольными камнями в конструкции большинства Windows-программ. Использование указателей Программа Snako распределяет память для двух указателей. Чтобы понять, почему это необходимо, вам нужно знать кое-что о том, как типичная программа 16-битовой Windows обращается с памятью. Большинство Windows-программ вынуждены держать свои данные, стек и локальную динамическую область в одном 64-килобайтном сегменте, имеющем имя DGROUP. Это означает, что обычно для данных программы отводится очень мало пространства. Чтобы справиться с этим недостатком доступного пространства, большинство Windows-про- грамм задействует память из глобальной динамической области. Поскольку змея в программе Snako может очень сильно вырасти, потенциально ощущается нужда в большом количестве памяти. Далее, когда пользователь начинает новый экран, все данные программы копируются в переменную, откуда они могут быть выбраны, если пользователю потребуется повторно обратиться к конкретному экрану. Иначе говоря, программе Snako требуется следить за двумя достаточно большими кусками памяти. Учитывая структурный способ построения Windows-программы, оста- ется слишком мало места для данных. Поэтому требуется создать в памяти один или более дополнительных сегментов. Здесь требуется немного больше углубиться в специфику и отметить некоторые из основных структур данных программы Snako. Без лишних сложностей Snako инициали- зирует единственную структуру, содержащую текущее состояние игры. Эта структура
называется G; память под нее отводится во время обращения к SnakoOnCreate и освобождается во время обращения к Snako_OnDestroy. Структура G имеет тип PGAMEINFO и содержит текущее состояние и форму змеи, текущий внешний вид экрана, счет, а также номера экрана и уровня. Точнее говоря, она включает в себя три дополнительные структуры и массив, определенные в SNAKO.H: 79: typedef struct ( 80: TSCOREREP ScoreRep; 81: char Map [MAXY] [MAXX] ; 82: TDATA Dat; 83: TSECTINFO Sectinfo [MAXSECTS] ; 84: } TGAMEINFO; Если хотите понять Snako, вам нужно познакомиться с TGAMEINFO. Помните, что здесь содержатся все переменные, определяющие текущее состояние игры. Вот краткий обзор этой структуры: TSCOREREP — структура, в которой содержатся текущие уровень, экран, счет и число секций тела змеи. Большая часть этой информации визуально отображается для пользователя модулем SCORE.CPP. Мар содержит двумерный массив, определяющий текущий внешний вид игрового поля. Каждый из элементов этого массива равен 1, 2 или 3 (GRASSMAP, PRIZEMAP или ROADMAP), в зависимости от того, определяет ли он изображение травы, приза или дорожки. TDATA содержит информацию о текущих размерах экрана, а также ряд прочих необходимых переменных. TSECTINFO используется в массиве, каждый элемент которого определяет текущее положение конкретной секции змеи. Программа Snako распределяет память для G следующим образом: 139: if ((G = (PGAMEINFO}malloc(sizeof(TGAMEINFO}}} == NULL} 140: ( 141: MessageBox(hwnd, "Memory is hosed!", "Closing Snako", MBOK); 142: return FALSE; 143: } Как видите, здесь нет ничего необычного. Это просто обращение к malloc, точно такое же, каким оно было бы в DOS. В результате выделяется память, явно предназна- ченная для данных программы Snako. Иными словами, данные программы выходят из тесных рамок DGROUP на простор динамической области! Функция malloc void ‘malloc(size_t size}; Функция возвращает блок памяти из динамической области. Она зависит от одного параметра, определяющего желаемый размер отводящейся памяти. Программисты обычно используют ключе- вое слово sizeof, чтобы компилятор вычислил размер переменной. Чаше всего необходимо приводить типы результата malloc и переменной, для которой вы отводите память. В DOS програмкбгстам нужно всегда иметь в виду, что обращение к malloc может потерпеть неудачу из-за недостатка памяти. На Windows-машинах дело обстоит по-другому, но все же этот момент не следует совсем сбрасывать со счетов. Пример: # define MAXSTRLEN 100 char * MyString; if((MySAtring = (char * )malloc(MAXSTRLEN}) === NULL} ( MessageBox(hwnd, "No MEmory!", "Error", MB_OK); return FALSE; }
Когда наступит время отдать память, распределенную посредством malloc, вам нужно проста обратиться к функции free: free(G); Я решил сконцентрироваться на malloc, поскольку она должна быть хорошо знакома широкому кругу потенциальных программистов. Впрочем, вы можете выбрать операторы new и delete или оригинальные функции Windows: GlobalAlloc и GlobalFree. Однако чаще всего обращение к new или malloc и проще, и мудрее, нежели обращение непосредст- венно к GlobalAlloc (см. замечание после описания синтаксиса). Функция GlobalAlloc HGLOBAL GlobalAlloc (UINT fuAlloc, DWORDcbAlloc) UINT fuAlloc Признак, определяющий характеристики памяти, которую требуется выделить. Используйте это поле для определения типа памяти: перемещаемый (moveable), неперемещаемый (fixed), вытесняемый на диск (discardable) и тд. DWORD cbAHoc Параметр, указывающий количество желаемой памяти. Всякий раз при вызове GlobalAlloc, вы также должны вызывать GlobalLock, прежде чем пытаться использовать память. Для освобождения памяти используйте GlobalUnlock и GlobalFree. Пример: HGLOBAL hglb; char FAR* MyStrlng; hglb = GlobalAlloc(GPTR, 1024); MySting = (char *)GlobalLock(hglb); strcpy(MyString, "Fine Tuna"); NessageBoxfhwnd, MyStrlng, "Info", MB_OK); GlobalUnlock(hglb); GlobalFree(hglb); Замечание. Распределение малых областей памяти часто осуществляется самим компилятором. Соответствующий модуль распределения существует в нем потому, что программы 16-битового защищенного режима не могут запрашивать у системы более 8192 областей памяти. Иначе говоря, на любой системе у операционной среды может быть запрошено только 8192 указателя. Эго означает, что если ваша программа делает 8,000 размещений элементов связанного списка, всем остальным программам в системе будет доступно лишь 192 области. Поэтому многие компиляторы автоматически забирают блоки памяти у системы, а затем при необходимости дробят каждый блок с помощью модуля распределения. То есть компилятор берет у системы кусок около 4000 байтов, а затем отдает его вам по частям. В результате только этот 4000-байтный кусок занимает один из 8К доступных дескрипторов. Весь этот процесс происходит без участия программиста, так что ему даже не приходится беспокоиться о том, как все это работает. Впрочем, полезно знать, что запросы на относительно большие блоки памяти передаются непосредственно в Windows с помощью GlobalAlloc. Резуль- таты этого обращения передаются обратно в вашу программу. Наличие такой схемы распреде- ления является одной из основных причин предпочтения работы с malloc или new. Ниже приводится часть файла SNAKUTIL.CPP, в которой страховочный экземпляр данных игры копируется по второму указателю типа PGAMEINFO: 31: BOOL SaveGameToMemory(HWND hwnd) 32: { 33: if ('SaveGame) 34: { 35: free(SaveGame); 36: SaveGame = NULL; 37: ) 38: 39: if ( (SaveGame = (PGAMEINFO)malloc (sizeof (TGAMEINFO) ) ) == NULL) ( 40: MessageBox(hwnd, "Memory is hosed!", "Closing Snako", MB OK) ;
41: return FALSE; 42: } 43: memcpy(SaveGame, G, sizeof(TGAMEINFO)); 44: return TRUE; 45: } Заметим еще раз, что этот код должен быть хорошо знаком всем, кто имел дело с указателями в DOS, UNIX или где-либо еще. Основная стратегия состоит в том, чтобы просто отвести некоторую область памяти, а затем использовать memcpy для перемещения данных программы внутри динамической области с одного места на другое. Когда требуется получить их назад, процесс выполня- ется в обратном направлении. Заметьте, что Snako аккуратно проверяет, требуется ли освободить указатель SaveGame перед распределением новой области памяти и копиро- ванием в нее данных. Программа всегда может сказать, была ли отведена память для SaveGame, проверив этот указатель на NULL. Для того чтобы эта система работала, вы должны специально присвоить указателю значение NULL где-то в начале. Когда игра завершена, распределенная под G и SaveGame память освобождается при необходимости в ответ на сообщение WM_DESTROY. Вам должны быть абсолютно уверены, что освободили всю ранее выделенную вам память, поскольку ваши динами- ческие области могут оставаться нетронутыми даже по завершении вашей программы. Это может так замутить воду, что вся система Windows выйдет из строя. Замечание. В защищенном режиме программистам уже не нужно беспокоиться по поводу знаменитого ограничения в 640К, довлевшего над программистами DOS в течение многих лет. Windows-программы, идущие в 386 расширенном режиме, могут иметь доступ к ЮМ, 20М, даже ЗОМ памяти, в зависимости от ресурсов, доступных в конкретной системе. Поэтому вы можете разместить много различных 64-килобайтных кусков памяти с помощью malloc или new. Кроме того, вы можете разместить гораздо большие куски памяти, обратившись к GlobalAlloc. Напри- мер, на 286-ом компьютере можно разместить до 1М за раз, а на 386-ом — около 16М. Впрочем, вам следует знать, что 16-битным системам нужно продираться через большие куски памяти по 64К за раз с помощью функции ahi пег, находящейся в Windows Kemal, индекс номер 114. Прочитав этот последний раздел, вы должны осознать, что память Windows ради- кально отличается от памяти DOS. Присутствие функций вроде malloc или операторов, подобных new, может сделать незнакомые вещи более родными. Однако вам следует отдавать себе отчет в том, что существует еще много новых понятий, которыми следует овладеть. Впрочем, если вам нужно лишь создать дополнительную область данных вашей программы, то знаний об указателях в рамках DOS или UNIX, по всей видимости, будет достаточно. Подведем итог. Всегда помните и никогда не забывайте, что ваши стек, данные и локальная динамическая область должны разделять между собой один и тот же 64-килобайтный сегмент данных! Это означает, что многие Windows-программы обязаны использовать указатели для хранения своих данных! Как правило, использование операторов malloc или new предпочтительнее GlobalAl- loc, поскольку они вам хорошо знакомы и используют преимущество двухуровневого распределения (через компилятор). Используйте GlobalAlloc для захвата кусков памяти размером до 16М! Ввод/вывод файлов Главной темой последнего раздела было то, что вы можете описывать указатели в Windows, почти так же, как в DOS или UNIX. То же самое справедливо и относительно ввода/вывода файлов. В качестве примера приведем функцию из SCORE.CPP, открывающую файл, содер- жащий список игроков и их рекордов. Информация, взятая с диска в функции Open- Scores, выводится в диалоге, как показано на рисунке 21.3.
Рис. 21.3. Диалоговая панель рекордсменов игры Snako for Windows 231: int OpenScores(FILE • Гр) 232: ( 233: if ( Up - fopen("Scores.Dta”, “rF")| == NULL) 234: ( 235: fp - fopen("Scores.Dta", "wi"); 23€: memset(Scores, \0*, sizeof(Scores)); 237: ) 236: else 239: tread(tScores, sizeof(Scores), 1, fp); 240: 241: fclose(fp); 242: return 1,- 243: ) Это код тою же типа, что можно встретить в учебнике по языку Си. Обращения к fopen, fread и fclose абсолютно стандартны, хотя здесь и недостает проверки ошибок. Дело тут в том, что вы просто должны выполнять ввод/вывод файлов в приложениях DOS Windows абсолютно так же, как это делается в UNIX или DOS. Единственное возможное исключение касается случая, когда вам требуется скопировать файл с одного места на другое. Тогда вам может понадобиться обращение к функции LZCopyFilc. Функция LZCopy LONG LZCopy(hfSourсе, hCDest) HFILE hfSource IIFILE hfDest Дескриптор, полученный из LZOpenFile, lopen, OpenFilc или любой другой подпрограммы Си, открывающей файл в двоичном виде Дескриптор файла назначения Если запрашиваемый файл был сжат с помощью программы COMPRESS EXE, сопровождаю- щей компиляторы фирм Borland и Microsoft, то эта функция восстановит и скопирует этот файл. В противном случае она просто скопирует этот файл.
Пример: flinclude zc-xpond-h chAxszSrc[] - ("c: Wgoober. txt''} i charszDstl) - ("c: Wgoober. foo"); OFSTRVCTofStrSrc; OFSTRUCIbfStrDest; HFILE Source, Dest; Source =»OpenFile(szSrc, bofStrSrc, OFRAED) ; Dest = OpenFlle (ezDst, SofStrDcst, OF_CREATE) ; LZCopyf Source,Dest); _lclose(Source); _lclose(Dest); Вот и все, что я хотел сказать о файловом вводе/выводс. Сей предмет столь легок для объяснения просто потому, что эта часть среды Windows 3.1 почти полностью наследуется из мира DOS. Динамические диалоги и центрирование диалоговой панели Диалог Score, показанный на рисунках 21.3 и 21.4, представляет интерес из-за того, что он может иметь два различных состояния. В одном случае в нижней части диалоговой панели видна лишь единственная кнопка Close, в то время как в другом случае, помимо этой кнопки, имеются также редактируемые и статические поля. Рис. 21.4. Сравните этот рисунок с рис. 21.3. и найдите два отличия в диалоге Score Snako изменяет внешний вил ScoreDlg на этапе выполнения, а не конструирует два отдельных диалога. Это делается с помошыо следующего кода (строчки 358-363 SCORE.CPP). MoveWindow(GetDlgltem(hDlg, IDSCOREBOX), 10, 6, 365, 225, FALSE); MoveWindow(GetDlgltem(hDlg, IDOK), 8, 240, 370, 25, FALSE); Showwindow(GetDlgltem(hDlg, ID SCORENAME) , SW HIDE); ShowWindow(GetDlgltenKhDlg, ID_SCORESTAT), SWBIDE);
Этот код вначале уменьшает размер перечня, содержащего список рекордов, а затем подгоняет размер кнопки Close и скрывает статическое и редактируемое поля, обычно находящиеся в нижней части диалоговой панели. Заметьте, что HWND элемента управления получают посредством обращения к GetDlgltem, и что любое окно может быть скрыто с помощью вызова ShowWindow с идентификатором SWHIDE. В дополнение к манипуляциям по изменению внешнего вида диалоговой панели рекордов, SCORE.CPP также содержит полезную маленькую функцию, гарантирующую, что диалоговая панель всегда будет появляться в середине экрана (см. рис. 21.4). Эта функция, называемая CenterDialog, может использоваться с любым стандартным диало- гом, объявляющимся со стилями WS_CAPTION и DS_MODALFRAME: 325: void CenterDialog(HWND hDlg) 326: { 327: RECT R; 328: int i = GetSysteniMetrics (SMCXSCREEN) ; 329: int j = GetSysteniMetrics (SM CYSCREEN); 330: int Height = GetSysteniMetrics (SM_CYCAPTION); 331: Height += (GetSysteniMetrics (SM_CYDLGFRAME) * 2); 332: int Width = GetSysteniMetrics (SM_CXDLGFRAME) * 2; 333: GetClientRect(hDlg, SR); 334: MoveWindow (hDlg, (i / 2)-(R.right /2), (j / 2)-R.bottom/2, 335: R.right + Width, R.bottom + Height, FALSE); 336: ) Эта функция использует GetSysteniMetrics, чтобы запросить у Windows разрешение текущего экрана, и GetClientRect для получения размера диалога. Затем она использует эту информацию для вычисления положения диалога так, чтобы оно пришлось на центр экрана. Дополнительный код учитывает толщину рамки диалога и заголовок. Резюме В этой главе приведен обзор программы Snako, а также общее обсуждение техники программирования под Windows. В частности, вы познакомились: С использованием malloc, new и GlobalAlloc для получения памяти из динамической области. С простым файловым вводом/выводом. И С центрированием диалогов. Вопросы и ответы 1. Мне трудно работать с ограничениями 64Кбайтного сегмента DGROUP. Как можно хранить данные иначе? Если возможно, то следует хранить символьные строки вашей программы в ресурсе символьных строк или в определяемом пользователем ресурсе. Эта техника исследова- лась в главах 6 и 7. Если вам нужно что-то поместить в динамическую область, помните, что массивы являются структурами данных, требующими наибольшего пространства. Если вы сможете поместить массив в динамическую область, то, возможно, получите значительный выигрыш. Запомните также, что вы можете изменять структуру динами- ческой области, работая с переменными HEAPSIZE и STACKSIZE в DEF-файле. 2. Чем локальная динамическая область отличается от глобальной? Локальная динамическая область располагается внутри 64Кбайтного сегмента DGROUP вместе со стеком и данными программами. Глобальная динамическая область — это просто другое название любой нераспределенной памяти, доступной в системе. Она ограничена в размере только емкостью ОЗУ и виртуальной памяти, доступной на конкретной машине. В Windows есть два набора подпрограмм распределения памяти, один из которых предназначен для локальной динамической области, а другой — для глобальной. Например, локальный эквивалент для GlobalAlloc называется LocalAlloc и
действует вместе с функцией LocalFree. В общем, LocalAlloc несколько быстрее GIobalAl- loc и должна использоваться для скорейшего удовлетворения потребности в памяти. 3. Существует ли соответствие между локальной динамической областью и ресурсами, затрачиваемыми при обращении программы к GDI? Хороший вопрос. Причина того, что вы должны быть столь внимательны при высвобождении ресурсов, полученных с помощью обращений к GDI, состоит в том, что они хранятся в локальной динамической области GDI.EXE. Когда вы обращаетесь к Register-Class или к CreateWindow, необходимая информация сохраняется в локальной динамической области USER.EXE. Поскольку эти области никогда не превосходят 64К, вы постоянно должны тщательно поддерживать память; в противном случае динамическая область GDI будет истрачена. Если захотите посмотреть содержимое своей собственной или какой-либо другой локальной динамической области, то можете воспользоваться динами- ческой библиотекой ToolHelp и функциями LocalFirst и LocalNext. Вопросы для самопроверки 1. В какой книге определены элементы интерфейса Windows и кто ее издал? 2. Как расшифровывается CUA? 3. Что возвращает функция malloc? 4. Какие три функции обычно вызываются всякий раз, когда вы обращаетесь к GlobalAlloc? 5. Какие три типа памяти ассоциируются с DGROUP? 6. Сколько раз одна программа может вызывать GlobalAlloc? 7. Зачем нужен модуль распределения памяти в компиляторе? 8. Как скрыть окно, чтобы пользователь не знал, что оно находится в памяти? 9. Какая единственная “родная” функция Windows может быть использована для копирования файла из одного подкаталога в другой? 10. Назовите, по крайней мере, одну функцию, использующуюся для изменения положения диалоговой панели. Упражнения 1. Измените Snako так, чтобы можно было пройти четыре различных уровня и 16 экранов. 2. Выработайте способ, позволяющий пользователю записывать состояние игры Snako на диск и перезагружать ее в дальнейшем. 3. Измените программу Snako так, чтобы состояние игры не записывалось в память, если пользователь входит в экран вторично. Иначе говоря, сохраняйте только состояние игры, соответствующее первому вхождению пользователя в новый экран. 4. Разрешите пользователю выбирать скорость движения змеи и скорость ее роста.
Приложение А ОТВЕТЫ НА ВОПРОСЫ ДЛЯ САМОПРОВЕРКИ День 1 1. Воспользуйтесь функцией WinExec для запуска Windows- или DOS-прцложения. 2. Windows представляет собой многозадачную среду со встроенной поддержкой мыши, работающую в графическом режиме, в то время как DOS была разработана для работы только с одним приложением, по умолчанию запускаемом в текстовом режиме. Если программисты хотят работать в DOS с мышью, они должны разработать свой собственный интерфейс. 3. GUI — это графический интерфейс пользователя. Традиционно эти интерфейсы обеспечивают поддержку мыши и такую знакомую всем графику, как Окна, линейки прокрутки, кнопки и диалоги. Большинство GUI разрабатывается таким образом, чтобы формировать относительно унифицированный интерфейс независимо от того, с какими приложениями придется работать пользователю. 4. Нет. Windows (которая работает над DOS’om) — это только очень изощренное расширение DOS. Она действительно выполняет много из того, что ассоциируется с операционной системой, но перекладывает остальные задачи, такие, как ввод/вывод, на DOS. Ей также недостает некоторых более развитых возможностей, таких, как вытес- няющая многозадачность, которая часто ассоциируется с настоящей операционной системой. 5. PIF — это место, где хранится информация, которую Windows может использовать, работая с DOS. Например, пользователи могут применять PIF-файлы для указания того, должен ли сеанс DOS проходить на полным экране или в окне, или указать количество памяти, необходимое для сеанса. 6. Борландовский отладчик называется Turbo Debugger for Windows. Его аналог, произведенный в Microsoft, называется Codeview. Еще одно очень популярное средство называется Bounds Checker for Windows. 7. Нет. Windows использует дескриптор HINSTANCE, назначенный программе для того, чтобы отличать данную программу от всех остальных', выполняющихся в системе. 8. С точки зрения программиста вход в программу — это функция WinMain. Впрочем, вы должны знать, что перед WinMain выполняется некоторый стартовый код. 9. hPrevInstance полагается равным NULL, если не существует предыдущих экзем- пляров программы. Может быть использован для проверки наличия ранее запущенных копий приложения. 10. Если выполняется более одного экземпляра программы, hPrevInstance полагается равным hlnstance последней копии программы, загруженной в память.
День 2 1. WinStub — это программа DOS, которая выполняется в том случае, если Windows- программа запускается из командной строки DOS. Обычно она выводит примерно такое сообщение: “Этой программе требуется Microsoft Windows”. 2. Файл определения модуля содержит информацию о размере стека и динамически распределяемой области памяти, а также имя WinStub, имя модуля и краткое описание файла. 3. WinMain и WndProc. 4. Код регистрации MainWindow, код создания основного окна и код определения основного цикла обработки сообщений. 5. WM DESTROY. День 3 1. WNDCLASS — это структура, использующаяся для определения основных харак- теристик оконного класса: имени, пиктограммы, курсора и т.п. 2. Используйте функцию Register для определения полей структуры WNDCLASS и для регистрации этой структуры в составе окна посредством вызова RegisterClass. 3. Используйте эту функцию для создания и визуализации основного окна програм- мы. Это делается посредством обращений к CreateWindow, ShowWindow и UpdateWindow. 4. Функция ShowWindow устанавливает состояние видимости окна, т.е. для того, чтобы сделать окно видимым или невидимым. Функция UpDateWindow посылает окну сообщение WM_PAINT, тем самым вызывая перерисовку его содержимого. 5. WndProc позволяет вам определить поведение, ассоциированное с конкретным окном. А именно, каким образом окно будет обрабатывать любые посылаемые в него сообщения. 6. Цикл опроса сообщений работает стражником при оконной процедуре. Он может быть использован для фильтрации, координации или модификации сообщений, прежде чем они попадут в оконную процедуру. 7. DefWindowProc используется для передачи сообщения непосредственно в Windows. В некоторых случаях программисту может потребоваться проглотить сообщение, никуда не передавая его дальше. Для этого достаточно выйти из оконной процедуры, не передавая сообщение в DefWindowProc. Следующие ответы применимы к 16-битовой Windows: 8. Беззнаковое короткое целое. 9. Длинное целое со знаком. 10. char _far* (Указатель на ASCIIZ-строку.) День 4 1. HANDLE_MSG позволяет пользователю избежать создания операторов case: case WM_CREATE: return HANDLE_WM_CREATE (hwnd, wParam, IParam, MyClsOnCreate); и заменить его легким для чтения кодом: HANDLE_MSG (hwnd, WM_CREATE, MyClsOnCreate); 2. Второй макрос называется FORWARD_WM_XXX и может быть использован для передачи сообщения обратно в оконную процедуру, действующую по умолчанию. 3. TextOut и DrawText. 4. GetDC. Когда закончите работу с контекстом, не забудьте вызвать ReleaseDC. Не допускается вызов GetDC в ответ на сообщения WMPAINT. 5. Большая часть информации хранится в параметрах WPARAM и LPARAM, хотя собственно сообщение находится во втором параметре, имеющем тип UINT. 6. Принтер.
7. Они либо игнорируются, либо передаются в оконную процедуру, действующую по умолчанию. 8. Загляните в WINDOWS.H. Например: «define WMCREATE 0x0001 9. Windows-программы обычно начинаются, по крайней мере, с двух файлов, один из которых имеет расширение СРР или С, а другой — DEF. Многие проекты также имеют МАКЕ-файл и файл ресурсов. Хороший способ начала нового проекта состоит в копировании общего для всех проектов набора файлов в новый подкаталог. 10. Традиционные DOS-программы работают в текстовом режиме, по одному зада- нию за раз и без поддержки мыши. Windows имеет встроенную поддержку мыши, работает в графическом режиме и может быть многозадачной. Другое важное отличие состоит в том, что Windows-программы по умолчанию являются ориентированными на события. День 5 1. WMJLBUTTONDBLCLK и WMJLBUTTONDOWN. 2. Константы VK указывают виртуальные клавиши, такие, как VK DOWN или VK UP. Полный список можно найти в WINDOWS.H. 3. CS_DBLCLK — это стиль класса. Используйте его с окнами, которые должны реагировать на двойные щелчки мышью. 4. Черный. 5. Следующий код проверяет, установлен ли флажок MK.CONTROL: if ((keyFlags S MKCONTROL) == MK_CONTROL) DoSomething 6. Системная клавиша также называется ALT. 7. , Используйте макрос FORWARD WM xxx. 8. На системную пиктограмму в левом верхнем углу окна. 9. KeyMouse_OnKey, поскольку почти все сообщения о нажатии клавиш передаются туда. Некоторые из этих сообщений затем транслируются и передаются в функцию Cls_OnChar. 10. Неудачные вызовы ReleaseDC имеют результатом медленное истощение систем- ных ресурсов. В конечном итоге происходит полное зависание системы. День 6 1. Для продуктов фирмы Microsoft введите гс -г emerson.rc для продуктов фирмы Borland brc -г emerson.rc 2. Для продуктов Micrisoft rc enter son. res Для Borland brc emerson.res 3. CM_ABOUT — это идентификатор пункта меню. Когда пользователь выбирает из меню данный пункт, числовое значение, ассоциированное с CM ABOUT, посылается с помощью сообщения WM COMMAND в оконную процедуру программы. 4. Всплывающее меню имеет маленькое ассоциированное с ним окно, которое выпадает, когда пользователь выбирает соответствующий элемент меню. Пункт (или элемент) меню — это просто одно из слов, присутствующих во всплывающем меню или на полоске меню вверху окна. 5. HINSTANCE. HINSTANCE — это уникальный дескриптор, идентифицирующий приложение.
6. WPARAM. Он транслируется в параметр id, который передается в функцию Cls_OnCommand. 7. FindResource ищет в файле конкретный ресурс вроде пиктограммы или пользова- тельского текста, в то время как LoadResource реально перемещает ресурсный объект в память. 8. GlobalUnlock уменьшает внутренний счетчик, ассоциированный с куском памяти. Если счетчик достигает нуля, данная область может быть передвинута или сброшена на диск при условии, что она объявлена как MOVEABLE или DISCARDABLE. FreeResource делает больше: она реально разгружает память, ассоциированную с ресурсом. 9. Новый исполняемый формат — это формат, использующийся ЕХЕ- и DLL-фай- лами под Windows и OS2. Он отличается от формата, исполняемых модулей в DOS. 10. Да. День 7 1. DialogBox. 2. Никакие. Диалог About — это модальный диалог, и поэтому почти все сообщения, ассоциированные с программой, посылаются в него, когда он находится на экране. Есть несколько маленьких исключений, однако основное правило состоит в том, что модаль- ный диалог перекрывает приложение, пока находится на экране, исполняя роль главного окна вплоть до своего закрытия. 3. WM_COMMAND. 4. FreeProcInstance используется для удаления функции, которая была связана с сегментом данных вызовом MakeProcInstance. 5. Вызывайте функцию DeleteObject для высвобождения памяти, ассоциированной с растровым изображением. Еще лучше, если у вас есть WINDOWSX, воспользоваться макросом DeleteBitmap, предусматривающим проверку типа. 6. Воспользуйтесь LoadString для выборки текста из ресурса символьных строк. 7. Сообщения WM VSCROLL посылаются при щелчке мышью на линейке прокрут- ки. Они несут информацию о направлении и способе прокрутки, а также о текущем положении ползунка. 8. Структура TEXTMETRIC содержит детализированную информацию о шрифте. Она описана в WINDOWS.H и в интерактивных файлах помощи по компиляторам фирм Borland и Microsoft. 9. Кнопка ОК в диалоге генерирует сообщение IDOK, посылаемое в диалоговую процедуру, ассоциированную с данной диалоговой панелью. 10. MakeProcInstance связывает функцию с прологом, который дает функции доступ к сегменту данных программы (mov ах, ds), тем самым гарантируя доступ к переменным и данным. День 8 1. Сначала регистрируется класс (если необходимо), а затем вызывается CreateWindow. 2. Первый раз она вызывается для основного окна приложения, а второй раз — для дочернего окна. 3. GameWndProc. 4. Поскольку это необязательно для дочерних окон. PostQuitMessage сообщает Windows, что приложение намеревается закрыться, а пользователи чаще всего не хотят закрывать все приложение из-за какого-то дочернего окна. 5. SetTimer — это функция API, которую следует использовать, когда вам нужно создать таймер. Не забудьте проверить результат, поскольку таймер не всегда доступен. 6. KillTimer располагается в обработчике сообщения WM_DESTROY для дочернего окна, a Windows всегда вызывает этот обработчик сообщения автоматически, прежде чем приложение закроется. 7. SRCINVERT.
8. Вызовите GetSysteniMetrics, и вы узнаете много интересного об аппаратных и претраммных компонентах вашей системы. 9. Возможны следующий вариант ответа: Ширину рамки окна Высоту рамки окна Ширину курсора Высоту курсора Ширину пиктограммы Высоту пиктограммы Ширину экрана Высоту экрана Имеется ли мышь Является ли текущая версия Windows отладочной 10. Я вставил в претрамму функцию Game OnChar для возможности организации паузы в игре. Для того чтобы продолжить игру, потребуется вызвать SetTimer. День 9 1. CreateFont и CreateFontlndirecrt. 2. GetStockObject или, если вы используете WINDOWSX, GetStockFont. 3. Шрифты TrueType были разработаны фирмой Microsoft для Windows 3.1. Основное их достоинство — то, что они высокого качества, легко переносимы и могут использо- ваться всеми владельцами Windows. 4. Встроенный шрифт ничем не отличается от любого другого шрифта системы, за исключением того, что он предопределен. Иначе говоря, встроенным, к примеру, является обычный “курьер”, который можно создать с помощью CreateFontlndirect, однако самая сложная часть работы уже сделана за вас, так что остается лишь обратиться к GetStockObject или GetStockFont. 5. GetTextFace получает имя текущего выбранного шрифта. 6. Чтобы найти размер текущего шрифта, вызовите GetTextMetrics для выборки структуры TEXTMETRIC, где содержится вся необходимая вам информация. 7. Ответ зависит от системы. 8. Ответ зависит от системы. 9. Копируйте шрифт в контекст устройства, обращаясь к SelectObject или, если вы пользуетесь WINDOWSX, через SelectFont. 10. Тип шрифта. Например, TrueType, Vector или Fixed_Pitch. День 10 1. Чтобы создать элемент управления, вызовите CreateWindow. 2. Потому что он уже зарегистрирован в Windows. 3. Дескриптор HWND владельца элемента управления находится в восьмом парамет- ре функции CreateWindow, называемом hwndParent. 4. Идентификатора. Для получения HWND элемента управления через его иденти- фикатор вызовите GetDlgltem. 5. В приведенном к соответствующему типу параметре hmenu функции CreateWindow. 6. Различные стили элемента управления объединяются посредством логического ИЛИ. 7. SetWindowText и GetWindowText. А также макросы из WINDOWSX: Edit_GetText, Edit_SetText, Static_GetText и Static_SetText. 8. Перечни и отмечаемые блоки можно использовать для управления ходом програм- мы. (Подобно регулированию громкости в стерео.) 9. Сообщение EM SETSEL ассоциируется с редактируемым полем. Об этом можно догадаться по первым буквам — ЕМ. Оно позволяет выделять произвольный фрагмент текста.
10. Вызовите SendMessage с сообщением BM_GETCHECK или макрос из WIN- DOWSX, называемый Button_GetCheck. День 11 1. Вызовите функцию SetFocus и передайте ей дескриптор элемента управления. 2. SendMessage пошлет сообщение непосредственно в соответствующую оконную процедуру, a PostMessage поместит сообщение в очередь. Поэтому PostMessage медлен- нее. 3. ButtonMessage. 4. Лучше всего посмотреть эту информацию в интерактивном файле помощи или в справочном руководстве. Самое главное — найти простой путь получения этой инфор- мации. 5. Обработчик перечисляемых объектов (callback) — это функция, вызываемая непосредственно Windows, а не какой-либо из подпрограмм вашего приложения. Обыч- но вы передаете Windows адрес этого обработчика и используете функцию MakeProcIn- stance, чтобы предоставить ему доступ к данным своей протраммы. Ну а если вы настолько освоили этот процесс, что он для вас — просто семечки, то можете время от времени обманывать систему, используя “интеллектуальный” обработчик вместо MakeProcInstance. 6. MakeProcInstance присоединяет некоторый прологовый код, дающий функции доступ к переменным и другим данным вашей программы. 7. FreeProcInstance. 8. Знак фунта (#) определяет идентификатор и использует константу WM_USER в качестве начального смещения: #define MyMessage (WM_USER + 0) 9. WM_USER. 10. Ничего. Сообщение BM_GETCHECK — это сообщение для кнопок, и основное окно его просто проигнорирует. День 12 1. Функцию ExitWindows, первый параметр которой может содержать либо EW RE- BOOTSYSTEM, либо EW_REBOOTWINDOWS. 2. IsDialogMessage вызывает перемещение по элементам управления внутри окна. Эта функция автоматически обрабатывает особые комбинации клавиш, такие, как Tab или Shift-Tab. 3. И труппирующие рамки, и кнопки-селекторы представляют собой подмножество класса “button”. 4. Соответствующие макросы перечислены в WINDOWSX. Н. Кроме того, их можно отыскать в файле WINDOWSX.TXT, сопровождающем компилятор фирмы Microsoft или WIN31.DOC, сопровождающем компилятор Borland. 5. Сообщение BMJSETCHECK посылается всякий раз, когда вы вызываете макрос ButtonJSetCheck из WINDOWSX. 6. Присвойте ей стиль BS_AUTORADIOBUTTON. 7. Группирующие рамки имеют чисто визуальное назначение. Они наглядно подчер- кивают функциональную общность конкретных элементов управления, а также влияют на способ переключения между элементами управления. 8. Присвойте первому элементу группы стиль WS_GROUP. Конец одной 1руппы определяется началом следующей группы. 9. Стиль WS_TABSTOP указывает, что пользователь может переключиться клавишей Tab на конкретный элемент управления, но отнюдь не означает, что он сможет автоматически делать это всегда, если, например, данный элемент управления — следующий в перечне дочерних окон. Стиль WS_GROUP отмечает начало группы элементов управления. Иногда группа элементов управления, таких как набор кнопок- селекторов, обрабатывает нажатие табуляции особым образом, даже если каждому
элементу группы приписан стиль WS_TABSTOP. Например, если вы переключаетесь с помощью клавиши Tab на группу кнопок-селекторов, то только текущая выбранная кнопка окажется в фокусе, даже если все кнопки группы имеют стиль WS_TABSTOP. Это очень удобно для пользователя, но немного путает программиста, который пытается понять, как же на самом деле работают стили WS_GROUP и WS_TABSTOP. 10. Проверьте, меньше ли возвращаемое значение WinExec, чем 32. Если да, то вам следует отобразить окно сообщений, показывающее одну из предопределенных ошибок, приведенных ниже: О Выход за пределы памяти, запорчен исполняемый модуль. 2 Файл не найден. 3 Путь не найден. 5 Попытка динамической компоновки задачи или ошибка разделения. 6 Библиотека затребовала отдельные сегменты данных для каждой задачи. 8 Не хватает памяти, чтобы стартовать приложение. 10 Неправильная версия Windows. 11 Ошибочный исполняемый файл. 12 Приложение разработано для другой операционной системы. 13 Приложение разработано для MS-DOS 4.0. 14 Неизвестен тип исполняемого файла. 15 Нельзя загрузить приложение реального-режима из старых версий Windows. 16 Попытка загрузить второй экземпляр исполняемого модуля, содержащего множество сегментов данных, не помеченных как “только для чтения”. 19 Попытка загрузить сжатый исполняемый файл. 20 Библиотека DLL, требуемая для выполнения этого файла, ошибочна. 21 Это приложение требует 32-битных расширений. День 13 1. BS_PUSHBUTTON и BS_RADIOBUTTON. 2. ListBox_Dir&. 3. Ниже приводится относительно полный список: ListBox_Enable(hwnd, fEnable) ListBox_GetCount(hwnd) ListBox_ResetContent(hwnd) ListBox_AddString(hwnd, Ipsz) ListBox_InsertString(hwnd, Ipsz, index) ListBox_Add!temData(hwnd, data) ListBox_InsertItemPata(hwnd, Ipsz, index) ListBox_DeleteString(hwnd, index) ListBox_GetTextLen(hwnd, index) ListBox_GetText(hwnd, index, IpszBuffer) ListBox_GetItemData(hwnd, index) ListBox_SetItemData(hwnd, index, data) ListBox_FindString(hwnd, indexStart, IpszFind) ListBoX-FindltemData(hwnd, indexStart, data) ListBox_SetSel(hwnd, fSelect, index) ListBox_SetItemRange(hwnd, fSelect, first, last) ListBox_GetCurSel(hwnd) ListBoxSetCurSel(hwnd, index) ListBox_SelectString(hwnd, indexStart, IpszFind) ListBox_SelectItemData(hwnd, indexStart, data) ListBox_GetSel(hwnd, index) ListBox_GetSelCount(hwnd) ListBox GetTopIndex(hwnd)
ListBox_GetSelItems(hwnd, cltems, Iplndices) ListBox_SetTopIndex(hwnd, indexTop) LxstBox_SetColumnWidth(hwnd, cxColumn) ListBoX—GetHorizontalExtent(hwnd) ListBox_SetHorizontalExtent(hwnd, cxExtent) LxstBox_SetTabStops(hwnd, clabs, IpTabs) ListBox_GetItemRect(hwnd, index, iprc) ListBox_SetCaret!ndex(hwnd, index) ListBox_GetCaretIndex(hwnd) ListBox_SetAnchorIndex(hwnd, index) LxstBox_GetAnchorIndex(hwnd) ListBox_Dir(hwnd, attrs, IpszFileSpec) ListBox_AddFile(hwnd, IpszFileName) ListBox_SetItemHight(hwnd, index, cy) ListBox_GetItemHight(hwnd, index) Последние два макроса работают только в Windows 3.1. 4. Вам потребуется привести тип аргумента LPARAM, чтобы воспользоваться струк- турой MINMAXINFO, если вы не работаете с WINDOWSX. 5. Сообщение WM_GETMINMAXINFO гарантирует, что пользователь не сможет изменить форму окна, за исключением случаев, предусмотренных программистом. CreateWindow запускает окно с определенным размером, но не мешает пользователю изменять его. 6. Используйте SetWindowLong (в комбинации с MakeProcInstance), когда потребу- ется создать подкласс элемента управления. 7. Это макрос EditJSetSel. Он относится к сообщению EMJSETSEL. 8. Воспользуйтесь функцией TrackPopupMenu. 9. Используйте функцию GetProfileString для выборки информации из файла WIN.INI и функцию GetPrivateProfileString для выборки информации из любого другого INI-файла. 10. InvalidateRect генерирует сообщения WM_PAINT. Второй параметр — это размер прямоугольника, который вы желаете обновить. Если вы положите его равным NULL, то обновится все окно. Сравните с UpdateWindow. День 14 1. Существенное отличие состоит в том, что дочернее окно всегда остается в границах рабочей области его родителя, в то время как всплывающее окно может свободно двигаться по экрану. 2. GetClientRect получает размеры окна с координатами левого верхнего угла, равными 0,0. GetWindowRect возвращает размеры окна с координатами левого верхнего угла относительно всего экрана. 3. Стиль WS OVERLAPPEDWINDOW используется для определения стандартного окна с рамкой, линейкой прокрутки, системным меню и кнопками минимизации/мак- симизации. Фактически он состоит из следующих стилей, объединенных логическим ИЛИ: VS_OVERLAPPEDWINDOW = WS OVERLAPPED I WS_CAPTION I WS SYSMENU I WS THICKFRAME I WSMINIMIZEBOXX | MAXIMIZEBOX; 4. Либо MoveWindow, либо SetWindowPos. 5. Используйте GetSysteniMetrics для выборки информации о толщине рамки окна. Передайте в эту функцию константы SM_CXFRAME и SM_CYFRAME. 6. Вызовите EnableWindow, передав HWND окна, которое вы хотите сделать полнос- тью инертным, в первом параметре. Второму параметру присваивается значение FALSE, чтобы заблокировать окно, и TRUE — для обратного действия. 7. Уравновешивайте каждое обращение к CreateSolidBrush вызовом DeleteObject. 8. GetClassWord получает информацию о целом классе окон, a GetWindowWord — о конкретном экземпляре окна. 9. Когда вы вызываете GetClassWord, этот идентификатор может быть использован для нахождения дескриптора кисти фона.
10. В большинстве случаев это дело программиста. Используйте дополнительные зарезервированные байты, которые вы ассоциируете с окном, для хранения информации, относящейся к этому окну. День 15 1. Режимы отображения определяют связь между единицами измерения устройства и логическими единицами, а также ориентацию осей х и у. 2. Пиксел — это наименьшая световая точка, которой программист может манипу- лировать на экране. Существует взаимно однозначное соответствие между пикселами и единицами устройства. 3. Меньше. Логическая единица в MM_LOMETRIC равна 0,1 миллиметра, что значительно меньше пиксела почти всех VGA-систем. Чтобы увидеть это соответствие, откройте диалоговую панель Size в протрамме WinSize и сравните координаты окна в режиме ММ_ТЕХТ с координатами в режиме MM_LOMETRIC. 4. Начало зоны видимости — это исходная точка (0,0) системы координат устройства в отличие от логической координатной системы. 5. Координаты устройства основаны на физических пикселах, видимых на экране, или физических точках, печатающихся на принтере. Логические координаты игнорируют эти зависящие от устройства факторы и соответствуют координатам GDI в логических единицах вроде дюймов или миллиметров. 6. SetViewportOrg устанавливает начало координатной системы устройства, a SetWin- dowOrg устанавливает исходную точку логической системы координат. 7. Немодальные диалоги дают пользователю доступ к остальной части протраммы, к которой они относятся. Напротив, пока модальный диалог находится на экране, он является единственным объектом взаимодействия с пользователем. 8. Вы можете создать немодальный диалог посредством вызова CreateDialog. 9. Вы можете создать модальный диалог с помощью DialogBox. 10. (Ответы могут варьироваться.) Диалоговые процедуры принимают сообщения WM_INITDIALOG, а не WM_CREATE. Вы должны передавать сообщения, предназна- ченные для обработки по умолчанию, в DefDlgProc, а не в DefWndProc. Вам также интересно будет узнать, что диалоги имеют стандартную оконную процедуру (выглядя- щую точно так же, как и другие оконные процедуры), которая фактически вызывает вашу диалоговую процедуру. Когда вы возвращаете из диалоговой процедуры TRUE или FALSE, то результат обрабатывается оконной процедурой диалоговой панели. День 16 1. Вы можете использовать SendDlgltemMessage для описания связи между диалогом и его элементами управления. С другой стороны SendMessage можно использовать всякий раз, когда вам потребуется послать сообщение из одной точки программы в другую или на рабочем столе. 2. Используйте GetDlgltem для восстановления дескриптора элемента управления, если все, что вы о нем знаете, — его идентификатор. 3. Используйте DPtoLP для превращения координат устройства в логические коор- динаты. 4. Используйте GetParent для нахождения HWND родителя окна. 5. Да, модальный диалог может свободно сообщаться со своим родителем с помощью функции SendMessage. Сообщения в других направлениях более затруднены, хотя и не невозможны. Например, вы можете воспользоваться таймером для отправления сооб- щений в указанных интервалах между родителем и модальным диалогом. 6. Установите точки прерывания на части диалоговой процедуры, которую вы хотите проверить. 7. Программа Mapper создает подкласс статического поля, чтобы показать находя- щееся в его границах растровое изображение.
8. Существует несколько ответов, но одно из возможных объяснений состоит в том, что это позволяет вам справиться с необычной координатной системой в диалогах. То есть вы можете разработать диалог и поместить туда статический элемент управления, используя Resource Workshop или Арр Studio, а затем просто нарисовать растровое изображение в начале координат статического элемента управления. Это убережет вас от выполнения вычислений на этапе работы программы. 9. StretchBlt при необходимости сожмет или растянет растровое изображение, копи- руя его из исходного места в конечное. BitBlt просто копирует растровое изображение из одного контекста устройства в другой. 10. Программа вызывает StretchBlt для того, чтобы растянуть исходные растровые изображения. Это означает, что они должны быть скопированы из одной формы в другую. Обращение к CreateCompatibeBitmap создает новые растровые изображения, в которые будут копироваться старые. День 17 1. Горячие клавиши, определенные в меню, отделяются от остального текста меню символами табуляции. В частности, они используют синтаксическую единицу ’\Г: SRound Cursor\tAlt+Fl 2. Чтобы поместить знак подчеркивания под буквой в меню, воспользуйтесь симво- лом &. Конечный результат состоит в том, что пользователь сможет выбрать этот пункт, нажав Alt и указанную клавишу. Если вы находитесь внутри всплывающего меню, то сможете выбрать соответствующий пункт, нажав только букву. 3. Всякий раз, когда используете ускорители, добавляйте к вашему циклу опроса сообщения обращение к TranslateAccelerators. 4. Проверьте, установлен ли в поле ItemState структуры DRAWITEMSTRUCT флажок ODS_SELECTED. 5. Ответы могут варьироваться, но вот полный список соответствующих констант из WINDOWS.H. Sdefine Sdefine Sdefine Sdefine #define Sdefine Sdefine Sdefine Sdefine Sdefine Sdefine Sdefine Sdefine Sdefine Sdefine Sdefine Sdefine Sdefine Sdefine Sdefine MF_BYCOMMAND MF_BYPOSITION MF_SEPARATOR MF_ENABLED MF_GRAYED MF_DISABLED MF_UNCHECKED MF_CHECKED MF_USECHECKBITMAPS MFJSTRING MF_BITMAP MF_OWNERDRAW MF_POPUP MF_MENUBARBREAK MF_BREAK MF_UNHILITE MF_HILITE MFJSYSHENU MF_HELP MF_MOUSESELECT 0x0000 0x0400 0x0800 0x0000 0x0001 0x0002 0x0000 0x0008 0x0200 0x0000 0x0004 0x0100 0x0010 0x0020 0x0040 0x0000 0x0080 0x2000 0x4000 0x8000 6. Флажок MF_BYPOSITION идентифицирует запрашиваемый пункт меню по его позиции относительно остальных пунктов. Например, это может быть пятый пункт меню или шестой. MF_BYCOMMAND идентифицирует пункт меню по его идентификатору. 7. Отсчет ведется с нуля. 8. Стиль SS_ICON можно использовать для указания того, что данное статическое поле имеет ассоциированную с ним пиктограмму. 9. Обращение к SetCapture должно сочетаться с вызовом ReleaseCapture. 10. Для получения размеров растрового изображения на этапе выполнения исполь- зуйте GetObject.
День 18 1. Параметр HDC содержится в любой GDI-функции. 2. chord, ellipse, polygon, rectangle, pie и roundrect — это GDI-функции, рисующие геометрические формы. 3. Для изменения цвета заливки эллипса выберите новую кисть в текущий контекст устройства. 4. Для изменения цвета прямоугольного контура выберите новое перо в текущий контекст устройства. 5. Размещаемый, или Aldus-, метафайл имеет 22-байтовый заголовок. 6. Для того чтобы показать метафайл, используйте PlayMetaFile или воспользуйтесь EnumMetaFile и обработчиком перечисляемых записей (EnumMetaFileProc), содержаще- го функцию PlayMetaFileRecord. 7. CreateMetaFile возвращает контекст устройства. Вы можете копировать перья, кисти и другие элементы GDI в контекст устройства. 8. Если вы передаете контекст устройства, полученный из CreateMetaFile, в Close- MetaFile, эта функция возвратит объект типа HMETAFILE, который может быть выведен на экран простой передачей его в PlayMetaFile. 9. Второе поле структуры METARECORD — это номер функции. Каждая GDI-функ- ция имеет ассоциированный с ней номер. Например, функции Polygon соответствует число 0x0324. 10. Первое поле структуры OPENFTLENAME называется IStructSize. Это поле должно содержать размер структуры OPEN FILENAME при передаче ее в функцию GetOpenFileName: OpenFileName.IStructSize = sizeof(OPENFILENAME); День 19 1. При создании рабочих окон MDI присваивайте параметру szClass значение MDICLIENT. 2. Используйте EnumChildWnds и EnumChildWindows для полного перебора всех окон на рабочем, столе. 3. Функция WM MDIGETACnVE находит активное окно. 4. Пользовательское окно посылает сообщение WMMD1ACTIVATE каждому дочер- нему окну, собирающемуся получить или потерять фокус. 5. Поле LPARAM, соответствующее сообщению WM_MDISETMENU, содержит новое меню или всплывающее меню. 6. Самое простое — это сделать окно с часами очень широким или очень узким. При этом изображение часов не изменит своих пропорций. 7. Прежде чем создать дочернее окно MDI, вы должны заполнить MDICREATEC- TRUCT. 8. Сообщение WM_QUERYENDSESSION высылается, когда сконструированная должным образом оболочка Windows готова закрыться. 9. Вызовите функцию GetWindow и передайте ей HWND вашего окна и константу GW_OWNER. Если она вернет TRUE, вы имеете дело с заголовком пиктограммы: if (GetWindow(hwnd, GW_OWNER)) // Заголовок пиктограммы? return TRUE; 10. Используйте поле cbWndExtra для хранения специфической для каждого окна информации. День 20 1. МО означает Media Control Interface. 2. WAVE-файлы могут хранить 1 секунду звука в ПК или 1 минуту в 1М. В MIDI-файлах на 1 минуту звука затрачивается примерно 5К.
3. Когда вы впервые открываете устройство мультимедиа, то должны передавать в этом параметре нуль. Открыв устройство мультимедиа, вы должны сохранить иденти- фикатор устройства, чтобы его можно было использовать в последующих вызовах. 4. Функция mciSendCommand возвращает 0 в случае успеха. В противном случае она возвращает код ошибки. Его можно передать в mciGetErrorString, если нужно вывести на экран поясняющий ошибку текст. 5. Если вы передадите HWND вместе с флажком MCI_NOTIFY, то указанному окну будут переданы сообщения MM_MCINOTIFY. Параметр WPARAM, ассоциированный с сообщением MM_MCINOTIFY, содержит информацию о состоянии текущего устрой- ства мультимедиа. Например, WPARAM может быть равен MCI NOTIFY ABORTED или MCI_NOTIFY_SUCCESSFUL. 6. Все функции, экспортируемые из DLL, используют ключевые слова _export или CALLBACK. Слово _export гарантирует правильный экспорт данной функции из DLL, т.е. размещение ее в таблице экспортируемых функций, а также создает прологовый код, устанавливающий сегмент данных должным образом, после того как функция будет скомпонована. CALLBACK — это сокращенное объявление функции как FAR PASCAL. 7. Чтобы информировать вашу программу о подпрограммах, находящихся в DLL, воспользуйтесь IMPLIB для создания LIB-файла, который может быть скомпонован с вашей программой. 8. Объявления для стандартных подпрограмм из Windows API помещаются в WIN- DOWS.H. 9. Когда создаете диалог, который должен работать в качестве основного окна приложения, вы должны присвоить ему уникальное имя класса, чтобы Windows могла правильно направлять сообщения. 10. Внутри DLL функция LibMain играет роль, подобную той, которую функция WinMain играет в стандартных исполняемых модулях Windows. День 21 1. Элементы интерфейса Windows описаны в SAA CUA Advanced Interface Design Guide, изданной IBM. 2. CUA означает Common User Unterface. 3. В случае успеха функция malloc возвращает указатель типа void; в противном случае — NULL. 4. Обращения к GlobalAlloc обычно сопровождаются вызовами GlobalLock, Glo- balUnlock и GlobalFree. 5. Данные, стек и локальная динамическая область памяти программы обычно хранятся в DGROUOP. 6. GlobalAlloc в защищенном режиме 16-битовой системы может быть вызвана 8192 раза. 7. Модуль распределения памяти, предусмотренный в компиляторе, использует GlobalAlloc для захвата кусков памяти у операционной среды. Затем он постепенно отдает эту память программе, удовлетворяя запросы по вызовам malloc и new. Подобная система помогает программам преодолеть предельное количество объектов, размещаемых в глобальной динамической области (8192). 8. Для того чтобы сделать окно невидимым, передайте в ShowWindow идентификатор SW_HIDE. 9. Используйте LZCopy для копирования файла из одного каталога в другой. 10. Используйте MoveWindows или SetWindowPos для перемещения окна с места на место.
Чарльз Калверт ПРОГАММИРОВАНИЕ В WINDOWS. ОСВОЙ САМОСТОЯТЕЛЬНО ЗА 21 ДЕНЬ Подписано в печать 28.07.95. Формат 70x108 Ц6 Печ. л. 31. Бумага газетная. Печать офсетная. Тираж 15000 экз. Заказ 987 Издательство «БИНОМ», 1995 г. Москва, ул. Новослободская, д. 50/1, стр. 1а. Лицензия на издательскую деятельность № 063367 от 20 мая 1994 г. Отпечатано с готовых диапозитивов в полиграфической фирме «Красный пролетарий» 103473, Москва, Краснопролетарская, 16