ITextHost：：TxNotify 方法 (textserv.h)

發行項
03/02/2024

通知各種事件的文字主機。

語法

HRESULT TxNotify(
  [in] DWORD iNotify,
  [in] void  *pv
);

參數

[in] iNotify

類型： DWORD

要通知主機的事件。其中一個 EN_ 通知碼。

[in] pv

類型： void*

視 iNotify 而定的額外數據。

傳回值

類型： HRESULT

如果方法成功，則傳回S_OK。

如果方法失敗，則傳回S_FALSE。如需 COM 錯誤碼的詳細資訊，請參閱 COM 中的錯誤處理。

備註

請注意，事件有兩個基本類別，直接和延遲。直接事件會立即傳送，因為它們需要一些處理，例如 EN_PROTECTED。發生所有處理之後，都會傳送延遲的事件;因此，控件處於穩定狀態。延遲通知的範例包括 EN_CHANGE、 EN_ERRSPACE和 EN_SELCHANGE。

通知事件與傳送至豐富編輯視窗之父視窗的通知代碼相同。事件引發可能會透過 EM_SETEVENTMASK 訊息設定遮罩來控制。

一般而言，在處理此方法時，對文字服務對象進行呼叫是合法的;不過，實作者會小心避免過度遞歸。

以下是可能傳送的通知清單。

通知	意義
EN_CHANGE	在系統更新畫面之後傳送，當用戶採取可能已改變控件文字的動作時。
EN_DROPFILES	收到 WM_DROPFILES 訊息或 IDropTarget：:D ragEnter 通知時傳送。
EN_ERRSPACE	當控件無法配置足夠的記憶體以符合指定的要求時傳送。
EN_HSCROLL	當使用者在螢幕更新之前單擊控件的水準滾動條時傳送。
EN_KILLFOCUS	當控件失去鍵盤焦點時傳送。
EN_LINK	當 RTF 編輯控制件收到各種訊息時傳送，例如滑鼠按一下訊息，當滑鼠指標位於具有CFE_LINK效果的文字上時。
EN_MAXTEXT	當目前的文字插入超過控件的最大字元數時傳送。
EN_OLEOPFAILED	當 OLE 物件上的使用者動作失敗時傳送。
EN_PROTECTED	當使用者採取變更受保護文字範圍的動作時傳送。
EN_REQUESTRESIZE	當豐富的編輯控制項內容與控件的視窗大小不同時傳送。
EN_SAVECLIPBOARD	正在終結編輯控制項時傳送。文字主機應該指出是否應該呼叫 OleFlushClipboard 。指出要排清之字元和物件數目的數據會在 ENSAVECLIPBOARD 數據結構中傳送。遮罩值不是任何值。
EN_SELCHANGE	當目前的選取範圍變更時傳送。也會傳送 SELCHANGE 數據結構，這表示選取範圍目前已結束之數據類型的新選取範圍。透過 ENM_SELCHANGE 遮罩來控制。
EN_SETFOCUS	編輯控制件收到鍵盤焦點時傳送。不會傳送額外的數據;沒有遮罩。
EN_STOPNOUNDO	當動作發生時，控件無法配置足夠的記憶體來維護復原狀態時傳送。如果傳回S_FALSE，動作將會停止;否則，動作將會繼續。
EN_UPDATE	在編輯控制項要求重新繪製已改變的數據或文字之前傳送。不會傳送其他數據。此事件是透過 ENM_UPDATE 遮罩來控制。 Rich Edit 2.0 和更新版本：系統會忽略 ENM_UPDATE 遮罩，而且一律會傳送 EN_UPDATE 通知碼。不過，當 Microsoft Rich Edit 3.0 模擬 Microsoft Rich Edit 1.0 時， ENM_UPDATE 遮罩會控制此通知。
EN_VSCROLL	當使用者按兩下編輯控制元件的垂直滾動條，或當使用者在編輯控件上方捲動滑鼠滾輪時傳送，再更新畫面。這會透過 ENM_SCROLL 遮罩來控制;不會傳送額外的數據。

注意EN_MSGFILTER不會傳送至 TxNotify。若要篩選視窗訊息，請使用 TxSendMessage。

規格需求

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