CA-Visual Objects: Cool New Menus

 

 

 

 

 

Меню в окне – это веянье моды. Каждая новая версия Microsoft Office и Internet Explorer – это новшества, которые так и просятся к использованию в Ваших приложениях. Как программисты, мы все хотели бы поскорее предоставить их для наших клиентов, при этом сохранив своё время, а собственные усилия – сведя к минимуму. К сожалению, так легко бывает не всегда. Но, это введение в программирование новейших форм меню – упростит Вашу задачу.

 

 

 

 

 

 

      Рис. 1: Меню.

 

 

Этот рисунок меню, изображённый выше, показывает нам новые возможности. И в этой статье мы ответим на следующие вопросы:

 

 

 

Как же сделать пункт меню, обладающим одной из этих новых особенностей? Как всегда, Вы найдете эту информацию на Вашем установочном CD-ROM-е, в разделе Platform SDK Microsoft Developers Network (MSDN). В ходе рассмотрения этого документа вы найдете ссылки на структуру, известную как MENUITEMINFO. В CA-Visual Objects библиотека «Win32 API Library» содержит копию этой структуры внутри модуля «WinUser». Выглядит это примерно так:

 

 

Если в этой структуре присвоить члену fMask параметр «MIIM_TYPE», то это будет означать, что мы хотим  получить или задать значение для члена fType, а «MIIM_DATA» – для dwTypeData. Для отображения Bitmap (значка), мы будем использовать fType, чтобы сообщить Windows, что вместо строки нам нужно отобразить Bitmap, и указатель на него – мы присвоим члену dwTypeDate.

 

 

Перед тем, как идти дальше, ответьте себе на вопрос: «Почему структура MENUITEMINFO в нижеследующем методе: AddBitmapMenu() определена не как «AS», а как «IS»? (Подсказка, для тех, кто забыл – прочтите ещё раз мою статью в SDT от 2/98 и 3/98).

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 Рис. 2: Значок в пункте меню.

 

На рисунке 2 Вы можете увидеть, что в меню нам удалось вывести значок, но нужно сделать еще некоторые улучшения:

 

 

Примечание: Если вы используете точечные рисунки (bitmap), высота которых превышает значение, возвращённое GetSystemMetrics( SM_YMENU ), то вы можете столкнуться с ошибкой при минимизации или максимизации окна. Чтобы этого избежать, вы должны правильно обработать сообщение WM_MEASUREITEM.

 

Как показано на рисунке 3, для bitmap-элементов меню также используется система корректировки и по ширине. Мы увидим, на примере OwnerDraw-меню, как решить этот вопрос во второй части этой статьи в следующем SDT (от 2/99).

 

 

 

 

 

 

 

 

     Рис. 3: Bitmap-меню с несколькими колонками.

 

 

Возможно, эти примеры не самые удачные, поскольку новые пункты меню содержат лишь один Bitmap и совсем без текста. Но, те из Вас, кто был внимательным, наверняка обратил внимание, что мы определяли только вывод Bitmap, а не текста, и поэтому – результат на самом деле ожидаем. Если вы хотите узнать, как в пунктах меню размещать значки (bitmap) и текстовые элементы рядом друг с другом, читайте часть 2 этой статьи (SDT 2/99).

 

Так же, многие из Вас заметили, что мы использовали API-функцию InsertMenuItem(), вместо стандартного метода InsertItem() для класса меню. Это связано с тем, что InsertItem() не использует нужную нам структуру MENUITEMINFO.

 

 

 

Bitmap для MenuItem может быть получен двумя способами:

 

 

 

 

 

 

А кусочек кода, который я приведу ниже, покажет простой пример, в котором нарисуются разные линии, по аналогии с меню на рисунке 4, взятым из Word 97.

 

 

 

 

 

 

 

 

       Рис. 4: Bitmap-меню типов линий (из Word 97)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Полный исходный код этого примера есть на диске. В дальнейшем, это растровое меню можно сделать, например, в виде разных стрелок или диаграмм.

 

 

Перед тем, как использовать новые MenuItems, мы должны спросить себя: «Где и как я могу определить, что пользователь выбрал именно этот MenuItem?». Как и для всех остальных пунктов меню, обработчик события MenuCommand отвечает за обработку событий. Он получает oEvent-объект, который содержит ItemID, присвоенный в MENUITEMINFO-структуре и wID:

 

 

 

 

 

 

Я думаю, что теперь у Вас появилось много весёлой работы с растровым меню. А в следующей статье – мы покажем вам, как реализовать OwnerDraw-меню. К этому времени мы будем полностью «Office97-совместимыми», так как затронем сами основы меню.

 

 

 

 

 

 

 

 

 

В части 1 (см. SDT 1/99), я показал, как создаются пункты меню, содержащие не текст, а bitmap-ы. В этом выпуске я хочу показать, как можно одновременно отображать и текст и растровые изображения в меню. Это одна из новаций, которая сделала Office97 таким узнаваемым.

 

 

Естественно, если мы хотим отойти от стандарта – Microsoft позволяет нам это сделать. Подробности можно найти в библиотеке MSDN по ключевому слову MFT_OWNERDRAW. Для того чтобы присвоить этот атрибут пункту меню (MenuItem), мы создадим свой подкласс (subclass) MenuItem, который и будем использовать в окне, меню которого уже создали.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Когда мы пытаемся «рисовать» вручную, мы «вступаем в игру» с некоторым опозданием, и поэтому для работы нам крайне важным становится сохранение информации в созданной нами (user-defined) структуре pMyItem. Это делается с помощью члена dwItemData (см. выше). Для вышеуказанного метода Init, важно, чтобы он вызывался в конце фазы инициализации окна. Поэтому мы перехватим следующее сообщение в Dispatch() окна, владеющее нашим меню:

 

 

 

 

 

 

 

 

 

И в методе ChangeCoolMenu(), мы заменим позиции меню на наши собственные CoolMenuItems:

 

 

 

 

 

Наш новый класс CoolMenu (наследник стандартного класса «Menu») настраивает желаемый вид MenuItems:

 

 

 

 

 

 

 

 

 

 

Для всех пунктов меню, для которых мы установили MFT_OWNERDRAW-ы, мы должны среагировать на сообщения WM_MEASUREITEM и WM_DRAWITEM. Сброс-установку OwnerDraw-атрибута можно сделать при обработке сообщения WM_INITMENUPOPUP.

 

 

 

Стандартный редактор меню соединяет значки панели инструментов с MenuItems. Эти значки берутся из bitmap-ленты (bitmap ribbon), в качестве которой выступает или встроенная стандартная лента VO или наша самостоятельно нарисованная. Однако, для наших пунктов меню нам нужны значки в виде ImageList. Поэтому мы поступим просто: мы переделаем под себя существующую ленту ToolBar в ImageList:

 

 

Перед рисованием пунктов меню (MenuItems), мы должны задать их размеры. Окно-владелец получает сообщение WM_MEASUREITEM, которое обрабатывается в обработчике событий, где мы и заполняем структуру с информацией, необходимой для отрисовки MenuItems. DrawText() (с параметром DT_CALCRECT) – важнейшая функция, используемая при обработке события WM_MEASUREITEM. Она производит вычисление размера текста. Кроме того, нам нужно дополнить текст пробелами по краям (CXTEXTMARGIN), изображение значка по ширине (oButtonSize:Width), и сделать некоторый зазор между значком и текстом меню (CXGAP). В любом случае, нам нужно получить системные размеры с помощью GetSystemMetrics(). (SM_CYMENU – нам даст высоту меню. А SM_CXMENUCHECK – укажет ширину стандартного значка «галочка», который мы заменим на наш значок, и, следовательно, его ширину нужно вычесть из нашей общей ширины).

 

 

 

 

 

 

 

Рисунок 1, его я взял из статьи Paul DiLascia [2], наглядно показывает нужную информацию.

 

Эта информация хранится в структуре _winMEASUREITEMSTRUCT, которая определена в VO. Для того чтобы правильно заполнить эту структуру для рисуемого меню, при обработке сообщения WM_MEASUREITEM, мы должны проверить, равен ли член структуры CtlType значению ODT_MENU. Дело в том, что сепараторы (разделители в меню) требуют специальной обработки, так как они используют только половину высоты стандартного пункта меню.

 

 

 

 

