Rich Edit

  • 發行項

本節包含與豐富編輯控件搭配使用之程式設計專案的相關信息。 豐富的編輯控制項可讓使用者輸入、編輯、列印及儲存文字。 文字可以指派字元和段落格式，而且可以包含內嵌的元件物件模型 （COM） 物件。

由於豐富的編輯控制項幾乎支援與多行 編輯控制項搭配使用的所有訊息和通知代碼，因此使用編輯控制件的應用程式可以輕鬆地變更為使用豐富的編輯控制件。

概觀

主題 目錄
關於 Rich Edit 控制件 本節介紹豐富的編輯控件。
使用 Rich Edit 控制件 本節包含主題，示範如何建立和使用豐富的編輯控件。

函式

主題 目錄
AutoCorrectProc AutoCorrectProc 函式是與EM_SETAUTOCORRECTPROC訊息搭配使用的應用程式定義回呼函式。
EditStreamCallback EditStreamCallback 函式是與EM_STREAMIN和EM_STREAMOUT訊息搭配使用的應用程式定義回呼函式。 它用來將數據串流傳送到或移出豐富的編輯控制件。
EditWordBreakProcEx EditWordBreakProcEx 函式是搭配EM_SETWORDBREAKPROCEX訊息使用的應用程式定義回呼函式。 它會決定斷詞符號的字元索引，或指定文字中字元的字元類別和斷詞旗標。
HyphenateProc HyphenateProc 函式是搭配EM_SETHYPHENATEINFO訊息使用的應用程式定義回呼函式。 它會決定如何在 Microsoft Rich Edit 控件中執行斷字。

介面

主題 目錄
IRichEditOle IRichEditOle 介面會公開豐富編輯控件的 COM 功能。 您可以藉由傳送 EM_GETOLEINTERFACE 訊息來取得介面。
IRichEditOleCallback IRichEditOleCallback 介面是由 RTF 編輯控件用來從其用戶端擷取 OLE 相關信息。 豐富的編輯控件客戶端負責實作此介面，並使用EM_SETOLECALLBACK訊息將它指派給控件。

訊息

