Share via

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
 一或多個參數無效。
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