Share via


Função IsWindowArranged (winuser.h)

Importante

Algumas informações estão relacionadas a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Determina se uma janela está organizada.

Sintaxe

BOOL IsWindowArranged(
  HWND hwnd
);

Parâmetros

hwnd

Digite: HWND

Um identificador para a janela a ser testada.

Retornar valor

Tipo: BOOL

Um valor diferente de zero se a janela estiver organizada; caso contrário, zero.

Comentários

Dica

No momento, essa função não tem um arquivo de cabeçalho ou arquivo de biblioteca associado. Seu aplicativo pode chamar LoadLibrary com o nome DLL (User32.dll) para obter um identificador de módulo. Em seguida, ele pode chamar GetProcAddress com o identificador do módulo e o nome dessa função para obter o endereço da função.

Uma janela ajustada (consulte Ajustar suas janelas) é considerada organizada. Você deve tratar organizado como um estado de janela semelhante ao maximizado. Organizados, maximizados e minimizados são estados mutuamente exclusivos. Uma janela organizada pode ser restaurada para seu tamanho e posição originais. Restaurar uma janela de minimizada pode organizar uma janela se a janela foi organizada antes de ser minimizada. Ao chamar GetWindowPlacement, tenha em mente que o membro showCmd no WINDOWPLACEMENT retornado pode ter um valor de SW_SHOWNORMAL mesmo que a janela esteja organizada.

Exemplo

// Check whether the window is in the restored state.
BOOL IsRestored(HWND hwnd)
{
  if (IsIconic(hwnd) || IsZoomed(hwnd) || IsWindowArranged(hwnd))
  {
    return false;
  }
  return true;
}

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1903
Cabeçalho winuser.h
Biblioteca User32.lib
DLL User32.dll

Confira também