GetMenuState

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

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

(UINT GetMenuState HMENU  hMenu, / / לטפל לתפריטUINTה-uId, / / פריט תפריט לשאילתה UINTuFlags / / תפריט דגלי);
 

פרמטרים

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

להחזיר ערכים

אם הפריט שצוין אינו קיים, הערך המוחזר הוא 0xFFFFFFFF.

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

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

ערך תיאור
MF_CHECKED מציב סימן ביקורת לצד הפריט (עבור תפריטים נפתחים, תפריטי משנה ותפריטי קיצור בלבד).
MF_DISABLED מבטל את הפריט.
MF_GRAYED ואילו grays את הפריט.
MF_HILITE מסמן את הפריט.
MF_MENUBARBREAK פונקציות זהה MF_MENUBREAK דגל, למעט תפריטים נפתחים, תפריטי משנה ותפריטי קיצור, בו העמודה החדשה מופרד מן העמודה ישן על-ידי קו אנכי.
MF_MENUBREAK ממקם את הפריט בשורה חדשה (עבור סרגלי תפריטים) או בעמודה חדשה (עבור תפריטים נפתחים, תפריטי משנה ותפריטי קיצור) ללא הפרדת עמודות.
MF_SEPARATOR יוצר קו המפריד האופקי (עבור תפריטים נפתחים, תפריטי משנה ותפריטי קיצור בלבד).

ראה גם

מבט כולל תפריטים, תפריט פונקציות, GetMenu, GetMenuItemCount, GetMenuItemID, GetMenuItemInfo

Index