GetMenuDefaultItem

הפונקציה GetMenuDefaultItem קובעת את פריט תפריט ברירת המחדל בתפריט שצוין.

(UINT GetMenuDefaultItem HMENU  hMenu,  UINT : UINT  fByPos,  gmdiFlags  );

פרמטרים

hMenu

לטפל לתפריט שיש לאחזר פריט תפריט ברירת המחדל.

fByPos

ערך המציין אם לאחזר המזהה של פריט התפריט או את המיקום שלו. אם פרמטר זה הוא FALSE, המזהה מוחזרת. אחרת, מוחזר מיקומו.

gmdiFlags

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

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

ערך

משמעות

GMDI_GOINTOPOPUPS

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

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

GMDI_USEDISABLED

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

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

להחזיר ערכים

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

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

QuickInfo

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

ראה גם

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