Funzione GetNextDlgGroupItem (winuser.h)
Recupera un handle al primo controllo in un gruppo di controlli che precede (o segue) il controllo specificato in una finestra di dialogo.
Sintassi
HWND GetNextDlgGroupItem(
[in] HWND hDlg,
[in, optional] HWND hCtl,
[in] BOOL bPrevious
);
Parametri
[in] hDlg
Tipo: HWND
Handle per la finestra di dialogo in cui eseguire la ricerca.
[in, optional] hCtl
Tipo: HWND
Handle per il controllo da utilizzare come punto di partenza per la ricerca. Se questo parametro è NULL, la funzione usa l'ultimo controllo (o primo) nella finestra di dialogo come punto iniziale per la ricerca.
[in] bPrevious
Tipo: BOOL
Indica la modalità di ricerca del gruppo di controlli nella finestra di dialogo. Se questo parametro è TRUE, la funzione cerca il controllo precedente nel gruppo. Se è FALSE, la funzione cerca il controllo successivo nel gruppo.
Valore restituito
Tipo: HWND
Se la funzione ha esito positivo, il valore restituito è un handle per il controllo precedente (o successivo) nel gruppo di controlli.
Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
La funzione GetNextDlgGroupItem cerca i controlli nell'ordine (o nell'ordine inverso) creati nel modello della finestra di dialogo. Il primo controllo nel gruppo deve avere lo stile WS_GROUP ; tutti gli altri controlli del gruppo devono essere stati creati consecutivamente e non devono avere lo stile WS_GROUP .
Quando si cerca il controllo precedente, la funzione restituisce il primo controllo individuato che è visibile e non disabilitato. Se il controllo specificato da hCtl ha lo stile WS_GROUP , la funzione inverte temporaneamente la ricerca per individuare il primo controllo con lo stile WS_GROUP , quindi riprende la ricerca nella direzione originale, restituendo il primo controllo individuato che è visibile e non disabilitato oppure restituendo hCtl se non viene trovato alcun controllo.
Quando si cerca il controllo successivo, la funzione restituisce il primo controllo individuato che è visibile, non disabilitato e non ha lo stile WS_GROUP . Se rileva un controllo con lo stile WS_GROUP , la funzione inverte la ricerca, individua il primo controllo con lo stile WS_GROUP e restituisce questo controllo se è visibile e non disabilitato. In caso contrario, la funzione riprende la ricerca nella direzione originale e restituisce il primo controllo individuato che è visibile e non disabilitato oppure restituisce hCtl se non viene trovato alcun controllo di questo tipo.
Se la ricerca del controllo successivo nel gruppo rileva una finestra con lo stile WS_EX_CONTROLPARENT , il sistema cerca in modo ricorsivo gli elementi figlio della finestra.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib |
| DLL | User32.dll |
Vedi anche
Informazioni concettuali
Riferimento