ITfRange::GetEmbedded メソッド (msctf.h)

[アーティクル]
08/24/2023

ITfRange::GetEmbedded メソッドは、テキストストリーム内のTS_CHAR_EMBEDDED文字に対応するコンテンツを取得します。テキスト範囲の開始アンカーは、目的の文字の直前に配置されます。

構文

HRESULT GetEmbedded(
  [in]  TfEditCookie ec,
  [in]  REFGUID      rguidService,
  [in]  REFIID       riid,
  [out] IUnknown     **ppunk
);

パラメーター

[in] ec

ITfDocumentMgr::CreateContext または ITfEditSession::D oEditSession から取得した Cookie を編集します。

[in] rguidService

埋め込みコンテンツの取得方法を指定する識別子。

値	意味
GUID_TS_SERVICE_ACCESSIBLE	出力は Accessible オブジェクトである必要があります。
GUID_TS_SERVICE_ACTIVEX	呼び出し元には、 riid で指定されたインターフェイスをサポートするオブジェクトへの直接ポインターが必要です。
GUID_TS_SERVICE_DATAOBJECT	コンテンツは IDataObject データ転送オブジェクトとして取得し、 riid をIID_IDataObjectする必要があります。クライアントは、コンテンツのコピーが必要な場合に、このオプションを指定する必要があります。
呼び出し元定義	テキストサービスとコンテキスト所有者は、カスタム GUID を定義できます。

[in] riid

要求されたオブジェクトのインターフェイスの UUID。

[out] ppunk

オブジェクトへのポインター。 riid と一致するようにキャストできます。

戻り値

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

値	説明
S_OK	メソッドは正常に実行されました。
E_INVALIDARG	1 つ以上のパラメーターが無効です。
E_NOTIMPL	実装するアプリケーションでは、テキストストリーム内の埋め込みオブジェクトは公開されません。
TF_E_NOINTERFACE	オブジェクトは、要求されたインターフェイスをサポートしていません。
TF_E_NOLOCK	ec パラメーターの値が無効な Cookie であるか、呼び出し元に読み取り専用ロックがありません。
TF_E_NOOBJECT	範囲の開始アンカーは、TF_CHAR_EMBEDDED文字の前に配置されません。
TF_E_NOSERVICE	rguidService と一致するようにコンテンツを返すことはできません。

注釈

取得したオブジェクトは特定のインターフェイスをサポートしていない可能性があります。オブジェクトは、IOleObject、IDataObject、IViewObject、IPersistStorage、IOleCache、IDispatch などの埋め込みドキュメントまたはコントロールに関連付けられているインターフェイスをサポートする可能性があります。呼び出し元は QueryInterface を 使用して、関心のあるインターフェイスをプローブする必要があります。メソッドが成功しても riid が NULL の場合、アプリケーションは埋め込みオブジェクトの存在を示しますが、オブジェクト自体は公開しません。テキストプロセッサは、単語区切りの可能性に関する通知の恩恵を受けることができます。

要件

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