Função CascadeWindows (winuser.h)

  • Artigo

Propaga as janelas filho especificadas da janela pai especificada.

Sintaxe

WORD CascadeWindows(
  [in, optional] HWND       hwndParent,
  [in]           UINT       wHow,
  [in, optional] const RECT *lpRect,
  [in]           UINT       cKids,
  [in, optional] const HWND *lpKids
);

Parâmetros

[in, optional] hwndParent

Digite: HWND

Um identificador para a janela pai. Se esse parâmetro for NULL, a janela da área de trabalho será assumida.

[in] wHow

Tipo: UINT

Um sinalizador em cascata. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
MDITILE_SKIPDISABLED
0x0002
 Impede que janelas filho MDI desabilitadas sejam colocadas em cascata.
MDITILE_ZORDER
0x0004
 Organiza as janelas na ordem Z. Se esse valor não for especificado, as janelas serão organizadas usando a ordem especificada na matriz lpKids .

[in, optional] lpRect

Tipo: const RECT*

Um ponteiro para uma estrutura que especifica a área retangular, nas coordenadas do cliente, na qual as janelas são organizadas. Esse parâmetro pode ser NULL, caso em que a área do cliente da janela pai é usada.

[in] cKids

Tipo: UINT

O número de elementos na matriz especificada pelo parâmetro lpKids . Esse parâmetro será ignorado se lpKids for NULL.

[in, optional] lpKids

Tipo: const HWND*

Uma matriz de identificadores para as janelas filho a serem organizadas. Se uma janela filho especificada for uma janela de nível superior com o estilo WS_EX_TOPMOST ou WS_EX_TOOLWINDOW, a janela filho não será organizada. Se esse parâmetro for NULL, todas as janelas filho da janela pai especificada (ou da janela da área de trabalho) serão organizadas.

Valor retornado

Tipo: WORD

Se a função for bem-sucedida, o valor retornado será o número de janelas organizadas.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Por padrão, CascadeWindows organiza as janelas na ordem fornecida pela matriz lpKids , mas preserva a Ordem Z. Se você especificar o sinalizador MDITILE_ZORDER , CascadeWindows organizará as janelas na ordem Z.

Chamar CascadeWindows faz com que todas as janelas maximizadas sejam restauradas para o tamanho anterior.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll

Confira também

Visão geral do Windows