CreateWindowEx

הפונקציה CreateWindowEx יוצרת חלון חופף, חלון מוקפץ או צאצא בסגנון מורחב; אחרת, פונקציה זו זהה לפונקציה של createwindow ליצירת . לקבלת מידע נוסף אודות יצירת חלון מלא תיאורים של שאר הפרמטרים של CreateWindowEx, ראה של createwindow ליצירת.

(HWND CreateWindowEx DWORD  dwExStyle, / / מורחב סגנון חלוןLPCTSTRlpClassName, / / מצביע רשום שם מחלקהLPCTSTRlpWindowName, / / מצביע על שם החלוןDWORDdwStyle, / / סגנון חלון int x, / / אופקי המיקום של חלון int y, / / אנכי המיקום של חלון intnWidth, / / רוחב חלון intnHeight, / / גובה החלוןHWNDhWndParent, / / לטפל לחלון האב או בעליםHMENUhMenu, / / לטפל לתפריט או מזהה חלון צאצאHINSTANCEhInstance, / / לטפל מופע היישוםLPVOIDlpParam / / מצביע לנתוני יצירת חלון);
 

פרמטרים

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	מאפשר למשתמש לנווט בין חלונות צאצאים של החלון על-ידי שימוש במקש tab.
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	מציין כי חלון שנוצרה בסגנון זה יש למקם windows ומעל הכל ללא-העליון תשארו מעליהם, גם כאשר החלון הופך ללא פעיל. כדי להוסיף או להסיר סגנון זה, השתמש בפונקציה SetWindowPos.
WS_EX_TRANSPARENT	מציין כי לא צבועים חלון שנוצרה בסגנון זה עד צבועות אחים מתחת החלון (שנוצרו על-ידי באותו הליך משנה). החלון מופיע שקוף מכיוון הסיביות של windows אח הבסיסית כבר צבועות. כדי להשיג שקיפות ללא הגבלות אלה, השתמש SetWindowRgn הפונקציה.
WS_EX_WINDOWEDGE	מציין כי חלון יש גבול עם קצה מוגבה.

שימוש WS_EX_RIGHT סגנון עבור סטטי או פקדי עריכה יש השפעה זהה לזו של שימוש בסגנון SS_RIGHT או ES_RIGHT, בהתאמה. שימוש בסגנון זה עם לחצן פקדים יש השפעה זהה לזו של שימוש בסגנונות BS_RIGHT ו- BS_RIGHTBUTTON.

lpClassName

המצביע למחרוזת המסתיימת ב- null או אטום מספר שלם. אם lpClassName הוא אטום, עליו להיות אטום כללית שנוצרו על-ידי קריאה קודמת ל- GlobalAddAtom. האטום, ערך של 16 סיביות קטן מ 0xC000, חייב להיות ב- word מסדר נמוך של lpClassName; המילה הגבוהות חייב להיות אפס.

אם lpClassName הוא מחרוזת, ערך זה מציין את שם המחלקה של החלון. שם המחלקה יכול להיות כל שם רשום עם הפונקציה RegisterClassEx או כל אחד משמות שליטה מראש-מחלקה.

lpWindowName

מצביע מחרוזת המסתיימת ב- null מציין את שם החלון.

אם סגנון החלון מציין שורת כותרת, כותרת חלון הצביע על-ידי lpWindowName מוצגת בשורת הכותרת. בעת שימוש של createwindow ליצירת ליצירת פקדים, כגון לחצנים, תיבות סימון ופקדים סטטי, להשתמש lpWindowName כדי לציין את הטקסט של הפקד.

dwStyle

מציין את הסגנון של חלון יוצרת. פרמטר זה יכול להיות שילוב של סגנונות חלון הבא, וכן הסגנונות הבקרה שצוינו בסעיף הערות.

סגנון	משמעות
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	יוצרת חלון בעל פס גלילה אנכי.

x

מציין את המיקום האופקי הראשונית של החלון. קיים חלון מוקפץ או חופף, הפרמטר x היא קואורדינטת x הראשונית של הפינה השמאלית העליונה של החלון, בקואורדינטות מסך. חלון צאצא, x הוא הקואורדינטה x של הפינה השמאלית העליונה של החלון ביחס לפינת השמאלית העליונה של אזור הלקוח של החלון האב.

אם x הוא CW_USEDEFAULT, המערכת בוחרת את מיקום ברירת המחדל בפינה השמאלית העליונה של החלון ומתעלם הפרמטר y . CW_USEDEFAULT הוא חוקי רק עבור windows חופף; אם צוין עבור פרמטרים חלון, x ו- y חלון מוקפץ או צאצא מוגדר כאפס.

y

ציון המיקום האנכי הראשונית של החלון. קיים חלון מוקפץ או חופף, הפרמטר y היא ראשונית קואורדינטת y של הפינה השמאלית העליונה של החלון, בקואורדינטות מסך. עבור חלון צאצא, y הוא קואורדינטת y הראשונית של הפינה השמאלית העליונה של חלון צאצא יחסיות לפינה הימנית העליונה של אזור הלקוח של החלון האב. תיבת רשימה, y הוא קואורדינטת y הראשונית של הפינה השמאלית העליונה של אזור הלקוח של תיבת הרשימה יחסית לפינה הימנית העליונה של אזור הלקוח של החלון האב.

אם החלון חופף נוצר עם ערכת הסיביות של הסגנון WS_VISIBLE הפרמטר x מוגדר CW_USEDEFAULT, המערכת מתעלמת הפרמטר y.

