ITextFont::GetProtected メソッド (tom.h)

文字が変更の試行から保護されているかどうかを取得します。

構文

HRESULT GetProtected(
  long *pValue
);

パラメーター

pValue

種類: long*

次のいずれかである tomBool 値。

値	意味
tomTrue	文字は保護されています。
tomFalse	文字は保護されません。
tomUndefined	Protected プロパティは未定義です。

戻り値

種類: HRESULT

メソッドが成功すると、 S_OKが返されます。 メソッドが失敗した場合は、次のいずれかの COM エラー コードが返されます。 COM エラー コードの詳細については、「COM でのエラー処理」を参照してください。

リターン コード	説明
E_INVALIDARG	引数が無効です。
CO_E_RELEASED	フォント オブジェクトは、削除された範囲にアタッチされます。

注釈

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

要件

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

関連項目

概念

CreateTextServices

CreateWindow

EN_PROTECTED

ITextFont

その他のリソース

リファレンス

SetProtected

Text オブジェクト モデル