GetMenuString

הפונקציה GetMenuString מעתיק מחרוזת הטקסט של פריט התפריט שצוין לתוך המאגר שצוין.

הפונקציה פונקציה GetMenuString הוחלף. השתמש בפונקציה GetMenuItemInfo כדי לאחזר את הטקסט של פריט תפריט.

int GetMenuString ( HMENU  hMenu, / / לטפל לתפריטUINTuIDItem, / / מזהה פריט תפריטLPTSTRlpString, / / המצביע אל המאגר עבור המחרוזתintnMaxCount, / / המרבי אורך המחרוזתUINTuFlag / / תפריט דגלי);
 

פרמטרים

hMenu

לטפל לתפריט.

uIDItem

מציין את פריט התפריט ישונו, כפי שנקבע על-ידי הפרמטר uFlag.

lpString

המצביע אל המאגר הוא לקבל את מחרוזת המסתיימת ב- null.

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

nMaxCount

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

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

uFlag

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

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

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר מציין את מספר התווים העתקה למאגר, לא כולל את התו null סיום.

אם הפעולה תיכשל, הערך המוחזר הוא אפס.

הערות

הפרמטר nMaxCount חייב להיות אחד גדול יותר מספר התווים במחרוזת טקסט כדי להכיל את התו null סיום.

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

ראה גם

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

Index