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

Функция GetNextDlgGroupItem (winuser.h)

  • Статья

Извлекает дескриптор первого элемента управления в группе элементов управления, которые предшествуют указанному элементу управления в диалоговом окне или следуют за ней.

Синтаксис

HWND GetNextDlgGroupItem(
  [in]           HWND hDlg,
  [in, optional] HWND hCtl,
  [in]           BOOL bPrevious
);

Параметры

[in] hDlg

Тип: HWND

Дескриптор диалогового окна для поиска.

[in, optional] hCtl

Тип: HWND

Дескриптор элемента управления, который будет использоваться в качестве отправной точки для поиска. Если этот параметр имеет значение NULL, функция использует последний (или первый) элемент управления в диалоговом окне в качестве отправной точки для поиска.

[in] bPrevious

Тип: BOOL

Указывает, как функция выполняет поиск в группе элементов управления в диалоговом окне. Если этот параметр имеет значение TRUE, функция выполняет поиск предыдущего элемента управления в группе. Если имеет значение FALSE, функция выполняет поиск следующего элемента управления в группе.

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

Тип: HWND

Если функция выполняется успешно, возвращаемое значение является дескриптором для предыдущего (или следующего) элемента управления в группе элементов управления.

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Функция GetNextDlgGroupItem выполняет поиск элементов управления в порядке (или обратном порядке), который они были созданы в шаблоне диалогового окна. Первый элемент управления в группе должен иметь стиль WS_GROUP ; все остальные элементы управления в группе должны создаваться последовательно и не должны иметь WS_GROUP стиле.

При поиске предыдущего элемента управления функция возвращает первый элемент управления, который она находит, видимый и не отключенный. Если элемент управления, указанный в параметре hCtl , имеет стиль WS_GROUP , функция временно отменяет поиск, чтобы найти первый элемент управления со стилем WS_GROUP , а затем возобновляет поиск в исходном направлении, возвращая первый элемент управления, который он находит, который является видимым и не отключенным, или возвращает hCtl , если такой элемент управления не найден.

При поиске следующего элемента управления функция возвращает первый элемент управления, который она находит, является видимым, не отключенным и не имеет WS_GROUP стиля. Если обнаруживается элемент управления со стилем WS_GROUP , функция отменяет поиск, находит первый элемент управления со стилем WS_GROUP и возвращает этот элемент управления, если он виден и не отключен. В противном случае функция возобновляет поиск в исходном направлении и возвращает первый элемент управления, который она находит, видимый и не отключенный, или возвращает hCtl , если такой элемент управления не найден.

Если при поиске следующего элемента управления в группе обнаруживается окно со стилем WS_EX_CONTROLPARENT , система рекурсивно выполняет поиск дочерних элементов окна.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll

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

Основные понятия

Диалоговые окна

GetNextDlgTabItem

Справочные материалы