VC. Меню и акселераторы

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

° m_hMenu ? дескриптор меню, связанный с объектом класса CMenu.
° BOOL CreateMenu() ? создает пустое меню и связывает его с объектом класса CMenu.
° BOOL CreatePopupMenu() ? создает пустое выпадающее меню и соединяет с объектом класса CMenu.
° BOOL LoadMenu(UINT nIDResource) ? загружает меню из ресурсов и соединяет его с объектом класса CMenu. Меню может быть создано программным путем метода заполнения структур MENUITEMTEMPLATEHEADER и MENUITEMTEMPLATE и посредством вызова метода LoadMenuIndirect(const MUNUTEMPLATE *lpMenuTemplate).
° BOOL Attach(HMENU hMenu) ? пристыковка существующего меню к объекту класса CMenu. Если известен дескриптор меню, то можно определить указатель на соответствующий ему объект CMenu с помощью следующего метода static CMenu* PASCAL FromHandle(HMENU hMenu).
° BOOL DestroyMenu() ? разрушает объект CMenu и освобождает все ресурсы. Этот метод обычно не вызывается явно, так как он автоматически вызывается из деструктора.
° BOOL DeleteMenu(UINT uPosition, UINT uFlags) ? метод удаляет указанный элемент меню. uPosition ? определяет удаляемый элемент меню. uFlags ? определяет, как интерпретируется первый параметр. Если флаг равен MF_BYCOMMAND, то первый параметр интерпретируется как идентификатор пункта меню. Если параметр равен MF_BYPOSITION, то первый параметр определяет позицию элемента меню. Первый элемент имеет позицию ноль.
° BOOL TrackPopupMenu ( UINT nFlags, int x, int y, CWnd* pWnd, LPCRECT lpRact = 0 ) ? метод осуществляет отображение всплывающего (контекстного) меню. Всплывающее меню может быть отображено в любом месте экрана. Метод автоматически отслеживает выбор пункта меню. nFlags ? может быть задан следующими константами: TPM_CENTERALIGN, TMP_LEFTALIGN, TMP_RIGHTALIGN ? для указания позиции выравнивания по горизонтали относительно координаты x, TMP_LEFTBUTTON, TMP_RIGHTBUTTON ? для определения кнопки мыши, выполняющей выбор пункта меню. Координаты x, y ? позиция меню. pWnd ? указатель на окно, в котором находится это меню. Параметр lpRect ? определяет прямоугольную область, в которой щелчок мыши не вызывает исчезновение меню. Если значение параметра NULL, то область ограничена окном меню.
° BOOL AppenedMenu(UINT nFlags, UINT_PTR nIDNewItem = 0, LPCTSTR lpszNewItem = NULL) и BOOL AppenedMenu(UINT nFlags, UINT_PTR nIDNewItem, const CBitmap* pBmp) Используются для добавления элемента в конец меню. Параметр nFlags может быть комбинацией следующих констант: MF_CHECKED ? переключаемый элемент, состояние ?включен? (отмечается галочкой). MF_UNCHECKED ? переключаемый элемент, состояние ?выключен? (галочки нет). MF_DISABLED ? элемент не лоступен. MF_ENABLED ? элемент доступен. MF_GRAYED ? 2серый? элемент (блокирован). MF_MENUBARBREAK ? элемент линейки меню. MF_OWNERDRAW ? самоотображаемый элемент., меня само отвечает за отображение элемента. MF_POPUP ? элемент меню имеет подменю. MF_SEPARATOR ? отображение горизонтальной разделительной линии. MF_STRING ? элемент является текстовой строкой. Параметр nIDNewItem ? в зависимости от первого параметра отпеделяет либо идентификаторор нового элемента, либо указатель (HMENU) подменю; игнорируется для значения MF_SEPARATOR. Параметр lpszNewItem определяет содержимое нового элемента. Параметр pBmp ? определяет указатель на объект класса CBitmap, который может использоваться в качестве содержимого строки меню. При этом первый параметр не может принимать значения MF_OWNERDRAW и MF_STRING.
° BOOL InsertMenu(UINT nPosition, UINT nFlags, UINT_PTR nIDNewItem = 0, LPCTSTR lpszNewItem = NULL) и BOOL InsertMenu(UINT nPosition, UINT nFlags, UINT_PTR nIDNewItem = 0, const CBitmap* pBmp) ? поставляют новый элемент в позицию, определяемцю параметром nPosition.
° UINT CheckMenuItem(UINT nIDCheckItem, UINT nCheck) ? устанавливает или сбрасывает галочку у элемента меню. Второй параметр может принимать два значения: MF_CHECKED и MF_UNCHECKED в комбинации с параметрами MF_BYCOMMAND и MF_BYPOSITION.
° UINT EnableMenuItem(UINT nIDEnableItem, UINT nEnable) ? метод устанавливает для указанного элемента одно из следующих значений: MF_DISABLES и MF_ENABLED, MF_GRAYED.
° UINT GetMenuItemCount() ? возвращает количество элементов меню.
° UINT GetMenuItemID(int nPos) ? метод возвращает идентификатор указанного элемента меню.
° Int GetMenuString(UINT nIDItem, lptstr lpString, int nMaxCount, UINT nFlags) и int GetMenuString(UINT nIDItem, CString& rString, UINT nFlags) ? определяют надпись на указанном элементе меню.
° BOOL RemoveMenu(UINT nPosition, UINT nFlags) ? метод удаляет указанный элемент меню.
° UINT GetMenustate(UINT nID, UINT nFlags) ? определяет состояние элемента или число элементов в раскрывающемся меню. Второй параметр определяет то, как интерпретировать первый элемент ? идентификатор или позиция элемента меню. Для раскрывающегося меню старший байт возвращаемого значения содержит число элементов в нем, младший байт ? набор флагов. Для меню верхнего уровня все возвращаемые значения являются набором флагов.
° Хотя сам редактор меню, предлагаемый Visual Studio.NET, весьма удобен, приведу структуру меня, то есть то, как оно хранится в текстовом файле ресурсов.

