Функция CreateMDIWindow создает дочернее окно многодокументного интерфейса (MDI).
Синтаксис
HWND CreateMDIWindow( LPCTSTR lpClassName, LPCTSTR lpWindowName, DWORD dwStyle, int X, int Y, int nWidth, int nHeight, HWND hWndParent, HINSTANCE hInstance, LPARAM lParam ); |
Параметры
lpClassName
[in] Указатель на символьную строку с нулем в конце, определяющую класс дочернего окна MDI. Имя класса должно быть зарегистрировано вызовом функции RegisterClassEx.lpWindowName
[in] Указатель на символьную строку с нулем в конце, которая обозначает имя окна. Система показывает на экране имя в области заголовка дочернего окна.dwStyle
[in] Устанавливает стиль дочернего окна многодокументного интерфейса (MDI). Если рабочее окно MDI создается со стилем MDIS_ALLCHILDSTYLES, этим параметром может быть любая комбинация стилей окна, перечисляемых в описании функции CreateWindow. В противном случае, этот параметр может состоять из одного или нескольких ниже перечисленных значений.
| Значение | Предназначение |
| WS_MINIMIZE | Создает дочернее окно MDI, которое первоначально свернуто. |
| WS_MAXIMIZE | Создает дочернее окно MDI, которое первоначально развернуто. |
| WS_HSCROLL | Создает дочернее окно MDI, которое имеет горизонтальную линейку прокрутки. |
| WS_VSCROLL | Создает дочернее окно MDI, которое имеет вертикальную линейку прокрутки. |
X
[in] Устанавливает начальную горизонтальную позицию, в рабочих координатах окна, дочернего окна MDI. Если этот параметр - CW_USEDEFAULT, дочернему окну MDI назначается заданная по умолчанию горизонтальная позиция.Y
[in] Устанавливает начальную вертикальную позицию, в рабочих координатах окна, дочернего окна MDI. Если этот параметр - CW_USEDEFAULT, дочернему окну MDI назначается заданная по умолчанию вертикальная позиция.nWidth
[in] Устанавливает начальную ширину, в единицах измерения устройства (пикселях), дочернего окна MDI. Если этот параметр - CW_USEDEFAULT, дочернему окну MDI назначается заданная по умолчанию ширина.nHeight
[in] Устанавливает начальную высоту, в единицах измерения устройства (пикселях), дочернего окна MDI. Если этот параметр установлен в CW_USEDEFAULT, дочернему окну MDI назначается заданная по умолчанию высота.hWndParent
[in] Дескриптор рабочего окна многодокументного интерфейса (MDI), которое должно быть родителем созданного дочернего окна MDI.hInstance
[in] Дескриптор экземпляра приложения, создающего дочернее окно MDI.lParam
[in] Устанавливает определяемое программой значение.Возвращаемое значение
Если функция завершается успешно, возвращаемое значение - дескриптор в созданного окна.
Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Использование функции CreateMDIWindow похоже на отправку сообщения WM_MDICREATE рабочему окну многодокументного интерфейса (MDI), за исключением того, что функция может создать дочернее окно MDI в другом потоке, в то время как сообщение это сделать не может.
Windows 95/98/Me: Система может поддерживать максимум 16 364 дескрипторов окна.
Windows 95/98/Me: CreateMDIWindowW поддерживается программой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.
Смотри также
Обзор Многодокументный интерфейс, Функции, используемые MDI, CreateWindow, RegisterClassEx, WM_MDICREATE
|
Размещение и совместимость CreateMDIWindow |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |