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 値を格納します。 これには、次のいずれかの値を指定できます。
値 | 意味 |
---|---|
|
オブジェクトは IDataObject データ オブジェクトとして取得する必要があります。 |
|
オブジェクトは 、Accessible オブジェクトとして取得する必要があります。 |
|
オブジェクトは ActiveX オブジェクトとして取得する必要があります。 |
[in] riid
要求されるインターフェイスの種類を指定します。
[out] ppunk
要求されたインターフェイスを受け取る IUnknown ポインターへのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
値 | 説明 |
---|---|
|
メソッドは正常に実行されました。 |
|
メソッドは、要求されたオブジェクトを取得できませんでした。 |
|
1 つ以上のパラメーターが無効です。 |
|
実装するアプリケーションは、テキスト ストリームに埋め込みオブジェクトを公開しません。 |
|
要求された paPos アンカーがドキュメント内にありません。 |
|
要求されたインターフェイスの種類はサポートされていません。 |
|
呼び出し元に読み取り専用ロックがありません。 |
|
TS_CHAR_EMBEDDED文字の直前に paPos アンカーはありません。 |
|
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 |