GetDlgItemText

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

 (UINT GetDlgItemText HWND  hDlg, / / לטפל בתיבת הדו-שיחintnIDDlgItem, / / המזהה של הפקדLPTSTRlpString, / / כתובת של מאגר עבור טקסטintnMaxCount / / המרבי בגודל של מחרוזת);
 

פרמטרים

hDlg
מזהה את תיבת דו-שיח המכילה את פקד.
nIDDlgItem
קביעת המזהה של הפקד שאת כותרת או טקסט היא שיש לאחזר.
lpString
המצביע אל המאגר לקבל את הכותרת או טקסט.
nMaxCount
ציון אורך מרבי, תווים, המחרוזת שיש להעתיק אל המאגר הצביע על-ידי lpString. אם אורך המחרוזת חורג מהמגבלה, המחרוזת תעגל.

להחזיר ערכים

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

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

הערות

הפונקציה GetDlgItemText שולח הודעה WM_GETTEXT לפקד.

QuickInfo

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

ראה גם

סקירה כללית של תיבות הדו-שיח, פונקציות של תיבת הדו-שיח, GetDlgItemInt, SetDlgItemInt, SetDlgItemText, WM_GETTEXT

Index