GetNextDlgGroupItem

Funkcja GetNextDlgGroupItem pobiera uchwyt pierwszego formantu w grupie Formanty, która poprzedza (lub zgodny) kontroli określonej w oknie dialogowym.

(HWND GetNextDlgGroupItem HWND  hDlg, / / uchwyt okna dialogowegoHWNDhCtl, / / obsługi sterowaniaBOOLbPoprzednie / / kierunku Flaga);
 

Parametry

hDlg

Identyfikuje okno dialogowe przeszukiwanych.

hCtl

Identyfikuje formant służyć za punkt wyjścia dla wyszukiwania. Jeśli ten parametr ma wartość NULL, funkcja używa formantu ostatni (lub pierwszego) w oknie dialogowym jako punktu wyjścia dla wyszukiwania.

bPoprzednie

Określa, jak funkcja ma wyszukiwać grupy formantów w oknie dialogowym. Jeśli ten parametr ma wartość PRAWDA, funkcja wyszukiwania poprzedniego formantu w grupie. Jeżeli ma wartość FAŁSZ, funkcja wyszukuje następny formant w grupie.

Zwraca wartości

Jeśli GetNextDlgGroupItem się powiedzie, wartość zwracany jest uchwyt sterowania poprzedniego (lub następny) w grupie Formanty.

Jeśli funkcja zawiedzie, wartość zwracana jest wartość NULL. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Funkcja GetNextDlgGroupItem przeszukuje formantów w kolejności (lub odwrotnej kolejności), które zostały utworzone w szablonie pole dialogowe. Pierwszy formant w grupie musi mieć styl WS_GROUP; wszystkie inne formanty w grupie należy kolejno utworzone i muszą nie mieć styl WS_GROUP.

Podczas wyszukiwania poprzedniego formantu, funkcja zwraca pierwszy formant, który zlokalizuje widoczny i nie wyłączone. Jeśli kontrola przez hCtl zostało zapisane w stylu WS_GROUP, funkcja tymczasowo odwraca Szukaj, aby zlokalizować na pierwszy formant o stylu WS_GROUP, następnie wznawia wyszukiwanie w kierunku oryginalnego, powrocie pierwszego formantu zlokalizuje jest widoczny i nie niepełnosprawnych lub zwracanie hwndCtrl jeśli nie znajdzie takiej kontroli.

Podczas wyszukiwania następnego formantu, funkcja zwraca pierwszy formant zlokalizuje, które jest widoczne, nie wyłączona, i jest nie mieć styl WS_GROUP. Jeśli napotka formant o stylu WS_GROUP, funkcja odwraca wyszukiwania, lokalizuje pierwszy formant o stylu WS_GROUP i zwraca ten formant, jeśli jest widoczny i nie niepełnosprawnych. W przeciwnym wypadku funkcja wznawia wyszukiwanie w kierunku oryginalnego i zwraca pierwszy formant, który zlokalizuje jest widoczny i nie niepełnosprawnych lub zwraca hCtl , jeśli stwierdzono brak takich kontroli.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Omówienie pola dialogowego, okno dialogowe pole funkcji, GetNextDlgTabItem

Index