הפונקציה של createwindow ליצירת יוצרת של החלון חופף, חלון מוקפץ או ילד. ערך זה מציין מחלקת חלון, כותרת חלון, סגנון החלון, (אופציונלית) המיקום ההתחלתי ואת הגודל של החלון. הפונקציה מציינת גם האב של החלון או הבעלים, אם בכלל ותפריט של החלון.
לשימוש בסגנונות מורחבת בנוסף ל סגנונות נתמכת על-ידי של createwindow ליצירת, השתמש בפונקציה CreateWindowEx במקום להשתמש של createwindow ליצירת.
(HWND של createwindow ליצירת LPCTSTR lpClassName, / / מצביע רשום שם מחלקהLPCTSTRlpWindowName, / / מצביע על שם החלוןDWORDdwStyle, / / סגנון חלוןint x, / / אופקי המיקום של חלון int y, / / אנכי המיקום של חלון intnWidth, / / רוחב חלון intnHeight, / / גובה החלוןHWNDhWndParent, / / לטפל לחלון האב או בעליםHMENUhMenu, / / לטפל למזהה תפריט או חלון צאצאלטפלhInstance, / / לטפל מופע היישוםLPVOIDlpParam / / מצביע לנתוני יצירת חלון);
אם lpClassName הוא מחרוזת, ערך זה מציין את שם המחלקה של החלון. שם המחלקה יכול להיות כל שם רשום עם הפונקציה RegisterClassEx או כל אחד משמות שליטה מראש-מחלקה. לקבלת רשימה מלאה, עיין בסעיף הערות.
אם סגנון החלון מציין שורת כותרת, כותרת חלון הצביע על-ידי lpWindowName מוצגת בשורת הכותרת. בעת שימוש של createwindow ליצירת ליצירת פקדים, כגון לחצנים, תיבות סימון ופקדים סטטי, להשתמש lpWindowName כדי לציין את הטקסט של הפקד.
| סגנון | משמעות |
|---|---|
| WS_BORDER | יוצרת חלון בעל גבול קו דק. |
| WS_CAPTION | יוצרת חלון בעל פס כותרת (כולל את סגנון WS_BORDER). |
| WS_CHILD | יצירת חלון צאצא. לא ניתן להשתמש בסגנון זה בסגנון WS_POPUP. |
| WS_CHILDWINDOW | זהה סגנון WS_CHILD. |
| WS_CLIPCHILDREN | אי-כלילה של האזור שנכבש על-ידי windows הילד הציור מתרחש בתוך חלון האב. סגנון זה משמש בעת יצירת חלון האב. |
| 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 | ציון פקד שיכול לקבל את המוקד של לוח המקשים כאשר המשתמש לוחץ על מקש tab. הקשה על מקש tab שינוי מוקד לוח המקשים לפקד הבא בסגנון 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 | יוצרת חלון בעל פס גלילה אנכי. |
אם פרמטר זה מוגדר CW_USEDEFAULT, המערכת בוחרת את מיקום ברירת המחדל בפינה השמאלית העליונה של החלון ומתעלם הפרמטר y . CW_USEDEFAULT הוא חוקי רק עבור windows חופף; אם צוין עבור פרמטרים חלון, x ו- y חלון מוקפץ או צאצא מוגדר כאפס.
אם החלון חופף נוצר עם ערכת הסיביות של הסגנון WS_VISIBLE הפרמטר x מוגדר CW_USEDEFAULT, המערכת מתעלמת הפרמטר y.
Windows NT 5.0 ואילך: כדי ליצור חלון ההודעה בלבד, לספק HWND_MESSAGE או נקודת אחיזה לחלון ההודעה בלבד קיים.
אם הפונקציה מצליחה, ערך ההחזרה הוא נקודת אחיזה לחלון החדש.
אם הפעולה תיכשל, הערך המוחזר הוא NULL. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.
לפני החזרה, של createwindow ליצירת שולח הודעה WM_CREATE ההליך חלון. עבור חופף מוקפצים וחלונות של הילד, של createwindow ליצירת שולחת הודעות WM_CREATE, WM_GETMINMAXINFOו- WM_NCCREATE החלון. הפרמטר lParam ההודעה WM_CREATE מכיל מצביע למבנה CREATESTRUCT . אם תציין את סגנון WS_VISIBLE, של createwindow ליצירת שולח החלון כל ההודעות הדרושות כדי להפעיל ולהציג את החלון.
לקבלת מידע אודות שליטה אם שורת המשימות מציגה לחצן עבור החלון שנוצר, ראה ניראות של לחצני שורת המשימות.
ניתן לציין המחלקות פקד המוגדרות מראש הבאות בפרמטר lpClassName . הערה שסגנונות הפקד המתאים, באפשרותך להשתמש בפרמטר dwStyle.
| מחלקה | משמעות |
|---|---|
| לחצן | מדיניות זו מגדירה חלון צאצא מלבנית קטנה המייצגת לחצן שיכול המשתמש ללחוץ כדי להפעיל או לבטל אותה. ניתן להשתמש בפקדי לחצן בנפרד או בקבוצות, הם או להיות מסומנים או מופיעים ללא טקסט. לחצן פקדים בדרך כלל לשנות מראה כאשר המשתמש לוחץ עליהם. לקבלת מידע נוסף, ראה לחצנים. |
| עבור טבלה של סגנונות לחצן שבאפשרותך לציין הפרמטר dwStyle , ראה סגנונות לחצן. | |
| תיבה משולבת | מדיניות זו מגדירה פקד של תיבת רשימה שדה בחירה דומה פקד עריכה. בעת שימוש בסגנון זה, יישום עליך להציג את תיבת הרשימה בכל עת או להפוך לזמין בתיבת רשימה נפתחת. אם תיבת הרשימה גלוי, הקלדת תווים בשדה הבחירה מסמן את הערך בתיבת הרשימה הראשון שמתאים לתווים שהוקלדו. לעומת זאת, בחירת פריט בתיבת הרשימה מציג את הטקסט הנבחר בשדה הבחירה. לקבלת מידע נוסף, ראה תיבות משולבות. |
| עבור טבלה של סגנונות תיבות משולבות שבאפשרותך לציין הפרמטר dwStyle , ראה סגנונות תיבות משולבות. | |
| עריכה | מדיניות זו מגדירה חלון צאצא מלבני שאליו המשתמש להקליד טקסט באמצעות לוח המקשים. המשתמש בוחר את הפקד ונותן אותו מוקד לוח המקשים על-ידי לחיצה עליו או מעבר אליו על-ידי הקשה על מקש tab. המשתמש להקליד טקסט כאשר לפקד העריכה מציג סימן caret מהבהב; השתמש בעכבר כדי להזיז את הסמן, בחירת תווים כדי להחליף, או הצב את הסמן עבור הוספת תווים; או להשתמש במקש backspace כדי למחוק את התווים. לקבלת מידע נוסף, ראה עריכת פקדים. |
| עבור טבלה הסגנונות פקד עריכה שבאפשרותך לציין הפרמטר dwStyle , ראה עריכת סגנונות הבקרה. | |
| תיבת רשימה | מדיניות זו מגדירה רשימה של מחרוזות תווים. לציין פקד זה בכל פעם יישום חייב להציג רשימה של שמות, כגון שמות קבצים, שממנו המשתמש יכול לבחור. המשתמש יכול לבחור מחרוזת על-ידי לחיצה עליו. מחרוזת שנבחרה מודגשת ולאחר הודעה מועברת אל חלון האב. לקבלת מידע נוסף, ראה תיבות רשימה. |
| עבור טבלה של סגנונות תיבת רשימה שבאפשרותך לציין הפרמטר dwStyle , ראה סגנונות תיבות רשימה. | |
| MDICLIENT | מדיניות זו מגדירה חלון לקוח של MDI. חלון זה מקבל הודעות השולטות חלונות צאצאים של יישום MDI. Bits סגנון מומלצים הם WS_CLIPCHILDREN WS_CHILD. ציין את WS_HSCROLL ואת WS_VSCROLL סגנונות כדי ליצור חלון MDI של לקוח המאפשר למשתמש לגלול חלונות צאצא מסוג MDI לתוך תצוגת. לקבלת מידע נוסף, ראה ממשק מרובה מסמכים. |
| RichEdit | מדיניות זו מגדירה פקד עריכה עשיר גירסה 1.0. חלון זה מאפשר את תצוגת משתמש לערוך טקסט עם עיצוב פיסקה ותו ואת יכולה לכלול אובייקטים מוטבעים של COM. לקבלת מידע נוסף, ראה פקדי עריכת עשיר. |
| עבור טבלה הסגנונות פקד עריכה עשירה שבאפשרותך לציין הפרמטר dwStyle , ראה סגנונות פקד עריכה של עשיר. | |
| RICHEDIT_CLASS | מדיניות זו מגדירה פקד עריכה עשיר גירסה 2.0. פקדים זה ליידע את תצוגת משתמש לערוך טקסט עם עיצוב פיסקה ותו ואת יכולה לכלול אובייקטים מוטבעים של COM. לקבלת מידע נוסף, ראה פקדי עריכת עשיר. |
| עבור טבלה הסגנונות פקד עריכה עשירה שבאפשרותך לציין הפרמטר dwStyle , ראה סגנונות פקד עריכה של עשיר. | |
| פס גלילה | מדיניות זו מגדירה מלבן מכיל תיבת הגלילה, יש כיוון חצים בשני קצותיו. פס הגלילה שולח הודעה חלון האב שלה בכל פעם שהמשתמש לוחץ על הפקד. חלון האב הוא אחראי על עדכון המיקום של תיבת גלילה, במידת הצורך. לקבלת מידע נוסף, ראה פסי גלילה. |
| עבור טבלה הסגנונות פקד פס הגלילה שבאפשרותך לציין הפרמטר dwStyle , ראה סגנונות פקד פס גלילה. | |
| סטטי | מדיניות זו מגדירה שדה טקסט פשוט, תיבת או מלבן שישמש תווית, תיבת או להפריד בין פקדים אחרים. פקדים סטטיים להימשך ללא קלט ולספק פלט. לקבלת מידע נוסף, ראה פקדים סטטיים. |
| עבור טבלה הסגנונות פקד סטטי שבאפשרותך לציין הפרמטר dwStyle , ראה סגנונות פקד סטטי. |
Windows 95:המערכת יכול לתמוך מרבי של נקודות אחיזה של חלון 16,364.
הערה אם תציין Windows גירסה 4. x בעת קישור את היישום שלך, windows שלו אין לחצנים עם כיתוב אלא אם יש להם גם תפריטי החלון. זו אינה דרישה אם תציין גירסה Windows 3. x בעת קישור את היישום שלך.
חלונות CE: של createwindow ליצירת מיושם של מאקרו. הוא מוגדר CreateWindowEx, אלא עם הפרמטר dwExStyle מוגדר 0 L.
שורות התפריטים אינם נתמכים. הפרמטר hMenu חייב להיות NULL, אלא אם כן היא משמשת כמזהה חלון צאצא.
מחלקת חלון MDICLIENT אינו נתמך.
הפרמטר dwStyle יכול להיות שילוב של סגנונות חלון, סגנונות פקד מתועד בסעיף:
תיבות דו-שיח
Windows
פקדים
הדגלים dwStyle הבאים אינם נתמכים עבור 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 |
הדגלים dwStyle הבאים אינם נתמכים עבור פקדים ותיבות דו-שיח:
| סגנונות לחצן שאינו נתמך | סגנונות שאינם נתמכים פקד סטטי |
| BS_LEFTTEXT | SS_BLACKFRAME |
| BS_MULTILINE | SS_GRAYFRAME |
| BS_TEXT | SS_METAPICT |
| BS_USERBUTTON | SS_SIMPLE |
| סגנונות תיבות משולבות שאינן נתמכות | SS_WHITERECT |
| CBS_OWNERDRAWFIXED | SS_BLACKRECT |
| CBS_OWNERDRAWVARIABLE | SS_GRAYRECT |
| CBS_SIMPLE | SS_RIGHTIMAGE |
| סגנונות של פקד תיבת רשימה שאינם נתמכים | SS_WHITEFRAME |
| LBS_NODATA | סגנונות תיבות דו-שיח שאינו נתמך |
| LBS_OWNERDRAWFIXED | DS_ABSALIGN |
| LBS_OWNERDRAWVARIABLE | DS_CENTERMOUSE |
| LBS_STANDARD | DS_CONTEXTHELP |
| סגנונות פס הגלילה לא נתמך | DS_FIXEDSYS |
| SBS_BOTTOMALIGN | DS_NOFAILCREATE |
| SBS_RIGHTALIGN | DS_NOIDLEMSG |
| SBS_SIZEBOXBOTTOMRIGHTALIGN | DS_SYSMODAL |
| SBS_SIZEGRIP |
באפשרותך להשתמש בסגנון BS_OWNERDRAW כתחליף סגנון BS_USERBUTTON.
באפשרותך להשתמש בסגנון SS_LEFT, או SS_LEFTNOWORDWRAP במקום על הסגנון SS_SIMPLE עבור פקדים סטטיים..
מחלקת חלון MDICLIENT אינו נתמך.
כל החלונות יש במרומז את WS_CLIPSIBLINGS ואת WS_CLIPCHILDREN סגנונות.
Windows CE 1.0 אינו תומך windows בבעלות, למעט עבור תיבות דו-שיח. אם הפרמטר hwndParent אינה NULL, החלון ניתנת במרומז את סגנון WS_CHILD.
Windows CE גירסה 1.0 אינו תומך שורות תפריטים.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.
מבט כולל על Windows, חלון מתפקד, CLIENTCREATESTRUCT, CREATESTRUCT, CreateWindowEx, GlobalAddAtom, RegisterClassEx, WM_COMMAND, WM_CREATE, WM_GETMINMAXINFO, WM_NCCREATE, WM_PAINT