SetWindowText

SetWindowText

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

語法

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

相關詞條

相關搜尋

熱門詞條

聯絡我們