CreateWindowEx

Składnia

Argumenty

Argument	Opis
dwExStyle	Rozszerzony style okna, które zostanie utworzone. Aby uzyskać listę możliwych wartości, zobacz » WinAPI ♦ Rozszerzone style okien
lpClassName	Ciąg znaków w stylu języka C zakończony znakiem NULL, lub klasa okna uzyskana przez poprzednie wywołania funkcji » WinAPI ♦ RegisterClass lub RegisterClassEx. Jeśli ten argument jest łańcuchem znaków, określa on nazwę klasy. Może ona zostać zarejestrowana przy użyciu » WinAPI ♦ RegisterClass lub RegisterClassEx, pod warunkiem, że moduł który zarejestrował klasę, jest również modułem, który stworzył okno. Może to być także jedna z predefiniowanych » WinAPI ♦ klas systemowych.
lpWindowName	Nazwa okna. Jeżeli styl okna określa pasek tytułowy, wartość tego argumentu będzie na nim wyświetlona. Argument ten służy także do określania tekstu w kontrolkach. Podczas tworzenia kontrolki ze stylem SS_ICON, możesz użyć lpWindowName do określenia nazwy ikonki lub jej identyfikatora (składnia: "#num").
dwStyle	Style określające wygląd tworzonego okna. Ten argument może być kombinacją » WinAPI ♦ styli okna oraz specyficznych stylów określonych dla każdej kontrolki.
x	Początkowa pozioma pozycja okna. Dla okien zwykłych oraz pop-up, ten argument określa współrzędną x lewego górnego rogu okna, względem ekranu. Dla okien potomnych, pozycja liczona jest względem lewego górnego rogu okna nadrzędnego. Jeżeli argument x jest równy CW_USEDEFAULT, system wybierze pozycję lewego górnego rogu okna, i zignoruje argument y. Użycie tej flagi jest poprawne tylko dla okien zwykłych. Dla okien typu pop-up oraz okien potomnych użycie jej spowoduje ustawienie współrzędnych x oraz y na wartość 0.
y	Początkowa pionowa pozycja okna. Dla okien zwykłych oraz pop-up, ten argument określa współrzędną y lewego górnego rogu okna, względem ekranu. Dla okien potomnych, pozycja liczona jest względem lewego górnego rogu okna nadrzędnego. Jeżeli funkcja CreateWindowEx została wywołana ze stylem WS_VISIBLE oraz z argumentem x równym CW_USEDEFAULT tworząc zwykłe okno, argument y określa, w jaki sposób zostanie ono wyświetlone. Po utworzeniu okna, zostanie wywołana funkcja » WinAPI ♦ ShowWindow z argumentem nCmdShow równym SW_SHOW jeżeli argument y wynosi CW_USEDEFAULT, lub wartością tego argumentu w przeciwnym wypadku.
nWidth	Szerokość okna, w jednostkach danego urządzenia względem współrzędnych ekranowych. Użycie CW_USEDEFAULT spowoduje wybranie przez system domyślnej szerokości i wysokości. Jeśli ta flaga zostanie użyta z oknami typu pop-up lub oknami potomnymi, spowoduje to przypisanie argumentom nWidth oraz nHeight wartości 0.
nHeight	Wysokość okna, w jednostkach danego urządzenia względem współrzędnych ekranowych. Jeżeli argument nWidth jest równy CW_USEDEFAULT, ten argument zostanie zignorowany.
hWndParent	Uchwyt do okna nadrzędnego. Możesz również użyć stałych HWND_DESKTOP, aby utworzyć zwykłe okno, lub HWND_MESSAGE, aby stworzyć okno do wymiany komunikatów.
hMenu	Uchwyt do menu dla okien zwykłych lub pop-up, albo identyfikator okna potomnego, zależnie od kontekstu. Identyfikator kontrolki jest używany, aby zawiadomić okno nadrzędne o zdarzeniach. Musi on być unikalny dla każdej kontrolki, spośród należących do danego okna nadrzędnego.
hInstance	Uchwyt do instancji lub modułu, powiązanego z oknem.
lpParam	Wskaźnik na wartość przekazywaną jako element lpCreateParams struktury CREATESTRUCT, w komunikacie WM_CREATE (argument lParam). Jeżeli aplikacja wywołuje funkcję CreateWindowEx w celu stworzenia okna MDI, ten argument powinien być wskaźnikiem na strukturę typu CLIENTCREATESTRUCT. Jeżeli okno MDI wywołuje tą funkcję w celu stworzenia potomnego okna MDI, powinien on być wskaźnikiem na strukturę typu MDICREATESTRUCT. Jeśli ten argument wyniesie NULL, żadne dodatkowe dane nie zostaną przekazane.

