Класс CContextMenuManager

Статья
06/10/2015

Объект CContextMenuManager управляет контекстные меню, также известные как контекстных меню.

class CContextMenuManager : public CObject

Члены

Открытые конструкторы

Имя	Описание
CContextMenuManager::CContextMenuManager	Создает объект CContextMenuManager.
CContextMenuManager::~CContextMenuManager	Деструктор.

Открытые методы

Имя	Описание
CContextMenuManager::AddMenu	Добавляет новое контекстное меню.
CContextMenuManager::GetMenuById	Возвращает дескриптор меню, связанный с предоставленным идентификатором ресурса
CContextMenuManager::GetMenuByName	Возвращает дескриптор меню, соответствующее предоставленному имени меню.
CContextMenuManager::GetMenuNames	Возвращает список имен меню.
CContextMenuManager::LoadState	Загружает контекстные меню, хранящийся в реестре Windows.
CContextMenuManager::ResetState	Очищает контекстные меню из диспетчера контекстного меню.
CContextMenuManager::SaveState	Сохраняет контекстные меню в реестр Windows.
CContextMenuManager::SetDontCloseActiveMenu	Элементы управления, закроет ли CContextMenuManager активное контекстное меню, когда он указывает новое контекстное меню.
CContextMenuManager::ShowPopupMenu	Отображает указанное контекстное меню.
CContextMenuManager::TrackPopupMenu	Отображает указанное контекстное меню. Возвращает индекс выбранной команды меню.

Заметки

CContextMenuManager управляет контекстных меню и убедитесь в том, что они имеют согласованный вид.

Не следует создать объект CContextMenuManager вручную. Границы приложения создают объект CContextMenuManager. Однако необходимо вызвать CWinAppEx::InitContextMenuManager когда приложение инициализируется. После инициализации диспетчера контекста, используйте метод CWinAppEx::GetContextMenuManager для получения указателя на диспетчер контекста для приложения.

Можно создать контекстные меню во время выполнения путем вызова AddMenu. Если необходимо отображать меню без первого получения введенных пользователем данных, вызовите ShowPopupMenu. TrackPopupMenu используется, когда требуется создать меню и ожидании ввода пользователя. Возвращает индекс TrackPopupMenu выбранных команды или значение 0, если пользователь остается без выбрать все.

CContextMenuManager также может сохранять и загружать свое состояние в реестр Windows.

Пример

В следующем примере показано добавление меню на объект CContextMenuManager и как закрыть активное всплывающее меню, когда объект CContextMenuManager указывает новое всплывающее меню. Этот фрагмент кода является частью Пользовательский образец страниц.

  // The GetContextMenuManager method is inherited from the CWinAppEx class.
    GetContextMenuManager()->AddMenu (_T("My menu"), IDR_CONTEXT_MENU);
    GetContextMenuManager()->SetDontCloseActiveMenu(true);