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

  • [アーティクル]

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

こちらもご覧ください

アクセシビリティの高いオブジェクト

Idataobject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfRange::InsertEmbedded

その他のフレームワーク定数

テキスト ストア