DLGITEMTEMPLATE

המבנה DLGITEMTEMPLATE מגדיר את הממדים ואת סגנון של פקד בתיבת דו-שיח. אחד או יותר של מבנים אלה משולבות עם מבנה DLGTEMPLATE ליצירת תבנית רגילה עבור תיבת דו-שיח.

typedef struct {/ / סגנון DWORD dlit; 
    DWORD dwExtendedStyle; 
    x קצרה; 
    y קצרה; 
    cx קצרה; 
    cy קצרה; 
    WORD מזהה; 
} DLGITEMTEMPLATE 

 

חברים

סגנון

מציין את הסגנון של הפקד. חבר זה יכול להיות שילוב של ערכים סגנון חלון (כגון WS_BORDER) אחד או יותר מהערכים סגנון הפקד (כגון BS_PUSHBUTTON ו- ES_LEFT).

dwExtendedStyle

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

x

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

y

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

cx

ציון הרוחב, ביחידות תיבת הדו-שיח, הפקד.

cy

מציין את הגובה ביחידות תיבת הדו-שיח, הפקד.

מזהה

מציין את המזהה של הפקד.

הערות

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

כל מבנה DLGITEMTEMPLATE בתבנית עליך ליישר על גבול DWORD . עליך להיות מיושרים מערכים class וכותרת ב- WORD גבולות. ניתן ליישר את מערך נתונים של היצירה על גבול של מילה.

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

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

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

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

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

QuickInfo

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

ראה גם

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

Index