Поделиться через

Метод ITextStoreAnchor::GetEmbedded (texttor.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
Header textstor.h
DLL Msctf.dll
Распространяемые компоненты TSF 1.0 в Windows 2000 Professional

См. также раздел

Объекты со специальными возможностями

Idataobject

ITextStoreAnchor