SetWindowTextW 函式 (winuser.h)

如果指定視窗的標題列有一個) ，請變更其標題列的文字 (。如果指定的視窗是控制項，控制項的文字就會變更。不過， SetWindowText 無法變更另一個應用程式中控制項的文字。

語法

BOOL SetWindowTextW(
  [in]           HWND    hWnd,
  [in, optional] LPCWSTR lpString
);

[in] hWnd

類型： HWND

要變更其文字之視窗或控制項的控制碼。

[in, optional] lpString

類型： LPCWSTR

新的標題或控制項文字。

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

如果目標視窗是由目前進程所擁有， SetWindowText 會導致 WM_SETTEXT 訊息傳送至指定的視窗或控制項。不過，如果控制項是使用 WS_CAPTION 樣式所建立的清單方塊控制項， SetWindowText 會 設定控制項的文字，而不是清單方塊專案。

若要在另一個進程中設定控制項的文字，請直接傳送 WM_SETTEXT 訊息，而不是呼叫 SetWindowText。

SetWindowText函式不會 (ASCII 程式碼0x09) 展開索引標籤字元。定位字元會顯示為垂直線 (|) 個字元。

如需範例，請參閱傳送訊息。

注意

winuser.h 標頭會將 SetWindowText 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
DLL	User32.dll
API 集合	ext-ms-win-ntuser-window-l1-1-3 (于 Windows 10 10.0.10240 版)

概念

參考