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.

Weitere Details finden Sie im Quellcode im Ordner VC\atlmfc\src\mfc Ihrer 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

CObject

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

Hinweise

Siehe auch

Hierarchiediagramm
Klassen
CWinAppEx-Klasse