主題 目錄
EM_AUTOURLDETECT 啟用或停用由豐富編輯控件自動偵測 URL。
EM_CANPASTE 判斷豐富的編輯控制項是否可以貼上指定的剪貼簿格式。
EM_CANREDO 判斷控件重做佇列中是否有任何動作。
EM_DISPLAYBAND 顯示豐富編輯控件內容的一部分，如先前使用 EM_FORMATRANGE 訊息為裝置格式化。
EM_EXGETSEL 擷取選取範圍在豐富編輯控件中的開始和結束字元位置。
EM_EXLIMITTEXT 設定使用者可以輸入或貼到豐富編輯控件的文字數量上限。
EM_EXLINEFROMCHAR 決定哪一行包含豐富編輯控制件中的指定字元。
EM_EXSETSEL 選取 Rich Edit 控制項中的字元或 COM 物件範圍。
EM_FINDTEXT 在豐富的編輯控制項內尋找文字。
EM_FINDTEXTEX 在豐富的編輯控制項內尋找文字。
EM_FINDTEXTEXW 在豐富的編輯控制項內尋找 Unicode 文字。
EM_FINDTEXTW 在豐富的編輯控制項內尋找 Unicode 文字。
EM_FINDWORDBREAK 尋找指定字元位置之前或之後的下一個斷詞符號，或擷取該位置的字元相關信息。
EM_FORMATRANGE 將特定裝置的豐富編輯控制件中的文字範圍格式化。
EM_GETAUTOURLDETECT 指出是否在豐富的編輯控件中開啟自動URL偵測。
EM_GETBIDIOPTIONS 指出豐富編輯控件中雙向選項的目前狀態。
EM_GETCHARFORMAT 決定豐富編輯控制件中的字元格式設定。
EM_GETCTFMODEBIAS 取得 Rich Edit 控制件的文字服務架構 （TSF） 模式偏差值。
EM_GETCTFOPENSTATUS 判斷 TSF 鍵盤是否開啟或關閉。
EM_GETEDITSTYLE 擷取目前的編輯樣式旗標。
EM_GETEVENTMASK 擷取豐富編輯控件的事件遮罩。 事件遮罩會指定控件傳送至其父視窗的通知代碼。
EM_GETHYPHENATEINFO 取得 Rich Edit 控制件的斷字相關信息。
EM_GETIMECOLOR 擷取輸入法編輯器 （IME） 組合色彩。 此訊息僅適用於作業系統的亞洲語言版本。
EM_GETIMECOMPMODE 取得豐富編輯控制件的目前輸入法模式。
EM_GETIMECOMPTEXT 取得輸入法組合文字。
EM_GETIMEMODEBIAS 取得 Rich Edit 控制件的輸入法模式偏差。
EM_GETIMEOPTIONS 擷取目前的輸入法選項。 此訊息僅適用於作業系統的亞洲語言版本。
EM_GETIMEPROPERTY 取得與目前輸入地區設定相關聯的 IME 屬性和功能。
EM_GETLANGOPTIONS 取得 IME 和亞洲語言支援的豐富編輯控制項選項設定。
EM_GETOLEINTERFACE 擷取用戶端可用來存取豐富編輯控件 COM 功能的 IRichEditOle 物件。
EM_GETOPTIONS 擷取豐富的編輯控件選項。
EM_GETPAGEROTATE 已取代。 取得 Rich Edit 控制件的文字配置。
EM_GETPARAFORMAT 擷取豐富編輯控制項中目前選取範圍的段落格式設定。
EM_GETPUNCTUATION 取得豐富編輯控制件的目前標點符號字元。 此訊息僅適用於作業系統的亞洲語言版本。
EM_GETREDONAME 擷取下一個動作的類型，如果有的話，在豐富編輯控件的重做佇列中。
EM_GETSCROLLPOS 取得編輯控制件的目前捲動位置。
EM_GETSELTEXT 擷取豐富編輯控件中目前選取的文字。
EM_GETTEXTEX 從任何您想要的特定程式代碼基底中，從豐富編輯控件取得所有文字。
EM_GETTEXTLENGTHEX 以各種方式計算文字長度。 通常會在建立緩衝區以接收控件中的文字之前呼叫它。
EM_GETTEXTMODE 取得豐富的編輯控制件目前的文字模式和復原層級。
EM_GETTEXTRANGE 從豐富的編輯控制項擷取指定的字元範圍。
EM_GETTYPOGRAPHYOPTIONS 擷取豐富編輯控件之印刷樣式選項的目前狀態。
EM_GETUNDONAME Microsoft Rich Edit 2.0 和更新版本：如果有的話，擷取下一個復原動作的類型。
Microsoft Rich Edit 1.0：不支援此訊息。
EM_GETWORDBREAKPROCEX 擷取目前已註冊之擴充斷詞程序的位址。
EM_GETWORDWRAPMODE 取得豐富的編輯控制件目前的自動換行和斷詞選項。 此訊息僅適用於作業系統的亞洲語言版本。
EM_GETZOOM 取得目前的縮放比例，其一律介於 1/64 和 64 之間。
EM_HIDESELECTION 在豐富的編輯控制件中隱藏或顯示選取專案。
EM_ISIME 判斷目前的輸入地區設定是否為東亞地區設定。
EM_PASTESPECIAL 在豐富的編輯控制件中貼上特定的剪貼簿格式。
EM_RECONVERSION 叫用 IME 重新轉換對話框。
EM_REDO 重做控件重做佇列中的下一個動作。
EM_REQUESTRESIZE 強制豐富的編輯控制項將EN_REQUESTRESIZE通知程式代碼傳送至其父視窗。
EM_SELECTIONTYPE 決定豐富編輯控件的選取類型。
EM_SETBIDIOPTIONS 設定豐富編輯控制件中雙向選項的目前狀態。
EM_SETBKGNDCOLOR 設定豐富編輯控制件的背景色彩。
EM_SETCHARFORMAT 在豐富的編輯控制件中設定字元格式設定。
EM_SETCTFMODEBIAS 設定 Rich Edit 控制件的 TSF 模式偏差。
EM_SETCTFOPENSTATUS 開啟或關閉 TSF 鍵盤。
EM_SETEDITSTYLE 設定目前的編輯樣式旗標。
EM_SETEVENTMASK 設定豐富編輯控件的事件遮罩。 事件遮罩會指定控件傳送至其父視窗的通知代碼。
EM_SETFONTSIZE 設定所選文字的字型大小。
EM_SETHYPHENATEINFO 設定 Rich Edit 控制件執行連字元的方式。
EM_SETIMECOLOR 設定輸入法組合色彩。 此訊息僅適用於作業系統的亞洲語言版本。
EM_SETIMEMODEBIAS 設定 Rich Edit 控制件的 IME 模式偏差。
EM_SETIMEOPTIONS 設定輸入法選項。 此訊息僅適用於作業系統的亞洲語言版本。
EM_SETLANGOPTIONS 在豐富的編輯控制項中設定 IME 和亞洲語言支援的選項。
EM_SETOLECALLBACK 提供豐富的編輯控件 IRichEditOleCallback 物件，控件會用來從用戶端取得 OLE 相關資源和資訊。
EM_SETOPTIONS 設定豐富編輯控制件的選項。
EM_SETPAGEROTATE 已取代。 設定 Rich Edit 控制件的文字配置。
EM_SETPALETTE 變更豐富編輯用於其顯示視窗的調色盤。
EM_SETPARAFORMAT 設定豐富編輯控制項中目前選取範圍的段落格式設定。
EM_SETPUNCTUATION 設定豐富編輯控制件的標點符號字元。 此訊息僅適用於作業系統的亞洲語言版本。
EM_SETSCROLLPOS 告知豐富的編輯控件捲動至特定點。
EM_SETTARGETDEVICE 設定在豐富編輯控制項中用於「您看到的內容」（WYSIWYG）格式設定目標裝置和線條寬度。
EM_SETTEXTEX 結合WM_SETTEXT和EM_REPLACESEL的功能，並新增了使用代碼頁設定文字的功能，以及使用 RTF 或純文字。
EM_SETTEXTMODE 設定豐富編輯控件的文字模式或復原層級。 如果控件包含任何文字，訊息就會失敗。
EM_SETTYPOGRAPHYOPTIONS 設定豐富編輯控制項之印刷樣式選項的目前狀態。
EM_SETUNDOLIMIT 設定可儲存在復原佇列中的動作數目上限。
EM_SETWORDBREAKPROCEX 設定擴充的斷詞程式。
EM_SETWORDWRAPMODE 設定豐富編輯控件的自動換行和斷詞選項。 此訊息僅適用於作業系統的亞洲語言版本。
EM_SETZOOM 設定介於 1/64 和 64 之間的縮放比例。
EM_SHOWSCROLLBAR 在 [文字主機] 視窗中顯示或隱藏其中一個滾動條。
EM_STOPGROUPTYPING 停止控制項將其他輸入動作收集到目前的復原動作。 控件會將下一個輸入動作儲存至復原佇列中的新動作。
EM_STREAMIN 以應用程式定義的 EditStreamCallback回 呼函式所提供的數據流取代豐富編輯控制件的內容。
EM_STREAMOUT 讓豐富的編輯控件將其內容傳遞至應用程式定義的 EditStreamCallback回 呼函式。 回呼函式接著可以將數據流寫入檔案或其選擇的任何其他位置。