IDR_MENU1 MENU BEGIN POPUP "File" BEGIN MENUITEM "Open", ID_FILE_OPEN131 MENUITEM "Exit", ID_FILE_EXIT END POPUP "File2" BEGIN MENUITEM "Open2", ID_FILE2_OPEN2 MENUITEM "Exit2", ID_FILE2_EXIT2 END POPUP "Help" BEGIN MENUITEM "About", ID_HELP_ABOUT END END

Как видите, меня имеет идентификатор IDR_MENU1, который, разумеется, имеет числовое выражение. Если мы посмотрим таблицу Resource Symbols, то увидим, что числовое выражение этого идентификатора 129 (у автора). Как вы наверно уже знаете, числовые значения идентификаторов хранятся в файле resource.h. Такие же идентификаторы имеет каждый элемент меню. Это очень важно, так как в программе мы фактически имеем дело не с меню, а с его элементами.
Теперь разберем алгоритм установки меню в диалоговое окно. Для этой цели естественно нужно выбрать функция OnInitDialog. Определим в начале файла указатель cm: CMenu * cm;. Следующий шаг ? это создание объекта класса CMenu: cm = new CMenu;. Теперь загружаем шаблон меню из файла ресурсов: cm->LoadMenu(IDR_MENU!). таким образом, наш объект наполнился реальным содержанием. Наконец последнее, мы должны пристыковать получившийся объект к диалоговому окну. Это производится следующим действием

This->SetMenu(cm);

?This?, как вы понимаете, указывает на объект ? диалоговое окно, SetMenu ? метод, осуществляющий желанную нами пристыковку. И все, этого уже достаточно, чтобы в созданном диалоговом окне появилось и меню. Да, не забудьте, закрывая окно, удалить меню из памяти, дабы не оставлять за собой мусор. Делается это очень просто: delete cm.
Конечно, этого еще не достаточно для полноценного функционирования приложения, так как пункты меню должны работать, то есть при выборе пункта должна выполняться какая-то процедура. Функцию-обработчик можно сделать для каждого пункта меню. Делается это точно тек же, как для любых других элементов диалогового окна. Для этого, находясь в редакторе меню, нужно щелкнуть правой кнопкой мыши на нужном элементе меню и выбрать Add Event Handler. Далее, в появившемся окне выбирается имя функции и команда, которую вы хотите обрабатывать. Разумеется, этой командой будет COMMAND. Кроме того, в окне следует выбрать класс, где будет производиться обработка. Следует выбрать класс, объектом которого является наше окно. Далее, оказавшись в нужном файле и в нужной функции, можете вводить нужный нам фрагмент кода, который будет выполняться, когда будет выбран соответствующий пунк меню. В принципе этого уже достаточно, чтобы писать приложения с меню.
Теперь обратимся к отдельному, но тесно связанному с меню вопросу ? клавишам акселераторам. Дело в том что этот ресурс используется в основном для быстрого доступа к элементам меню. Для того чтобы клавиша-акселератор была связана с соответствующим пунктом меню, нужно чтобы идентификаторы пункта меню и акселератора совпадали. Тогда обработчик пункта меню и клавиши будет одним и тем же. Но для работы акселератора нужно сделать еще две вещи.
Во-первых, следует загрузить таблицу акселераторов в память. Сделать это можно там же, где вы загружаете меню. Но вот для диалогового окна (точнее в классе CDialog) подходящего метода нет. Придется воспользоваться функцие API: LoadAccelerators. Загружая таблицу, эта функция возвращает дискриптор загруженного ресурса. Следует запомнить этот дискриптор в какой-нибудь глобальной переменной. Наприметр, можно ввести дополнительное свойство в объект theApp. Первым аргументом функции является дескриптор приложения, который может быть с помощью глобальной функции AfxgetInstanceHandle(). Вторым аргументом является идентификатор таблици акселераторв, преобразованный с помощью макроса MAKEINTRESOURCE.
Итак, таблица акселераторов загружена, что дальше? Дальше, и это последнее, следует подвергнуть дополнительной обработке сообщение, приходящее на окно. Для этого достаточно переписать метод PreTransleteMessage.

BOOL CDemoMenuDlg::PreTranslateMessage(MSG*pMsg) { ::TranslateAccelerator(this->m_hWnd, theApp.h,pMsg); return CDialog::PreTranslateMessage(pMsg); } Как вы уже понимаете, CDemoMenuDlg ? это объект, соответствующий нашему диалоговому окну. Вот теперь все, наша таблица акселераторов будет успешно работать в паре с меню. Теория будет не полной, если я не приведу пример. // DemoMenuDlg.cpp : implementation file // #include "stdafx.h" #include "DemoMenu.h" #include "DemoMenuDlg.h" #ifdef _DEBUG #define new DEBUG_NEW #endif // CDemoMenuDlg dialog CMenu* cm; CDemoMenuDlg::CDemoMenuDlg(CWnd* pParent /*=NULL*/) : CDialog(CDemoMenuDlg::IDD, pParent) { m_hIcon = AfxGetApp()->LoadIcon(IDR_MAINFRAME); } void CDemoMenuDlg::DoDataExchange(CDataExchange* pDX) { CDialog::DoDataExchange(pDX); DDX_Control(pDX, IDC_CHECK1, m_check1); } BEGIN_MESSAGE_MAP(CDemoMenuDlg, CDialog) ON_WM_PAINT() ON_WM_RBUTTONUP() ON_WM_QUERYDRAGICON() //}}AFX_MSG_MAP ON_COMMAND(ID_FILE_OPEN130, OnFileOpen130) ON_BN_CLICKED(IDC_CHECK1, OnBnClickedCheck1) END_MESSAGE_MAP() // CDemoMenuDlg message handlers BOOL CDemoMenuDlg::OnInitDialog() { CDialog::OnInitDialog(); // Set the icon for this dialog. The framework does this automatically // when the application′s main window is not a dialog SetIcon(m_hIcon, TRUE); // Set big icon SetIcon(m_hIcon, FALSE); // Set small icon // TODO: Add extra initialization here theApp.h=::LoadAccelerators(AfxGetInstanceHandle(), MAKEINTRESOURCE(IDR_ACCEL)); cm = new CMenu; cm->LoadMenu(IDR_MENU1); this->SetMenu(cm); return TRUE; // return TRUE unless you set the focus to a control } // If you add a minimize button to your dialog, you will need the code below // to draw the icon. For MFC applications using the document/view model, // this is automatically done for you by the framework. void CDemoMenuDlg::OnPaint() { if (IsIconic()) { CPaintDC dc(this); // device context for painting SendMessage(WM_ICONERASEBKGND, reinterpret_cast(dc.GetSafeHdc()), 0); // Center icon in client rectangle int cxIcon = GetSystemMetrics(SM_CXICON); int cyIcon = GetSystemMetrics(SM_CYICON); CRect rect; GetClientRect(&rect); int x = (rect.Width() - cxIcon + 1) / 2; int y = (rect.Height() - cyIcon + 1) / 2; // Draw the icon dc.DrawIcon(x, y, m_hIcon); } else { CDialog::OnPaint(); } } // The system calls this function to obtain the cursor to display while the user drags // the minimized window. HCURSOR CDemoMenuDlg::OnQueryDragIcon() { return static_cast(m_hIcon); } BOOL CDemoMenuDlg::PreTranslateMessage(MSG*pMsg) { ::TranslateAccelerator(this->m_hWnd, theApp.h,pMsg); return CDialog::PreTranslateMessage(pMsg); } void CDemoMenuDlg::OnFileOpen130() { // TODO: Add your command handler code here MessageBox("Open"); } void CDemoMenuDlg::OnRButtonUp(UINT nFlags, CPoint point) { // TODO: Add your command handler code here CMenu menu; POINT pt; GetCursorPos(&pt); menu.LoadMenu(MAKEINTRESOURCE(IDR_MENU2)); menu.GetSubMenu(0)->TrackPopupMenu(0, pt.x, pt.y, this, NULL); } void CDemoMenuDlg::OnBnClickedCheck1() { if(!m_check1.GetCheck()) { cm->EnableMenuItem(ID_FILE2_OPEN2, MF_ENABLED); } else { cm->EnableMenuItem(ID_FILE2_OPEN2, MF_GRAYED); } }