ITextStoreAnchor::GetEmbedded メソッド (textstor.h)

  • [アーティクル]

ITextStoreAnchor::GetEmbedded メソッドは、テキスト ストリームから埋め込みオブジェクトを取得します。

構文

HRESULT GetEmbedded(
  [in]  DWORD    dwFlags,
  [in]  IAnchor  *paPos,
  [in]  REFGUID  rguidService,
  [in]  REFIID   riid,
  [out] IUnknown **ppunk
);

パラメーター

[in] dwFlags

メソッドが非表示のテキストを処理する方法を指定するビット フィールド。 TS_GEA_HIDDENに設定すると、埋め込みオブジェクトを非表示のテキスト内に配置できます。 それ以外の場合、非表示のテキストはスキップされます。

[in] paPos

TS_CHAR_EMBEDDED文字で示されているように、埋め込みオブジェクトの直前に配置されたアンカーへのポインター。

[in] rguidService

取得したオブジェクトの要求された形式を定義する GUID 値を格納します。 これには、次のいずれかの値を指定できます。

値 意味
GUID_TS_SERVICE_DATAOBJECT
 オブジェクトは IDataObject データ オブジェクトとして取得する必要があります。
GUID_TS_SERVICE_ACCESSIBLE
 オブジェクトは 、Accessible オブジェクトとして取得する必要があります。
GUID_TS_SERVICE_ACTIVEX
 オブジェクトは ActiveX オブジェクトとして取得する必要があります。

[in] riid

要求されるインターフェイスの種類を指定します。

[out] ppunk

要求されたインターフェイスを受け取る IUnknown ポインターへのポインター。

戻り値

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

値 説明
S_OK
 メソッドは正常に実行されました。
E_FAIL
 メソッドは、要求されたオブジェクトを取得できませんでした。
E_INVALIDARG
 1 つ以上のパラメーターが無効です。
E_NOTIMPL
 実装するアプリケーションは、テキスト ストリームに埋め込みオブジェクトを公開しません。
TF_E_INVALIDPOS
 要求された paPos アンカーがドキュメント内にありません。
TS_E_NOINTERFACE
 要求されたインターフェイスの種類はサポートされていません。
TS_E_NOLOCK
 呼び出し元に読み取り専用ロックがありません。
TS_E_NOOBJECT
 TS_CHAR_EMBEDDED文字の直前に paPos アンカーはありません。
TS_E_NOSERVICE
 rguidService で指定されたサービスの種類はサポートされていません。

注釈

呼び出し元は QueryInterface を 使用して、適切なインターフェイスをプローブする必要があります。 見込みインターフェイスには、IOleObject、IDataObject、IViewObject、IPersistStorage、IOleCache、IDispatch などの埋め込みドキュメントまたはコントロールに関連付けられているインターフェイスが含まれます。

要件

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

こちらもご覧ください

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

Idataobject

ITextStoreAnchor