Freigeben über


CMFCDropDownFrame-Klasse

Bietet Dropdownfeld-Fensterfunktionen für Dropdownsymbolleisten und Dropdown-Symbolleistenschaltflächen.

Syntax

class CMFCDropDownFrame : public CMiniFrameWnd

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCDropDownFrame::CMFCDropDownFrame Der Standardkonstruktor.
CMFCDropDownFrame::~CMFCDropDownFrame Destruktor.

Öffentliche Methoden

Name Beschreibung
CMFCDropDownFrame::Create Erstellt ein CMFCDropDownFrame-Objekt.
CMFCDropDownFrame::CreateObject Wird vom Framework verwendet, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CMFCDropDownFrame::GetParentMenuBar Ruft die übergeordnete Menüleiste des Dropdownframes ab.
CMFCDropDownFrame::GetParentPopupMenu Ruft das übergeordnete Popupmenü des Dropdownframes ab.
CMFCDropDownFrame::GetThisClass Wird vom Framework verwendet, um einen Zeiger auf das CRuntimeClass -Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCDropDownFrame::RecalcLayout Positioniert den Dropdownrahmen neu.
CMFCDropDownFrame::SetAutoDestroy Legt fest, ob das untergeordnete Dropdownsymbolleistenfenster automatisch zerstört wird.

Hinweise

Diese Klasse soll nicht direkt aus Dem Code verwendet werden.

Das Framework verwendet diese Klasse, um Frameverhalten für die CMFCDropDownToolbar klassen bereitzustellen CMFCDropDownToolbarButton . Weitere Informationen zu diesen Klassen finden Sie unter CMFCDropDownToolBar Class and CMFCDropDownToolbarButton Class.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie Sie einen Zeiger auf ein CMFCDropDownFrame Objekt aus einer CFrameWnd Klasse abrufen und festlegen, wie das untergeordnete Dropdownsymbolleistenfenster automatisch zerstört wird.

CFrameWnd *pTopFrame = AFXGetParentFrame(this);
if (pTopFrame == NULL)
{
   return FALSE;
}

CMFCDropDownFrame *pDropFrame = DYNAMIC_DOWNCAST(CMFCDropDownFrame, pTopFrame);
pDropFrame->SetAutoDestroy(true);

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

CMFCDropDownFrame

Anforderungen

Header: afxdropdowntoolbar.h

CMFCDropDownFrame::Create

Erstellt ein CMFCDropDownFrame-Objekt.

virtual BOOL Create(
    CWnd* pWndParent,
    int x,
    int y,
    CMFCDropDownToolBar* pWndOriginToolbar);

Parameter

pWndParent
[in] Das übergeordnete Fenster des Dropdownframes.

x
[in] Die horizontale Bildschirmkoordinate für die Position des Abwärtsrahmens.

y
[in] Die vertikale Bildschirmkoordinate für die Position des Abwärtsrahmens.

pWndOriginToolbar
[in] Die Symbolleiste mit den Dropdownschaltflächen, die von dieser Methode zum Auffüllen des neuen Dropdownframeobjekts verwendet werden.

Rückgabewert

TRUE, wenn der Dropdownframe erfolgreich erstellt wurde; andernfalls FALSE.

Hinweise

Diese Methode ruft die CMiniFrameWnd::CreateEx-Basismethode auf, um das Dropdownframefenster mit dem WS_POPUP-Format zu erstellen. Das Dropdownfeldfenster wird an den angegebenen Bildschirmkoordinaten angezeigt. Diese Methode schlägt fehl, wenn die CMiniFrameWnd::CreateEx-Methode FALSE zurückgibt.

Die CMFCDropDownFrame Klasse erstellt eine Kopie des bereitgestellten CMFCDropDownToolBar Parameters. Diese Methode kopiert die Schaltflächenbilder und Schaltflächenzustände aus dem pWndOriginToolbar Parameter in das m_pWndOriginToolbar Datenmemm.

CMFCDropDownFrame::GetParentMenuBar

Ruft die übergeordnete Menüleiste des Dropdownframes ab.

CMFCMenuBar* GetParentMenuBar() const;

Rückgabewert

Ein Zeiger auf die übergeordnete Menüleiste des Dropdownframes oder NULL, wenn der Frame kein übergeordnetes Element aufweist.

Hinweise

Diese Methode ruft die übergeordnete Menüleiste aus der übergeordneten Schaltfläche ab. Diese Methode gibt NULL zurück, wenn der Dropdownframe keine übergeordnete Schaltfläche hat oder die übergeordnete Schaltfläche keine übergeordnete Menüleiste aufweist.

CMFCDropDownFrame::GetParentPopupMenu

Ruft das übergeordnete Popupmenü des Dropdownframes ab.

CMFCDropDownFrame* GetParentPopupMenu() const;

Rückgabewert

Ein Zeiger auf das übergeordnete Dropdownmenü des Dropdownframes oder NULL, wenn der Frame kein übergeordnetes Element aufweist.

Hinweise

Diese Methode ruft das übergeordnete Menü aus der übergeordneten Schaltfläche ab. Diese Methode gibt NULL zurück, wenn der Dropdownframe keine übergeordnete Schaltfläche hat oder die übergeordnete Schaltfläche kein übergeordnetes Menü hat.

CMFCDropDownFrame::RecalcLayout

Positioniert den Dropdownrahmen neu.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parameter

bNotify
[in] Nicht verwendet.

Hinweise

Das Framework ruft diese Methode auf, wenn der Dropdownframe erstellt wird oder die Größe des übergeordneten Fensters geändert wird. Diese Methode berechnet die Position und Größe des Dropdownrahmens mithilfe der Position und Größe des übergeordneten Fensters.

CMFCDropDownFrame::SetAutoDestroy

Legt fest, ob das untergeordnete Dropdownsymbolleistenfenster automatisch zerstört wird.

void SetAutoDestroy(BOOL bAutoDestroy = TRUE);

Parameter

bAutoDestroy
[in] TRUE, um das zugeordnete Dropdownsymbolleistenfenster automatisch zu zerstören; andernfalls FALSE.

Hinweise

Wenn bAutoDestroy TRUE ist, zerstört der CMFCDropDownFrame Destruktor das zugeordnete Dropdownsymbolleistenfenster. Der Standardwert ist TRUE.

Siehe auch

Hierarchiediagramm
Klassen
CMFCDropDownToolBar-Klasse
CMFCDropDownToolbarButton-Klasse