次の方法で共有


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によって指されるバッファーにコピーされる文字列の最大長 (文字数)。 null 文字を含む文字列の長さが制限を超えると、文字列は切り捨てられます。

戻り値

型: 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 を する

リファレンス

SetDlgItemInt

SetDlgItemText の

WM_GETTEXT