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

Vedi anche

Informazioni concettuali

Finestre di dialogo

GetNextDlgTabItem

Riferimento