Метод ITextStoreAnchor::GetEmbedded (texttor.h)

Статья
03/02/2024

Метод 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

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