GetWindowText

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

int GetWindowText ( HWND  hWnd, / / לטפל לחלון או לשלוט עם טקסטLPTSTRlpString, / / כתובת של מאגר עבור טקסטintnMaxCount / / המרבי מספר תווים להעתקה);
 

פרמטרים

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

להחזיר ערכים

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

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

הערות

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

QuickInfo

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

ראה גם

מבט כולל על Windows, פונקציות חלון, GetWindowTextLength, SetWindowText, WM_GETTEXT

Index