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 [僅限傳統型應用程式] |
標頭 |
|