После кропотливой подготовки, наконец-то можно преступить к рисованию пункта меню. Как только Windows получит размеры нашего пункта, что мы сделали при обработке WM_ MEASUREITEM, он пошлёт нашему окну сообщение WM_DRAWITEM: по очереди, по одному для каждого элемента. И с информацией из _winDRAWITEMSTRUT, можно сделать всё, что угодно. Отображение цвета и тип 3D-края (raised или pressed) определяются ItemState (ODS_GRAYED, ODS_SELECTED или ODS_CHECKED). Также, важно учесть, надо ли рисовать какие-то значки. Может, надо нарисовать «галочку»? Вообще, значок не имеет значения, он просто ставится на свою позицию, как представлено ​​на рис. 1.

 

 

Windows чрезвычайно жёстко относится к программистам, которые решили взять на себя труд написать OwnerDraw-программу. Не то, чтобы оно не работает. Но, нам придётся наново изобрести обработку подчеркнутых букв. Подчеркивания есть, но нам потребуется дополнительная обработка события, которое будет реагировать на WM_MENUCHAR. В этом примере, этот вопрос не решён. Но, он может быть раскрыт в следующем или в последующем выпуске SDT. Кстати, работа ускорителей (акселераторов, «горячих» клавиш) на самом деле не зависит от атрибута OwnerDraw, а это значит, что они работают в обычном режиме.

 

 

 

Напоминаю, мы определили наши собственные структуры для расширения стандартной структуры MENUITEMINFO. А это значит, что при закрытии окна, мы должны не забыть освободить эти указатели.

 

 

 

Часто в коммерческих приложениях забывают о системных настройках цветов и шрифтов. Пол DiLascia в своей статье [2] рекомендует использовать функции GetSysColor() и GetSystemMetrics() в том случае, если пользователь вдруг захочет выбрать свои цвета и шрифты. Кроме того, стоит добавить обработку сообщений WM_SYSCOLORCHANGE и WM_SETTINGCHANGE. Самые правильная реакция – это всё уничтожить и построить меню с нуля. В этой таблице перечислены только наиболее важные для меня параметры для GetSystemMetrics() и GetSysColor():

 

 

 

 

Множество дополнительных проблем, связанных с созданием OwnerDraw-меню приоткрыл Paul DiLascia [2], но всё это выходит за пределы этой ознакомительной статьи.

Если, по прочтению этой статьи кто-то начал считать, что Office97 и Office2000 работают с OwnerDraw-меню – это неверно. Для этой цели Microsoft создала нечто новое: CommandBars. Объектная модель для этих COM-объектов описана в VBAOff8.HLP. К сожалению, эти объекты могут быть использованы только в самом MS-Office и его приложениях.

Пройдя через все неприятности написания этого VO-примера, я лёгкостью понимаю, почему VO-программисты стараются держаться подальше от разработки собственного меню и ждут, когда Microsoft включить CommandBars в ComCtl32.dll. Естественно, никаких гарантий этому нет.

Тем не менее, я решился сделать с ещё один пример с CustomDraw и написал TreeListView для Cayman, который будет представлен ​​в следующем выпуске SDT, с версиями для VO и ClassMate.

 

 

An excellent article, well worth reading, concerning the troubles of ownerdraw programming. How much the emotions can be involved, is showed by the following short quotations:

 

 

Dieter Crispien Software Entwicklung Vertrieb (dcSE)
Frauenlobstr, 24
80337 München

Telefon: 089/5151 9608
Fax: 089/5434 9983
Email: vosales@visualobjects.de

Falls Sie uns noch nicht als Lieferant aufgeführt haben, benötigen Sie sicher unsere USt-ID.

Diese lautet: DE 221 513 168.

Inhaltlich verantwortlich gemäß § 6 MDStV: Dieter Crispien

 

 

 

 

 

 

 

 

       

 

 

 

 

 

P.S.: К большому сожалению, у меня нет оригинальных примеров к этой статье. Но, если кто-либо ими поделится, то я с удовольствием выложу их для всеобщего обозрения. И напишу ему хвалебную Оду.