Поделиться через


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

Создает дочернее окно многодокументного интерфейса (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

См. также раздел

Основные понятия

CreateWindow

Интерфейс нескольких документов

Справочные материалы

RegisterClassEx

WM_MDICREATE