ITfContext::GetAppProperty メソッド (msctf.h)

  • [アーティクル]

アプリケーション プロパティを取得します。

構文

HRESULT GetAppProperty(
  [in]  REFGUID             guidProp,
  [out] ITfReadOnlyProperty **ppProp
);

パラメーター

[in] guidProp

プロパティ識別子を指定します。 これには、カスタム識別子または 定義済みのプロパティ識別子のいずれかを指定できます。

[out] ppProp

プロパティ オブジェクトを受け取る ITfReadOnlyProperty インターフェイス ポインターへのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 説明
S_OK
 メソッドは正常に実行されました。
S_FALSE
 コンテキスト所有者は、 プロパティをサポートしていません。
TF_E_DISCONNECTED
 コンテキストがドキュメント スタック上にありません。
E_INVALIDARG
 1 つ以上のパラメーターが無効です。
E_OUTOFMEMORY
 メモリ割り当てエラーが発生しました。
E_NOTIMPL
 コンテキスト所有者は、このメソッドを実装しません。
E_FAIL
 未指定のエラーが発生しました。

解説

アプリケーションでは、GUID によって識別される一意のプロパティを定義できます。 プロパティは VARIANT データとして格納されるため、呼び出し元は一意のプロパティの形式と意味を認識して使用できるようにする必要があります。

アプリケーション プロパティは、 ITfContext::GetProperty によって取得されるテキスト プロパティとは異なります。つまり、アプリケーション プロパティはコンテキスト所有者によって管理され、テキスト サービスでは変更できません。 アプリケーション のプロパティは、コンテキスト所有者のみが変更できます。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー msctf.h
[DLL] Msctf.dll
再頒布可能パッケージ Windows 2000 Professional 上の TSF 1.0

関連項目

ITfContext インターフェイス、 ITfContext::GetProperty、 ITfReadOnlyProperty インターフェイス、 定義済みプロパティ