Notifications

主題 目錄
EN_ALIGNLTR 通知豐富編輯控件的父視窗，段落方向已變更為由左至右。 豐富的編輯控制項會以WM_COMMAND訊息的形式傳送此通知程式代碼。
EN_ALIGNRTL 通知豐富的編輯控件父視窗，段落方向變更為由右至左。 豐富的編輯控制項會以WM_COMMAND訊息的形式傳送此通知程式代碼。
EN_CORRECTTEXT 通知豐富編輯控件的父窗口發生SYV_CORRECT手勢，讓父視窗有機會取消更正文字。 豐富的編輯控制項會以WM_NOTIFY訊息的形式傳送此通知程序代碼。
EN_DRAGDROPDONE 通知豐富的編輯控制項父視窗，拖放作業已完成。 豐富的編輯控制項會以WM_NOTIFY訊息的形式傳送此通知程序代碼。
EN_DROPFILES 通知豐富編輯控制件的父視窗，使用者正嘗試將檔案放入控件中。 豐富的編輯控制項會在收到WM_DROPFILES訊息時，以WM_NOTIFY訊息的形式傳送此通知程式代碼。
EN_IMECHANGE 通知豐富編輯控制件的父系輸入法轉換狀態已變更。 此訊息 僅適用於 作業系統的亞洲語言版本。 豐富的編輯控制項會以WM_COMMAND訊息的形式傳送此通知程式代碼。
EN_LINK 當使用者按兩下滑鼠或滑鼠指標超過具有CFE_LINK效果的文字時，通知 RTF 控制件的父視窗。 控件的父視窗會透過 WM_NOTIFY 訊息接收此通知程序代碼。
EN_LOWFIRTF 通知 Rich Edit 控制件的父視窗，該控件收到不支援的 RTF 格式 （RTF） 關鍵詞。 Rich Edit 控制項會以WM_NOTIFY訊息的形式傳送此通知程式代碼。
EN_MSGFILTER 通知控件中鍵盤或滑鼠事件的豐富編輯控制項父視窗。 豐富的編輯控制項會以WM_NOTIFY訊息的形式傳送此通知程序代碼。
EN_OBJECTPOSITIONS 當控件在 物件中讀取時，通知豐富的編輯控件父視窗。 豐富的編輯控制項會以WM_NOTIFY訊息的形式傳送此通知程序代碼。
EN_OLEOPFAILED 通知豐富編輯控制件的父視窗，COM 物件上的使用者動作失敗。 豐富的編輯控制項會以WM_NOTIFY訊息的形式傳送此通知程序代碼。
EN_PROTECTED 通知豐富編輯控制件的父視窗，使用者正在採取會變更受保護文字範圍的動作。 豐富的編輯控制項會以WM_NOTIFY訊息的形式傳送此通知程序代碼。
EN_REQUESTRESIZE 通知豐富的編輯控制項父視窗，控件的內容小於或大於控件的視窗大小。 豐富的編輯控制項會以WM_NOTIFY訊息的形式傳送此通知程序代碼。
EN_SAVECLIPBOARD 通知豐富編輯控制件的父視窗，控制項正在關閉，且剪貼簿包含資訊。 豐富的編輯控制項會以WM_NOTIFY訊息的形式傳送此通知程序代碼。
EN_SELCHANGE 通知豐富編輯控制件的父視窗，目前的選取範圍已變更。 豐富的編輯控制項會以WM_NOTIFY訊息的形式傳送此通知程序代碼。
EN_STOPNOUNDO 通知豐富的編輯控制項父視窗發生動作，控制項無法配置足夠的記憶體來維護復原狀態。 豐富的編輯控制項會以WM_NOTIFY訊息的形式傳送此通知程序代碼。

