Funkcji CreateWindow tworzy okno zakładkę, wyskakujące okienko lub dziecka. Określa klasę okna, tytuł okna, styl okna, i (opcjonalnie) początkowego położenia i rozmiaru okna. Funkcja określa także okna nadrzędnego lub właściciela, ewentualne i menu okna.
Aby używać rozszerzonego stylów oprócz style obsługiwane przez właściwości CreateWindow, należy użyć funkcji funkcji CreateWindowEx zamiast za pomocą właściwości CreateWindow.
(HWND CreateWindow LPCTSTR lpClassName, / / wskaźnik zarejestrowane nazwy klasyLPCTSTRlpWindowName, / / wskaźnik, aby oknie NazwaDWORDdwStyle, / / styl oknaint x, / / pozioma pozycja okna int y, / / pionowe położenie okna intnWidth właściwości, / / szerokość okna intnHeight, / / wysokość oknaHWNDhWndParent, / / dojście do okna nadrzędnego lub właścicielaHMENUhMenu, / / dojście do menu lub okna podrzędnego identyfikatoraUchwytwystąpienie hInstance, / / dojście do instancji aplikacjiElementem LPVOIDlpParam / / wskaźnik, aby oknie tworzenie danych);
Jeśli lpClassName jest ciągiem, określa nazwę klasy okna. Nazwa klasy może być dowolna nazwa zarejestrowana z funkcją RegisterClassEx lub z nazwy wstępnie zdefiniowany formant klasa. Aby uzyskać pełną listę zobacz sekcję Spostrzeżenia.
Jeśli styl okna określa pasek tytułu, tytuł okna wskazywanego przez lpWindowName jest wyświetlany na pasku tytułu. Podczas tworzenia formantów, takich jak przyciski, pola wyboru i formantów statycznych, za pomocą właściwości CreateWindow umożliwia określanie tekstu formantu lpWindowName.
| Styl | Znaczenie |
|---|---|
| WS_BORDER | Tworzy okno, w którym ma obramowanie w postaci linii cienki. |
| WS_CAPTION | Tworzy okno, w którym ma paska tytułu (zawiera styl WS_BORDER). |
| WS_CHILD | Tworzy okno podrzędne. Ten styl nie mogą być używane w stylu WS_POPUP. |
| WS_CHILDWINDOW | Takie same jak styl WS_CHILD. |
| WS_CLIPCHILDREN | Z wyłączeniem obszaru zajmowanego przez okien podrzędnych, podczas rysowania występuje w okno nadrzędne. Styl ten jest używany podczas tworzenia okno nadrzędne. |
| WS_CLIPSIBLINGS | Klipy okien podrzędnych względem siebie; oznacza to, że, gdy okno, w szczególności otrzymuje WM_PAINT wiadomości, styl WS_CLIPSIBLINGS klipów wszystkich innych nakładających się okien podrzędnych z regionu okna podrzędnego, należy zaktualizować. Jeśli zachodzą na siebie okien podrzędnych i WS_CLIPSIBLINGS nie jest określony, jest możliwe, podczas rysowania w obrębie obszaru klienckiego okna podrzędnego, aby narysować w obrębie obszaru klienckiego sąsiadujące okna podrzędnego. |
| WS_DISABLED | Tworzy okno, w którym początkowo jest wyłączona. Wyłączone okno nie mogą odbierać danych wejściowych od użytkownika. |
| WS_DLGFRAME | Tworzy okno, w którym ma obramowanie stylu zazwyczaj używane w oknach dialogowych. Okno z tego stylu nie może mieć pasek tytułu. |
| WS_GROUP | Określa pierwszy formant grupę formantów. Grupa składa się z ten pierwszego formantu i wszystkie formanty zdefiniowane, po którym aż do następnego formantu w stylu WS_GROUP. Pierwszy formant w każdej grupie zwykle ma styl WS_TABSTOP, tak, aby użytkownik może przechodzić od grupa. Użytkownik może później zmienić fokusu klawiatury z jednego formantu w grupie do następnego formantu w grupie za pomocą klawiszy kierunkowych. |
| WS_HSCROLL | Tworzy okno, w którym ma poziomego paska przewijania. |
| WS_ICONIC | Tworzy okno, w którym początkowo jest zminimalizowany. Takie same jak styl WS_MINIMIZE. |
| WS_MAXIMIZE | Tworzy okno, w którym początkowo jest zmaksymalizowane. |
| WS_MAXIMIZEBOX | Tworzy okno, w którym znajduje się przycisk Maksymalizuj. Nie można łączyć z stylu WS_EX_CONTEXTHELP. Styl WS_SYSMENU musi być także określona. |
| WS_MINIMIZE | Tworzy okno, w którym początkowo jest zminimalizowany. Takie same jak styl WS_ICONIC. |
| WS_MINIMIZEBOX | Tworzy okno, w którym znajduje się przycisk Minimalizuj. Nie można łączyć z stylu WS_EX_CONTEXTHELP. Styl WS_SYSMENU musi być także określona. |
| WS_OVERLAPPED | Tworzy okna. Nakładające się okna znajduje się pasek tytułu i obramowanie. Takie same jak styl WS_TILED. |
| WS_OVERLAPPEDWINDOW | Tworzy okna ze stylów WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX i WS_MAXIMIZEBOX. Takie same jak styl WS_TILEDWINDOW. |
| WS_POPUP | Tworzy okno podręczne. Ten styl nie mogą być używane w stylu WS_CHILD. |
| WS_POPUPWINDOW | Tworzy wyskakujące okienko stylów WS_BORDER, WS_POPUP i WS_SYSMENU. Style WS_CAPTION i WS_POPUPWINDOW muszą być połączone aby wyświetlić menu Okno. |
| WS_SIZEBOX | Tworzy okno, w którym ma obramowanie zmiany rozmiaru. Takie same jak styl WS_THICKFRAME. |
| WS_SYSMENU | Tworzy okno, w którym ma menu okna na pasku tytułu. Styl WS_CAPTION musi być także określona. |
| WS_TABSTOP | Określa formant, który można otrzymać fokusu klawiatury, kiedy użytkownik naciśnie klawisz tab. Nacionięcie klawisza tab zmienia fokusu klawiatury do następnego formantu w stylu WS_TABSTOP. |
| WS_THICKFRAME | Tworzy okno, w którym ma obramowanie zmiany rozmiaru. Takie same jak styl WS_SIZEBOX. |
| WS_TILED | Tworzy okna. Nakładające się okna znajduje się pasek tytułu i obramowanie. Takie same jak styl WS_OVERLAPPED. |
| WS_TILEDWINDOW | Tworzy okna ze stylów WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX i WS_MAXIMIZEBOX. Takie same jak styl WS_OVERLAPPEDWINDOW. |
| WS_VISIBLE | Tworzy okno, w którym jest początkowo widoczne. |
| WS_VSCROLL | Tworzy okno, w którym ma pionowego paska przewijania. |
Jeżeli ten parametr jest ustawiony na CW_USEDEFAULT, system wybierze domyślne położenie w prawym górnym rogu okna i ignoruje parametr y . CW_USEDEFAULT jest prawidłowa tylko dla windows nakładające się; Jeśli jest określony dla wyskakujących lub dziecko parametry okna, x i y ustawia się na zero.
Jeśli okna jest tworzony z ustawionym bitem stylu WS_VISIBLE i parametr x jest CW_USEDEFAULT, system zignoruje parametr y.
Systemu Windows NT 5.0 i nowsze: Aby utworzyć tylko do wiadomości okno, dostaw HWND_MESSAGE lub dojścia do istniejących okno tylko do wiadomości.
Jeśli funkcja, wartość zwracany jest dojście do nowego okna.
Jeśli funkcja zawiedzie, wartość zwracana jest wartość NULL. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.
Przed zwróceniem, właściwości CreateWindow wysyła wiadomość WM_CREATE procedurę okna. Na który zachodzi, wyskakującego i okien podrzędnych właściwości CreateWindow wysyła komunikaty WM_CREATE, WM_GETMINMAXINFOi WM_NCCREATE do okna. Parametr fikcyjnymi wiadomości WM_CREATE zawiera wskaźnik do struktury CREATESTRUCT . Jeżeli określono stylów WS_VISIBLE, właściwości CreateWindow wysyła okno wszystkie wiadomości wymagane do uaktywnienia i Pokaż okno.
Uzyskać na kontrolowanie, czy pasek zadań wyświetla przycisk w oknie utworzone, zobacz Widoczności przyciski paska zadań.
Następujące klasy wstępnie zdefiniowany formant można określić w parametrze lpClassName . Uwaga odpowiedniego formantu style możesz można użyć parametru dwStyle.
| Klasa | Znaczenie |
|---|---|
| PRZYCISK | Wyznacza okno małe dziecko prostokątne, który reprezentuje przycisk, który użytkownik może kliknąć, aby go włączyć lub wyłączyć. Przycisk formanty mogą być używane pojedynczo lub w grupach i albo może być oznaczony jako lub są wyświetlane bez tekstu. Przycisk kontroli zazwyczaj zmiany wyglądu, gdy użytkownik kliknie je. Aby uzyskać więcej informacji zobacz przyciski. |
| Aby uzyskać tabelę style przycisk, który można określić w parametrze dwStyle zobacz Przycisk Style. | |
| SKŁADNIK COMBOBOX | Wyznacza kontrolą składającą się z pola listy i pola wyboru podobne do formant edycyjny. Przy użyciu tego stylu, aplikacja powinna albo wyświetlić pole listy przez cały czas, lub włączyć pole listy rozwijanej. Jeśli pole listy jest widoczny, wpisując znaki w polu wyboru podkreśla pierwszego wpisu pole listy, który odpowiada wpisanych znaków. Odwrotnie zaznaczanie elementów w polu listy zaznaczony tekst jest wyświetlany w polu wyboru. Aby uzyskać więcej informacji zobacz temat Pola kombi. |
| Aby uzyskać tabelę style pole kombi, które można określić w parametrze dwStyle zobacz Style pola kombi. | |
| EDYCJA | Wyznacza okno potomne prostokątne, w którym użytkownik może wpisać tekst przy użyciu klawiatury. Użytkownik wybiera kontroli i ustawią na niej fokus klawiatury klikając go lub przenosząc go naciskając klawisz tab. Użytkownik może wpisać tekst, gdy formant edycyjny wyświetla daszek migające; Używanie myszy do przenoszenia kursora, zaznacz znaki zastępuje lub umieść kursor do wstawiania znaków; lub użyj klawisza backspace do usuwania znaków. Aby uzyskać więcej informacji zobacz Edycja formantów. |
| Dla tabeli style formant edycji, które można określić w parametrze dwStyle zobacz Edycja stylów formantu. | |
| POLE LISTY | Określa listę ciągów znaków. Gdy aplikacja musi przedstawić listę nazw, takich jak nazwy plików, z których użytkownik może wybrać, należy określić ten formant. Użytkownik może wybrać ciąg, klikając go. Ciąg zaznaczony jest wyróżniona, a wiadomość z powiadomieniem jest przekazywana do okno nadrzędne. Aby uzyskać więcej informacji zobacz Lista pól. |
| Aby uzyskać tabelę style pole listy, które można określić w parametrze dwStyle zobacz Style pole listy. | |
| MDICLIENT | Wyznacza okna klienta MDI. W tym oknie odbiera komunikaty sterujące okien podrzędnych stosowania MDI. Bity stylów zalecane są WS_CLIPCHILDREN i WS_CHILD. Określić style WS_HSCROLL i WS_VSCROLL, aby utworzyć okna klienta MDI, który umożliwia użytkownikowi przewijanie okien podrzędnych MDI do widoku. Aby uzyskać więcej informacji zobacz temat MDI. |
| RichEdit | Wyznacza Rich Edit kontroli wersji 1.0. To okno pozwala użytkownikowi na wyświetlanie i edytowanie tekstu ze znaków i formatowania akapitu i mogą obejmować osadzone obiekty COM. Aby uzyskać więcej informacji zobacz Rich Edit formantów. |
| Dla tabeli style formant edycji wzbogaconej, które można określić w parametrze dwStyle zobacz Rich Edit Control style. | |
| RICHEDIT_CLASS | Wyznacza Rich Edit kontroli wersji 2.0. To formanty pozwolić użytkownikowi na wyświetlanie i edytowanie tekstu ze znaków i formatowania akapitu i mogą obejmować osadzone obiekty COM. Aby uzyskać więcej informacji zobacz Rich Edit formantów. |
| Dla tabeli style formant edycji wzbogaconej, które można określić w parametrze dwStyle zobacz Rich Edit Control style. | |
| PASEK PRZEWIJANIA | Wyznacza prostokąt, w którym znajduje się pole przewijania i ma kierunek strzałki na obu końcach. Pasek przewijania wysyła wiadomość z powiadomieniem do jego okno nadrzędne, zawsze, gdy użytkownik kliknie formant. Okno nadrzędne jest odpowiedzialny za aktualizację pozycja pola przewijania, jeżeli jest to konieczne. Aby uzyskać więcej informacji zobacz temat Pasków przewijania. |
| Dla tabeli stylów formantu pasek przewijania, które można określić w parametrze dwStyle zobacz Style kontroli pasków przewijania. | |
| STATYCZNE | Wyznacza prosty tekst pola, pole lub prostokąt etykietę, pole lub oddzielne innych formantów. Formantów statycznych podjąć nie danych wejściowych i zapewnia nie wyjście. Aby uzyskać więcej informacji zobacz temat Formantów statycznych. |
| Dla tabeli stylów statyczne formantu, który można określić w parametrze dwStyle zobacz Statyczne stylów formantu. |
Systemu Windows 95:System może obsługiwać maksymalnie 16,364 okno uchwyty.
Uwaga Jeśli określisz Windows wersja 4.x, gdy łączenie aplikacji, jej systemu windows nie może mieć przyciski paska tytułowego, chyba że mają one również menu Okno. To nie jest wymogiem Jeśli określisz system Windows w wersji 3.x, gdy łączenie aplikacji.
Systemu Windows CE: Właściwości CreateWindow jest zaimplementowany jako makro. Jest ona definiowana jako funkcji CreateWindowEx, ale z parametrem dwExStyle ustawiony na 0 L.
Paski menu nie są obsługiwane. Parametr hMenu musi mieć wartość NULL, o ile nie jest używane jako identyfikator okna podrzędnego.
Klasy okno MDICLIENT nie jest obsługiwany.
Parametr dwStyle może być kombinacją style okien i stylów formantu udokumentowane w:
Okna dialogowe
Windows
Formanty
Następujące flagi dwStyle nie są obsługiwane w systemie windows:
| WS_CHILDWINDOW | WS_ICONIC |
| WS_MAXIMIZE | WS_MAXIMIZEBOX |
| WS_MINIMIZE | WS_MINIMIZEBOX |
| WS_OVERLAPPEDWINDOW | WS_POPUPWINDOW |
| WS_SIZEBOX | WS_THICKFRAME |
| WS_TILED | WS_TILEDWINDOW |
Następujące flagi dwStyle nie są obsługiwane dla formantów i oknach dialogowych:
| Nieobsługiwana przycisk Style | Nieobsługiwany formant statyczne style |
| BS_LEFTTEXT | SS_BLACKFRAME |
| BS_MULTILINE | SS_GRAYFRAME |
| BS_TEXT | SS_METAPICT |
| BS_USERBUTTON | SS_SIMPLE |
| Style pola kombi nieobsługiwane | SS_WHITERECT |
| CBS_OWNERDRAWFIXED | SS_BLACKRECT |
| CBS_OWNERDRAWVARIABLE | SS_GRAYRECT |
| CBS_SIMPLE | SS_RIGHTIMAGE |
| Nieobsługiwana listy pole formantu style | SS_WHITEFRAME |
| LBS_NODATA | Nieobsługiwana okno dialogowe Style ramek |
| LBS_OWNERDRAWFIXED | DS_ABSALIGN |
| LBS_OWNERDRAWVARIABLE | DS_CENTERMOUSE |
| LBS_STANDARD | DS_CONTEXTHELP |
| Style pasków przewijania nieobsługiwane | DS_FIXEDSYS |
| SBS_BOTTOMALIGN | DS_NOFAILCREATE |
| SBS_RIGHTALIGN | DS_NOIDLEMSG |
| SBS_SIZEBOXBOTTOMRIGHTALIGN | DS_SYSMODAL |
| SBS_SIZEGRIP |
Można użyć stylu BS_OWNERDRAW jako substytut dla stylu BS_USERBUTTON.
Dla formantów statycznych, można zamiast styl SS_SIMPLE styl SS_LEFT lub SS_LEFTNOWORDWRAP..
Klasy okno MDICLIENT nie jest obsługiwany.
Wszystkie okna niejawnie są style WS_CLIPSIBLINGS i WS_CLIPCHILDREN.
Windows CE 1.0 nie obsługuje własnością systemu windows, z wyjątkiem dla okien dialogowych. Jeżeli parametr hwndParent nie ma wartości NULL, okna niejawnie znajduje się styl WS_CHILD.
Windows CE w wersji 1.0 obsługuje paski menu.
nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Należy użyć user32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.
Omówienie Windows, okno funkcji, CLIENTCREATESTRUCT, CREATESTRUCT, funkcji CreateWindowEx, GlobalAddAtom, RegisterClassEx, WM_COMMAND, WM_CREATE, WM_GETMINMAXINFO, WM_NCCREATE, WM_PAINT