Функция 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz