Funzione GetNextDlgTabItem (winuser.h)

Recupera un handle al primo controllo con lo stile WS_TABSTOP che precede (o segue) il controllo specificato.

Sintassi

HWND GetNextDlgTabItem(
  [in]           HWND hDlg,
  [in, optional] HWND hCtl,
  [in]           BOOL bPrevious
);

Parametri

[in] hDlg

Tipo: HWND

Handle della finestra di dialogo da cercare.

[in, optional] hCtl

Tipo: HWND

Handle per il controllo da usare come punto iniziale per la ricerca. Se questo parametro è NULL, la funzione ha esito negativo.

[in] bPrevious

Tipo: BOOL

Indica come la funzione consiste nel cercare la finestra di dialogo. Se questo parametro è TRUE, la funzione cerca il controllo precedente nella finestra di dialogo. Se questo parametro è FALSE, la funzione cerca il controllo successivo nella finestra di dialogo.

Valore restituito

Tipo: HWND

Se la funzione ha esito positivo, il valore restituito è l'handle della finestra del controllo precedente (o successivo) con il set di stili WS_TABSTOP .

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione GetNextDlgTabItem cerca i controlli nell'ordine (o nell'ordine inverso) creati nel modello della finestra di dialogo. La funzione restituisce il primo controllo che individua che è visibile, non disabilitato e ha lo stile WS_TABSTOP . Se non esiste alcun controllo di questo tipo, la funzione restituisce hCtl.

Se la ricerca del controllo successivo con lo stile WS_TABSTOP rileva una finestra con lo stile WS_EX_CONTROLPARENT , il sistema esegue ricerche ricorsive nei figli della finestra.

Requisiti

Vedi anche

Informazioni concettuali

Finestre di dialogo

GetDlgItem

GetNextDlgGroupItem

Riferimento