GetNextDlgGroupItem

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

() HWND GetNextDlgGroupItem HWND  hDlg, / / обработать диалогового окнаHWNDhCtl, / / обработки элемента управленияBOOLbPrevious / / направление флага);
 

Параметры

hDlg
Идентифицирует диалогового окна Поиск.
hCtl
Идентифицирует элемент управления для использования в качестве отправной точки для поиска. Если этот параметр имеет значение NULL, функция использует последний (или первый) управления в диалоговом окне в качестве отправной точки для поиска.
bPrevious
Определяет, как для поиска группы элементов управления в диалоговом окне функции. Если этот параметр имеет значение TRUE, функция ищет предыдущего элемента управления в группе. Если оно имеет значение ложь, функция ищет следующий элемент управления в группе.

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

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

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

Примечания

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

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

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

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Использование user32.lib.

Родственные слова

Обзор полей диалогового окна, диалогового окна функций, GetNextDlgTabItem

Index