CContextMenuManager-Klasse

Artikel
06/10/2015

Das CContextMenuManager-Objekt verwaltet Kontextmenüs, auch als Kontextmenüs.

class CContextMenuManager : public CObject

Mitglieder

Öffentliche Konstruktoren

Name	Beschreibung
CContextMenuManager::CContextMenuManager	Erstellt ein CContextMenuManager-Objekt.
CContextMenuManager::~CContextMenuManager	Destruktor.

Öffentliche Methoden

Name	Beschreibung
CContextMenuManager::AddMenu	Fügt ein neues Kontextmenü hinzu.
CContextMenuManager::GetMenuById	Gibt ein Handle für das Menü zurück, das mit der bereitgestellten Ressourcen-ID zugeordnet ist
CContextMenuManager::GetMenuByName	Gibt ein Handle für das Menü zurück, das den angegebenen Menünamen übereinstimmt.
CContextMenuManager::GetMenuNames	Gibt eine Liste von Menünamen zurück.
CContextMenuManager::LoadState	Lädt die Kontextmenüs, die in der Windows-Registrierung gespeichert werden.
CContextMenuManager::ResetState	Löscht die Kontextmenüs vom Kontextmenümanager.
CContextMenuManager::SaveState	Speichert Kontextmenüs zur Windows-Registrierung.
CContextMenuManager::SetDontCloseActiveMenu	Steuert, ob CContextMenuManager das aktive Kontextmenü geschlossen wird, wenn ein neues Kontextmenü angezeigt wird.
CContextMenuManager::ShowPopupMenu	Zeigt das angegebene Kontextmenü an.
CContextMenuManager::TrackPopupMenu	Zeigt das angegebene Kontextmenü an. Gibt den Index des ausgewählten Menübefehls zurück.

Hinweise

CContextMenuManager verwaltet Kontextmenüs und stellt sicher, dass sie eine konsistente Darstellung haben.

Sie sollten ein CContextMenuManager-Objekt nicht manuell erstellen. Das Framework der Anwendung erstellt das CContextMenuManager-Objekt. Sie sollten CWinAppEx::InitContextMenuManager aufrufen, wenn die Anwendung initialisiert wird. Nachdem Sie den Kontextmanager initialisiert haben, verwenden Sie die - Methode CWinAppEx::GetContextMenuManager, um ein Zeiger auf Kontextmanager für die Anwendung abzurufen.

Sie können Kontextmenüs zur Laufzeit erstellen, indem Sie AddMenu aufrufen. Wenn Sie das erste Menü ohne empfangende Benutzereingaben anzeigen möchten, rufen Sie ShowPopupMenu auf. TrackPopupMenu wird verwendet, wenn Sie ein Menü und ein Wartung Benutzereingaben erstellen möchten. TrackPopupMenu gibt den Index des ausgewählten Befehls oder des 0 zurück, wenn der Benutzer der ohne alles auszuwählen gebeendet wird.

CContextMenuManager kann ihren Zustand zur Windows-Registrierung auch speichern und laden.

Beispiel

Das folgende Beispiel zeigt, wie ein Menü einem CContextMenuManager-Objekt hinzufügen und wie Sie nicht das aktive Popupmenü enthält, wenn das Objekt CContextMenuManager ein neues Popupmenü anzeigt. Dieser Codeausschnitt ist Teil Gewohnheits-Seitenbeispiel.

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