Функция CreateMDIWindowA (winuser.h)

Статья
08/27/2023

Создает дочернее окно многодокументного интерфейса (MDI).

Синтаксис

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
);

Параметры

[in] lpClassName

Тип: LPCTSTR

Класс окна дочернего окна MDI. Имя класса должно быть зарегистрировано вызовом функции RegisterClassEx .

[in] lpWindowName

Тип: LPCTSTR

Имя окна. Система отображает имя в заголовке дочернего окна.

[in] dwStyle

Тип: DWORD

Стиль дочернего окна MDI. Если окно клиента MDI создается со стилем окна MDIS_ALLCHILDSTYLES , этот параметр может быть любым сочетанием стилей окон, перечисленных на странице Стили окон . В противном случае этот параметр ограничен одним или несколькими из следующих значений.

Значение	Значение
WS_MINIMIZE 0x20000000L	Создает дочернее окно MDI, которое изначально свернуто.
WS_MAXIMIZE 0x01000000L	Создает дочернее окно MDI, которое изначально развернуто.
WS_HSCROLL 0x00100000L	Создает дочернее окно MDI с горизонтальной полосой прокрутки.
WS_VSCROLL 0x00200000L	Создает дочернее окно MDI с вертикальной полосой прокрутки.

[in] X

Тип: int

Начальное горизонтальное положение дочернего окна MDI в клиентских координатах. Если этот параметр имеет значение CW_USEDEFAULT ((int)0x80000000), дочернему окну MDI назначается горизонтальная позиция по умолчанию.

[in] Y

Тип: int

Начальная вертикальная позиция дочернего окна MDI в клиентских координатах. Если этот параметр имеет CW_USEDEFAULT, дочернему окну MDI назначается вертикальная позиция по умолчанию.

[in] nWidth

Тип: int

Начальная ширина дочернего окна MDI в единицах устройства. Если этот параметр имеет значение CW_USEDEFAULT, то дочернему окну MDI назначается ширина по умолчанию.

[in] nHeight

Тип: int

Начальная высота дочернего окна MDI в единицах устройства. Если для этого параметра задано значение CW_USEDEFAULT, то дочернему окну MDI назначается высота по умолчанию.

[in, optional] hWndParent

Тип: HWND

Дескриптор клиентского окна MDI, который будет родительским для нового дочернего окна MDI.

[in, optional] hInstance

Тип: HINSTANCE

Дескриптор экземпляра приложения, создающего дочернее окно MDI.

[in] lParam

Тип: LPARAM

Значение, определяемое приложением.

Возвращаемое значение

Тип: HWND

Если функция выполняется успешно, возвращаемое значение является дескриптором созданного окна.

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Заголовок winuser.h определяет CreateMDIWindow в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll