Compartilhar via

Função CreateMDIWindowW (winuser.h)

  • Artigo

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

Sintaxe

HWND CreateMDIWindowW(
  [in]           LPCWSTR   lpClassName,
  [in]           LPCWSTR   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 do 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 do 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 que é 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 do MDI. Se esse parâmetro for CW_USEDEFAULT ((int)0x80000000), a janela filho do 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 do 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 do MDI será atribuída à largura padrão.

[in] nHeight

Tipo: int

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

[in, optional] hWndParent

Tipo: HWND

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

[in, optional] hInstance

Tipo: HINSTANCE

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

[in] lParam

Tipo: LPARAM

Um valor definido pelo aplicativo.

Valor de retorno

Tipo: 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.

Observações

Nota

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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

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)
biblioteca User32.lib
de DLL User32.dll

Consulte também

Conceitual

CreateWindow

de interface de vários documentos

de referência de

RegisterClassEx

WM_MDICREATE