ITextServices::TxQueryHitPoint-Methode (textserv.h)

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.

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

Siehe auch

Konzept

ITextServices

OnTxSetCursor

Referenz

TxDraw

Fensterlose Rich-Edit-Steuerelemente