TrackPopupMenu

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

(BOOL TrackPopupMenu HMENU  hMenu, / / לטפל לתפריט הקיצורUINTuFlags, / / מסמן מיקום המסך ואת לחצן העכברint x, / / קואורדינטות המיקום האופקי, במסךint y, / / קואורדינטות המיקום האנכי, במסך intnReserved, / / שמורות, חייב להיות אפסHWNDhWnd, / / לטפל לחלון הבעליםCONST RECT* prcRect / / להתעלם ממנה);
 

פרמטרים

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

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

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

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

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

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

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

prcRect
המערכת התעלמה.

להחזיר ערכים

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

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

הערות

חלונות CE: Windows CE אינו תומך הדגלים הבאים עבור הפרמטר uFlags

TPM_NONOTIFY

TPM_LEFTBUTTON

TPM_RIGHTBUTTON

QuickInfo

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

ראה גם

מבט כולל תפריטים, תפריט מתפקד, CreatePopupMenu, GetSubMenu, RECT, WM_COMMAND

Index