Compartilhar via

Método ITextStoreAnchor::GetEmbedded (textstor.h)

  • Artigo

O método ITextStoreAnchor::GetEmbedded obtém um objeto inserido de um fluxo de texto.

Sintaxe

HRESULT GetEmbedded(
  [in]  DWORD    dwFlags,
  [in]  IAnchor  *paPos,
  [in]  REFGUID  rguidService,
  [in]  REFIID   riid,
  [out] IUnknown **ppunk
);

Parâmetros

[in] dwFlags

Campos de bits que especificam como o método lida com texto oculto. Se definido como TS_GEA_HIDDEN, um objeto inserido poderá ser localizado dentro do texto oculto. Caso contrário, o texto oculto será ignorado.

[in] paPos

Ponteiro para uma âncora posicionada imediatamente na frente do objeto inserido, conforme indicado por um caractere TS_CHAR_EMBEDDED.

[in] rguidService

Contém um valor GUID que define o formato solicitado do objeto obtido. Esse pode ser um dos valores a seguir.

Valor Significado
GUID_TS_SERVICE_DATAOBJECT
 O objeto deve ser obtido como um objeto de dados IDataObject .
GUID_TS_SERVICE_ACCESSIBLE
 O objeto deve ser obtido como um objeto Accessible.
GUID_TS_SERVICE_ACTIVEX
 O objeto deve ser obtido como um objeto ActiveX.

[in] riid

Especifica o tipo de interface solicitado.

[out] ppunk

Ponteiro para um ponteiro IUnknown que recebe a interface solicitada.

Retornar valor

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
 O método foi bem-sucedido.
E_FAIL
 O método não conseguiu obter o objeto solicitado.
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_INVALIDPOS
 A âncora de paPos solicitada não está dentro do documento.
TS_E_NOINTERFACE
 O tipo de interface solicitado não tem suporte.
TS_E_NOLOCK
 O chamador não tem um bloqueio somente leitura.
TS_E_NOOBJECT
 Não há nenhuma âncora paPos imediatamente na frente de um caractere TS_CHAR_EMBEDDED.
TS_E_NOSERVICE
 O tipo de serviço especificado em rguidService não tem suporte.

Comentários

O chamador deve usar QueryInterface para investigar interfaces apropriadas. As interfaces em potencial incluem aquelas associadas a documentos ou controles inseridos, como IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache ou IDispatch.

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 textstor.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

Objetos acessíveis

Idataobject

ITextStoreAnchor