CreateWindowEx

HWND CreateWindowEx( DWORD dwExStyle, LPCTSTR lpClassName, LPCTSTR lpWindowName, DWORD dwStyle, int x, int y, int nWidth, int nHeight, HWND hWndParent, HMENU hMenu, HINSTANCE hInstance, LPVOID lpParam );

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

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

Аргументы

0. dwExStyle — определяет расширенные стили окна. Определены следующие значения расширенных стилей:

• WS_EX_ACCEPTFILES — данный стиль окна допускает перетаскивание файлов.

• WS_EX_APPWINDOW — отображает окно верхнего уровня в панели задач, если оно видимо.

• WS_EX_CLIENTEDGE — рабочая область окна имеет рамку.

• WS_EX_CONTEXTHELP — в панели заголовка окна помещается кнопка с вопросительным знаком. Когда пользователь щёлкает по ней кнопкой мыши, курсор мыши приобретает вид указателя со знаком вопроса. Если пользователь помещает этот курсор на дочернее окно и щёлкает кнопкой мыши, то это дочернее окно получает сообщение WM_HELP. Дочернее окно должно передать это сообщение процедуре родительского окна, которое, в свою очередь, должно вызвать функцию WinHelp, использующую команду HELP_WM_HELP. При этом справочная система приложения выводит окно контекстной справки по дочернему окну. Стиль WS_EX_CONTEXTHELP несовместим со стилями WS_MAXIMIZEBOX и WS_MINIMIZEBOX.

• WS_EX_CONTROLPARENT — позволяет пользователю перемещаться по дочерним окнам данного окна с использованием клавиши табуляции.

• WS_EX_DLGMODALFRAME — создаёт окно, имеющее двойную рамку. Кроме того, окно может иметь заголовок. Для этого следует установить стиль WS_CAPTION в аргументе dwStyle.

• WS_EX_LEFT — информация в окне выравнивается по левому краю. Этот стиль устанавливается по умолчанию.

• WS_EX_LEFTSCROLLBAR — если в оболочке использован еврейский, арабский или другой язык, предполагающий чтение справа налево, вертикальная полоса прокрутки (если она установлена) располагается по левой границе рабочей области. Для других языков этот стиль игнорируется и не рассматривается как ошибка.

• WS_EX_LTRREADING — текст в окне отображается слева направо. Этот стиль используется по умолчанию.

• WS_EX_MDICHILD — создаёт дочернее окно MDI.

• WS_EX_NOPARENTNOTIFY — дочернее окно, при создании которого был задан этот стиль, не посылает сообщения WM_PARENTNOTIFY своему родительскому окну при своём создании или уничтожении.

• WS_EX_OVERLAPPEDWINDOW — представляет собой комбинацию стилей WS_EX_CLIENTEDGE и WS_EX_WINDOWEDGE.

• WS_EX_PALETTEWINDOW — представляет собой комбинацию стилей WS_EX_WINDOWEDGE, WS_EX_TOOLWINDOW и WS_EX_TOPMOST.

• WS_EX_RIGHT — информация в окне выравнивается по левому краю. Действие этого стиля зависит от класса окна. Этот стиль проверяется, если в оболочке использован еврейский, арабский или другой язык, предполагающий чтение справа налево. Для других языков этот стиль игнорируется и не рассматривается как ошибка.

• WS_EX_RIGHTSCROLLBAR — вертикальная полоса прокрутки (если она установлена), отображается на правой границе рабочей области окна. Этот стиль используется по умолчанию.

• WS_EX_RTLREADING — если в оболочке использован еврейский, арабский или другой подобный язык, то информация в окне выводится справа налево. Для других языков этот стиль игнорируется и не рассматривается как ошибка.

• WS_EX_STATICEDGE — создаёт окно с трёхмерной рамкой, не предназначенное для ввода в него информации.

• WS_EX_TOOLWINDOW — создаёт окно плавающей панели инструментов. Это окно имеет более короткую панель заголовок, чем у обычного окна, заголовок в которой выводится мелким шрифтом. Окна панелей инструментов не отображаются в панели задач или в диалоговом окне, появляющемся при нажатии комбинации клавиш <Alt+Tab>. Если окно панель инструментов имеет системное меню, его значок не отображается в заголовке окна. Для его вывода можно щёлкнуть правой кнопкой мыши или нажать комбинацию клавиш <Alt+Space>.

• WS_EX_TOPMOST — окно, при создании которого был задан данный стиль, должно быть размещено поверх всех окон, при создании которых этот стиль не был задан, и должно оставаться поверх их даже в том случае, если оно перестало быть активным. Для установки и удаления данного стиля используется функция SetWindowPos.

