ITextServices：：OnTxPropertyBitsChange 方法 (textserv.h)

發行項
03/13/2024

設定屬性 (由控件的位) 表示。

語法

HRESULT OnTxPropertyBitsChange(
  [in] DWORD dwMask,
  [in] DWORD dwBits
);

參數

[in] dwMask

類型： DWORD

代表要變更之屬性的位。如需可能的位值，請參閱 dwBits 中的 TXTBIT_* 值清單。

[in] dwBits

類型： DWORD

位屬性的新值。它可以是下列任何組合。

值	意義
TXTBIT_ALLOWBEEP	如果為 TRUE，則會啟用嗶聲。
TXTBIT_AUTOWORDSEL	如果為 TRUE，則會啟用 AutoWordSelect 功能。
TXTBIT_BACKSTYLECHANGE	如果為 TRUE，則反樣式已變更。請參閱 TxGetBackStyle。
TXTBIT_CHARFORMATCHANGE	如果為 TRUE，則字元格式已變更。
TXTBIT_CLIENTRECTCHANGE	如果為TRUE，則用戶端矩形已變更。
TXTBIT_DISABLEDRAG	如果為 TRUE，則會停用拖曳。
TXTBIT_D2DDWRITE	針對這個實例使用 Direct2D/DirectWrite，而不是 GDI/Uniscribe。
TXTBIT_D2DPIXELSNAPPED	將圖像轉譯為最接近的圖元位置。只有在設定D2DDWRITE時才有效。
TXTBIT_D2DSUBPIXELLINES	使用子圖元精確度繪製線條。請勿在次要文字流程方向中像素貼齊文字行、底線和刪除線， (通常是垂直) 。只有在設定D2DDWRITE且未設定D2DPIXELSNAPPED時才有效。
TXTBIT_D2DSIMPLETYPOGRAPHY	使用簡單的印刷樣式來轉譯文字， (沒有圖像轉譯) 。只有在同時指定TXTBIT_D2DDWRITE時，這個值才有效。
TXTBIT_EXTENTCHANGE	如果為 TRUE，則表示用戶端矩形的大小已變更。
TXTBIT_HIDESELECTION	如果為 TRUE，文字服務對象應該會在控件處於非使用中狀態時隱藏選取範圍。如果為 FALSE，則當控件處於非使用中狀態時，應該會顯示選取範圍。請注意，這表示 TXTBIT_SAVESELECTION 為 TRUE。
TXTBIT_MAXLENGTHCHANGE	如果為 TRUE，控件中文字的最大長度已變更。
TXTBIT_MULTILINE	如果為 TRUE，文字服務對象應該會以多行模式運作。使用 TXTBIT_WORDWRAP 值來判斷是否要將線條換行到檢視矩形或裁剪。如果為 FALSE，則文字服務對象不應該處理 ENTER 鍵中的歸位字元/換行字元，而且應該截斷內送文字，其中包含第一個換行符之前的硬換行符。也可以接受截斷使用 ITextServices：：TxSetText 設定的文字，因為主應用程式在系結至多行字段時不要使用單行控件的責任。
TXTBIT_NOTHREADREFCOUNT	請勿代表此實例參考 TLS 數據。
TXTBIT_PARAFORMATCHANGE	如果為 TRUE，表示段落格式已變更。
TXTBIT_READONLY	如果為TRUE，則文字服務物件不應接受透過使用者介面的任何編輯變更。不過，它仍應該透過 EM_SETTEXTEX、 EM_REPLACESEL和 ITextServices：：TxSetText 接受程式設計變更。此外，使用者仍應該能夠移動插入點、選取文字，以及執行其他不會修改內容的作業，例如 Copy。
TXTBIT_RICHTEXT	如果為 TRUE，則文字服務對象應該處於 RTF 模式。如果為 FALSE，則為純文字模式。請注意，這會影響編輯命令的套用方式。例如，在純編輯控件中將粗體套用至部分文字，會使整個文字變成粗體。不過，對於豐富編輯控件，這隻會讓選取的文字變成粗體。
TXTBIT_SAVESELECTION	如果為 TRUE，則當控件處於非使用中狀態時，應該儲存選取範圍的界限。如果為 FALSE，當控件再次作用時，可以重設選取範圍界限以開始 = 0，長度 = 0。
TXTBIT_SCROLLBARCHANGE	如果為 TRUE，滾動條已變更。
TXTBIT_SELBARCHANGE	如果為 TRUE，則選取列寬度已變更
TXTBIT_SHOWACCELERATOR	如果設定，則快捷鍵字元應加上底線。這必須設定為呼叫 TxGetAcceleratorPos。
TXTBIT_SHOWPASSWORD	顯示密碼字串。
TXTBIT_USECURRENTBKG	不支援。
TXTBIT_USEPASSWORD	如果為 TRUE，請使用 TxGetPasswordChar 取得的密碼字元來顯示文字。此屬性的通知可能表示密碼字元已變更，或密碼字元在之前未使用，但現在使用 (，反之亦然) 。
TXTBIT_VERTICAL	不支援。
TXTBIT_VIEWINSETCHANGE	如果為 TRUE，則表示內嵌已變更。
TXTBIT_WORDWRAP	如果 TRUE 和 TXTBIT_MULTILINE 也是 TRUE，多行控件應該會將線條換行到檢視矩形。如果此屬性為 FALSE ，且TXTBIT_MULTILINE 為 TRUE，則不應該包裝行，而是裁剪。應該忽略檢視矩形的右側。如果 TXTBIT_MULTILINE 為 FALSE，則此屬性沒有任何作用。

傳回值

類型： HRESULT

如果方法成功，傳回值會 S_OK。

如果方法失敗，傳回值會是下列 HRESULT 程序代碼。如需 COM 錯誤碼的詳細資訊，請參閱 COM 中的錯誤處理。

傳回碼	Description
E_NOTIMPL	未實作。

備註

用戶端矩形是文字服務對象負責繪製和管理的矩形。主機依賴文字服務對象繪製該區域。文字服務物件不得繪製或使該矩形外部的區域失效。此外，當游標位於此矩形上方時，主機會將滑鼠訊息轉送至文字服務物件。這個矩形是以包含視窗的用戶端座標表示。

檢視集是用戶端矩形與檢視矩形之間每個側邊的空間量。檢視矩形 (也稱為 [格式化] 矩形) 是應該格式化文字的矩形。如需詳細資訊，請參閱 TxGetViewInset。

backstyle 是用戶端矩形背景的樣式。它可以是TXTBACK_TRANSPARENT或TXTBACK_SOLID。請參閱 TXTBACKSTYLE。

滾動條屬性表示滾動條的變更：滾動條是否存在，不論滾動條在無法捲動時是否隱藏或停用，以及在插入點關閉用戶端矩形時啟用自動捲動也一樣。

規格需求

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