Функция CreateMDIWindow

Функция 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, CreateWindowRegisterClassEx 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

Нет

Замечания по платформе

Не имеется

Назад в оглавление
На главную страницу
На главную страницу справки 

Hosted by uCoz