Поcобие_БЕЛОВ_Графический_интерфейс_API

Поле wID содержит определяемый приложением идентификатор команды, связанный с элементом меню.

Пример. Пусть создается элемент меню, который отображается строкой «Создать» и связан с идентификатором CM_FILE_NEW.

Идентификатор создают обычным способом:

#define CM_FILE_NEW 3001

Тогда этот идентификатор в поле wID можно записать так: mii.wID=CM_FILE_NEW;

Поле hSubMenu содержит дескриптор временного меню, которое должно появиться при выборе этого элемента. Если меню не должно появиться, это поле содержит NULL.

Поле hbmpChecked содержит дескриптор изображения метки для отмеченного элемента. Если это поле содержит NULL, используется символ переключателя или галочка.

Поле hbmpUnchecked содержит дескриптор изображения метки для неотмеченного элемента. Если это поле содержит NULL, данное состояние ничем не отображается.

Поле dwItemData – определяемое приложением значение, связанное с элементом меню.

Поле dwTypeData – содержание отображения элемента. Если mii.fType=MFT_STRING, в поле dwTypeData записывают строку.

Поле cch равно длине строки dwTypeData или 0.

4.2. Создание меню

Алгоритм создания меню в общем случае содержит два шага:

1)создание пустого меню hMenu;

2)доставка элемента в меню hMenu;

Шаг 2 повторяем столько раз, сколько элементов содержит

152

меню hMenu.

Этот алгоритм позволяет создавать многоуровневое меню. Так, вставляемый на 2-м шаге элемент может указывать на созданное временное меню. Причем любой элемент последнего также может указывать на временное меню.

Меню сначала создают только в памяти. Существуют функции, которые указывают операционной системе, какое меню создано, какому окну оно принадлежит и когда его отображать. Рассмотрим эти функции.

Функция CreateMenu создает пустое главное меню окна:

HMENU CreateMenu(VOID);

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

Функция CreatePopupMenu создает пустое временное меню:

HMENU CreatePopupMenu(VOID);

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

Функция SetMenu подключает главное меню hMenu к окну hwnd:

BOOL SetMenu(HWND hwnd, HMENU hMenu);

Она удаляет предыдущее меню, но не разрушает его. Если же hMenu=NULL, то удаляется только главное меню. При успешном подключении функция возвращает ненулевое значение.

После изменений в меню, независимо от состояния окна hwnd, для перерисовки полосы меню необходимо вызвать функцию

DrawMenuBar:

void WINAPI DrawMenuBar(HWND hwnd);

Она перерисовывает полосу меню окна hwnd.

Таким образом, алгоритм подключения главного меню к окну и отображения полосы меню содержит следующие шаги:

1)создание главного меню (этот шаг полностью совпадает с алгоритмом создания меню);

2)подключение главного меню к окну;

3)перерисовка полосы меню окна.

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

состояние любого элемента.

154

должно появиться при выборе строки str в меню hMenu; 6) flag совпадает с параметром fByPosition в InsertMenuItem;

Задача. Главное меню содержит разделы «Файлы» и «Правка». При выборе строки «Файлы» отображается временное меню со строками «Открыть», «Сохранить» и «Выход». При выборе строки «Правка» отображается временное меню со строками «Найти» и «Заменить».

Листинг 4.1. Пример приложения со статическим меню.

#include <windows.h> #defineCM_FILE_OPEN 1001 #define CM_FILE_SAVE 1002 #define CM_FILE_QUIT 1003 #define CM_EDlT_FIND 2001 #define CM_EDIT_REPLC 2002

BOOL RegClass(WNDPROC, LPCTSTR, UINT); LRESULT CALLBACK WndProc(HWND,UINT,

WPARAM,LPARAM); HINSTANCE hInstance;

char szClass[ ]="MenuWindow";

int WINAPI WinMain(HINSTANCE hInstance,

HINSTANCE hPrevInstance, LPSTR lpszCmdLine, int nCmdShow) { MSG msg;

HWND hwnd; ::hInstance=hInstance;

if (!RegClass(WndProc, szClass,COLOR_WINDOW)) return FALSE;

hwnd = CreateWindow(szClass,

"Приложение со статическим меню",

WS_OVERLAPPEDWINDOW | WS_VISIBLE, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, 0,0, hInstance, NULL);

if (!hwnd)

return FALSE; while(GetMessage(&msg, 0,0,0))

{TranslateMessage(&msg);

DispatchMessage(&msg);

155

}

return msg.wParam;

}

BOOL RegClass(WNDPROC Proc, LPCTSTR szName, UINT brBackground)

{WNDCLASS wc; wc.style=wc.cbClsExtra=wc.cbWndExtra = 0; wc.lpfnWndProc = Proc; wc.hInstance=hInstance;

wc.hIcon = LoadIcon(NULL, IDI_APPLICATION); wc.hCursor = LoadCursor(NULL, IDC_ARROW); wc.hbrBackground = (HBRUSH)(brBackground +1); wc.lpszMenuName = NULL;

wc.lpszClassName = szName; return (RegisterClass(&wc) != 0);

}

