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

Статья
08/24/2023

Метод 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 Профессиональная