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

Artigo
08/24/2023

O método ITfRange::GetEmbedded obtém conteúdo que corresponde a um caractere TS_CHAR_EMBEDDED no fluxo de texto. A âncora inicial do intervalo de texto é posicionada pouco antes do caractere de interesse.

Sintaxe

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

Parâmetros

[in] ec

Edite o cookie obtido de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] rguidService

Identificador que especifica como o conteúdo inserido é obtido.

Valor	Significado
GUID_TS_SERVICE_ACCESSIBLE	A saída deve ser um objeto Accessible.
GUID_TS_SERVICE_ACTIVEX	O chamador requer um ponteiro direto para o objeto que dá suporte à interface especificada por riid.
GUID_TS_SERVICE_DATAOBJECT	O conteúdo deve ser obtido como um objeto de transferência de dados IDataObject , com riid sendo IID_IDataObject. Os clientes devem especificar essa opção quando uma cópia do conteúdo for necessária.
Definido pelo chamador	Os serviços de texto e os proprietários de contexto podem definir GUIDs personalizados.

[in] riid

UUID da interface do objeto solicitado.

[out] ppunk

Ponteiro para o objeto . Ele pode ser convertido para corresponder riid.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
E_NOTIMPL	O aplicativo de implementação não expõe objetos inseridos em seu fluxo de texto.
TF_E_NOINTERFACE	O objeto não dá suporte à interface solicitada.
TF_E_NOLOCK	O valor no parâmetro ec é um cookie inválido ou o chamador não tem um bloqueio somente leitura.
TF_E_NOOBJECT	A âncora inicial do intervalo não é posicionada antes de um caractere TF_CHAR_EMBEDDED.
TF_E_NOSERVICE	O conteúdo não pode ser retornado para corresponder a rguidService.

Comentários

Embora o objeto obtido possa não dar suporte a determinadas interfaces, é provável que o objeto dê suporte a essas interfaces associadas a documentos ou controles inseridos, como IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache ou IDispatch. O chamador deve usar QueryInterface para investigar qualquer interface interessante. Se o método for bem-sucedido, mas riid for NULL, o aplicativo indicará a presença de um objeto inserido, mas não exporá o próprio objeto. Os processadores de texto ainda podem se beneficiar de uma notificação sobre a possível quebra de palavra.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional