הפונקציה SetWindowText משנה את הטקסט של פס הכותרת של החלון שצוין (אם קיימת). אם החלון שצוין הוא פקד, הטקסט של הפקד משתנה. עם זאת, SetWindowText לא ניתן לשנות את הטקסט של פקד ביישום אחר.
(BOOL SetWindowText HWND hWnd, / / לטפל חלון או לפקדLPCTSTRlpString / / כתובת של מחרוזת);
אם הפונקציה מצליחה, הערך המוחזר אינו אפס.
אם הפעולה תיכשל, הערך המוחזר הוא אפס. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.
אם החלון היעד נמצא בבעלות התהליך הנוכחי, SetWindowText גורם הודעה WM_SETTEXT להישלח אל החלון שצוין או פקד. אם הפקד הוא פקד תיבת רשימה שנוצרה בסגנון WS_CAPTION, עם זאת, SetWindowText מגדיר את הטקסט עבור הפקד, לא עבור ערכי תיבת רשימה.
הפונקציה SetWindowText אינה מתרחבת תווי טאב (קוד ASCII 0x09). תווי טאב מוצגים תווים ופס אנכי (|).
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.
מבט כולל על Windows, פונקציות חלון, GetWindowText, WM_SETTEXT