IVBGetControl::EnumControls 메서드(vbinterf.h)

폼의 컨트롤을 열거합니다.

참고 Visual Basic 이외의 컨테이너는 이 메서드를 지원하지 않으므로 이 메서드를 더 이상 사용하지 않는 것이 좋습니다.

 

구문

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

매개 변수

[in] dwOleContF

열거할 OLE 개체의 형식을 지정합니다. 이 매개 변수는 OLECONTF 열거형으로 열거된 다음 값 중 하나일 수 있습니다.

값	의미
OLECONTF_EMBEDDINGS	폼에 포함된 개체를 열거합니다. OLE 컨트롤을 열거하려면 이 플래그를 포함합니다.
OLECONTF_LINKS	양식에서 연결된 개체를 열거합니다.
OLECONTF_OTHER	모든 의사 OLE 개체를 열거합니다. VBX 컨트롤을 열거하려면 이 플래그를 포함합니다.
OLECONTF_ONLYUSER	사용자가 알고 있는 개체만 열거합니다.
OLECONTF_ONLYIFRUNNING	폼에서 실행 중인 개체만 열거합니다.

 

OLE 컨트롤을 열거할 때 플래그 OLECONTF_ONLYUSER, OLECONTF_ONLYIFRUNNING 및 OLECONTF_EMBEDDINGS 결합하는 것이 좋습니다. OLE 컨트롤과 VBX 컨트롤을 모두 포함하려면 이 목록에 OLECONTF_OTHERS 플래그를 추가합니다. VBX 컨트롤만 열거하려면 OLECONTF_EMBEDDINGS 플래그를 제거하고 OLECONTF_OTHERS 플래그를 포함합니다.

[in] dwWhich

열거할 컨트롤 집합을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
GCW_WCH_SIBLING 0x00000001	컨트롤의 모든 형제를 열거합니다.
GC_WCH_CONTAINER 0x00000002	컨트롤의 부모인 모든 개체를 열거합니다. 이 플래그에는 GC_WCH_FONLYAFTER 또는 GC_WCH_FONLYBEFORE 플래그를 사용할 수 없습니다.
GC_WCH_CONTAINED 0x00000003	컨트롤의 자식 개체인 모든 개체를 열거합니다. 이 플래그에는 GC_WCH_FONLYAFTER 또는 GC_WCH_FONLYBEFORE 플래그를 사용할 수 없습니다.
GC_WCH_ALL 0x00000004	모든 개체를 열거합니다.
GC_WCH_FREVERSEDIR 0x08000000	컨트롤을 역방향 탭 순서 방향으로 열거하고 구성합니다. 이 플래그는 다른 플래그와 결합할 수 있습니다.
GC_WCH_FONLYAFTER 0x10000000	탭 순서에서 컨트롤 다음에 표시되는 모든 컨트롤을 열거합니다.
GC_WCH_FONLYBEFORE 0x20000000	탭 순서에서 컨트롤 앞에 표시되는 모든 컨트롤을 열거합니다.
GC_WCH_FSELECTED 0x40000000	현재 선택된 모든 컨트롤을 열거합니다.

 

GC_WCH_Fxxx 플래그와 함께 플래그 GC_WCH_SIBLING, GC_WCH_CONTAINER, GC_WCH_CONTAINED 또는 GC_WCH_ALL 중 하나를 사용합니다.

VBX 코드에서 GC_FORM 플래그가 VBGetControl 에 전달되어 양식에 대한 포인터를 가져옵니다. OLE 컨트롤 코드에서는 이 플래그를 직접 대체할 수 없습니다. 대신 GC_WHC_ALLEnumControls 에 전달하고 열거형의 첫 번째 컨트롤에 대한 포인터를 사용합니다. 열거형의 첫 번째 컨트롤은 GC_WHC_ALL 사용할 때 항상 폼입니다.

[out] ppenumUnk

OLE 개체의 열거형에 대한 포인터입니다.

반환 값

이 메서드는 E_INVALIDARG, E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값과 다음을 지원합니다.

설명

VBX 컨트롤을 OLE 컨트롤로 마이그레이션할 때 EnumControls 는 더 이상 지원되지 않는 Visual Basic VBGetControl을 대체합니다.

요구 사항

대상 플랫폼	Windows
헤더	vbinterf.h

추가 정보

IVBGetControl

OLECONTF