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