• WS_EX_TRANSPARENT — окно, при создании которого был задан данный стиль, не должно перерисовываться до тех пор, пока не будут перерисованы все окна, созданные тем же потоком и расположенные под ним. Окно выглядит прозрачным, поскольку уже выведены все биты окон, созданных тем же потоком и расположенных под ним. Для достижения эффекта прозрачности без ограничений используется функция SetWindowRgn.

• WS_EX_WINDOWEDGE — данное окно имеет рамку.

0. Использование стиля WS_EX_RIGHT для статических элементов управления или для текстовых полей имеет тот же эффект, что и установка стиля SS_RIGHT или ES_RIGHT в зависимости от элемента управления. Использование этого стиля для кнопок имеет тот же эффект, что и установка стиля BS_RIGHT и BS_RIGHTBUTTON.

1. lpClassName — указатель на заканчивающуюся нулём строку или на целочисленный атом. Если в аргументе lpClassName передаётся атом, то его значение должно быть получено при предыдущем вызове функции GlobalAddAtom. Атом, представляющий собой 16-разрядную величину, меньшую 0xC000 должен располагаться в младшем слове аргумента lpClassName, а старшее его слово должно иметь нулевое значение.

2. Если в аргументе lpClassName содержится строка, то она должна определять имя класса окна. Этот класс окна должен быть зарегистрирован функцией RegisterClassEx или быть одним из предопределённых имён классов элементов управления. При задании в аргументе lpClassName предопределённого имени класса элемента управления в аргументе dwStyle должен быть указан соответствующий стиль данного элемента управления. Определены следующие значения:

• BUTTON — создаваемое окно представляет собой маленькое прямоугольное окно кнопки, активируемой щелчком мыши. Кнопочные элементы управления могут использоваться по отдельности и в группах. Они могут содержать или не содержать текст. Кнопки, обычно, меняют свой вид при нажатии на них пользователем.

• COMBOBOX — создаётся окно комбинированного списка, представляющее собой окно списка, снабжённое текстовым полем. При использовании данного элемента управления приложение должно или постоянно отображать на экране окно списка, или сделать его раскрывающимся. Если окно списка постоянно присутствует на экране, то при вводе символов в текстовое поле в окне списка выделяется первый элемент списка, соответствующий вводимым символам. И наоборот, при выделении элемента списка он отображается в текстовом поле.

• EDIT — создаётся прямоугольное дочернее окно, в которое пользователь может вводить текст с клавиатуры. Для этого, щелчком мыши или с использованием клавиши табуляции, необходимо выделить данный элемент управления и передать ему фокус ввода. Пользователь может вводить текст в текстовое поле, если в нём отображается мигающий курсор. При работе с текстовым полем мышь позволяет перемещать текстовый курсора, выделять заменяемый фрагменте текста и позиционировать курсор для вставки символов. Для уничтожения символов используется клавиша <Backspace>.

• LISTBOX — создаётся окно списка текстовых строк. Данный элемент управления используется для создания списков имён, например имён файлов, из которого следует сделать выбор. Для выделения строки по ней щёлкают кнопкой мыши. выделенная строка подсвечивается и родительскому окну посылается извещение.

• MDICLIENT — создаётся окно документа многооконного приложения. Это окно получает сообщения, управляющие работой дочернего окна многооконного приложения. Для данного окна рекомендуется устанавливать стили WS_CLIPCHILDREN и WS_CHILD. Если в данном окне предполагается прокрутка информации, необходимо также установить стили WS_HSCROLL и WS_VSCROLL.

• RichEdit — создаётся элемент управления расширенного текстового поля по версии 1.0. Это окно позволяет пользователю просматривать и редактировать текст, используя при этом форматирование шрифтов и абзацев, а также включая в него объекты COM.

• RICHEDIT_CLASS — создаётся элемент управления расширенного текстового поля по версии 2.0. Это окно позволяет пользователю просматривать и редактировать текст, используя при этом форматирование шрифтов и абзацев, а также включая в него объекты COM.

• SCROLLBAR — создаётся полоса прокрутки, представляющая собой прямоугольник, на концах которого расположены кнопки со стрелками между которыми перемещается бегунок. Полоса прокрутки посылает извещения своему родительскому окну при щелчке кнопкой мыши в её области. За обработку полученных сообщений отвечает родительское окно.

• STATIC — используется для создания различных надписей. Этот элемент управления не может получать или выдавать информацию.

