Функция
GetNextDlgGroupItemФункция GetNextDlgGroupItem извлекает дескриптор первого органа управления в группе органов управления, которая предшествует (или следует за) заданному органу управления в диалоговом окне.
Синтаксис
HWND GetNextDlgGroupItem( HWND hDlg, HWND hCtl, BOOL bPrevious ); |
Параметры
hDlg
[in] Дескриптор диалогового окна, где производится поиск.
hCtl
[in] Дескриптор органа управления, который будет использован как начальная точка для поиска. Если этот параметр является значением ПУСТО (NULL), функция использует последний (или первый) орган управления диалогового окна как отправной пункт для поиска.
bPrevious
[in] Определяет, как функция должна искать группу органов управления в диалоговом окне. Если этот параметр - ИСТИНА (TRUE), функция осуществляет поиск от предыдущего органа управления в группе. Если он - ЛОЖЬ(FALSE), функция осуществляет поиск от следующего органа управления в группе.
Возвращаемое значение
Если GetNextDlgGroupItem завершается успешно, возвращаемое значение - дескриптор предыдущего (или следующего) органа управления в группе органов управления.
Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Функция GetNextDlgGroupItem ищет органы управления по порядку (или в обратном порядке), как они были созданы в шаблоне диалогового окна. Первый орган управления в группе должен иметь стиль
WS_GROUP; все другие органы управления в группе, должны быть созданы последовательно за ним и не должны иметь стиля WS_GROUP.Когда найден предыдущий орган управления, функция возвращает значение первого обнаруженного ею органа управления, который является видимым и не заблокированным. Если орган управления, определяемый параметром hCtl имеет стиль WS_GROUP, функция временно изменяет направление поиска, чтобы обнаружить первый орган управления, имеющий стиль WS_GROUP, затем продолжает поиск в первоначальном направлении, возвращая значение обнаруженного ею первого органа управления, который является видимым и не заблокированным, или возвращает значение hCtrl если такой орган управления не найден.
Когда найден следующий орган управления, функция возвращает значение первого обнаруженного ею органа управления, который является видимым и не заблокированным, но не имеет стиля WS_GROUP.
Если она обнаруживает орган управления, имеющий стиль WS_GROUP, функция изменяет направление поиска, обнаруживает первый орган управления, имеющий стиль WS_GROUP и возвращает значение этого элемента управления, если он видим и не заблокирован. Иначе, функция возобновляет поиск в первоначальном направлении и возвращает значение обнаруженного ею первого органа управления, который является видимым и не заблокированным, или возвращает значение hCtl, если такой орган управления не найден.Если поиск следующего органа управления в группе встречает окно со стилем WS_EX_CONTROLPARENT, система рекурсивно ищет потомков окна.
Смотри также
Обзор Диалоговые окна, Функции, используемые диалоговыми окнами, GetNextDlgTabItem
|
Размещение и совместимость GetNextDlgGroupItem |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |