Método ITfRange::GetEmbedded (msctf.h)

Artículo
08/24/2023

El método ITfRange::GetEmbedded obtiene contenido que corresponde a un carácter TS_CHAR_EMBEDDED en la secuencia de texto. El delimitador inicial del intervalo de texto se coloca justo antes del carácter de interés.

Sintaxis

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

Parámetros

[in] ec

Edite la cookie obtenida de ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] rguidService

Identificador que especifica cómo se obtiene el contenido incrustado.

Valor	Significado
GUID_TS_SERVICE_ACCESSIBLE	La salida debe ser un objeto Accesible.
GUID_TS_SERVICE_ACTIVEX	El autor de la llamada requiere un puntero directo al objeto que admite la interfaz especificada por riid.
GUID_TS_SERVICE_DATAOBJECT	El contenido debe obtenerse como un objeto de transferencia de datos IDataObject , con riid IID_IDataObject. Los clientes deben especificar esta opción cuando se requiera una copia del contenido.
Definido por el autor de la llamada	Los servicios de texto y los propietarios de contexto pueden definir GUID personalizados.

[in] riid

UUID de la interfaz del objeto solicitado.

[out] ppunk

Puntero al objeto . Se puede convertir para que coincida con riid.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_INVALIDARG	Uno o varios parámetros no son válidos.
E_NOTIMPL	La aplicación de implementación no expone objetos incrustados en su flujo de texto.
TF_E_NOINTERFACE	El objeto no admite la interfaz solicitada.
TF_E_NOLOCK	El valor del parámetro ec es una cookie no válida o el autor de la llamada no tiene un bloqueo de solo lectura.
TF_E_NOOBJECT	El delimitador inicial del intervalo no se coloca antes de un carácter de TF_CHAR_EMBEDDED.
TF_E_NOSERVICE	No se puede devolver el contenido para que coincida con rguidService.

Comentarios

Aunque es posible que el objeto obtenido no admita determinadas interfaces, es probable que el objeto admita esas interfaces asociadas a documentos incrustados o controles como IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache o IDispatch. El autor de la llamada debe usar QueryInterface para sondear cualquier interfaz interesante. Si el método se ejecuta correctamente pero riid es NULL, la aplicación indica la presencia de un objeto incrustado, pero no expone el propio objeto. Los procesadores de texto todavía pueden beneficiarse de una notificación sobre la posible interrupción de palabras.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional