Macro GetNextWindow (winuser.h)

Articolo
11/20/2024

Recupera un handle nella finestra successiva o precedente nel ordine Z. La finestra successiva è sotto la finestra specificata; la finestra precedente è sopra.

Se la finestra specificata è una finestra superiore, la funzione cerca una finestra superiore. Se la finestra specificata è una finestra di primo livello, la funzione cerca una finestra di primo livello. Se la finestra specificata è una finestra figlio, la funzione cerca una finestra figlio.

Sintassi

void GetNextWindow(
  [in]  hWnd,
  [in]  wCmd
);

Parametri

[in] hWnd

Tipo: HWND

Handle di una finestra. L'handle di finestra recuperato è relativo a questa finestra, in base al valore del parametro wCmd.

[in] wCmd

Tipo: UINT

Indica se la funzione restituisce un handle alla finestra successiva o alla finestra precedente. Questo parametro può essere uno dei valori seguenti.

Valore	Significato
GW_HWNDNEXT 2	Restituisce un handle alla finestra sotto la finestra specificata.
GW_HWNDPREV 3	Restituisce un handle alla finestra sopra la finestra specificata.

Valore restituito

Tipo: HWND

Se la funzione ha esito positivo, il valore restituito è un handle di finestra. Se non esiste alcuna finestra con la relazione specificata con la finestra specificata, il valore restituito è NULL. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Questa funzione viene implementata come chiamata alla funzione GetWindow.

#define GetNextWindow(hWnd, wCmd) GetWindow(hWnd, wCmd)

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)

Vedere anche

concettuale

GetTopWindow

GetWindow

riferimento

Windows

Condividi tramite