Función CreateMDIWindowA (winuser.h)

Artículo
08/27/2023

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

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

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

[in] dwStyle

Tipo: DWORD

Estilo de la ventana secundaria MDI. Si la ventana del 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 MDI que se minimiza inicialmente.
WS_MAXIMIZE 0x01000000L	Crea una ventana secundaria 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 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 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 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 la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll