Freigeben über


CMenu-Klasse

Eine Kapselung Windows HMENU.

class CMenu : public CObject

Mitglieder

Öffentliche Konstruktoren

Name

Description

CMenu::CMenu

Erstellt ein CMenu-Objekt.

Öffentliche Methoden

Name

Description

CMenu::AppendMenu

Fügt ein neues Element am Ende dieses Menüs an.

CMenu::Attach

Fügt ein Menü Fenster-Handle zu einem CMenu-Objekt.

CMenu::CheckMenuItem

Setzt ein Häkchen neben oder entfernt ein Häkchen von einem Menüelement im Popupmenü.

CMenu::CheckMenuRadioItem

Setzt ein Optionsfeld neben einem Menüelement und entfernt das Optionsfeld aus allen anderen Menüelemente in der Gruppe.

CMenu::CreateMenu

Erstellt ein leeres Menü und fügt es zu einem CMenu-Objekt.

CMenu::CreatePopupMenu

Erstellt ein leeres Popupmenü und fügt es zu einem CMenu-Objekt.

CMenu::DeleteMenu

Löscht ein angegebenes Element aus dem Menü. Wenn das Menüelement ein zugeordnetes Popupmenü verfügt, zerstört das Handle für das Popupmenü und gibt den Speicher frei, der von diesen verwendet wird.

CMenu::DeleteTempMap

Löscht alle temporären CMenu-Objekte, die von der FromHandle-Memberfunktion erstellt werden.

CMenu::DestroyMenu

Zerstört das Menü, das einem Objekt CMenu angefügt wird und jeden Speicherplatz, den das Menü gefüllte.

CMenu::Detach

Trennt ein Menü Fenster-Handle von einem CMenu-Objekt und gibt das Handle zurück.

CMenu::DrawItem

Aufgerufen vom Framework ausgelöst, wenn ein visueller Aspekt eines Ownerdrawnmenüs ändert.

CMenu::EnableMenuItem

Aktiviert, deaktiviert oder blendet (grau) ein Menüelement ab.

CMenu::FromHandle

Gibt einen Zeiger auf einen CMenu-Objekt zurück, das ein Menü Fenster-Handle angegeben ist.

CMenu::GetDefaultItem

Bestimmt das standardmäßige Menüelement auf dem angegebenen Menü.

CMenu::GetMenuContextHelpId

Ruft die Hilfekontext-id ab, die dem Menü zugeordnet ist.

CMenu::GetMenuInfo

Ruft Informationen über ein bestimmtes Menü ab.

CMenu::GetMenuItemCount

Bestimmt die Anzahl der Elemente in einem Popup oder in einem Menü der obersten Ebene.

CMenu::GetMenuItemID

Erhält der Menüelementbezeichner für ein Menüelement, das an der angegebenen Position und wird.

CMenu::GetMenuItemInfo

Ruft Informationen über ein Menüelement ab.

CMenu::GetMenuState

Gibt den Status des angegebenen Menüelements oder die Anzahl der Elemente in einem Popupmenü zurück.

CMenu::GetMenuString

Ruft die Bezeichnung des angegebenen Menüelements ab.

CMenu::GetSafeHmenu

Gibt m_hMenu zurück, das von diesem Objekt CMenu umschlossen wird.

CMenu::GetSubMenu

Ruft einen Zeiger auf ein Popupmenü ab.

CMenu::InsertMenu

Fügt ein neues Menüelement an der angegebenen Position ein verschiebt und andere Elemente in das Menü.

CMenu::InsertMenuItem

Fügt ein neues Menüelement an der angegebenen Position in einem Menü ein.

CMenu::LoadMenu

Lädt eine Menüressource der ausführbaren Datei und fügt sie zu einem CMenu-Objekt.

CMenu::LoadMenuIndirect

Lädt ein Menü mit einer Menüvorlage im Arbeitsspeicher und fügt es zu einem CMenu-Objekt.

CMenu::MeasureItem

Aufgerufen durch das Framework, um Menüdimensionen zu bestimmen, ob ein Ownerdrawnmenü erstellt wird.

CMenu::ModifyMenu

Ändert ein vorhandenes Menüelement an der angegebenen Position.

CMenu::RemoveMenu

Löscht ein Menüelement einem zugeordneten Popupmenü aus dem angegebenen Menü.

CMenu::SetDefaultItem

Legt das standardmäßige Menüelement für das angegebene Menü fest.

CMenu::SetMenuContextHelpId

Legt die dem Menü fest zugeordnet werden Hilfekontext-id.

CMenu::SetMenuInfo

Enthält Informationen über ein bestimmtes Menü fest.

CMenu::SetMenuItemBitmaps

Ordnet die angegebenen Prüfzeichenbitmaps mit einem Menüelement zu.

CMenu::SetMenuItemInfo

Ändert Informationen über ein Menüelement.

CMenu::TrackPopupMenu

Zeigt ein unverankertes Popupmenü an der angegebenen Position an und verfolgt die Auswahl von Elementen im Popupmenü.

CMenu::TrackPopupMenuEx

Zeigt ein unverankertes Popupmenü an der angegebenen Position an und verfolgt die Auswahl von Elementen im Popupmenü.

Öffentliche Operatoren

Name

Description

CMenu::operator HMENU

Ruft das Handle des Menüobjekts ab.

CMenu::operator! =

Bestimmt, ob zwei Menüobjekte nicht gleich sind.

CMenu::operator-==

Bestimmt, ob zwei Menüobjekte gleich sind.

Öffentliche Datenmember

Name

Description

CMenu::m_hMenu

Gibt das Handle für das Menü Fenster an, das dem Objekt CMenu angefügt wird.

Hinweise

Es enthält Memberfunktionen für das Erstellen, Nachverfolgen, Aktualisieren und das Löschen eines Menüs bereit.

Erstellen Sie ein CMenu-Objekt im Stapelrahmen als lokale Variable, und rufen Sie dann die Memberfunktionen von CMenu auf, um das neue Menü nach Bedarf zu bearbeiten. Als Nächstes Aufruf CWnd::SetMenu, damit das Menü zu einem Fenster festzulegen, direkt gefolgt von einem Aufruf der Memberfunktion des CMenuTrennen Sie sich-Objekts. Die CWnd::SetMenu-Memberfunktion legt das Menü des Fensters in das neue Menü fest, wird das Fenster neu gezeichnet werden, um die Menüänderung wiederzugeben und führt auch den Besitzer des Menüs in das Fenster. Der Aufruf Detach trennt HMENU vom CMenu-Objekt, damit, wenn die lokalen CMenu-Variablenübergaben außerhalb des Bereichs, der CMenu-Objektdestruktor nicht versucht, ein Menü zu zerstören, er nicht mehr besitzt. Das Menü selbst wird automatisch zerstört, wenn das Fenster zerstört wird.

Sie können die LoadMenuIndirect-Memberfunktion verwenden, um ein Menü mit einer Vorlage im Arbeitsspeicher erstellen, aber ein Menü, das von einer Ressource durch einen Aufruf LoadMenu erstellt wird, kann einfach verwaltet, und die Menüressource selbst kann im Menü-Editor erstellt und geändert werden.

Vererbungshierarchie

CObject

CMenu

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CObject-Klasse

Hierarchiediagramm

CObject-Klasse

Konzepte

MFC-Beispiel CTRLTEST

MFC-Beispiel DYNAMENU