IVBGetControl::EnumControls-Methode (vbinterf.h)

Artikel
08/26/2023

Listet die Steuerelemente im Formular auf.

Hinweis Die Verwendung dieser Methode wird nicht mehr empfohlen, da andere Container als Visual Basic sie nicht unterstützen.

Syntax

HRESULT EnumControls(
  [in]  DWORD         dwOleContF,
  [in]  DWORD         dwWhich,
  [out] LPENUMUNKNOWN *ppenumUnk
);

Parameter

[in] dwOleContF

Gibt den Typ der OLE-Objekte an, die aufgelistet werden sollen. Dieser Parameter kann einer der folgenden Werte sein, die von der OLECONTF-Enumeration aufgezählt werden.

Wert	Bedeutung
OLECONTF_EMBEDDINGS	Listet die eingebetteten Objekte im Formular auf. Fügen Sie dieses Flag ein, um OLE-Steuerelemente aufzulisten.
OLECONTF_LINKS	Listet die verknüpften Objekte im Formular auf.
OLECONTF_OTHER	Listet alle Pseudo-OLE-Objekte auf. Fügen Sie dieses Flag ein, um VBX-Steuerelemente aufzulisten.
OLECONTF_ONLYUSER	Listet nur Objekte auf, die dem Benutzer bekannt sind.
OLECONTF_ONLYIFRUNNING	Listet nur die Objekte auf, die im Formular ausgeführt werden.

Beim Auflisten von OLE-Steuerelementen wird empfohlen, die Flags OLECONTF_ONLYUSER, OLECONTF_ONLYIFRUNNING und OLECONTF_EMBEDDINGS zu kombinieren. Um sowohl OLE-Steuerelemente als auch VBX-Steuerelemente einzubeziehen, fügen Sie der Liste das Flag OLECONTF_OTHERS hinzu. Um nur VBX-Steuerelemente aufzulisten, entfernen Sie das OLECONTF_EMBEDDINGS-Flag , und fügen Sie das OLECONTF_OTHERS-Flag ein.

[in] dwWhich

Gibt den Satz von Steuerelementen an, die aufgelistet werden sollen. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
GCW_WCH_SIBLING 0x00000001	Listet alle Geschwister des Steuerelements auf.
GC_WCH_CONTAINER 0x00000002	Listet alle Objekte auf, die die Übergeordneten Ihrer Steuerung sind. Sie können die GC_WCH_FONLYAFTER - oder GC_WCH_FONLYBEFORE-Flags nicht mit diesem Flag verwenden.
GC_WCH_CONTAINED 0x00000003	Listet alle Objekte auf, die untergeordnete Elemente Ihres Steuerelements sind. Sie können die GC_WCH_FONLYAFTER - oder GC_WCH_FONLYBEFORE-Flags nicht mit diesem Flag verwenden.
GC_WCH_ALL 0x00000004	Listet alle Objekte auf.
GC_WCH_FREVERSEDIR 0x08000000	Listet Steuerelemente in umgekehrter Tabulatorreihenfolge auf und organisiert sie. Dieses Flag kann mit jedem anderen Flag kombiniert werden.
GC_WCH_FONLYAFTER 0x10000000	Listet alle Steuerelemente auf, die nach dem Steuerelement in der Registerkartenreihenfolge angezeigt werden.
GC_WCH_FONLYBEFORE 0x20000000	Listet alle Steuerelemente auf, die vor dem Steuerelement in der Registerkartenreihenfolge angezeigt werden.
GC_WCH_FSELECTED 0x40000000	Listet alle Steuerelemente auf, die derzeit ausgewählt sind.

Verwenden Sie eines der Flags GC_WCH_SIBLING, GC_WCH_CONTAINER, GC_WCH_CONTAINED oder GC_WCH_ALL in Kombination mit einem der GC_WCH_Fxxx-Flags .

Im VBX-Code wurde das GC_FORM-Flag an VBGetControl übergeben, um einen Zeiger auf das Formular abzurufen. Im OLE-Steuerelementcode gibt es keinen direkten Ersatz für dieses Flag. Übergeben Sie stattdessen GC_WHC_ALL an EnumControls , und verwenden Sie den Zeiger auf das erste Steuerelement in der Enumeration. Das erste Steuerelement in der Enumeration ist immer das Formular, wenn GC_WHC_ALL verwendet wird.

[out] ppenumUnk

Zeiger auf eine Enumeration von OLE-Objekten.

Rückgabewert

Diese Methode unterstützt die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und E_UNEXPECTED sowie Folgendes:

Hinweise

Bei der Migration eines VBX-Steuerelements zu einem OLE-Steuerelement ersetzt EnumControls das Visual Basic-VBGetControl, das nicht mehr unterstützt wird.

Anforderungen


Zielplattform	Windows
Kopfzeile	vbinterf.h

Weitere Informationen

IVBGetControl

OLECONTF

Share via