GetDlgItemTextW 関数 (winuser.h)
ダイアログ ボックス内のコントロールに関連付けられているタイトルまたはテキストを取得します。
構文
UINT GetDlgItemTextW(
[in] HWND hDlg,
[in] int nIDDlgItem,
[out] LPWSTR lpString,
[in] int cchMax
);
パラメーター
[in] hDlg
型: HWND
コントロールを含むダイアログ ボックスのハンドル。
[in] nIDDlgItem
型: int
タイトルまたはテキストを取得するコントロールの識別子。
[out] lpString
型: LPTSTR
タイトルまたはテキストを受け取るバッファー。
[in] cchMax
型: int
lpString
戻り値
型: UINT
関数が成功した場合、戻り値はバッファーにコピーされる文字数を指定します。終端の null 文字は含まれません。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError
備考
文字列がバッファーの長さ以上の場合、バッファーには、終端の null 文字を含む切り捨てられた文字列が含まれます。
GetDlgItemText 関数は、WM_GETTEXT メッセージをコントロールに送信します。
例
例については、「モーダル ダイアログ ボックスの作成」を参照してください。
手記
winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetDlgItemText を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | winuser.h (Windows.h を含む) |
ライブラリ | User32.lib |
DLL | User32.dll |
API セットの | ext-ms-win-ntuser-dialogbox-l1-1-0 (Windows 8 で導入) |
関連項目
概念
GetDlgItemInt を
リファレンス
SetDlgItemText の