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