Compartir a través de

Función CreateMDIWindowA (winuser.h)

  • Artículo

Crea una ventana secundaria de interfaz de varios documentos (MDI).

Sintaxis

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 de

Clase de ventana de la ventana secundaria MDI. El nombre de clase debe haberse registrado mediante una llamada a la función RegisterClassEx.

[in] lpWindowName

Tipo: LPCTSTR de

Nombre de la ventana. El sistema muestra el nombre en la barra de título de la ventana secundaria.

[in] dwStyle

Tipo: DWORD de

Estilo de la ventana secundaria MDI. Si la ventana de cliente MDI se crea con el estilo de ventana de MDIS_ALLCHILDSTYLES, este parámetro puede ser cualquier combinación de los estilos de ventana enumerados en la página Estilos de ventana. De lo contrario, este parámetro se limita a uno o varios de los valores siguientes.

Valor Significado
WS_MINIMIZE
0x200000000L
 Crea una ventana secundaria de MDI que se minimiza inicialmente.
WS_MAXIMIZE
0x01000000L
 Crea una ventana secundaria de MDI que se maximiza inicialmente.
WS_HSCROLL
0x00100000L
 Crea una ventana secundaria MDI que tiene una barra de desplazamiento horizontal.
WS_VSCROLL
0x00200000L
 Crea una ventana secundaria MDI que tiene una barra de desplazamiento vertical.

[in] X

Tipo: int

Posición horizontal inicial, en coordenadas de cliente, de la ventana secundaria MDI. Si este parámetro es CW_USEDEFAULT ((int)0x80000000), a la ventana secundaria de MDI se le asigna la posición horizontal predeterminada.

[in] Y

Tipo: int

Posición vertical inicial, en coordenadas de cliente, de la ventana secundaria MDI. Si este parámetro es CW_USEDEFAULT, a la ventana secundaria de MDI se le asigna la posición vertical predeterminada.

[in] nWidth

Tipo: int

Ancho inicial, en unidades de dispositivo, de la ventana secundaria MDI. Si este parámetro es CW_USEDEFAULT, a la ventana secundaria de MDI se le asigna el ancho predeterminado.

[in] nHeight

Tipo: int

Alto inicial, en unidades de dispositivo, de la ventana secundaria MDI. Si este parámetro se establece en CW_USEDEFAULT, a la ventana secundaria de MDI se le asigna el alto predeterminado.

[in, optional] hWndParent

Tipo: HWND

Identificador de la ventana del cliente MDI que será el elemento primario de la nueva ventana secundaria de MDI.

[in, optional] hInstance

Tipo: HINSTANCE

Identificador de la instancia de la aplicación que crea la ventana secundaria MDI.

[in] lParam

Tipo: LPARAM

Valor definido por la aplicación.

Valor devuelto

Tipo: HWND

Si la función se ejecuta correctamente, el valor devuelto es el identificador de la ventana creada.

Si se produce un error en la función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Nota

El encabezado winuser.h define CreateMDIWindow como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winuser.h (incluya Windows.h)
biblioteca de User32.lib
DLL de User32.dll

Consulte también

conceptual de

createWindow

de interfaz de varios documentos

de referencia de

RegisterClassEx

WM_MDICREATE