ITextFont::GetProtected メソッド (tom.h)
文字が変更の試行から保護されているかどうかを取得します。
構文
HRESULT GetProtected(
long *pValue
);
パラメーター
pValue
種類: long*
次のいずれかである tomBool 値。
| 値 | 意味 |
|---|---|
| tomTrue | 文字は保護されています。 |
| tomFalse | 文字は保護されません。 |
| tomUndefined | Protected プロパティは未定義です。 |
戻り値
種類: HRESULT
メソッドが成功すると、 S_OKが返されます。 メソッドが失敗した場合は、次のいずれかの COM エラー コードが返されます。 COM エラー コードの詳細については、「COM でのエラー処理」を参照してください。
| リターン コード | 説明 |
|---|---|
|
引数が無効です。 |
|
フォント オブジェクトは、削除された範囲にアタッチされます。 |
注釈
一般に、範囲の書式または内容を変更しようとするテキスト オブジェクト モデル (TOM) メソッドは、その範囲の一部が保護されている場合、またはドキュメントが読み取り専用の場合は、 E_ACCESSDENIED で失敗します。 保護されたテキストを変更するには、TOM クライアントが変更するテキストの保護をオフにしようとする必要があります。 ドキュメントの所有者は、この実行を許可する場合があります。 たとえば、リッチ エディット コントロールでは、保護されたテキストを変更しようとすると、ドキュメントの作成者に EN_PROTECTED 通知コードが表示され、変更のアクセス許可を拒否または付与できます。 作成者は、CreateWindow 関数または CreateTextServices 関数を呼び出した ITextHost オブジェクトを使用してウィンドウ表示のリッチエディット コントロールを作成し、ウィンドウなしのリッチエディット コントロールを作成したクライアントです。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | tom.h |
| [DLL] | Msftedit.dll |
関連項目
概念
その他のリソース
リファレンス