CContextMenuManager::ShowPopupMenu

Zeigt das angegebene Kontextmenü an.

virtual BOOL ShowPopupMenu(
   UINT uiMenuResId,
   int x,
   int y,
   CWnd* pWndOwner,
   BOOL bOwnMessage = FALSE,
   BOOL bRightAlign = FALSE
);

virtual CMFCPopupMenu* ShowPopupMenu(
   HMENU hmenuPopup,
   int x,
   int y,
   CWnd* pWndOwner,
   BOOL bOwnMessage = FALSE,
   BOOL bAutoDestroy = TRUE,
   BOOL bRightAlign = FALSE
);

Parameter

  • [in] uiMenuResId
    Das Ressourcen-ID des, das diese Methode anzeigt.

  • [in] x
    Die horizontale Offset für das Kontextmenü in Clientkoordinaten.

  • [in] y
    Der vertikale Offset für das Kontextmenü in Clientkoordinaten

  • [in] pWndOwner
    Ein Zeiger auf das übergeordnete Fenster des Kontextmenüs.

  • [in] bOwnMessage
    Ein boolescher Parameter, der angibt, wie Nachrichten weitergeleitet werden.Wenn bOwnMessageFALSE ist, wird Standard-MFC-Routing verwendet.Andernfalls erhält pWndOwner die Nachrichten.

  • [in] hmenuPopup
    Das Handle des, das diese Methode anzeigt.

  • [in] bAutoDestroy
    Ein boolescher Parameter, der angibt, ob das Menü automatisch zerstört wird.

  • [in] bRightAlign
    Ein boolescher Parameter, der angibt, wie die Menüelemente ausgerichtet sind.Wenn bRightAlignTRUE ist, ist das Menü für Rechts-nach-Links-Lesefolge rechtsbündig ausgerichtet.

Rückgabewert

Die erste Methodenüberladung gibt Wert ungleich 0 (null) zurück, wenn die Methode erfolgreich das Menü angezeigt wird; 0 andernfalls.Die zweite Methodenüberladung gibt einen Zeiger auf CMFCPopupMenu wenn die Kontextmenüanzeigen ordnungsgemäß zurück; andernfalls NULL.

Hinweise

Diese Methode ähnelt der Methode CContextMenuManager::TrackPopupMenu darin, dass beide Methoden ein Kontextmenü anzeigen.Es gibt TrackPopupMenu den Index des ausgewählten Menübefehls zurück.

Wenn der Parameter bAutoDestroyFALSE ist, müssen Sie die geerbte Methode DestroyMenu manuell aufrufen, um Arbeitsspeicherressourcen freizugeben.Die Standardimplementierung von ShowPopupMenu verwendet nicht den Parameter bAutoDestroy.Sie ist für die zukünftige Verwendung oder für die benutzerdefinierten Klassen bereitgestellt, die von CContextMenuManager-Klasse abgeleitet werden.

Anforderungen

Header: afxcontextmenumanager.h

Siehe auch

Referenz

CContextMenuManager-Klasse

Hierarchien-Diagramm

CContextMenuManager::TrackPopupMenu