ITextServices::OnTxPropertyBitsChange 方法 (textserv.h)
設定屬性 (由控件的位) 表示。
語法
HRESULT OnTxPropertyBitsChange(
[in] DWORD dwMask,
[in] DWORD dwBits
);
參數
[in] dwMask
類型: DWORD
代表要變更之屬性的位。 如需可能的位值,請參閱 dwBits 中的 TXTBIT_* 值清單。
[in] dwBits
類型: DWORD
位屬性的新值。 它可以是下列任何組合。
值 | 意義 |
---|---|
|
如果 為 TRUE,則會啟用嗶聲。 |
|
如果為 TRUE,則會啟用 AutoWordSelect 功能。 |
|
如果 為 TRUE,則反樣式已變更。 請參閱 TxGetBackStyle。 |
|
如果為 TRUE,則字元格式已變更。 |
|
如果 為TRUE,則用戶端矩形已變更。 |
|
如果 為 TRUE,則會停用拖曳。 |
|
針對這個實例使用 Direct2D/DirectWrite,而不是 GDI/Uniscribe。 |
|
將圖像轉譯為最接近的圖元位置。 只有在設定D2DDWRITE時才有效。 |
|
使用子圖元精確度繪製線條。 請勿在次要文字流程方向中像素貼齊文字行、底線和刪除線, (通常是垂直) 。 只有在設定D2DDWRITE且未設定D2DPIXELSNAPPED時才有效。 |
|
使用簡單的印刷樣式來轉譯文字, (沒有圖像轉譯) 。 只有在同時指定TXTBIT_D2DDWRITE時,這個值才有效。 |
|
如果為 TRUE,則表示用戶端矩形的大小已變更。 |
|
如果 為 TRUE,文字服務對象應該會在控件處於非使用中狀態時隱藏選取範圍。 如果 為 FALSE,則當控件處於非使用中狀態時,應該會顯示選取範圍。
請注意,這表示 TXTBIT_SAVESELECTION 為 TRUE。 |
|
如果為 TRUE,控件中文字的最大長度已變更。 |
|
如果 為 TRUE,文字服務對象應該會以多行模式運作。 使用 TXTBIT_WORDWRAP 值來判斷是否要將線條換行到檢視矩形或裁剪。
如果為 FALSE,則文字服務對象不應該處理 ENTER 鍵中的歸位字元/換行字元,而且應該截斷內送文字,其中包含第一個換行符之前的硬換行符。 也可以接受截斷使用 ITextServices::TxSetText 設定的文字,因為主應用程式在系結至多行字段時不要使用單行控件的責任。 |
|
請勿代表此實例參考 TLS 數據。 |
|
如果 為 TRUE,表示段落格式已變更。 |
|
如果 為TRUE,則文字服務物件不應接受透過使用者介面的任何編輯變更。 不過,它仍應該透過 EM_SETTEXTEX、 EM_REPLACESEL和 ITextServices::TxSetText 接受程式設計變更。 此外,使用者仍應該能夠移動插入點、選取文字,以及執行其他不會修改內容的作業,例如 Copy。 |
|
如果 為 TRUE,則文字服務對象應該處於 RTF 模式。
如果為 FALSE,則為純文字模式。 請注意,這會影響編輯命令的套用方式。 例如,在純編輯控件中將粗體套用至部分文字,會使整個文字變成粗體。 不過,對於豐富編輯控件,這隻會讓選取的文字變成粗體。 |
|
如果 為 TRUE,則當控件處於非使用中狀態時,應該儲存選取範圍的界限。
如果為 FALSE,當控件再次作用時,可以重設選取範圍界限以開始 = 0,長度 = 0。 |
|
如果 為 TRUE,滾動條已變更。 |
|
如果 為 TRUE,則選取列寬度已變更 |
|
如果設定,則快捷鍵字元應加上底線。
這必須設定為呼叫 TxGetAcceleratorPos。 |
|
顯示密碼字串。 |
|
不支援。 |
|
如果 為 TRUE,請使用 TxGetPasswordChar 取得的密碼字元來顯示文字。
此屬性的通知可能表示密碼字元已變更,或密碼字元在之前未使用,但現在使用 (,反之亦然) 。 |
|
不支援。 |
|
如果 為 TRUE,則表示內嵌已變更。 |
|
如果 TRUE 和 TXTBIT_MULTILINE 也是 TRUE,多行控件應該會將線條換行到檢視矩形。 如果此屬性為 FALSE , 且TXTBIT_MULTILINE 為 TRUE,則不應該包裝行,而是裁剪。 應該忽略檢視矩形的右側。
如果 TXTBIT_MULTILINE 為 FALSE,則此屬性沒有任何作用。 |
傳回值
類型: HRESULT
如果方法成功,傳回值會 S_OK。
如果方法失敗,傳回值會是下列 HRESULT 程序代碼。 如需 COM 錯誤碼的詳細資訊,請參閱 COM 中的錯誤處理。
傳回碼 | Description |
---|---|
|
未實作。 |
備註
用戶端矩形是文字服務對象負責繪製和管理的矩形。 主機依賴文字服務對象繪製該區域。 文字服務物件不得繪製或使該矩形外部的區域失效。 此外,當游標位於此矩形上方時,主機會將滑鼠訊息轉送至文字服務物件。 這個矩形是以包含視窗的用戶端座標表示。
檢視集是用戶端矩形與檢視矩形之間每個側邊的空間量。 檢視矩形 (也稱為 [格式化] 矩形) 是應該格式化文字的矩形。 如需詳細資訊,請參閱 TxGetViewInset。
backstyle 是用戶端矩形背景的樣式。 它可以是TXTBACK_TRANSPARENT或TXTBACK_SOLID。 請參閱 TXTBACKSTYLE。
滾動條屬性表示滾動條的變更:滾動條是否存在,不論滾動條在無法捲動時是否隱藏或停用,以及在插入點關閉用戶端矩形時啟用自動捲動也一樣。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | textserv.h |
Dll | Msftedit.dll |
另請參閱
概念
其他資源
參考