Compartilhar via


Macro GetNextWindow (winuser.h)

Recupera um identificador para a próxima janela ou anterior no Z-Order. A próxima janela está abaixo da janela especificada; a janela anterior está acima.

Se a janela especificada for uma janela superior, a função procurará uma janela superior. Se a janela especificada for uma janela de nível superior, a função procurará uma janela de nível superior. Se a janela especificada for uma janela filho, a função procurará uma janela filho.

Sintaxe

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

Parâmetros

[in] hWnd

Tipo: HWND

Um identificador para uma janela. O identificador de janela recuperado é relativo a essa janela, com base no valor do parâmetro wCmd .

[in] wCmd

Tipo: UINT

Indica se a função retorna um identificador para a próxima janela ou a janela anterior. Esse parâmetro pode ser um dos valores a seguir.

Valor Significado
GW_HWNDNEXT
2
Retorna um identificador para a janela abaixo da janela fornecida.
GW_HWNDPREV
3
Retorna um identificador para a janela acima da janela fornecida.

Valor de retorno

Tipo: HWND

Se a função for bem-sucedida, o valor retornado será um identificador de janela. Se nenhuma janela existir com a relação especificada com a janela especificada, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Observações

Essa função é implementada como uma chamada para a função GetWindow.

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho winuser.h (inclua Windows.h)

Consulte também

Conceitual

GetTopWindow

GetWindow

de referência de

Windows