TrackPopupMenuEx

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

(BOOL TrackPopupMenuEx HMENU  hmenu,  UINT  fuFlags,  int  x,  int  y,  HWND  hwnd,  LPTPMPARAMS  lptpm  );
 

פרמטרים

hmenu
לטפל לתפריט הקיצור שיוצג. נקודת אחיזה זו ניתן להשיג על-ידי קריאה בפונקציה CreatePopupMenu כדי ליצור תפריט קיצור דרך חדש או על-ידי קריאה לפונקציה GetSubMenu כדי לאחזר את נקודת האחיזה כדי המשנה המשויכים על פריט התפריט הקיים.
fuFlags
מיקום ואפשרויות אחרות. פרמטר זה, שיכול להיות אפס או יותר מהערכים ברשימה עם הפונקציה TrackPopupMenu , יכול גם לכלול את אחד הערכים הבאים:
ערך משמעות
TPM_HORIZONTAL אם אין אפשרות להציג את התפריט במיקום שצוין ללא חפיפה המלבן שלא נכללו, המערכת מנסה להתאים את היישור האופקי המבוקש לפני יישור אנכי המבוקש.
TPM_VERTICAL אם אין אפשרות להציג את התפריט במיקום שצוין ללא חפיפה המלבן שלא נכללו, המערכת מנסה להתאים את היישור האנכי המבוקש לפני היישור האופקי המבוקש.

המלבן שלא נכללו הוא חלק של המסך אשר אינן יכולות לחפוף התפריט; הוא מצוין על-ידי lptpm.

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

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

lptpm
אינן יכולות לחפוף מצביע למבנה TPMPARAMS המציין אזור של המסך התפריט. פרמטר זה יכול להיות NULL.

להחזיר ערכים

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

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

הערות

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

TPM_NONOTIFY

TPM_LEFTBUTTON

TPM_RIGHTBUTTON

TPM_HORIZONTAL

TPM_VERTICAL

הפרמטר lptpm חייב להיות מוגדר כ- NULL.

QuickInfo

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

ראה גם

מבט כולל תפריטים, תפריט פונקציות, CreatePopupMenu, GetSubMenu, TPMPARAMS, TrackPopupMenu, WM_COMMAND

Index