會讓一個豐富的編輯控制項將其內容傳遞給應用程式定義的 EditStreamCallback 回調函式。 回調函式接著可以將資料流寫入檔案或它選擇的其他位置。
Parameters
-
wParam
-
指定資料格式及替換選項。
此值必須是以下其中之一。
價值 Meaning - SF_RTF
轉發。 - SF_RTFNOOBJS
RTF 用空格代替 COM 物件。 - SF_TEXT
用空格代替 COM 物件的文字。 - SF_TEXTIZED
帶有 COM 物件文字表示的文字。 如果應用程式本身儲存 COM 物件， SF_RTFNOOBJS 選項很有用，因為 COM 物件的 RTF 表示並不夠簡潔。 控制字 \objattph 後接空格表示物體位置。
此外，你還可以指定以下標記。
價值 Meaning - SFF_PLAINRTF
若指定，豐富的編輯控制只輸出所有語言共有的關鍵字，忽略語言特定關鍵字。 若未指定，豐富的編輯控制會將所有關鍵字串流出去。 你可以將此旗幟與 SF_RTF 或 SF_RTFNOOBJS 旗結合使用。 - SFF_SELECTION
若指定，豐富的編輯控制只串流當前選取的內容。 若未指定，控制項會將整個內容串流出去。 你可以將此旗標與任一資料格式值結合使用。 - SF_UNICODE
Microsoft Rich Edit 2.0 及以後版本：表示 Unicode 文字。 你可以將此旗幟與 SF_TEXT 旗合併使用，但無法與任何變體的 SF_RTF結合。 - SF_USECODEPAGE
Rich Edit 3.0 及以後版本： 產生 UTF-8 RTF 及使用其他碼頁的文字。 代碼頁設定在 wParam 的高字中。 例如，對於 UTF-8 RTF，將 wParam 設為 （CP_UTF8 << 16） |SF_USECODEPAGE |SF_RTF。 若未設定此旗標，則任何 RTF 都會以 7 位元 ASCII 產生（並有擴展 ASCII 字元逃逸）。 -
lParam
-
指向 EDITSTREAM 結構的指標。 在輸入時，該結構的 pfnCallback 成員必須指向應用程式定義的 EditStreamCallback 函式。 輸出時， dwError 成員可包含非零錯誤碼，若發生錯誤。
返回值
此訊息會回傳寫入資料串流的字元數。
Remarks
當你傳送 EM_STREAMOUT 訊息時，豐富的編輯控制項會反覆呼叫由 EDITSTREAM 結構中 pfnCallback 成員指定的 EditStreamCallback 函式。 每次呼叫回調函式時，控制項會傳遞一個緩衝區，包含控制項部分內容。 此過程持續，直到控制項將所有內容傳給回調函式，或發生錯誤為止。
要求
| 需求 | 價值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
| Header |
|
參見
-
參考資料