Freigeben über


IVBGetControl::EnumControls-Methode (vbinterf.h)

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