ITextServices::OnTxSetCursor-Methode (textserv.h)

Artikel
08/26/2023

Benachrichtigt das Textdienstobjekt, um den Cursor festzulegen.

Syntax

HRESULT OnTxSetCursor(
  [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
);

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::OnTxSetCursor 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::OnTxSetCursor 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*

Das Zielgerät.

[in] hdcDraw

Typ: HDC

Rendern des Gerätekontexts.

[in] hicTargetDev

Typ: HDC

Zielinformationskontext.

[in] lprcClient

Typ: LPCRECT

Das Clientrechteck des Steuerelements. Die Koordinaten des Rechtecks befinden sich in Clientkoordinaten des enthaltenden Fensters. NULL ist ein gesetzlicher Wert.

[in] x

Typ: INT

x Position des Cursors in den Clientkoordinaten des enthaltenden Fensters.

[in] y

Typ: INT

y Position des Cursors in den Clientkoordinaten des enthaltenden Fensters.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK.

Wenn die Methode fehlschlägt, ist der Rückgabewert der folgende HRESULT-Code . Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.

Rückgabecode	Beschreibung
E_INVALIDARG	Mindestens ein unzulässiger Parameter.

Hinweise

Das Textdienstobjekt kann als Ergebnis dieses Aufrufs neu gemessen werden, um den richtigen Cursor zu bestimmen. Der richtige Cursor wird über TxSetCursor festgelegt.

Der lprcClient-Parameter ist das Clientrechteck der Ansicht des Steuerelements, über dem der Mauscursor positioniert ist. Der lprcClient-Parameter befindet sich in den Gerätekoordinaten des enthaltenden Fensters auf die gleiche Weise wie die WM_SIZE Nachricht. Dies ist möglicherweise nicht die Ansicht, die zuletzt gerendert wurde. Darüber hinaus ist das Steuerelement möglicherweise nicht die aktuelle aktive Ansicht, wenn das Steuerelement aktiv ist. Daher sollte das Textdienstobjekt dieses Rechteck anhand des Werts des aktuellen Caches überprüfen und ermitteln, ob eine Neuberechnung der Zeilen erforderlich ist oder nicht. Der Zoomfaktor sollte in diese Berechnung einbezogen werden. Eine Erläuterung des Zoomfaktors finden Sie unter TxGetExtent.

Diese Methode sollte nur für Bildschirmansichten des Steuerelements aufgerufen werden. Daher wird der Gerätekontext (Device Context, DC) nicht übergeben, sondern sollte angenommen werden, dass es sich um einen Bildschirm-DC handelt.

Weitere Informationen finden Sie unter Hinweise in ITextServices::TxDraw.

Anforderungen

Anforderung	Wert
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