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 (デスクトップ アプリのみ) |
| ヘッダー |
|