EM_STREAMOUT メッセージ

リッチ エディット コントロールに、その内容をアプリケーション定義 の EditStreamCallback コールバック関数に渡します。 コールバック関数は、データのストリームを、選択したファイルまたはその他の場所に書き込むことができます。

パラメーター

wParam

データ形式と置換オプションを指定します。

この値は、次のいずれかの値である必要があります。

値	説明
SF_RTF	Rtf。
SF_RTFNOOBJS	COM オブジェクトの代わりにスペースを含む RTF。
SF_TEXT	COM オブジェクトの代わりにスペースを含むテキスト。
SF_TEXTIZED	COM オブジェクトのテキスト表現を含むテキスト。

SF_RTFNOOBJS オプションは、COM オブジェクトの RTF 表現はあまりコンパクトでなく、アプリケーションが COM オブジェクト自体を格納する場合に便利です。 コントロール ワード \objattph の後にスペースが続くは、オブジェクトの位置を示します。

さらに、次のフラグを指定できます。

値	説明
SFF_PLAINRTF	指定した場合、リッチ エディット コントロールは、言語固有のキーワードを無視して、すべての言語に共通するキーワードのみをストリーミングします。 指定しない場合、リッチエディットコントロールはすべてのキーワードをストリーム出力します。 このフラグは、 SF_RTF または SF_RTFNOOBJS フラグと組み合わせることができます。
SFF_SELECTION	指定した場合、リッチエディット コントロールは現在の選択範囲の内容のみをストリーム出力します。 指定しない場合、コントロールはコンテンツ全体をストリーム出力します。 このフラグは、任意のデータ形式の値と組み合わせることができます。
SF_UNICODE	Microsoft Rich Edit 2.0 以降: Unicode テキストを示します。 このフラグは 、SF_TEXT フラグと組み合わせることができます。
SF_USECODEPAGE	リッチ エディット 3.0 以降: 他のコード ページを使用して UTF-8 RTF とテキストを生成します。 コード ページは、 wParam の高い単語で設定されます。 たとえば、UTF-8 RTF の場合、 wParam を に設定します (CP_UTF8 << 16) |SF_USECODEPAGE |SF_RTF。

lParam

EDITSTREAM 構造体へのポインター。 入力時に、この構造体の pfnCallback メンバーは、アプリケーション定義の EditStreamCallback 関数を指す必要があります。 出力時に、エラーが発生した場合、 dwError メンバーに 0 以外のエラー コードを含めることができます。

戻り値

このメッセージは、データ ストリームに書き込まれた文字数を返します。

解説

EM_STREAMOUT メッセージを送信すると、リッチエディット コントロールは EDITSTREAM 構造体の pfnCallback メンバーによって指定された EditStreamCallback 関数を繰り返し呼び出します。 コールバック関数を呼び出すたびに、コントロールはコントロールの内容の一部を含むバッファーを渡します。 このプロセスは、コントロールがすべての内容をコールバック関数に渡すか、エラーが発生するまで続行されます。

必要条件

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

関連項目

参照

EDITSTREAM

EditStreamCallback

EM_STREAMIN