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

  • Artigo

Enumera os controles no formulário.

Nota O uso desse método não é mais recomendado porque contêineres diferentes do Visual Basic não dão suporte a ele.
 

Sintaxe

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

Parâmetros

[in] dwOleContF

Especifica o tipo de objetos OLE a serem enumerados. Esse parâmetro pode ser um dos seguintes valores enumerados pela enumeração OLECONTF .

Valor Significado
OLECONTF_EMBEDDINGS
 Enumera os objetos inseridos no formulário. Inclua esse sinalizador para enumerar controles OLE.
OLECONTF_LINKS
 Enumera os objetos vinculados no formulário.
OLECONTF_OTHER
 Enumera todos os objetos pseudo OLE. Inclua esse sinalizador para enumerar controles VBX.
OLECONTF_ONLYUSER
 Enumera apenas objetos dos quais o usuário está ciente.
OLECONTF_ONLYIFRUNNING
 Enumera apenas os objetos que estão em execução no formulário.
 

Ao enumerar controles OLE, é recomendável combinar os sinalizadores OLECONTF_ONLYUSER, OLECONTF_ONLYIFRUNNING e OLECONTF_EMBEDDINGS. Para incluir controles OLE e controles VBX, adicione o sinalizador OLECONTF_OTHERS a essa lista. Para enumerar apenas controles VBX, remova o sinalizador OLECONTF_EMBEDDINGS e inclua o sinalizador OLECONTF_OTHERS .

[in] dwWhich

Especifica o conjunto de controles a serem enumerados. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
GCW_WCH_SIBLING
0x00000001
 Enumera todos os irmãos do controle.
GC_WCH_CONTAINER
0x00000002
 Enumera todos os objetos que são pais de seu controle. Não é possível usar os sinalizadores GC_WCH_FONLYAFTER ou GC_WCH_FONLYBEFORE com esse sinalizador.
GC_WCH_CONTAINED
0x00000003
 Enumera todos os objetos que são filhos do seu controle. Não é possível usar os sinalizadores GC_WCH_FONLYAFTER ou GC_WCH_FONLYBEFORE com esse sinalizador.
GC_WCH_ALL
0x00000004
 Enumera todos os objetos.
GC_WCH_FREVERSEDIR
0x08000000
 Enumera e organiza controles na direção da ordem de tabulação inversa. Esse sinalizador pode ser combinado com qualquer outro sinalizador.
GC_WCH_FONLYAFTER
0x10000000
 Enumera todos os controles que aparecem após o controle na ordem de tabulação.
GC_WCH_FONLYBEFORE
0x20000000
 Enumera todos os controles que aparecem antes do controle na ordem de tabulação.
GC_WCH_FSELECTED
0x40000000
 Enumera todos os controles que estão selecionados no momento.
 

Use um dos sinalizadores GC_WCH_SIBLING, GC_WCH_CONTAINER, GC_WCH_CONTAINED ou GC_WCH_ALL em combinação com qualquer um dos sinalizadoresxxx GC_WCH_F.

No código VBX, o sinalizador GC_FORM foi passado para VBGetControl para obter um ponteiro para o formulário. No código de controle OLE, não há substituição direta para esse sinalizador. Em vez disso, passe GC_WHC_ALL para EnumControls e use o ponteiro para o primeiro controle na enumeração. O primeiro controle na enumeração é sempre o formulário ao usar GC_WHC_ALL.

[out] ppenumUnk

Ponteiro para uma enumeração de objetos OLE.

Valor retornado

Esse método dá suporte aos valores retornados padrão E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, bem como os seguintes:

Comentários

Ao migrar um controle VBX para um controle OLE, enumControls substitui o VBGetControl do Visual Basic, que não tem mais suporte.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho vbinterf.h

Confira também

IVBGetControl

OLECONTF