EnableMenuItem

הפונקציה EnableMenuItem מאפשר, הופך ללא זמין, או grays את פריט התפריט שצוין.

(BOOL EnableMenuItem HMENU  hMenu, / / לטפל לתפריטUINTuIDEnableItem, / / פריט התפריט כדי להפעיל, לבטל, או אפורUINTuEnable / / מסמן בדגל של פריט בתפריט);
 

פרמטרים

hMenu

לטפל לתפריט.

uIDEnableItem

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

uEnable

מציין דגלים לשלוט הפירוש של הפרמטר uIDEnableItem , לציין אם פריט התפריט זמין, לא זמין או אפורה. פרמטר זה חייב להיות שילוב של MF_BYCOMMAND או MF_BYPOSITION, MF_ENABLED, MF_DISABLED או MF_GRAYED.

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

להחזיר ערכים

הערך המוחזר מציין את המצב הקודם של פריט התפריט (זהו MF_DISABLED, MF_ENABLED או MF_GRAYED). אם פריט התפריט אינו קיים, הערך המוחזר הוא 0xFFFFFFFF.

הערות

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

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

InsertMenu, InsertMenuItem, LoadMenuIndirect, ModifyMenuופונקציות SetMenuItemInfo ניתן גם להגדיר את המצב (זמין, לא זמין או אפורה) של פריט בתפריט.

חלונות CE: Windows CE אינו תומך את הדגל MF_DISABLED עבור הפרמטר uEnable . אין אפשרות לבטל את פריטי התפריט מבלי להיות אפור. כדי להפוך פריט תפריט השתמש בדגל MF_GRAYED.

QuickInfo

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

ראה גם

מבט כולל תפריטים, תפריט פונקציות, GetMenuItemID, InsertMenu, InsertMenuItem, LoadMenuIndirect, ModifyMenu, SetMenuItemInfo, WM_SYSCOMMAND