EM_STREAMOUT訊息

導致豐富的編輯控制項將其內容傳遞至定義 EditStreamCallback 回 呼函式的應用程式。 然後，回呼函式可以將資料流程寫入檔案或其選擇的任何其他位置。

參數

wParam

指定資料格式和取代選項。

此值必須是下列其中一個值。

值	意義
SF_RTF	Rtf。
SF_RTFNOOBJS	具有空格取代 COM 物件的 RTF。
SF_TEXT	具有空格的文字取代 COM 物件。
SF_TEXTIZED	具有 COM 物件文字表示的文字。

如果應用程式儲存 COM 物件本身，則 SF_RTFNOOBJS 選項很有用，因為 COM 物件的 RTF 表示方式並不非常精簡。 控制項字 \objattph，後面接著空格表示物件位置。

此外，您可以指定下列旗標。

值	意義
SFF_PLAINRTF	如果指定，豐富編輯控制項只會串流出所有語言通用的關鍵字，而忽略語言特定的關鍵字。 如果未指定，豐富編輯控制項會串流出所有關鍵詞。 您可以將此旗標與 SF_RTF 或 SF_RTFNOOBJS 旗標結合。
SFF_SELECTION	如果指定，豐富編輯控制項只會串流出目前選取範圍的內容。 如果未指定，則控制項會串流出整個內容。 您可以將此旗標與任何資料格式值結合。
SF_UNICODE	Microsoft Rich Edit 2.0 和更新版本： 表示 Unicode 文字。 您可以將此旗標與 SF_TEXT 旗標結合。
SF_USECODEPAGE	Rich Edit 3.0 和更新版本： 使用其他字碼頁產生 UTF-8 RTF 和文字。 字碼頁是以 wParam的高字設定。 例如，針對 UTF-8 RTF，將 wParam 設定為 (CP_UTF8 << 16) |SF_USECODEPAGE |SF_RTF。

lParam

EDITSTREAM結構的指標。 在輸入時，這個結構的 pfnCallback 成員必須指向已定義 EditStreamCallback 函式的應用程式。 輸出時， dwError 成員可以在發生錯誤時包含非零的錯誤碼。

傳回值

此訊息會傳回寫入資料流程的字元數。

備註

當您傳送EM_STREAMOUT訊息時，豐富的編輯控制項會重複呼叫 EDITSTREAM 結構的pfnCallback成員所指定的EditStreamCallback函式。 每次呼叫回呼函式時，控制項都會傳遞緩衝區，其中包含控制項內容的一部分。 此程式會繼續執行，直到控制項將所有內容傳遞至回呼函式，或直到發生錯誤為止。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	Richedit.h

另請參閱

參考

EDITSTREAM

EditStreamCallback

EM_STREAMIN