Método IAccClientDocMgr::LookupByPoint (msaatext.h)

Os clientes chamam IAccClientDocMgr::LookupByPoint para obter um objeto de documento de um ponto dentro do documento.

Nota Os Serviços de Texto de Acessibilidade Ativa foram preteridos. Consulte Microsoft Windows Text Services Framework para obter mais informações sobre tecnologias avançadas de entrada de texto e linguagem natural.

 

Sintaxe

HRESULT LookupByPoint(
  [in]  POINT    pt,
  [in]  REFIID   riid,
  [out] IUnknown **ppunk
);

Parâmetros

[in] pt

Tipo: POINT

Um ponto dentro do retângulo delimitador do documento a ser retornado.

[in] riid

Tipo: REFIID

IID do documento que está sendo solicitado. Isso geralmente é IID_ITextStoreAnchor.

[out] ppunk

Tipo: IUnknown*

Ponteiro de interface para o documento que está sendo solicitado.

Valor retornado

Tipo: HRESULT

Se for bem-sucedido, retornará S_OK.

Se não for bem-sucedido, retornará o valor a seguir ou outro código de erro COM padrão.

Erro	Descrição
E_FAIL	Se o valor em pt não se enquadrar no retângulo delimitador de um documento ativo, ppunk será NULL.

Comentários

Talvez os servidores precisem sondar esse método mais de uma vez antes de receberem um documento. Pode haver um lapso de tempo limitado (aproximadamente segundo) entre quando um documento aparece no sistema e quando ele é registrado com serviços de documentos.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msaatext.h
DLL	Msaatext.dll
Redistribuível	Active Accessibility 2.0 RDK no Windows NT 4.0 com SP6 e posterior e Windows 98