0. lpWindowName — указатель на заканчивающуюся нулём строку, определяющую имя окна.

1. Если стиль окна задаёт для него панель заголовка, то в него выводится заголовок окна, на который указывает аргумент lpWindowName. Если функция CreateWindow используется для создания элементов управления таких, как кнопки, флажки и статические элементы управления, то в аргументе lpWindowName содержится текст данного элемента управления.

2. dwStyle — стиль создаваемого окна. Определены следующие значения стилей:

• WS_BORDER — создаётся окно, имеющее тонкую рамку.

• WS_CAPTION — создаётся окно, имеющее заголовок (включает в себя стиль WS_BORDER).

• WS_CHILD — создаётся дочернее окно. Этот стиль несовместим со стилем WS_POPUP.

• WS_CHILDWINDOW — то же, что и стиль WS_CHILD.

• WS_CLIPCHILDREN — исключает область, занимаемую дочерними окнами из области перерисовки родительского окна. Этот стиль используется при создании родительского окна.

• WS_CLIPSIBLINGS — взаимно исключает области перерисовки дочерних окон одного родительского окна. То есть, когда какое-либо дочернее окно получает сообщение WM_PAINT, стиль WS_CLIPSIBLINGS исключает из области перерисовки все области, занимаемые другими дочерними окнами. Если стиль WS_CLIPSIBLINGS не установлен, то в случае взаимного перекрытия дочерних окон возможен вариант, когда при перерисовке одного дочернего окна будет испорчено содержимое перекрывающегося с ним другого дочернего окна.

• WS_DISABLED — создаётся изначально недоступное окно. Недоступное окно не может получить фокус ввода.

• WS_DLGFRAME — создаётся окно с рамкой, характерной для диалоговых окон. Данные окна не могут иметь заголовка.

• WS_GROUP — определяет первый элемент управления в группе элементов управления. Группа состоит из первого элемента управления и всех следующих за ним элементов управления до следующего элемента управления, имеющего стиль WS_GROUP. Первый элемент управления в группе, как правило, имеет стиль WS_TABSTOP, позволяющий перемещаться между группами с помощью клавиши табуляции. Для перемещения фокуса ввода с одного элемента управления в группе на другой используются клавиши управления курсором.

• WS_HSCROLL — создаётся окно, имеющее горизонтальную полосу прокрутки.

• WS_ICONIC — создаётся изначально минимизированное окно. То же самое, что и стиль WS_MINIMIZE.

• WS_MAXIMIZE — создаётся окно, развёрнутое на весь экран.

• WS_MAXIMIZEBOX — в панели заголовка создаваемого окна помещается кнопка Развернуть. Несовместим со стилем WS_EX_CONTEXTHELP. Должен быть также установлен стиль WS_SYSMENU.

• WS_MINIMIZE — создаётся изначально минимизированное окно. То же самое, что и стиль WS_ICONIC.

• WS_MINIMIZEBOX — в панели заголовка создаваемого окна помещается кнопка Свернуть. Несовместим со стилем WS_EX_CONTEXTHELP. Должен быть также установлен стиль WS_SYSMENU.

• WS_OVERLAPPED — создаёт перекрывающееся окно. Перекрывающееся окно имеет панель заголовка и рамку. То же самое, что и стиль WS_TILED.

• WS_OVERLAPPEDWINDOW — создаётся окно, имеющее стили WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX и WS_MAXIMIZEBOX. То же самое, что и стиль WS_TILEDWINDOW.

• WS_POPUP — создаёт всплывающее окно. Этот стиль несовместим со стилем WS_CHILD.

• WS_POPUPWINDOW — создаётся всплывающее окно, имеющее стили WS_BORDER, WS_POPUP и WS_SYSMENU. Чтобы сделать видимым меню окна необходимо добавить комбинацию стилей WS_CAPTION и WS_POPUPWINDOW.

• WS_SIZEBOX — создаётся окно, размер которого можно менять при помощи мыши. То же самое, что и стиль WS_THICKFRAME.

• WS_SYSMENU — создаваемое окно имеет в своей панели заголовка кнопку вызова системного меню. Необходимо также установить стиль WS_CAPTION.

• WS_TABSTOP — создаваемый элемент управления может получать фокус ввода при нажатии пользователем клавиши табуляции. Нажатие клавиши табуляции передаёт фокус ввода следующему элементу управления, имеющему стиль WS_TABSTOP.

• WS_THICKFRAME — создаётся окно, размер которого можно менять при помощи мыши. То же самое, что и стиль WS_SIZEBOX.

