DRAWITEMSTRUCT

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

 typedef struct tagDRAWITEMSTRUCT {/ / דיס UINT CtlType; 
    UINT CtlID; 
    UINT itemID; 
    UINT itemAction; 
    UINT itemState; 
    HWND hwndItem; 
    HDC hDC; 
    RECT rcItem; 
    נתוני פריט DWORD; 
} DRAWITEMSTRUCT 

 

חברים

CtlType
מציין את סוג הפקד. חבר זה יכול להיות אחד מהבאים:
ערך משמעות
ODT_BUTTON לחצן שצוירו על-ידי הבעלים
ODT_COMBOBOX תיבה משולבת שצוירו על-ידי הבעלים
ODT_LISTBOX תיבת רשימה שצוירו על-ידי הבעלים
ODT_LISTVIEW פקד בתצוגת רשימה
ODT_MENU פריט התפריט שצוירו על-ידי הבעלים
ODT_STATIC שצוירו על-ידי הבעלים של פקד סטטי
ODT_TAB פקד כרטיסיה

CtlID
קביעת המזהה של תיבה משולבת, תיבת רשימה, לחצן או פקד סטטי. חבר זה לא נעשה עבור פריט תפריט.
itemID
מציין את מזהה פריט תפריט פריט תפריט או את האינדקס של הפריט בתיבת רשימה או בתיבה משולבת. עבור תיבת רשימה ריקה או תיבה משולבת, חבר זה יכול להיות – 1. פעולה זו מאפשרת ליישום לצייר מלבן המוקד רק בקואורדינטות אשר נקבעו על-ידי חבר rcItem למרות שישנם פריטים בפקד. הדבר מציין למשתמש אם תיבת הרשימה או התיבה המשולבת בעל המוקד. כיצד להגדיר את הסיביות חבר itemAction קובע המלבן הוא להיגרר כאילו תיבת הרשימה או התיבה המשולבת במוקד.
itemAction
מציין את פעולת הציור הנדרש. חבר זה יכול להיות אחד או יותר מהבאים:
ערך משמעות
ODA_DRAWENTIRE הפקד כולו צורך לצייר.
ODA_FOCUS הפקד אבד או זכו מוקד לוח המקשים. יש לבדוק את החבר itemState כדי לקבוע אם הפקד נמצא במוקד.
ODA_SELECT שינה מצב הבחירה. יש לבדוק את החבר itemState כדי לקבוע את מצב בחירה חדשה.

itemState
מציין את המצב החזותי של הפריט לאחר פעולת הציור הנוכחי מתקיים. חבר זה יכול להיות שילוב של הערכים הבאים:
ערך משמעות
ODS_CHECKED פריט התפריט הוא ייבדק. סיבית זו משמשת רק תפריט.
ODS_COMBOBOXEDIT הציור מתרחש בתחום הבחירה (פקד עריכה) בתיבה משולבת שצוירו על-ידי הבעלים לא.
ODS_DEFAULT הפריט הוא פריט ברירת המחדל.
ODS_DISABLED הפריט הוא להיגרר כאל לא זמינה.
ODS_FOCUS הפריט במוקד באמצעות לוח המקשים.
ODS_GRAYED הפריט הוא להיות אפור. סיבית זו משמשת רק תפריט.
ODS_SELECTED המצב של פריט התפריט נבחר.

hwndItem
לטפל לפקד עבור תיבות משולבות, תיבות רשימה, לחצני פקדים סטטיים. תפריטים, חבר זה מזהה את תפריט המכיל את הפריט.
hDC
לטפל בהקשר התקן; בהקשר זה התקן יש להשתמש בעת ביצוע פעולות הציור הפקד.
rcItem
ציון המלבן המגדיר את גבולות הפקד לצייר. מלבן זה הוא בהקשר התקן שצוין על-ידי חבר hDC . המערכת באופן אוטומטי פריטים דבר חלון בעלים מצייר בהקשר התקן עבור תיבות משולבות, תיבות רשימה ולחצנים, אך לא אוסף תמונות של פריטי התפריט. בעת ציור פריטי תפריט, חלון בעלים לא להפסיק מחוץ לגבולות המלבן שמוגדר על-ידי חבר rcItem.
נתוני פריט
מציין את ערך 32 סיביות המוגדר על-ידי היישום המשויך פריט התפריט. עבור פקד, פרמטר זה מציין את הערך האחרון המוקצות את תיבת הרשימה או התיבה המשולבת על-ידי הודעה LB_SETITEMDATA או CB_SETITEMDATA . אם תיבת הרשימה או התיבה המשולבת היא בסגנון LBS_HASSTRINGS או CBS_HASSTRINGS, ערך זה נקבע תחילה אפס. אחרת, ערך זה נקבע תחילה הערך שהועבר אל תיבת הרשימה או התיבה המשולבת בפרמטר lParam של אחת ההודעות הבאות:

אם ctlType הוא ODT_BUTTON או ODT_STATIC, ש- itemData הוא אפס.

QuickInfo

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

ראה גם

מבט כולל על תיבות משולבות, מבנים של התיבה המשולבת, CB_ADDSTRING, CB_INSERTSTRING, CB_SETITEMDATA, LB_ADDSTRING, LB_INSERTSTRING, LB_SETITEMDATA, WM_DRAWITEM

Index