Função CreateMDIWindowA (winuser.h)

Artigo
03/13/2024

Cria uma janela filho MDI (interface de vários documentos).

Sintaxe

HWND CreateMDIWindowA(
  [in]           LPCSTR    lpClassName,
  [in]           LPCSTR    lpWindowName,
  [in]           DWORD     dwStyle,
  [in]           int       X,
  [in]           int       Y,
  [in]           int       nWidth,
  [in]           int       nHeight,
  [in, optional] HWND      hWndParent,
  [in, optional] HINSTANCE hInstance,
  [in]           LPARAM    lParam
);

Parâmetros

[in] lpClassName

Tipo: LPCTSTR

A classe de janela da janela filho MDI. O nome da classe deve ter sido registrado por uma chamada para a função RegisterClassEx .

[in] lpWindowName

Tipo: LPCTSTR

O nome da janela. O sistema exibe o nome na barra de título da janela filho.

[in] dwStyle

Tipo: DWORD

O estilo da janela filho MDI. Se a janela do cliente MDI for criada com o estilo de janela MDIS_ALLCHILDSTYLES , esse parâmetro poderá ser qualquer combinação dos estilos de janela listados na página Estilos de Janela . Caso contrário, esse parâmetro será limitado a um ou mais dos valores a seguir.

Valor	Significado
WS_MINIMIZE 0x20000000L	Cria uma janela filho MDI inicialmente minimizada.
WS_MAXIMIZE 0x01000000L	Cria uma janela filho MDI que é maximizada inicialmente.
WS_HSCROLL 0x00100000L	Cria uma janela filho MDI que tem uma barra de rolagem horizontal.
WS_VSCROLL 0x00200000L	Cria uma janela filho MDI que tem uma barra de rolagem vertical.

[in] X

Tipo: int

A posição horizontal inicial, nas coordenadas do cliente, da janela filho MDI. Se esse parâmetro for CW_USEDEFAULT ((int)0x80000000), a janela filho MDI será atribuída à posição horizontal padrão.

[in] Y

Tipo: int

A posição vertical inicial, nas coordenadas do cliente, da janela filho MDI. Se esse parâmetro for CW_USEDEFAULT, a janela filho MDI será atribuída à posição vertical padrão.

[in] nWidth

Tipo: int

A largura inicial, em unidades de dispositivo, da janela filho MDI. Se esse parâmetro for CW_USEDEFAULT, a janela filho MDI será atribuída à largura padrão.

[in] nHeight

Tipo: int

A altura inicial, em unidades de dispositivo, da janela filho MDI. Se esse parâmetro for definido como CW_USEDEFAULT, a janela filho MDI será atribuída à altura padrão.

[in, optional] hWndParent

Digite: HWND

Um identificador para a janela do cliente MDI que será o pai da nova janela filho MDI.

[in, optional] hInstance

Tipo: HINSTANCE

Um identificador para a instância do aplicativo que cria a janela filho MDI.

[in] lParam

Tipo: LPARAM

Um valor definido pelo aplicativo.

Retornar valor

Digite: HWND

Se a função for bem-sucedida, o valor retornado será o identificador para a janela criada.

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

Comentários

Observação

O cabeçalho winuser.h define CreateMDIWindow como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
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