Zwracana wartość

Jeżeli wywołanie funkcji powiedzie się, zwróci ona uchwyt do nowo stworzonego okna. W przypadku błędu, zwróconą wartością będzie NULL. Aby uzyskać szczegółowe informacje o błędzie, użyj _{» WinAPI ♦} GetLastError.

Najczęstszymi przyczynami błędów są:

• Użycie nieprawidłowych argumentów.
• Klasa systemowa została zarejestrowana przez inny moduł.
• Został założony hak WH_CBT i zwrócił kod błędu.
• Jedna z kontrolek w szablonie dialogu nie została zarejestrowana, lub jej procedura okna zwróciła kod błędu dla wywołań komunikatów WM_CREATE lub WM_NCCREATE.

Opis szczegółowy

Funkcja CreateWindowEx tworzy nowe okno uwzględniając rozszerzone style okien. W celu jego utworzenia wysyła komunikaty WM_NCCREATE, WM_NCCALCSIZE, i WM_CREATE.

Jeżeli tworzone jest okno potomne, jego domyślną pozycją jest pierwsza od dołu w porządku Z. Jeśli tworzone jest okno zwykłe, znajduje się ono na samej górze w porządku Z, zaraz po oknach posiadających styl WS_EX_TOPMOST, chyba że tworzone okno także jest w posiadaniu tego stylu.

Aby usunąć okno, należy użyć funkcji _{» WinAPI ♦} DestroyWindow.

W argumencie lpClassName mogą być użyte następujące predefiniowane klasy:

Klasa	Znaczenie
BUTTON	Określa małe prostokątne okno-dziecko, które reprezentuje przycisk. Przyciski mogą występować pojedynczo lub w grupach, z tekstem, lub bez tekstu. Zazwyczaj zmieniają one wygląd, kiedy zostaną naciśnięte przez użytkownika. » WinAPI ♦ Style kontrolki Button.
COMBOBOX	Określa kontrolkę zawierającą listę oraz pole wprowadzania, podobnego do kontrolki EDIT. Jeśli lista jest aktywna, wpisywanie znaków do pola wprowadzania powoduje zaznaczenie pierwszego elementu listy pasującego do tekstu wpisywanego przez użytkownika. Z kolei wybranie któregoś z elementów listy spowoduje ustawienie jego tekstu do pola wprowadzania. » WinAPI ♦ Style kontrolki ComboBox.
EDIT	Określa prostokątne okno-dziecko, do którego użytkownik może wprowadzać tekst. Ta kontrolka otrzymuje fokusa, gdy użytkownik kliknie na nią, lub przemieści się do niej za pomocą klawisza TAB. Po otrzymaniu fokusa, w kontrolce pojawia się migający symbol. Używając myszy można zaznaczyć tekst, lub przemieścić kursor w inne miejsce. » WinAPI ♦ Style kontrolki Edit.
LISTBOX	Określa listę z ciągami znaków. Tej kontrolki należy używać, kiedy aplikacja musi zaprezentować listę nazw (takich jak np. nazwy plików), z pośród których użytkownik musi wybierać. Po kliknięciu na element listy zostaje on podświetlony, a następnie zostaje wysłane powiadomienie do okna nadrzędnego.
MDICLIENT	Określa okno klienta MDI. To okno odbiera wiadomości, które pozwalają kontrolować okna MDI. Zalecanymi stylami są WS_CLIPCHILDREN oraz WS_CHILD. Użycie WS_HSCROLL oraz WS_VSCROLL pozwala scrollować okna wewnątrz obszaru klienta.
RichEdit	Określa kontrolkę typu RichEdit, w wersji 1.0. Kontrolka ta pozwala użytkownikowi wprowadzać tekst sformatowany. Potrafi ona również przechowywać zagnieżdżone obiekty typu COM. » WinAPI ♦ Style kontrolki RichEdit.
RICHEDIT_CLASS	Określa kontrolkę typu RichEdit, w wersji 2.0. Kontrolka ta pozwala użytkownikowi wprowadzać tekst sformatowany. Potrafi ona również przechowywać zagnieżdżone obiekty typu COM. » WinAPI ♦ Style kontrolki RichEdit.
SCROLLBAR	Wyznacza prostokąt, który zawiera pole przewijania oraz posiada strzałki na obu końcach. Kontrolka ta wysyła powiadomienie do okna nadrzędnego, kiedy tylko zostanie kliknięta. Okno to jest odpowiedzialne za zmianę pozycji przewijanego okna oraz za aktualizowanie pozycji paska przewijania w razie potrzeby.
STATIC	Wyznacza proste pole tekstowe, używane do oznaczenia innych kontrolek. Kontrolka ta nie reaguje na działania użytkownika.

