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