BOOL CreateMenuItem(HMENU hMenu, char *str, UINT ulns, UINT uCom, HMENU hSubMenu, BOOL flag, UINT fType) MENUITEMINFO mii;

mii.cbSize=sizeof(MENUITEMINFO);

mii.fMask = MIIM_STATE | MIIM_TYPE | MIIM_SUBMENU | MIIM_ID;

mii.fType = fType; mii.fState= MFS_ENABLED; mii.dwfypeData = str; mii.cch=sizeof(str); mii.wID=uCom; mii.hSubMenu=hSubMenu;

return InsertMenuItem(hMenu, ulns, flag, &mii);

)

LRESULT CALLBACK WndProc( HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam)

{ static HMENU hMainMenu, hFileMenu, hEditMenu; switch (msg)

{caseWM_CREATE:

{hMainMenu=CreateMenu();

//Создаем временное меню для раздела "Файлы" hFileMenu=CreatePopupMenu();

156

int i=0;

//Инициализация позиции в меню hFileMenu CreateMenuItem( hFileMenu, "&Открыть", i++, CM_FILE_OPEN, NULL, FALSE, MFT_STRING); CreateMenuItem( hFileMenu, "&Сохранить", i++, CM_FILE_SAVE, NULL, FALSE, MFT_STRING); CreateMenuItem( hFileMenu, NULL, i++,

0, NULL, FALSE, MFT_SEPARATOR ); CreateMenuItem( hFileMenu, "&Выход", i++, CM_FILE_QUIT, NULL, FALSE, MFT_STRING); //Создаем временное меню для раздела "Правка" hEditMenu=CreatePopupMenu();

i=0;

//Инициализация позиции в меню

hEditMenu CreateMenuItem( hEditMenu, "&Найти", i++, CM_EDIT_FIND, NULL, FALSE, MFT_STRING); CreateMenuItem( hEditMenu, "&Заменить", i++, CM_EDIT_REPLC, NULL, FALSE, MFT_STRING); //Подключаем временные меню к главному меню i=0; //Инициализация позиции в меню

hMainMenu CreateMenuItem( hMainMenu, "&Файл", i++, 0, hFileMenu, FALSE, MFT_STRING); CreateMenuItem( hMainMenu, "&Правка", i++, 0, hEditMenu, FALSE, MFT_STRING);

SetMenu( hwnd, hMainMenu); DrawMenuBar( hwnd);

return 0;

}

case WM_COMMAND:

{switch (LOWORD(wParam))

{case CM_FILE_OPEN:

{MessageBox(hwnd,

"Команда CM_FILE_OPEN", "Меню", МВ_ОК); return 0; case CM_FILE_SAVE:

{ MessageBox(hwnd, "Команда CM_FILE_SAVE", "Меню",МВ_ОК); return 0;

case CM_EDIT_FIND:

157

{MessageBox(hwnd, "Команда CM_EDIT_FIND", "Меню",МВ_ОК); return 0;

case CM_EDIT_REPLC:

{MessageBox(hwnd, "Команда CM_EDIT_REPLC", "Меню",МВ_ОК); return 0;

case CM_FILE_QUIT: .

{DestroyWindow(hwnd); return 0; }

} return 0;

}

case WM_DESTROY: {PostQuitMessage(0); return 0;}

}

return DefWindowProc(hwnd, msg, wParam, lParam);

}

Это приложение демонстрирует применение рассмотренной функции CreateMenuItem для создания статического меню. Меню названо статическим потому, что при работе приложения оно не изменяется. Рассмотрим основные шаги создания меню.

1.Описывают дескрипторы для создаваемых меню: static HMENU hMainMenu, hFileMenu, hEditMenu;

2.При обработке сообщения WM_CREATE создают всю систему меню (хотя не запрещается это делать и в любом другом месте):

1)Создают пустое главное меню окна: hMainMenu=CreateMenu();

2)Создают временное меню для раздела «Файлы»

создают пустое временное меню: hFileMenu=CreatePopupMenu();

вставляют элементы в меню hFileMenu:

CreateMenuItem( hFileMenu, "&Открыть", i++, CM_FILE_OPEN, NULL, FALSE, MFT_STRING);

CreateMenuItem( hFileMenu,"&Сохранить",i++, CM_FILE_SAVE,

NULL, FALSE, MFT_STRING); CreateMenuItem( hFileMenu, NULL, i++,0,

NULL, FALSE, MFT_SEPARATOR);

CreateMenuItem( hFileMenu, "&Выход", i++, CM_FILE_QUIT, NULL, FALSE, MFT_STRING);

Здесь аргумент «&Открыть» обозначает ту строку, которая будет отображена во временном меню. Ключ & означает, что символ «О»

158

можно использовать для быстрого доступа к данной строке меню. Аргумент CM_FILE_OPEN является идентификатором той команды, которую получит функция окна при выборе строки «&Открыть».

Так же вставляют второй и четвертый элементы меню. Третьим элементом является разделительная линия.

3)Создают временное меню для раздела «Правка». Создают пустое временное меню: hEditMenu=CreatePopupMenu();