nWidth

ציון הרוחב, ביחידות של ההתקן, של החלון. עבור windows חופף, nWidth היא ברוחב של החלון, קואורדינטות מסך, או CW_USEDEFAULT. אם nWidth CW_USEDEFAULT, המערכת בוחרת ברירת המחדל רוחב וגובה עבור החלון; רוחב ברירת המחדל של הרחבת החל הקואורדינטות x הראשונית לקצה הימני של המסך; גובה ברירת המחדל מרחיב מ הראשונית הקואורדינטה y לחלק העליון של האזור סמל. CW_USEDEFAULT הוא חוקי רק עבור windows חופף; אם CW_USEDEFAULT מצוין עבור חלון מוקפץ או ילד, הפרמטר nWidth ו- nHeight מוגדרים לאפס.

nHeight

מציין את הגובה ביחידות של ההתקן, של החלון. עבור windows חופף, nHeight הוא בגובה של החלון, בקואורדינטות מסך. אם הגדרת את הפרמטר nWidth היא CW_USEDEFAULT, המערכת מתעלמת nHeight.

hWndParent

לטפל בחלון האב או בעלים של החלון יוצרת. כדי ליצור חלון צאצא או חלון בבעלות, לספק נקודת אחיזה חלון חוקי. פרמטר זה הוא אופציונלי עבור חלונות מוקפצים.

Windows NT 5.0 ואילך: כדי ליצור חלון ההודעה בלבד, לספק HWND_MESSAGE או נקודת אחיזה לחלון ההודעה בלבד קיים.

hMenu

לטפל לתפריט, או ציון מזהה חלון צאצא, בהתאם סגנון החלון. קיים חלון מוקפץ או חופף, hMenu מזהה את התפריט כדי לשמש עם החלון; זה יכול להיות NULL אם התפריט מחלקה כדי לשמש. חלון צאצא, hMenu מציין את מזהה חלון צאצא, ערך מספר שלם בשימוש על-ידי פקד של תיבת הדו-שיח כדי להודיע האב שלו אודות אירועים. היישום קובע את מזהה חלון צאצא; הוא מוכרח להיות ייחודי עבור כל ילד חלונות באותו חלון האב.

hInstance

לטפל למופע של המודול שברצונך לשייך החלון.

lpParam

מצביע על ערך שיש להעביר החלון באמצעות המבנה CREATESTRUCT עברו בפרמטר lParam את ההודעה WM_CREATE . אם יישום שיחות של createwindow ליצירת כדי ליצור חלון לקוח ממשק (MDI) מסמך מרובים, lpParam חייב להצביע מבנה CLIENTCREATESTRUCT.

להחזיר ערכים

אם הפונקציה מצליחה, ערך ההחזרה הוא נקודת אחיזה לחלון החדש.

אם הפעולה תיכשל, הערך המוחזר הוא NULL. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.

הערות

הפונקציה CreateWindowEx שולחת הודעות WM_NCCREATE WM_NCCALCSIZE, WM_CREATE החלון יוצרת.

לקבלת מידע אודות שליטה אם שורת המשימות מציגה לחצן עבור החלון שנוצר, ראה ניראות של לחצני שורת המשימות.

ניתן לציין המחלקות פקד המוגדרות מראש הבאות בפרמטר lpClassName . הערה שסגנונות הפקד המתאים, באפשרותך להשתמש בפרמטר dwStyle.

Windows 95: המערכת יכול לתמוך מרבי של נקודות אחיזה של חלון 16,364.

חלונות CE: Windows CE אינו תומך שורות תפריטים העצמאיים. הפרמטר hMenu חייב להיות NULL, אלא אם כן היא משמשת כמזהה חלון צאצא.

בגירסאות Windows CE 2.0 או גירסה מתקדמת יותר תומך שני סגנונות חלון הבא:

WS_EX_NOACTIVATE

לא ניתן להפעיל את חלון ברמה העליונה שנוצרו עם סגנון זה. אם חלון צאצא יש סגנון זה, הקשה עליו לא יגרום האב שלו ברמה העליונה תופעל. חלון הכולל סגנון זה יקבלו אירועים עט אלקטרוני, אך לא הוא ולא חלונותיו הילד יכול לקבל את המוקד.

WS_EX_NOANIMATION

חלון שנוצרה בסגנון זה תציג מתפוצצים המונפש ואת imploding מלבנים, אינו כולל לחצן בשורת המשימות.

הדגלים dwExStyle הבאים אינם נתמכים.

Windows CE 1.0 אינו תומך בסגנון WS_EX_TOPMOST. בגירסה 2.0 ואילך.

הדגלים dwStyle הבאים אינם נתמכים.

כל החלונות יש במרומז את WS_CLIPSIBLINGS ואת WS_CLIPCHILDREN סגנונות.

Windows CE 1.0 אינו תומך windows בבעלות, למעט עבור תיבות דו-שיח. אם הפרמטר hwndParent אינה NULL, החלון ניתנת במרומז את סגנון WS_CHILD.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.

ראה גם

מבט כולל על Windows, חלון מתפקד, CLIENTCREATESTRUCT, CREATESTRUCT, של createwindow ליצירת, GlobalAddAtom, RegisterClassEx, SetWindowPos, WM_CREATE, WM_NCCALCSIZE, WM_NCCREATE, WM_PAINT, WM_PARENTNOTIFY

Index