iTextSelection：：TypeText 方法 (tom.h)

發行項
03/03/2024

在此選取範圍中 輸入 bstr 所提供的字串，就像有人輸入一樣。這類似於基礎 SetText 方法，但會敏感於 Insert/Overtype 索引鍵狀態和 UI 設定，例如自動更正和智慧引號。

語法

HRESULT TypeText(
  BSTR bstr
);

參數

bstr

類型： BSTR

要輸入至此選取範圍的字串。

傳回值

類型： HRESULT

方法會傳回 HRESULT 值。如果方法成功，它會 傳回S_OK。如果方法失敗，它會傳回下列其中一個錯誤碼。如需 COM 錯誤碼的詳細資訊，請參閱 COM 中的錯誤處理。

傳回碼	Description
E_ACCESSDENIED	文字受到寫入保護。
E_INVALIDARG	bstr 為 null。
E_OUTOFMEMORY	記憶體不足。

備註

這個方法會在選取範圍 中輸入 bstr 所提供的字串，就像有人輸入一樣。使用 TypeText 比透過 SendMessage 函式傳送字元更快，但比使用 SetText 慢。

TypeText 與基礎 SetText 方法類似，不過，它會區分 Insert/Overtype 索引鍵狀態和 UI 設定，例如自動更正和智慧引號。例如，它會刪除任何非產生的選取專案，然後根據 Insert/Overtype 索引鍵狀態來插入或過度輸入 (，請參閱 SetFlags 方法) 插入點上的字元串 bstr ，將此選取專案保留為插入文字後面的插入點。

規格需求

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