CreateWindow

[funkcja] Tworzy nowe okno.

Składnia

#include <windows.h>

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

Argumenty

Argument	Opis
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 `CreateWindow` 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ę `CreateWindow` 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. Zadaniem funkcji jest wysłanie komunikatu WM_CREATE. Dla okien zwykłych, pop-up oraz okien potomnych, wysyłane są także komunikaty WM_GETMINMAXINFO oraz WM_NCCREATE. Argument lParam w komunikacie WM_CREATE zawiera wskaźnik na strukturę typu CREATESTRUCT. Jeśli został podany styl WS_VISIBLE, funkcja wysyła wszystkie potrzebne wiadomości, aby aktywować i pokazać okno.

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.

Funkcja CreateWindow jest zaimplementowana jako wywołanie funkcji _{» WinAPI ♦}CreateWindowEx w sposób pokazany poniżej:

#define CreateWindowA(lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)\
CreateWindowExA(0L, lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)

#define CreateWindowW(lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)\
CreateWindowExW(0L, lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)

#ifdef UNICODE
#define CreateWindow CreateWindowW
#else
#define CreateWindow CreateWindowA
#endif

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional
Minimalny obsługiwany serwer	Windows 2000 Server
Plik nagłówkowy	Winuser.h (wewnątrz Windows.h)
Nazwy Unicode i ANSI	CreateWindowW (Unicode) i CreateWindowA (ANSI)

Zagadnienia powiązane

CreateWindowEx	Tworzy nowe okno uwzględniając rozszerzone style okien. (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)
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://msdn.microsoft.com/en-us/library/windows/desktop/ms632679(v=vs.85).aspx

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.