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.
Syntax
class CMenuTearOffManager : public CObject
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CMenuTearOffManager::CMenuTearOffManager | Erstellt ein CMenuTearOffManager-Objekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CMenuTearOffManager::Build | |
| CMenuTearOffManager::GetRegPath | |
| CMenuTearOffManager::Initialize | Initialisiert ein CMenuTearOffManager-Objekt. |
| CMenuTearOffManager::IsDynamicID | |
| CMenuTearOffManager::P ararse | |
| CMenuTearOffManager::Reset | |
| CMenuTearOffManager::SetInUse | |
| CMenuTearOffManager::SetupTearOffMenus |
Hinweise
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.
Beispiel
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);
Vererbungshierarchie
CMenuTearOffManager
Anforderungen
Header: afxmenutearoffmanager.h
CMenuTearOffManager::Build
void Build(
UINT uiTearOffBarID,
CString& strText);
Parameter
[in] uiTearOffBarID
[in] strText
Hinweise
CMenuTearOffManager::CMenuTearOffManager
Erstellt ein CMenuTearOffManager -Objekt.
CMenuTearOffManager();
Hinweise
In den meisten Fällen sollten Sie keinen manuellen Erstellen CMenuTearOffManager . Das Framework Ihrer Anwendung erstellt das CMenuTearOffManager Objekt, wenn Sie CWinAppEx::EnableTearOffMenus aufrufen.
CMenuTearOffManager::GetRegPath
LPCTSTR GetRegPath() const;
Rückgabewert
Bemerkungen
CMenuTearOffManager::Initialize
Initialisiert ein CMenuTearOffManager -Objekt.
BOOL Initialize(
LPCTSTR lpszRegEntry,
UINT uiTearOffMenuFirst,
UINT uiTearOffMenuLast);
Parameter
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ü.
Rückgabewert
Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).
Hinweise
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.
CMenuTearOffManager::IsDynamicID
BOOL IsDynamicID(UINT uiID) const;
Parameter
[in] uiID
Rückgabewert
Bemerkungen
CMenuTearOffManager::P ararse
UINT Parse(CString& str);
Parameter
[in] Str
Rückgabewert
Bemerkungen
CMenuTearOffManager::Reset
void Reset(HMENU hmenu);
Parameter
[in] hmenu
Hinweise
CMenuTearOffManager::SetInUse
void SetInUse(
UINT uiCmdId,
BOOL bUse = TRUE);
Parameter
[in] uiCmdId
[in] bUse
Hinweise
CMenuTearOffManager::SetupTearOffMenus
void SetupTearOffMenus(HMENU hMenu);
Parameter
[in] hMenu