Metodo ITextServices::TxQueryHitPoint (textserv.h)

Articolo
08/26/2023

Verifica se un punto specificato si trova all'interno del rettangolo dell'oggetto servizi di testo.

Sintassi

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
);

Parametri

[in] dwDrawAspect

Tipo: DWORD

L'aspetto di disegno può essere uno dei valori seguenti.

valore	Significato
DVASPECT_CONTENT	Esegue il rendering di un'immagine dello schermo del contenuto di testo nel contesto di dispositivo hdcDraw . I parametri hicTargetDev e ptd forniscono informazioni sul contesto del dispositivo di destinazione, se presenti (in genere una stampante).
DVASPECT_DOCPRINT	Esegue il rendering dell'oggetto nel contesto di dispositivo hdcDraw come se fosse stampato in una stampante. Di conseguenza, l'oggetto servizi di testo può essere ottimizzato per la stampante (ad esempio, non disegnare il colore di sfondo, se bianco). Inoltre, non deve essere eseguito il rendering di alcuni elementi specifici dello schermo, ad esempio la selezione. ITextServices::TxGetNaturalSize deve eseguire il rendering del rettangolo lprcClient , a partire dalla posizione di scorrimento corrente.

valore

Significato

DVASPECT_CONTENT

Esegue il rendering di un'immagine dello schermo del contenuto di testo nel contesto di dispositivo hdcDraw .

I parametri hicTargetDev e ptd forniscono informazioni sul contesto del dispositivo di destinazione, se presenti (in genere una stampante).

DVASPECT_DOCPRINT

Esegue il rendering dell'oggetto nel contesto di dispositivo hdcDraw come se fosse stampato in una stampante. Di conseguenza, l'oggetto servizi di testo può essere ottimizzato per la stampante (ad esempio, non disegnare il colore di sfondo, se bianco). Inoltre, non deve essere eseguito il rendering di alcuni elementi specifici dello schermo, ad esempio la selezione.

ITextServices::TxGetNaturalSize deve eseguire il rendering del rettangolo lprcClient , a partire dalla posizione di scorrimento corrente.

lindex

Tipo: LONG

Non supportato.

[in] pvAspect

Tipo: void*

Informazioni per le ottimizzazioni del disegno.

[in] ptd

Tipo: DVTARGETDEVICE*

Informazioni sul dispositivo di destinazione.

[in] hdcDraw

Tipo: HDC

Rendering del contesto del dispositivo.

[in] hicTargetDev

Tipo: HDC

Contesto delle informazioni di destinazione.

[in] lprcClient

Tipo: LPCRECT

Rettangolo client del controllo, nelle coordinate client (dispositivo) della visualizzazione in cui viene eseguito l'hit testing.

[in] x

Tipo: INT

Coordinata x da controllare, nelle coordinate client, della visualizzazione in cui viene eseguito l'hit testing.

[in] y

Tipo: INT

Coordinata y da controllare, nelle coordinate client, della visualizzazione in cui viene eseguito l'hit testing.

[out] pHitResult

Tipo: DWORD*

Risultato dell'hit test. Può essere uno dei valori di enumerazione TXTHITRESULT seguenti.

valore	Significato
TXTHITRESULT_CLOSE	Il punto si trova nel rettangolo client e vicino a un'area nontransparente.
TXTHITRESULT_HIT	Il punto si trova nel rettangolo client e sopra il testo o lo sfondo non è trasparente.
TXTHITRESULT_NOHIT	Il punto si trova all'esterno del rettangolo client.
TXTHITRESULT_TRANSPARENT	Il punto si trova nel rettangolo client e non sopra il testo o lo sfondo è trasparente.

Valore restituito

Tipo: HRESULT

Il valore restituito è un codice HRESULT .

Commenti

Questo metodo consente all'host di implementare hit testing trasparente sul testo.

Per altre informazioni, vedere la sezione Osservazioni in ITextServices::TxDraw e ITextServices::OnTxSetCursor.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	textserv.h
DLL	Msftedit.dll