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


Метод ITfRange::GetEmbedded (msctf.h)

Метод ITfRange::GetEmbedded получает содержимое, соответствующее символу TS_CHAR_EMBEDDED в текстовом потоке. Начальная привязка диапазона текста располагается непосредственно перед интересующим символом.

Синтаксис

HRESULT GetEmbedded(
  [in]  TfEditCookie ec,
  [in]  REFGUID      rguidService,
  [in]  REFIID       riid,
  [out] IUnknown     **ppunk
);

Параметры

[in] ec

Измените файл cookie, полученный из ITfDocumentMgr::CreateContext или ITfEditSession::D oEditSession.

[in] rguidService

Идентификатор, указывающий способ получения внедренного содержимого.

Значение Значение
GUID_TS_SERVICE_ACCESSIBLE
Выходные данные должны быть доступными объектами.
GUID_TS_SERVICE_ACTIVEX
Для вызывающего объекта требуется прямой указатель на объект , поддерживающий интерфейс, заданный riid.
GUID_TS_SERVICE_DATAOBJECT
Содержимое должно быть получено в виде объекта передачи данных IDataObject с IID_IDataObject riid . Клиенты должны указывать этот параметр, если требуется копия содержимого.
Определение вызывающего абонента
Текстовые службы и владельцы контекста могут определять пользовательские GUID.

[in] riid

UUID интерфейса запрошенного объекта.

[out] ppunk

Указатель на объект . Его можно привести в соответствии с riid.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение Описание
S_OK
Метод выполнен успешно.
E_INVALIDARG
Один или несколько параметров являются недопустимыми.
E_NOTIMPL
Реализующее приложение не предоставляет внедренные объекты в своем текстовом потоке.
TF_E_NOINTERFACE
Объект не поддерживает запрошенный интерфейс.
TF_E_NOLOCK
Значение в параметре EC является недопустимым файлом cookie или у вызывающего объекта нет блокировки только для чтения.
TF_E_NOOBJECT
Начальная привязка диапазона не располагается перед символом TF_CHAR_EMBEDDED.
TF_E_NOSERVICE
Содержимое не может быть возвращено в соответствии с rguidService.

Комментарии

Хотя полученный объект может не поддерживать определенные интерфейсы, скорее всего, объект будет поддерживать интерфейсы, связанные с внедренными документами или элементами управления, такими как IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache или IDispatch. Вызывающий объект должен использовать QueryInterface для проверки любого интересного интерфейса. Если метод выполняется успешно, но riid имеет значение NULL, приложение указывает на наличие внедренного объекта, но не предоставляет сам объект. Обработчики текста по-прежнему могут воспользоваться уведомлением о возможном разрыве слов.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header msctf.h
DLL Msctf.dll
Распространяемые компоненты TSF 1.0 в Windows 2000 Профессиональная

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

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

Idataobject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfRange::InsertEmbedded

Прочие константы платформы

Текстовые хранилища