Użycie stylu WS_EX_NOACTIVATE w argumencie dwExStyle zapobiega aktywowaniu okna po jego utworzeniu. Aby zapobiec aktywowaniu okna po tym, jak zostało ono kliknięte przez użytkownika, należy odpowiednio obsłużyć komunikat WM_MOUSEACTIVATE. Aby przenieść okno na pierwszy plan, lub je aktywować, użyj funkcji _{» WinAPI ♦} SetForegroundWindow lub _{» WinAPI ♦} SetActiveWindow. Zwrócenie  podczas obsługi komunikatu WM_NCACTIVATE zapobiega utracie aktywności. Wartość zwrócona jest ignorowana podczas aktywacji.

Użycie stylu WS_EX_COMPOSITED spowoduje, że wszystkie okna potomne będą rysowane z użyciem podwójnego buforowania. Rysowanie to pozwala uzyskać efekty przeźroczystości oraz przejrzystości (jeśli okno posiada styl WS_EX_TRANSPARENT), a także zapobiega migotaniu.

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional
Minimalny obsługiwany serwer	Windows 2000 Server
Plik nagłówkowy	Winuser.h (wewnątrz Windows.h)
Biblioteka	User32.lib
DLL	User32.dll
Nazwy Unicode i ANSI	CreateWindowExW (Unicode) i CreateWindowExA (ANSI)

Zagadnienia powiązane

CreateWindow	Tworzy nowe okno. (funkcja)
DestroyWindow	Niszczy wskazane okno. (funkcja)
EnableWindow	Włącza lub wyłącza otrzymywanie komunikatów od klawiatury i myszki dla danego okna. (funkcja)
RegisterClass	Rejestruje klasę okna. (funkcja)
SetActiveWindow	Aktywuje okno, które musi być powiązane z kolejką komunikatów wywołującego wątku. (funkcja)
SetForegroundWindow	Wysuwa podane okno na pierwszy plan. (funkcja)
SetWindowLong	Modyfikuje atrybuty okna (Windows 32 bitowy). (funkcja)
SetWindowPos	Zmienia rozmiar, pozycję lub kolejność wyświetlania okna. (funkcja)
ShowWindow	Ustawia określony stan widoczności okna. (funkcja)

Linki zewnętrzne

• http://cpp0x.pl/kursy/Kurs-WinAPI-C++/Podstawy/Kontrolki/178
• http://cpp0x.pl/kursy/Kurs-WinAPI-C++/Podstawy/Podstawy-WinAPI/168
• http://cpp0x.pl/kursy/Kurs-WinAPI-C++/Zaawansowane/MDI/200
• http://msdn.microsoft.com/en-us/library/windows/desktop/ms632680(v=vs.85).aspx