SetDlgItemTextA 関数 (winuser.h)

ダイアログ ボックス内のコントロールのタイトルまたはテキストを設定します。

構文

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

パラメーター

[in] hDlg

型: HWND

コントロールを含むダイアログ ボックスのハンドル。

[in] nIDDlgItem

型: int

設定するタイトルまたはテキストを含むコントロール。

[in] lpString

種類: LPCTSTR

コントロールにコピーするテキスト。

戻り値

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

SetDlgItemText 関数は、指定したコントロールにWM_SETTEXTメッセージを送信します。

例については、「 リスト ボックスの使用」を参照してください。

注意

winuser.h ヘッダーは、SetDlgItemText をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-dialogbox-l1-1-0 (Windows 8 で導入)

関連項目

概念

ダイアログ ボックス

GetDlgItemInt

GetDlgItemText

リファレンス

SetDlgItemInt

WM_SETTEXT