SetWindowTextA 関数 (winuser.h)
指定したウィンドウのタイトル バーのテキストを変更します (ある場合)。 指定したウィンドウがコントロールの場合、コントロールのテキストが変更されます。 ただし、SetWindowText は、別のアプリケーションのコントロールのテキストを変更できません。
構文
BOOL SetWindowTextA(
[in] HWND hWnd,
[in, optional] LPCSTR lpString
);
パラメーター
[in] hWnd
型: HWND
テキストを変更するウィンドウまたはコントロールへのハンドル。
[in, optional] lpString
型: LPCTSTR
新しいタイトルまたはコントロール テキスト。
戻り値
型: BOOL
関数が成功した場合、戻り値は 0 以外です。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError
備考
ターゲット ウィンドウが現在のプロセスによって所有されている場合、SetWindowText
別のプロセスでコントロールのテキストを設定するには、SetWindowTextを呼び出す代わりに、
SetWindowText 関数はタブ文字 (ASCII コード 0x09) を展開しません。 タブ文字は、縦棒 (|) 文字として表示されます。
例
例については、「メッセージの送信」を参照してください。
手記
winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetWindowText を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winuser.h (Windows.h を含む) |
| ライブラリ | User32.lib |
| DLL | User32.dll |
| API セットの | ext-ms-win-ntuser-window-l1-1-3 (Windows 10 バージョン 10.0.10240 で導入) |
関連項目
概念
GetWindowText の
リファレンス
Windows の