iTextFont：：SetProtected 方法 (tom.h)

設定字元是否受到保護，以防止嘗試修改字元。

語法

HRESULT SetProtected(
  [in] long Value
);

參數

[in] Value

類型： long

tomBool 值，可以是下列其中一項。

值	意義
tomTrue	字元受到保護。
tomFalse	字元不會受到保護。
tomToggle	切換 Protected 屬性的狀態。
tomUndefined	Protected 屬性未定義。

傳回值

類型： HRESULT

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

傳回碼	Description
E_INVALIDARG	無效引數。
CO_E_RELEASED	字型物件會附加至已刪除的範圍。
E_ACCESSDENIED	拒絕寫入存取。
E_OUTOFMEMORY	記憶體不足。

備註

一般而言，如果該範圍的任一部分受到保護，或是檔是只讀的，則嘗試變更範圍格式設定或內容的方法 (TOM) 方法將會失敗， 並E_ACCESSDENIED 。 若要變更受保護文字，TOM 用戶端應該嘗試關閉要修改之文字的保護。 檔的擁有者可能會允許發生這種情況。 例如，在 RTF 編輯控制件中，嘗試變更受保護的文字會導致 EN_PROTECTED 通知程式代碼給檔的建立者，然後可以拒絕或授與變更的許可權。 建立者是用戶端，可透過 CreateWindow 函式或呼叫 CreateTextServices 函式的 ITextHost 物件建立視窗式豐富編輯控件，以建立無窗口豐富編輯控件。

規格需求

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

另請參閱

概念

CreateTextServices

CreateWindow

EN_PROTECTED

GetProtected

ITextFont

其他資源

參考

文字物件模型