ITextServices::TxQueryHitPoint-Methode (textserv.h)

Artikel
08/26/2023

Testet, ob sich ein angegebener Punkt innerhalb des Rechtecks des text services-Objekts befindet.

Syntax

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

Parameter

[in] dwDrawAspect

Typ: DWORD

Der Zeichnungsaspekt kann einer der folgenden Werte sein.

Wert	Bedeutung
DVASPECT_CONTENT	Rendert ein Bildschirmbild des Textinhalts im hdcDraw-Gerätekontext . Die Parameter hicTargetDev und ptd geben Informationen zum Zielgerätekontext (sofern vorhanden) (normalerweise ein Drucker).
DVASPECT_DOCPRINT	Rendert das Objekt im hdcDraw-Gerätekontext , als würde es auf einen Drucker gedruckt. Daher kann das Textdienstobjekt für den Drucker optimiert werden (z. B. die Hintergrundfarbe nicht malen, wenn sie weiß ist). Außerdem sollten bestimmte bildschirmspezifische Elemente (z. B. die Auswahl) nicht gerendert werden. ITextServices::TxGetNaturalSize sollte das lprcClient-Rechteck ab der aktuellen Bildlaufposition rendern.

Wert

Bedeutung

DVASPECT_CONTENT

Rendert ein Bildschirmbild des Textinhalts im hdcDraw-Gerätekontext .

Die Parameter hicTargetDev und ptd geben Informationen zum Zielgerätekontext (sofern vorhanden) (normalerweise ein Drucker).

DVASPECT_DOCPRINT

Rendert das Objekt im hdcDraw-Gerätekontext , als würde es auf einen Drucker gedruckt. Daher kann das Textdienstobjekt für den Drucker optimiert werden (z. B. die Hintergrundfarbe nicht malen, wenn sie weiß ist). Außerdem sollten bestimmte bildschirmspezifische Elemente (z. B. die Auswahl) nicht gerendert werden.

ITextServices::TxGetNaturalSize sollte das lprcClient-Rechteck ab der aktuellen Bildlaufposition rendern.

lindex

Typ: LONG

Wird nicht unterstützt.

[in] pvAspect

Typ: void*

Informationen zu Zeichnungsoptimierungen.

[in] ptd

Typ: DVTARGETDEVICE*

Informationen zum Zielgerät.

[in] hdcDraw

Typ: HDC

Rendern des Gerätekontexts.

[in] hicTargetDev

Typ: HDC

Zielinformationskontext.

[in] lprcClient

Typ: LPCRECT

Das Clientrechteck des Steuerelements in Clientkoordinaten (Gerät) der Ansicht, in der der Treffertest durchgeführt wird.

[in] x

Typ: INT

x-koordinate, um in Clientkoordinaten die Ansicht zu überprüfen, in der Treffertests ausgeführt werden.

[in] y

Typ: INT

y-Koordinate, um in Clientkoordinaten die Sicht zu überprüfen, in der die Treffertests durchgeführt werden.

[out] pHitResult

Typ: DWORD*

Das Ergebnis des Treffertests. Es kann sich um einen der folgenden TXTHITRESULT-Enumerationswerte handeln.

Wert	Bedeutung
TXTHITRESULT_CLOSE	Der Punkt befindet sich im Clientrechteck und in der Nähe eines nicht intransparenten Bereichs.
TXTHITRESULT_HIT	Der Punkt befindet sich im Clientrechteck, und entweder über Text oder hintergrund ist nicht transparent.
TXTHITRESULT_NOHIT	Der Punkt befindet sich außerhalb des Clientrechtecks.
TXTHITRESULT_TRANSPARENT	Der Punkt befindet sich im Clientrechteck und entweder nicht über Text oder der Hintergrund war transparent.

Rückgabewert

Typ: HRESULT

Der Rückgabewert ist ein HRESULT-Code .

Hinweise

Mit dieser Methode kann der Host transparente Treffertests für Text implementieren.

Weitere Informationen finden Sie im Abschnitt Hinweise in ITextServices::TxDraw und ITextServices::OnTxSetCursor.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	textserv.h
DLL	Msftedit.dll