SetWindowText

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

(BOOL SetWindowText HWND  hWnd, / / לטפל חלון או לפקדLPCTSTRlpString / / כתובת של מחרוזת);
 

פרמטרים

hWnd
לטפל לחלון או פקד שאת הטקסט הוא שינוי.
lpString
המצביע למחרוזת המסתיימת ב- null בו יש להשתמש בתור טקסט כותרת או פקד חדש.

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר אינו אפס.

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

הערות

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

הפונקציה SetWindowText אינה מתרחבת תווי טאב (קוד ASCII 0x09). תווי טאב מוצגים תווים ופס אנכי (|).

QuickInfo

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

ראה גם

מבט כולל על Windows, פונקציות חלון, GetWindowText, WM_SETTEXT

Index