EM_GETLINE メッセージ (Winuser.h)

  • [アーティクル]

編集コントロールからテキスト行をコピーし、指定したバッファーに配置します。 このメッセージは、編集コントロールまたはリッチ エディット コントロールに送信できます。

パラメーター

wParam

複数行の編集コントロールから取得する行の 0 から始まるインデックス。 0 の値は、一番上の行を指定します。 このパラメーターは、1 行の編集コントロールでは無視されます。

lParam

行のコピーを受け取るバッファーへのポインター。 メッセージを送信する前に、このバッファーの最初の単語をバッファーの サイズ (TCHARs) に設定します。 ANSI テキストの場合、これはバイト数です。Unicode テキストの場合、これは文字数です。 最初の単語のサイズは、コピーした行によって上書きされます。

戻り値

戻り値は、コピーされた TCHARの数です。 wParam パラメーターで指定された行番号が編集コントロールの行数より大きい場合、戻り値は 0 です。

解説

コントロールの編集: コピーされた行に終端の null 文字が含まれていません。

豊富な編集コントロール: Microsoft Rich Edit 1.0 以降でサポートされています。 テキストがコピーされなかった場合を除き、コピーされた行には終端の null 文字は含まれません。 テキストがコピーされなかった場合、メッセージはバッファーの先頭に null 文字を配置します。 リッチ エディット バージョンとさまざまなシステム バージョンの互換性については、「 Rich Edit Controls について」を参照してください。

必要条件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー
Winuser.h (Windows.h を含む)

関連項目

参照

EM_LINELENGTH

Edit_GetLine

その他のリソース

WM_GETTEXT