結構

主題 目錄
BIDIOPTIONS 包含豐富編輯控制件的雙向資訊。 EM_GETBIDIOPTIONS和EM_SETBIDIOPTIONS訊息會使用此結構來取得及設定控件的雙向資訊。
CHARFORMAT 包含豐富編輯控制件中字元格式設定的相關信息。
CHARFORMAT2 包含豐富編輯控制件中字元格式設定的相關信息。 CHARFORMAT2是 CHARFORMAT 結構的 Microsoft Rich Edit 2.0 延伸模組。 Microsoft Rich Edit 2.0 可讓您搭配EM_GETCHARFORMAT和EM_SETCHARFORMAT訊息使用任一結構。
CHARRANGE 指定豐富編輯控制件中的字元範圍。
COMPCOLOR 包含組合字串的色彩設定。
EDITSTREAM 包含應用程式傳遞至EM_STREAMIN或EM_STREAMOUT訊息中豐富編輯控件的資訊。 豐富的編輯控制項會使用資訊將數據流傳送至或移出控件。
ENCORRECTTEXT 包含要更正之選取文字的相關信息。
ENDROPFILES 包含與 EN_DROPFILES 通知程式代碼相關聯的資訊。 豐富的編輯控制件會在收到 WM_DROPFILES 訊息時傳送此通知程式代碼。
ENLINK 包含來自豐富編輯控制件之EN_LINK通知程式代碼的相關信息。
ENLOWFIRTF 包含 Rich Edit 控制件中不支援 RTF 關鍵詞的資訊。
ENOLEOPFAILED 包含失敗作業的相關信息。
ENPROTECTED 包含與 EN_PROTECTED 通知程式代碼相關聯的資訊。 當使用者嘗試編輯受保護的文字時，豐富的編輯控制項會傳送此通知。
ENSAVECLIPBOARD 包含剪貼簿上物件和文字的相關信息。
FINDTEXT 包含豐富編輯控制件中搜尋作業的相關信息。 這個結構會與EM_FINDTEXT訊息搭配使用。
FINDTEXTEX 包含在豐富編輯控件中搜尋之文字的相關信息。 此結構會與EM_FINDTEXTEX訊息搭配使用。
FORMATRANGE 包含豐富編輯控制項用來格式化特定裝置輸出的資訊。 這個結構會與EM_FORMATRANGE訊息搭配使用。
GETTEXTEX 包含從豐富編輯控件取得文字之作業的相關信息。 此結構會在EM_GETTEXTEX訊息中的 wParam 中傳遞。
GETTEXTLENGTHEX 包含如何計算豐富編輯控件文字長度的相關信息。 此結構會在EM_GETTEXTLENGTHEX訊息中的 wParam 中傳遞。
HYPHENATEINFO 包含 Rich Edit 控制件中斷字的相關信息。
HYPHRESULT 包含 Rich Edit 控制件中斷字結果的相關信息。
IMECOMPTEXT 包含 Rich Edit 控制件中組合文字的相關信息。
MSGFILTER 包含鍵盤或滑鼠事件的相關信息。 豐富的編輯控件會將這個結構傳送至其父視窗，做為EN_MSGFILTER通知程式代碼的一部分，讓父代變更訊息或防止處理訊息。
OBJECTPOSITIONS 包含物件位置資訊。
PARAFORMAT 包含豐富編輯控制件中段落格式屬性的相關信息。 此結構會與EM_GETPARAFORMAT和EM_SETPARAFORMAT訊息搭配使用。
PARAFORMAT2 包含豐富編輯控制件中段落格式屬性的相關信息。
標點符號 包含豐富編輯控制件中使用的標點符號相關信息。
REOBJECT 包含對象的相關信息。
REPASTESPECIAL 包含資訊，可識別貼上對象的顯示層面是否應該以對象的內容或代表物件的圖示為基礎。
REQRESIZE 包含豐富編輯控制件的要求大小。 豐富的編輯控制項會將這個結構傳送至其父視窗，做為EN_REQUESTRESIZE通知程式代碼的一部分。
SELCHANGE 包含與 EN_SELCHANGE 通知程式代碼相關聯的資訊。 豐富的編輯控制項會在目前的選取範圍變更時，將此通知傳送至其父視窗。
SETTEXTEX 指定要在設定文字中使用的代碼頁、文字是否取代控制項中的所有文字，還是只取代選取範圍，以及是否要保留復原狀態。
TEXTRANGE 從豐富的編輯控制項接收文字範圍。 此結構會由 EM_GETTEXTRANGE 訊息填入。 lpstrText 成員所指向的緩衝區必須夠大，才能接收所有字元和終止的 Null 字元。

常數

主題 目錄
Rich Edit Control 事件遮罩旗標 事件遮罩會指定豐富編輯控件傳送至其父視窗的通知代碼。
豐富的編輯控件樣式 描述豐富編輯控制件特有的視窗樣式。