Método ITextServices::TxQueryHitPoint (textserv.h)

Artigo
08/26/2023

Testa se um ponto especificado está dentro do retângulo do objeto de serviços de texto.

Sintaxe

HRESULT TxQueryHitPoint(
  [in]  DWORD          dwDrawAspect,
        LONG           lindex,
  [in]  void           *pvAspect,
  [in]  DVTARGETDEVICE *ptd,
  [in]  HDC            hdcDraw,
  [in]  HDC            hicTargetDev,
  [in]  LPCRECT        lprcClient,
  [in]  INT            x,
  [in]  INT            y,
  [out] DWORD          *pHitResult
);

Parâmetros

[in] dwDrawAspect

Tipo: DWORD

O aspecto de desenho pode ser um dos valores a seguir.

Valor	Significado
DVASPECT_CONTENT	Renderiza uma imagem de tela do conteúdo do texto para o contexto do dispositivo hdcDraw . Os parâmetros hicTargetDev e ptd fornecem informações sobre o contexto do dispositivo de destino, se houver (geralmente uma impressora).
DVASPECT_DOCPRINT	Renderiza o objeto para o contexto do dispositivo hdcDraw como se ele fosse impresso em uma impressora. Assim, o objeto de serviços de texto pode otimizar para a impressora (por exemplo, não pintar a cor da tela de fundo, se for branco). Além disso, determinados elementos específicos da tela (como a seleção) não devem ser renderizados. ITextServices::TxGetNaturalSize deve renderizar o retângulo lprcClient , começando na posição de rolagem atual.

Valor

Significado

DVASPECT_CONTENT

Renderiza uma imagem de tela do conteúdo do texto para o contexto do dispositivo hdcDraw .

Os parâmetros hicTargetDev e ptd fornecem informações sobre o contexto do dispositivo de destino, se houver (geralmente uma impressora).

DVASPECT_DOCPRINT

Renderiza o objeto para o contexto do dispositivo hdcDraw como se ele fosse impresso em uma impressora. Assim, o objeto de serviços de texto pode otimizar para a impressora (por exemplo, não pintar a cor da tela de fundo, se for branco). Além disso, determinados elementos específicos da tela (como a seleção) não devem ser renderizados.

ITextServices::TxGetNaturalSize deve renderizar o retângulo lprcClient , começando na posição de rolagem atual.

lindex

Tipo: LONG

Sem suporte.

[in] pvAspect

Tipo: void*

Informações para otimizações de desenho.

[in] ptd

Tipo: DVTARGETDEVICE*

Informações sobre o dispositivo de destino.

[in] hdcDraw

Tipo: HDC

Renderizando o contexto do dispositivo.

[in] hicTargetDev

Tipo: HDC

Contexto de informações de destino.

[in] lprcClient

Tipo: LPCRECT

O retângulo do cliente do controle, nas coordenadas do cliente (dispositivo) da exibição na qual o teste de clique é feito.

[in] x

Tipo: INT

Coordenada x para marcar, em coordenadas do cliente, da exibição na qual o teste de clique é feito.

[in] y

Tipo: INT

Coordenada y para marcar, em coordenadas do cliente, da exibição na qual o teste de clique é feito.

[out] pHitResult

Tipo: DWORD*

O resultado do teste de clique. Pode ser qualquer um dos seguintes valores de enumeração TXTHITRESULT .

Valor	Significado
TXTHITRESULT_CLOSE	O ponto está no retângulo do cliente e próximo a uma área não transitória.
TXTHITRESULT_HIT	O ponto está no retângulo do cliente e o texto ou a tela de fundo não é transparente.
TXTHITRESULT_NOHIT	O ponto está fora do retângulo do cliente.
TXTHITRESULT_TRANSPARENT	O ponto está no retângulo do cliente e não sobre texto ou a tela de fundo era transparente.

Valor retornado

Tipo: HRESULT

O valor retornado é um código HRESULT .

Comentários

Esse método permite que o host implemente testes de clique transparentes no texto.

Para obter mais informações, consulte a seção Comentários em ITextServices::TxDraw e ITextServices::OnTxSetCursor.

Requisitos


Cliente mínimo com suporte	Windows Vista [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	textserv.h
DLL	Msftedit.dll