CWnd::GetNextDlgGroupItem

Artikel
02/26/2013

Sucht das vorherige oder nächste Steuerelement innerhalb einer Gruppe Steuerelemente in einem Dialogfeld.

CWnd* GetNextDlgGroupItem(
   CWnd* pWndCtl,
   BOOL bPrevious = FALSE 
) const;
COleControlSiteOrWnd* GetNextDlgGroupItem(
   COleControlSiteOrWnd *pCurSiteOrWnd = NULL
) const;

Parameter

pWndCtl
Identifiziert das als Ausgangspunkt für die Suche verwendet werden Steuerelement.
bPrevious
Gibt an, wie die Funktion, die Gruppe von Steuerelementen im Dialogfeld zu finden ist.Wenn TRUE, die Funktionssuchen für das vorherige Steuerelement in der Gruppe; FALSE, wenn es für das nächste Steuerelement in der Gruppe sucht.
pCurSiteOrWnd
Identifiziert das COleControlSiteOrWnd -Steuerelement.Weitere Informationen zu COleControlSiteOrWnd, finden Sie unter Remarks.

Rückgabewert

Zeiger zum vorherigen oder nächsten Steuerelement in der Gruppe, wenn die Memberfunktion erfolgreich ist.

Der zurückgegebene Zeiger ist möglicherweise und sollte nicht für die spätere Verwendung gespeichert werden temporär.

Hinweise

Eine Gruppe Steuerelemente beginnt mit einem Steuerelement, das mit dem WS_GROUP Format und endet mit dem letzten - Steuerelement erstellt wurde, das nicht im WS_GROUP Format erstellt wurde.

Standardmäßig gibt die GetNextDlgGroupItem-Memberfunktion einen Zeiger zum nächsten Steuerelement in der Gruppe zurück.Wenn pWndCtl das erste Steuerelement in der Gruppe identifiziert und bPreviousTRUE ist, gibt GetNextDlgGroupItem einen Zeiger auf das letzte Steuerelement in der Gruppe zurück.

Hinweis
Da MFC fensterlose ActiveX-Steuerelemente, Standard-ActiveX-Steuerelemente und unterstützt, ist das Ansprechen eines Steuerelements durch nur HWND nicht mehr.Das COleControlSiteOrWnd-Objekt enthält Informationen, die das Objekt als ActiveX-Steuerelement mit Fenster, fensterloses ActiveX-Steuerelement oder Fenster identifiziert, wie folgt:

Steuerelement- oder Fenstertyp	Identifikationsinformationen
ActiveX-Steuerelement mit Fenster	Enthält HWND und ordnet ein COleControlSite-Objekt damit zu.Der m_hWnd-Member von COleControlSiteOrWnd wird zum HWND des Steuerelements festgelegt, und der m_pSite-Member zeigt auf COleControlSite des Steuerelements.
Fensterloses ActiveX-Steuerelement	Enthält kein HWND.Der m_pSite-Member von COleControlSiteOrWnd zeigt auf COleControlSite des Steuerelements, und der m_hWnd -Member ist NULL.
Standardfenster	Enthält nur HWND.Der m_hWnd-Member von COleControlSiteOrWnd wird zu HWND des Fensters festgelegt, und der m_pSite-Member ist NULL.