CMenuTearOffManager-Klasse
Verwaltet abtrennbare Menüs. Ein abtrennbares Menü ist ein Menü in der Menüleiste. Der Benutzer kann ein solches Menü von der Menüleiste abtrennen, wodurch das Menü beliebig positionierbar wird.
Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.
class CMenuTearOffManager : public CObject
Name | Beschreibung |
---|---|
CMenuTearOffManager::CMenuTearOffManager | Erstellt ein CMenuTearOffManager -Objekt. |
Name | Beschreibung |
---|---|
CMenuTearOffManager::Build | |
CMenuTearOffManager::GetRegPath | |
CMenuTearOffManager::Initialize | Initialisiert ein CMenuTearOffManager -Objekt. |
CMenuTearOffManager::IsDynamicID | |
CMenuTearOffManager::P ararse | |
CMenuTearOffManager::Reset | |
CMenuTearOffManager::SetInUse | |
CMenuTearOffManager::SetupTearOffMenus |
Damit Sie in Ihrer Anwendung Abreißmenüs verwenden können, müssen Sie über ein CMenuTearOffManager
Objekt verfügen. In den meisten Fällen erstellen oder initialisieren Sie ein CMenuTearOffManager
Objekt nicht direkt. Dies wird für Sie behandelt, wenn Sie die CWinAppEx::EnableTearOffMenus-Funktion aufrufen.
Im folgenden Beispiel wird das Erstellen und Initialisieren eines CMenuTearOffManager
Objekts durch Aufrufen der CWinAppEX::EnableTearOffMenus
Methode veranschaulicht. Dieser Codeausschnitt ist Teil des WordPad-Beispiels.
// The EnableTearOffMenus method is inherited from the CWinAppEx class.
EnableTearOffMenus(NULL, ID_FREE_TEAROFF1, ID_FREE_TEAROFF2);
CMenuTearOffManager
Header: afxmenutearoffmanager.h
void Build(
UINT uiTearOffBarID,
CString& strText);
[in] uiTearOffBarID
[in] strText
Erstellt ein CMenuTearOffManager -Objekt.
CMenuTearOffManager();
In den meisten Fällen sollten Sie keinen manuellen Erstellen CMenuTearOffManager
. Das Framework Ihrer Anwendung erstellt das CMenuTearOffManager
Objekt, wenn Sie CWinAppEx::EnableTearOffMenus aufrufen.
LPCTSTR GetRegPath() const;
Initialisiert ein CMenuTearOffManager -Objekt.
BOOL Initialize(
LPCTSTR lpszRegEntry,
UINT uiTearOffMenuFirst,
UINT uiTearOffMenuLast);
lpszRegEntry
[in] Eine Zeichenfolge, die den Pfad eines Registrierungseintrags enthält. Ihre Anwendungen speichern die Einstellungen für Abreißleisten in diesem Registrierungseintrag.
uiTearOffMenuFirst
[in] Die erste Menü-ID für ein abreißende Menü.
uiTearOffMenuLast
[in] Die letzte Menü-ID für ein Abrissmenü.
Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).
Der Bereich von Menü-IDs von uiTearOffMenuFirst zu uiTearOffMenuLast muss ein fortlaufendes Intervall sein. Das Intervall definiert die Anzahl der Abreißmenüs, die gleichzeitig in der Anwendung angezeigt werden können.
BOOL IsDynamicID(UINT uiID) const;
[in] uiID
UINT Parse(CString& str);
[in] Str
void Reset(HMENU hmenu);
[in] hmenu
void SetInUse(
UINT uiCmdId,
BOOL bUse = TRUE);
[in] uiCmdId
[in] bUse
void SetupTearOffMenus(HMENU hMenu);
[in] hMenu