Win32 API. Справочник по диалоговому окну
Страница 18. Функция GetNextDlgGroupItem


Функция GetNextDlgGroupItem

(ПолучитьЭлементСледующейГруппыДиалога)

Функция GetNextDlgGroupItem извлекает дескриптор первого органа управления в группе элементов управления, которая предшествует (или следует за) заданному органу управления в диалоговом окне.

Синтаксис

HWND GetNextDlgGroupItem
(
HWND hDlg,// дескриптор диалогового окна
HWND hCtl,// дескриптор элемента управления
BOOL bPrevious // флажок направления
);

Параметры
hDlg
Идентифицирует диалоговое окно, где производится поиск.
hCtl
Идентифицирует орган управления, который будет использован как начальная точка для поиска. Если этот параметр является значением ПУСТО (NULL), функция использует последний (или первый) элемент управления диалогового окна как отправной пункт для поиска.
bPrevious
Определяет, как функция должна искать группу органов управления в диалоговом окне. Если этот параметр - ИСТИНА (TRUE), функция осуществляет поиск от предыдущего элемента управления в группе. Если он - ЛОЖЬ(FALSE), функция осуществляет поиск от следующего органа управления в группе.

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

Замечания
Функция GetNextDlgGroupItem ищет органы управления по порядку (или в обратном порядке), как они были созданы в шаблоне диалогового окна. Первый элемент управления в группе должен иметь стиль WS_GROUP; все другие органы управления в группе, должны быть созданы последовательно за ним и не должны иметь стиля WS_GROUP.
Когда найден предыдущий элемент управления, функция возвращает значение первого, обнаруженного ею органа управления, который является видимым и не заблокированным. Если элемент управления, заданный параметром hCtl имеет стиль WS_GROUP, функция временно изменяет направление поиска, чтобы обнаружить первый орган управления, имеющий WS_GROUP стиль, затем продолжает поиск в первоначальном направлении, возвращая значение обнаруженного ею первого элемента управления, который является видимым и не заблокированным, или возвращает значение hwndCtrl если такой элемент управления не найден.
Когда найден следующий элемент управления, функция возвращает значение первого обнаруженного ею органа управления, который является видимым и не заблокированным, но не имеет стиля WS_GROUP. Если она обнаруживает элементом управления, имеющий стиль WS_GROUP, функция изменяет направление поиска, обнаруживает первый орган управления, имеющий стиль WS_GROUP и возвращает значение этого элемента управления, если он видим и не заблокирован. Иначе, функция возобновляет поиск в первоначальном направлении и возвращает значение обнаруженного ею первого элемента управления, который является видимым и не заблокированным, или возвращает значение hCtl, если такой орган управления не найден.

Смотри также
GetNextDlgTabItem

Размещение и совместимость GetNextDlgGroupItem

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотекаuser32.lib
Заголовочный файлwinuser.h
UnicodeНет
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »