通过

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
 应将 对象作为 辅助对象获取。
GUID_TS_SERVICE_ACTIVEX
 应将 对象作为 ActiveX 对象获取。

[in] riid

指定请求的接口类型。

[out] ppunk

指向接收所请求接口的 IUnknown 指针的指针。

返回值

此方法可以返回其中一个值。

值 说明
S_OK
 方法成功。
E_FAIL
 方法未能获取请求的对象。
E_INVALIDARG
 一个或多个参数无效。
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 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 textstor.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

辅助对象

IDataObject

ITextStoreAnchor