SetDlgItemTextA 函式 (winuser.h)

設定對話方塊中控制項的標題或文字。

語法

BOOL SetDlgItemTextA(
  [in] HWND   hDlg,
  [in] int    nIDDlgItem,
  [in] LPCSTR lpString
);

[in] hDlg

類型： HWND

包含控制項之對話方塊的控制碼。

[in] nIDDlgItem

類型： int

要設定標題或文字的控制項。

[in] lpString

類型： LPCTSTR

要複製到控制項的文字。

類型： BOOL

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

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

SetDlgItemText函式會將WM_SETTEXT訊息傳送至指定的控制項。

如需範例，請參閱使用清單方塊。

注意

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


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-dialogbox-l1-1-0 (在 Windows 8)