Функция 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 |
См. также раздел
Основные понятия
Справочные материалы