SetWindowTextA 函式 (winuser.h)

  • 發行項

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

語法

BOOL SetWindowTextA(
  [in]           HWND   hWnd,
  [in, optional] LPCSTR lpString
);

參數

[in] hWnd

類型： HWND

要變更其文字之視窗或控件的句柄。

[in, optional] lpString

類型： LPCTSTR

新的標題或控件文字。

傳回值

類型： 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 版)

另請參閱

概念

GetWindowText

參考

WM_SETTEXT

Windows