iTextFont::GetProtected 方法 (tom.h)
取得字元是否受到保護,以防止嘗試修改它們。
語法
HRESULT GetProtected(
long *pValue
);
參數
pValue
類型: long*
tomBool 值,可以是下列其中一項。
值 | 意義 |
---|---|
tomTrue | 字元受到保護。 |
tomFalse | 字元不會受到保護。 |
tomUndefined | Protected 屬性未定義。 |
傳回值
類型: HRESULT
如果方法成功,它會 傳回S_OK。 如果方法失敗,它會傳回下列其中一個 COM 錯誤碼。 如需 COM 錯誤碼的詳細資訊,請參閱 COM 中的錯誤處理。
傳回碼 | Description |
---|---|
|
無效引數。 |
|
字型物件會附加至已刪除的範圍。 |
備註
一般而言 ,文字物件 模型 (TOM) 方法來嘗試變更範圍的格式設定或內容,如果該範圍的任何部分受到保護,或檔唯讀,則E_ACCESSDENIED失敗。 若要變更受保護文字,TOM 用戶端應該嘗試關閉要修改之文字的保護。 檔的擁有者可能會允許發生這種情況。 例如,在 RTF 編輯控制件中,嘗試變更受保護的文字會導致 EN_PROTECTED 通知程式代碼給檔的建立者,然後可以拒絕或授與變更的許可權。 建立者是用戶端,該用戶端會透過 CreateWindow 函式或呼叫 CreateTextServices 函式的 ITextHost 物件建立視窗式豐富編輯控件,以建立無窗口豐富編輯控件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | tom.h |
Dll | Msftedit.dll |
另請參閱
概念
其他資源
參考