GetNextDlgGroupItem

La funzione GetNextDlgGroupItem recupera l'handle del controllo primo in un gruppo di controlli che precede (o segue) il controllo specificato in una finestra di dialogo.

(HWND GetNextDlgGroupItem HWND  hDlg, / / handle di finestra di dialogoHWNDhCtl, / / handle del controlloBOOLbPrevious / / direzione bandiera);
 

Parametri

hDlg

Identifica la finestra di dialogo è cercato.

hCtl

Identifica il controllo da utilizzare come punto di partenza per la ricerca. Se questo parametro è NULL, la funzione utilizza il controllo ultimo (o primo) nella finestra di dialogo come punto di partenza per la ricerca.

bPrevious

Specifica come la funzione è alla ricerca del gruppo dei controlli nella finestra di dialogo. Se questo parametro è TRUE, la funzione cerca il precedente controllo del gruppo. Se è FALSE, la funzione Cerca per il controllo successivo nel gruppo.

Valori restituiti

Se GetNextDlgGroupItem ha esito positivo, il valore restituito è l'handle del controllo precedente (o successivo) nel gruppo di controlli.

Se la funzione ha esito negativo, il valore restituito è NULL. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

La funzione GetNextDlgGroupItem cerca controlli in ordine (o ordine inverso) sono stati creati nel modello di finestra di dialogo. Il primo controllo del gruppo deve avere lo stile WS_GROUP; tutti gli altri controlli nel gruppo è necessario che consecutivamente creati e deve non hanno lo stile WS_GROUP.

Durante la ricerca per il precedente controllo, la funzione restituisce il primo controllo localizza che è visibile e non disabili. Se il controllo dato da hCtl ha lo stile WS_GROUP, la funzione temporaneamente inverte la ricerca per individuare il primo controllo avendo lo stile WS_GROUP, poi riprende la ricerca nella direzione originale, restituendo il primo controllo che localizza che è visibile e non disabili o ritorno hwndCtrl se no tale controllo viene trovato.

Durante la ricerca per il controllo successivo, la funzione restituisce il primo controllo localizza che è visibile, non disattivato, e fa non hanno lo stile WS_GROUP. Se incontra un controllo avendo lo stile WS_GROUP, la funzione inverte la ricerca, individua il primo controllo avendo lo stile WS_GROUP e restituisce questo controllo se è visibile e non disabili. In caso contrario, la funzione riprende la ricerca nella direzione originale e restituisce il primo controllo localizza che è visibile e non disabili, o restituisce hCtl se questo controllo non viene trovato.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica di finestre di dialogo, finestra di dialogo casella funzioni, GetNextDlgTabItem

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index