Share via

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 でのエラー処理」を参照してください。

リターン コード 説明
E_INVALIDARG
 引数が無効です。
CO_E_RELEASED
 フォント オブジェクトは、削除された範囲にアタッチされます。
E_ACCESSDENIED
 書き込みアクセスが拒否されました。
E_OUTOFMEMORY
 メモリ不足です。

注釈

一般に、範囲の書式または内容を変更しようとするテキスト オブジェクト モデル (TOM) メソッドは、その範囲の一部が保護されている場合、またはドキュメントが読み取り専用の場合、 E_ACCESSDENIED で失敗します。 保護されたテキストを変更するには、TOM クライアントが変更するテキストの保護をオフにしようとする必要があります。 ドキュメントの所有者は、この問題の発生を許可する場合があります。 たとえば、リッチ エディット コントロールでは、保護されたテキストを変更しようとすると、ドキュメントの作成者に EN_PROTECTED 通知コードが生成され、変更のアクセス許可を拒否または許可できます。 作成者は、CreateWindow 関数または CreateTextServices 関数を呼び出してウィンドウなしのリッチ エディット コントロールを作成した ITextHost オブジェクトを使用して、ウィンドウのリッチ エディット コントロールを作成したクライアントです。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー tom.h
[DLL] Msftedit.dll

関連項目

概念

CreateTextServices

CreateWindow

EN_PROTECTED

GetProtected

ITextFont

その他のリソース

リファレンス

Text オブジェクト モデル