DLGITEMTEMPLATEEX

המבנה DLGITEMTEMPLATEEX אינו מוגדר בקובץ הכותרת רגיל כלשהו. הגדרת מבנה ניתנת כאן כדי להסביר את העיצוב של תבנית מורחבת עבור תיבת דו-שיח.

עבור כל פקד בתיבת דו-שיח, יש תבנית בתיבת הדו-שיח מורחבת של בלוק נתונים המשתמשת בתבנית DLGITEMTEMPLATEEX כדי לתאר את הפקד. לקבלת תיאור של התבנית של תבנית בתיבת הדו-שיח מורחבת, ראה DLGTEMPLATEEX.

typedef struct {DWORD helpID; 
    DWORD exStyle; 
    סגנון DWORD; 
    x קצרה; 
    y קצרה; 
    cx קצרה; 
    cy קצרה; 
    WORD מזהה; 
    sz_Or_Ord windowClass; / / שם או מספר סידורי ממין של מחלקת חלון
    כותרת sz_Or_Ord;       / / כותרת מחרוזת או סודר של משאב
    המילה extraCount;     \ \ בתים של בעקבות יצירת נתונים
} DLGITEMTEMPLATEEX 

 

חברים

helpID
מציין את מזהה ההקשר של עזרה עבור הפקד. כאשר המערכת שולחת WM_HELP ההודעה, הוא מעביר את הערך helpID ב החבר dwContextId HELPINFO מבנה.
dwExtendedStyle
קביעת סגנונות מורחבת עבור חלון. חבר זה לא נעשה כדי ליצור פקדי תיבות הדו-שיח, אך יישומים העושים שימוש בתבניות של תיבת הדו-שיח ניתן להשתמש בו כדי ליצור סוגים אחרים של windows.
סגנון
מציין את הסגנון של הפקד. חבר זה יכול להיות שילוב של ערכים סגנון חלון (כגון WS_BORDER) אחד או יותר מהערכים סגנון הפקד (כגון BS_PUSHBUTTON ו- ES_LEFT).
x
ציון קואורדינטות x יחידות של תיבת הדו-שיח, של הפינה השמאלית העליונה של הפקד. קואורדינטות זו היא תמיד יחסית לפינה הימנית העליונה של אזור הלקוח של תיבת הדו-שיח.
y
ציון הקואורדינטה y, ביחידות תיבת הדו-שיח, של הפינה השמאלית העליונה של הפקד. קואורדינטות זו היא תמיד יחסית לפינה הימנית העליונה של אזור הלקוח של תיבת הדו-שיח.
cx
ציון הרוחב, ביחידות תיבת הדו-שיח, הפקד.
cy
מציין את הגובה ביחידות תיבת הדו-שיח, הפקד.
מזהה
מציין את המזהה של הפקד.
windowClass
ציון מערך באורך משתנה של רכיבי 16 סיביות המזהה את מחלקת חלון הפקד. אם הרכיב הראשון של מערך זה מכיל ערך שאינו 0xFFFF, המערכת מתייחסת המערך כמחרוזת Unicode המסתיימת ב- null המציין את שם המחלקה חלון רשומים.

אם הרכיב הראשון 0xFFFF, המערך יש רכיב נוסף אחד אשר מציין שהערך הסודר של מחלקת מערכת מוגדרת מראש. הדירוג הסודר יכול להיות אחד מהבאים: אטום.
ערך משמעות
0x0080 לחצן
0x0081 עריכה
0x0082 סטטי
0x0083 תיבת רשימה
0x0084 פס גלילה
0x0085 תיבה משולבת

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

אם הרכיב הראשון לכל ערך אחר מלבד 0xFFFF, המערכת מתייחסת המערך כמחרוזת Unicode המסתיימת ב- null המציין את הטקסט ההתחלתי.

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

הערות

תבנית מורחבת עבור תיבת דו-שיח מורכבת כותרת DLGTEMPLATEEX ואחריו מבנה DLGITEMTEMPLATEEX עבור כל פקד בתיבת הדו-שיח.

עליך ליישר כל מבנה DLGITEMTEMPLATEEX על גבול DWORD . עליך להיות מיושרים המערכים באורך משתנה windowClass ואת כותרת ב- WORD גבולות. מערך נתונים של היצירה, אם בכלל, עליך ליישר על גבול של מילה.

אם ברצונך לציין מחרוזות תווים מערכים windowClass ואת כותרת , עליך להשתמש במחרוזות Unicode. כדי ליצור קוד הפועל ב- Windows ו- Windows NT, השתמש בפונקציה MultiByteToWideChar כדי ליצור מחרוזות Unicode אלה.

חברי x, y, cxו cy לציין ערכים ביחידות של תיבת הדו-שיח. באפשרותך להמיר ערכים אלה יחידות מסך (פיקסלים) באמצעות הפונקציה MapDialogRect.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.51 ואילך.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.

ראה גם

סקירה כללית של תיבות הדו-שיח, מבני תיבת הדו-שיח, CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DLGITEMTEMPLATE, DLGTEMPLATE, DLGTEMPLATEEX, MapDialogRect, MultiByteToWideChar

Index