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

Статья
11/20/2024

Создает дочернее окно интерфейса с несколькими документами (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 0x200000000L	Создает дочернее окно 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll