Método IVBGetControl::EnumControls (vbinterf.h)

  • Artículo

Enumera los controles del formulario.

Nota El uso de este método ya no se recomienda porque los contenedores distintos de Visual Basic no lo admiten.
 

Sintaxis

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

Parámetros

[in] dwOleContF

Especifica el tipo de objetos OLE que se van a enumerar. Este parámetro puede ser uno de los siguientes valores enumerados por la enumeración OLECONTF .

Valor Significado
OLECONTF_EMBEDDINGS
 Enumera los objetos incrustados en el formulario. Incluya esta marca para enumerar controles OLE.
OLECONTF_LINKS
 Enumera los objetos vinculados del formulario.
OLECONTF_OTHER
 Enumera todos los objetos pseudo OLE. Incluya esta marca para enumerar controles VBX.
OLECONTF_ONLYUSER
 Enumera solo los objetos que el usuario conoce.
OLECONTF_ONLYIFRUNNING
 Enumera solo los objetos que se ejecutan en el formulario.
 

Al enumerar controles OLE, se recomienda combinar las marcas OLECONTF_ONLYUSER, OLECONTF_ONLYIFRUNNING y OLECONTF_EMBEDDINGS. Para incluir controles OLE y controles VBX, agregue la marca OLECONTF_OTHERS a esta lista. Para enumerar solo los controles VBX, quite la marca OLECONTF_EMBEDDINGS e incluya la marca OLECONTF_OTHERS .

[in] dwWhich

Especifica el conjunto de controles que se van a enumerar. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
GCW_WCH_SIBLING
0x00000001
 Enumera todos los elementos del mismo nivel del control.
GC_WCH_CONTAINER
0x00000002
 Enumera todos los objetos que son elementos primarios del control. No puede usar las marcas GC_WCH_FONLYAFTER o GC_WCH_FONLYBEFORE con esta marca.
GC_WCH_CONTAINED
0x00000003
 Enumera todos los objetos que son elementos secundarios del control. No puede usar las marcas GC_WCH_FONLYAFTER o GC_WCH_FONLYBEFORE con esta marca.
GC_WCH_ALL
0x00000004
 Enumera todos los objetos.
GC_WCH_FREVERSEDIR
0x08000000
 Enumera y organiza los controles en la dirección del orden de tabulación inverso. Esta marca se puede combinar con cualquier otra marca.
GC_WCH_FONLYAFTER
0x10000000
 Enumera todos los controles que aparecen después del control en el orden de tabulación.
GC_WCH_FONLYBEFORE
0x20000000
 Enumera todos los controles que aparecen antes del control en el orden de tabulación.
GC_WCH_FSELECTED
0x40000000
 Enumera todos los controles que están seleccionados actualmente.
 

Use una de las marcas GC_WCH_SIBLING, GC_WCH_CONTAINER, GC_WCH_CONTAINED o GC_WCH_ALL en combinación con cualquiera de las marcas GC_WCH_Fxxx .

En el código VBX, la marca GC_FORM se pasó a VBGetControl para obtener un puntero al formulario. En el código de control OLE, no hay ningún reemplazo directo para esta marca. En su lugar, pase GC_WHC_ALL a EnumControls y use el puntero al primer control de la enumeración. El primer control de la enumeración siempre es el formulario cuando se usa GC_WHC_ALL.

[out] ppenumUnk

Puntero a una enumeración de objetos OLE.

Valor devuelto

Este método admite los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY y E_UNEXPECTED, así como los siguientes:

Comentarios

Al migrar un control VBX a un control OLE, EnumControls reemplaza el VBGetControl de Visual Basic, que ya no se admite.

Requisitos

   
Plataforma de destino Windows
Encabezado vbinterf.h

Consulte también

IVBGetControl

OLECONTF