SetWindowText

Windows API宏，在WinUser.h中根據是否已定義Unicode被分別定義為SetWindowTextW和SetWindowTextA，這兩個函式改變指定視窗的標題欄的文本內容（如果視窗有標題欄）。如果指定視窗是一個控制項，則改變控制項的文本內容。特別需要引起重視的是，【SetWindowText函式不改變在其他應用程式中的控制項的文本內容，如果需要可以用另外一個SendMessage函式傳送一條WM_SETTEXT訊息】。

基本介紹

• 中文名：設定視窗文本
• 外文名：SetWindowText
• 聲明位置：WinUser.h
• 所屬作業系統：Windows

語法

BOOLSetWindowText(

HWNDhwnd,

LPCTSTRlpString

);

參數

hWnd

要改變文本內容的視窗或控制項的句柄。不能改變在其他應用程式中的控制項的文本內容，如果需要可以用另外一個SendMessage函式傳送一條WM_SETTEXT訊息。

lpString

指向一個空結束的字元串的指針，該字元串將作為視窗或控制項的新文本。

返回值

如果函式成功，返回值為非零(在win7中，對其他程式的文本框賦值會返回1，但是無法改變其內容)；如果函式失敗，返回值為零。若想獲得更多錯誤信息，請調用GetLastError函式。

備註

如果目標視窗屬於當前進程，SetWindowText函式會使WM_SETTEXT訊息傳送給指定的視窗或控制項。然而，如果控制項是以WS_CAPTION風格創建的列表框控制項，SetWindowText函式將為控制項設定文本，而不是為列表項設定文本。

SetWindowText函式不擴展Tab字元（ASCII代碼0×09），Tab字元以字元‘|’來顯示。

需求

DLL最低版本	user32.dll
頭檔案	在Winuser.h中聲明，包含於Windows.h。
庫檔案	User32.lib
作業系統最低版本	Windows 95, Windows NT 3.1
Unicode	以ANSI和Unicode版本實現。