語法
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版本實現。 |