• WS_TILED — создаёт перекрывающееся окно. Перекрывающееся окно имеет панель заголовка и рамку. То же самое, что и стиль WS_OVERLAPPED.

• WS_TILEDWINDOW — создаётся окно, имеющее стили WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX и WS_MAXIMIZEBOX. То же самое, что и стиль WS_OVERLAPPEDWINDOW.

• WS_VISIBLE — создаваемое окно сразу же отображается на экране.

• WS_VSCROLL — создаваемое окно имеет вертикальную полосу прокрутки.

x — определяет горизонтальное положение создаваемого окна. Для перекрывающихся или всплывающих окон данный аргумент определяет горизонтальную координату верхнего левого угла окна в экранной системе координат. Для дочерних окон данный аргумент определяет горизонтальную координату верхнего левого угла окна относительно верхнего левого угла рабочей области родительского окна.

Если в аргументе x передаётся значение CW_USEDEFAULT, система использует координаты левого верхнего угла окна, установленные по умолчанию и игнорирует значение аргумента y. Значение CW_USEDEFAULT может передаваться только для перекрывающихся окон. Если оно используется для всплывающего или дочернего окна, то в аргументы x и y заносится нулевое значение.

y — определяет вертикальное положение создаваемого окна. Для перекрывающихся или всплывающих окон данный аргумент определяет вертикальную координату верхнего левого угла окна в экранной системе координат. Для дочерних окон данный аргумент определяет вертикальную координату верхнего левого угла окна относительно верхнего левого угла рабочей области родительского окна. Для окна списка аргумент y содержит вертикальную координату верхнего левого угла рабочей области окна списка относительно верхнего левого угла рабочей области родительского окна.

Если при создании перекрывающегося окна был задан стиль WS_VISIBLE, а в аргументе x передаётся значение CW_USEDEFAULT, то значение аргумента y игнорируется.

0. nWidth — определяет ширину окна в единицах устройства. Для перекрывающихся окон аргумент nWidth содержит ширину окна в экранных координатах. Если в аргументе nWidth передаётся значение CW_USEDEFAULT, то для окна выбираются ширина и высота, установленные по умолчанию. При этом ширина окна определяется как разность правой границы экрана и значения переменной x, а высота окна определяется как разность верхней границы области значков и значения переменной y. Значение CW_USEDEFAULT может передаваться только для перекрывающихся окон. Если значение CW_USEDEFAULT передаётся для всплывающего или дочернего окна, то в аргументы nWidth и nHeight заносится нулевое значение.

1. nHeight — определяет высоту окна в единицах устройства. Для перекрывающихся окон аргумент nHeight содержит ширину окна в экранных координатах. Если в аргументе nWidth передаётся значение CW_USEDEFAULT, то значение переменной nHeight игнорируется.

2. hWndParent — дескриптор родительского окна или окна, владеющего создаваемым окном. Для создания дочернего окна в данном аргументе передаётся корректный дескриптор родительского окна. Для всплывающих окон этот аргумент необязателен.

3. hMenu — в зависимости от стиля окна в данном аргументе передаётся дескриптор объекта меню или идентификатор дочернего окна. Для перекрывающихся или всплывающих окон в аргументе hMenu передаётся дескриптор объекта меню, используемого данным окном, или нулевое значение, если используется меню класса. Для дочернего окна в аргументе hMenu передаётся идентификатор дочернего окна, представляющего собой целочисленное значение, используемое элементом управления диалогового окна для извещения своего родительского окна о событиях. Идентификатор дочернего окна, определяемый приложением, должен быть уникальным для всех дочерних окон одного и того же родительского окна.

4. hInstance — дескриптор экземпляра модуля, связанного с окном.

5. lpParam — указатель на величину, передаваемую окну через объект структуры CREATESTRUCT на который указывает аргумент lParam сообщения WM_CREATE. Если приложение вызывает функцию CreateWindowEx для создания окна документа в многооконном приложении, аргумент lParam указывает на объект структуры CLIENTCREATESTRUCT

Примечание

Функция CreateWindowEx создаёт перекрывающееся, всплывающее или дочернее окно, имеющее расширенные стили. Во всех остальных отношениях она полностью идентична функции CreateWindow.

Функция CreateWindowEx при создании окна посылает сообщения WM_NCCREATE, WM_NCCALCSIZE и WM_CREATE.

Описание данной функции содержится в файле заголовка winuser.h. При работе с данной функцией следует включить в проект библиотеку user32.lib.