SetMenuItemBitmaps

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

(BOOL SetMenuItemBitmaps HMENU  hMenu, / / לטפל לתפריטUINTuPosition, / / פריט תפריט לקבל מפות סיביות חדשUINTuFlags, / / מסמן בדגל של פריט בתפריטHBITMAPhBitmapUnchecked, / / לטפל מפת סיביות לא מסומןHBITMAPhBitmapChecked / / לטפל אל מפת הסיביות של המסומן);
 

פרמטרים

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

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

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר אינו אפס.

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

הערות

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

כאשר התפריט מושמד, מפות סיביות אלה שלא נהרס; זהו יישום להשמיד אותם.

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

השתמש בפונקציה GetSystemMetrics עם ערכי CXMENUCHECK ו- CYMENUCHECK כדי לאחזר את הממדים של מפת סיביות.

QuickInfo

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

ראה גם

מבט כולל תפריטים, תפריט פונקציות, GetSystemMetrics

Index