Metodo IVBGetControl::EnumControls (vbinterf.h)

Articolo
08/26/2023

Enumera i controlli nel modulo.

Nota L'uso di questo metodo non è più consigliato perché i contenitori diversi da Visual Basic non lo supportano.

Sintassi

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

Parametri

[in] dwOleContF

Specifica il tipo di oggetti OLE da enumerare. Questo parametro può essere uno dei valori seguenti enumerati dall'enumerazione OLECONTF .

valore	Significato
OLECONTF_EMBEDDINGS	Enumera gli oggetti incorporati nel modulo. Includere questo flag per enumerare i controlli OLE.
OLECONTF_LINKS	Enumera gli oggetti collegati nel modulo.
OLECONTF_OTHER	Enumera tutti gli oggetti pseudo OLE. Includere questo flag per enumerare i controlli VBX.
OLECONTF_ONLYUSER	Enumera solo gli oggetti di cui l'utente è a conoscenza.
OLECONTF_ONLYIFRUNNING	Enumera solo gli oggetti in esecuzione nel modulo.

Quando enumera i controlli OLE, è consigliabile combinare i flag OLECONTF_ONLYUSER, OLECONTF_ONLYIFRUNNING e OLECONTF_EMBEDDINGS. Per includere entrambi i controlli OLE e i controlli VBX, aggiungere il flag di OLECONTF_OTHERS a questo elenco. Per enumerare solo i controlli VBX, rimuovere il flag di OLECONTF_EMBEDDINGS e includere il flag di OLECONTF_OTHERS .

[in] dwWhich

Specifica il set di controlli da enumerare. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
GCW_WCH_SIBLING 0x00000001	Enumera tutti i fratelli del controllo.
GC_WCH_CONTAINER 0x00000002	Enumera tutti gli oggetti padre del controllo. Non è possibile usare i flag GC_WCH_FONLYAFTER o GC_WCH_FONLYBEFORE con questo flag.
GC_WCH_CONTAINED 0x00000003	Enumera tutti gli oggetti figlio del controllo. Non è possibile usare i flag GC_WCH_FONLYAFTER o GC_WCH_FONLYBEFORE con questo flag.
GC_WCH_ALL 0x00000004	Enumera tutti gli oggetti.
GC_WCH_FREVERSEDIR 0x08000000	Enumera e organizza i controlli nella direzione dell'ordine di tabulazione inversa. Questo flag può essere combinato con qualsiasi altro flag.
GC_WCH_FONLYAFTER 0x10000000	Enumera tutti i controlli visualizzati dopo il controllo nell'ordine di tabulazioni.
GC_WCH_FONLYBEFORE 0x20000000	Enumera tutti i controlli visualizzati prima del controllo nell'ordine di tabulazioni.
GC_WCH_FSELECTED 0x40000000	Enumera tutti i controlli attualmente selezionati.

Usare uno dei flag GC_WCH_SIBLING, GC_WCH_CONTAINER, GC_WCH_CONTAINED o GC_WCH_ALL in combinazione con uno dei flag GC_WCH_Fxxx.

Nel codice VBX il flag di GC_FORM è stato passato a VBGetControl per ottenere un puntatore al modulo. Nel codice di controllo OLE non è disponibile alcuna sostituzione diretta per questo flag. Passare invece GC_WHC_ALL a EnumControls e usare il puntatore al primo controllo nell'enumerazione. Il primo controllo nell'enumerazione è sempre il modulo quando si usa GC_WHC_ALL.

[out] ppenumUnk

Puntatore a un'enumerazione di oggetti OLE.

Valore restituito

Questo metodo supporta i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, nonché i seguenti:

Commenti

Quando si esegue la migrazione di un controllo VBX a un controllo OLE, EnumControls sostituisce Visual Basic VBGetControl, che non è più supportato.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	vbinterf.h

Vedi anche

IVBGetControl

OLECONTF

Condividi tramite