Вставляют элементы в меню hEditMenu:

CreateMenuItem( hEditMenu, "&Найти", i++, CM_EDIT_FIND, NULL, FALSE, MFT_STRING);

CreateMenuItem(hEditMenu,"&3aменить", i++, CM_EDIT_REPLC, NULL, FALSE, MFT_STRING );

4)Подключают временные меню hFileMenu и hEditMenu к главному меню hMainMenu:

CreateMenuItem( hMainMenu, "&Файл", i++, 0, hFileMenu, FALSE, MFT_STRING);

CreateMenuItem( hMainMenu, "&Правка", i++, 0, hEditMenu, FALSE, MFT_STRING);

5)Подключают главное меню к окну и перерисовывают полосу меню:

SetMenu(hwnd,hMainMenu); DrawMenuBar(hwnd);

Приложение обрабатывает команды меню. Как видно из листинга, обработка команд от меню ничем не отличается от обработки команд от других элементов.

4.2.2. Удаление элементов из меню

Функция DeleteMenu удаляет элемент из меню и освобождает все связанные с ним ресурсы. Если удаляемый элемент указывает на временное меню, то функция DeleteMenu удаляет и это временное меню. Прототип функции

BOOL DeleteMenu( HMENU hMenu, UINT uPosition, UINT uFlags);

Приведем параметры функции:

1)hMenu – дескриптор изменяемого меню.

2)uPosition определяет удаляемый элемент. Его значение связано со значением параметра uFlags;

3)uFlags задает способ истолкования параметра uPosition.

159

Если uFlags=MF_BYCOMMAND (значение по умолчанию), то значение uPosition равно идентификатору команды удаляемого элемента. Если uFlags=MF_BYPOSITION, то значение uPosition

равно позиции удаляемого элемента в меню.

При успешном удаления функция возвращает ненулевое значение.

Функция RemoveMenu удаляет элемент из меню, не разрушая связанные с ним ресурсы. Эти ресурсы можно использовать в дальнейшем. Прототип функции

BOOL RemoveMenu( HMENU hMenu, UINT uPosition, UINT uFlags);

Параметры функции RemoveMenu подобны параметрам функции DeleteMenu. При успешном удалении элемента RemoveMenu возвращает ненулевое значение.

Для разрушения меню вызывают функцию

DestroyMenu:

BOOL DestroyMenu( HMENU hMenu);

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

При успешном разрушении функция возвращает ненулевое значение.

Задача. Главное меню изначально содержит раздел «Файлы». При выборе строки «Файлы» отображается временное меню со строками «Открыть», «Сохранить», разделительной линией и строкой «Выход». При выборе строки «Открыть» в главное меню добавить элемент «Правка». .При выборе строки «Правка» отображается временное меню со строками «Найти» и «Заменить». Если же затем выбрать строку «Сохранить», то из главного меню удалить элемент «Правка».

Листинг 4.2. Пример удаления элементов меню.

#include <windows.h>

#define CM_FILE_OPEN 1001 #define CM_FILE_SAVE 1002 #define CM_FILE_QUIT 1003 #define CM_EDIT_FIND 2001 #define CM_EDIT_REPLC 2002

160

BOOL RegClass(WNDPROC, LPCTSTR, UINT); LRESULTCALLBACK WndProc(HWND,UINT,

WPARAM,LPARAM); HINSTANCE hInstance;

char szClass[ ]="RemoveMenu";

int WINAPI WinMain(HINSTANCE hInstance,

HINSTANCE hPrevInstance, LPSTR lpszCmdLine, int nCmdShow) { MSG msg;

HWND hwnd; ::hInstance=hInstance;

if (!RegClass(WndProc, szClass,COLOR_WINDOW) return FALSE;

hwnd = CreateWindow(szClass, "Пример удаления элементов меню",

WS_OVERLAPPEDWINDOW | WS_VISIBLE, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT,

0, 0, hInstance, NULL); if (!hwnd) return FALSE;

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

{ TranslateMessage(&msg); DispatchMessage(&msg);

}

return msg.wParam;

}

BOOL RegClass(WNDPROC Proc, LPCTSTR szName, UINT brBackground)

{ WNDCLASS wc; wc.style=wc.cbClsExtra=wc.cbWndExtra = 0; wc.lpfnWndProc = Proc; wc.hInstance=hInstance;

wc.hIcon = LoadIcon(NULL, IDI_APPLICATION); wc.hCursor = LoadCursor(NULL, IDC_ARROW); wc.hbrBackground = (HBRUSH)(brBackground + 1); wc.lpszMenuName = NULL;

wc.lpszClassName = szName; return (RegisterClass(&wc) != 0);

}

BOOL CreateMenuItem(HMENU hMenu, char *str, UINT ulns,