CWnd::GetNextDlgGroupItem

Статья
02/20/2013

Выполняет поиск предыдущего или следующего элемента управления в пределах группы в составе элементы управления в диалоговом окне.

CWnd* GetNextDlgGroupItem(
   CWnd* pWndCtl,
   BOOL bPrevious = FALSE 
) const;
COleControlSiteOrWnd* GetNextDlgGroupItem(
   COleControlSiteOrWnd *pCurSiteOrWnd = NULL
) const;

Параметры

pWndCtl
Указывает элемент управления, который следует использовать в качестве отправной точки для поиска.
bPrevious
Определяет, как функция поиска группу в составе элементы управления в диалоговом окне.Если TRUE функция выполняет поиск предыдущего элемента управления в группе; если FALSE, он выполняет поиск следующего элемента управления в группе.
pCurSiteOrWnd
Определяет элемент управления COleControlSiteOrWnd .Дополнительные сведения о COleControlSiteOrWnd см. в разделе Примечания.

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

Указатель к предыдущему или следующему элементу управления в группе если функция-член успешно.

Возвращенный указатель может быть временным и не должен сохранить для последующего использования.

Заметки

Группа элементов управления в составе начинается с элементом управления, который был создать с учетом WS_GROUP и заканчивается с последним элементом управления, который не был создан с учетом WS_GROUP.

По умолчанию функцию-член GetNextDlgGroupItem возвращает указатель к следующему элементу управления в группе.Если pWndCtl определяет первый элемент управления в группе и bPreviousTRUE, то GetNextDlgGroupItem возвращает указатель к последнему элементу управления в группе.

Примечание
Поскольку MFC поддерживают безоконные элементы управления ActiveX, стандартные элементы управления ActiveX и окна, обратившись к элементу управления HWND только больше не достаточно.Объект COleControlSiteOrWnd включает сведения, который идентифицирует объект как оконного элемента управления ActiveX, безоконное элемент управления ActiveX или окно, следующим образом:

Поскольку MFC поддерживают безоконные элементы управления ActiveX, стандартные элементы управления ActiveX и окна, обратившись к элементу управления HWND только больше не достаточно.Объект COleControlSiteOrWnd включает сведения, который идентифицирует объект как оконного элемента управления ActiveX, безоконное элемент управления ActiveX или окно, следующим образом:

Тип элемента управления или окна	Задание сведений
Оконного элемента управления ActiveX	Содержащее HWND и связывает объект COleControlSite с ним.Элемент m_hWndCOleControlSiteOrWnd ему присваивается HWND элемента управления и точкам элемента m_pSite к COleControlSite элемента управления.
Безоконное элемент управления ActiveX	Нет HWND.Элемент m_pSite точек COleControlSiteOrWnd к COleControlSite элемента управления и элемент m_hWnd NULL.
Стандартное окно	Содержит только HWND.Элемент m_hWndCOleControlSiteOrWnd ему присваивается HWND окна, и участник m_pSiteNULL.