Поделиться через

Метод 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_SIBLING, GC_WCH_CONTAINER, GC_WCH_CONTAINED или GC_WCH_ALL в сочетании с любым из флагов GC_WCH_Fxxx .

В коде VBX флаг GC_FORM был передан в VBGetControl для получения указателя на форму. В коде элемента управления OLE нет прямой замены этого флага. Вместо этого передайте GC_WHC_ALL в EnumControls и используйте указатель на первый элемент управления в перечислении . Первый элемент управления в перечислении всегда является формой при использовании GC_WHC_ALL.

[out] ppenumUnk

Указатель на перечисление объектов OLE.

Возвращаемое значение

Этот метод поддерживает стандартные возвращаемые значения E_INVALIDARG, E_OUTOFMEMORY и E_UNEXPECTED, а также следующие:

Комментарии

При переносе элемента управления VBX в элемент управления OLE EnumControls заменяет visual Basic VBGetControl, который больше не поддерживается.

Требования

   
Целевая платформа Windows
Header vbinterf.h

См. также раздел

IVBGetControl

OLECONTF