IDirect3DDevice9::SetCursorPosition-Methode (d3d9helper.h)

Artikel
08/23/2023

Legt die Cursorposition und die Aktualisierungsoptionen fest.

Syntax

void SetCursorPosition(
  [in] int   X,
  [in] int   Y,
  [in] DWORD Flags
);

Parameter

[in] X

Typ: INT

Die neue X-Position des Cursors in virtuellen Desktopkoordinaten. Siehe Hinweise.

[in] Y

Typ: INT

Die neue Y-Position des Cursors in virtuellen Desktopkoordinaten. Siehe Hinweise.

[in] Flags

Typ: DWORD

Gibt die Updateoptionen für den Cursor an. Derzeit ist nur ein Flag definiert.

Wert	Bedeutung
D3DCURSOR_IMMEDIATE_UPDATE	Aktualisieren Sie den Cursor mit der Aktualisierungsrate. Wenn dieses Flag angegeben wird, garantiert das System, dass der Cursor mindestens mit der Hälfte der Anzeigeaktualisierungsrate aktualisiert wird, aber niemals häufiger als die Anzeigeaktualisierungsrate. Andernfalls verzögert die Methode Cursorupdates bis zum nächsten IDirect3DDevice9::P resent-Aufruf . Das Festlegen dieses Flags führt in der Regel zu einer besseren Leistung, als wenn das Flag festgelegt ist. Anwendungen sollten dieses Flag jedoch festlegen, wenn die Rate der Aufrufe von Present so niedrig ist, dass Benutzer eine erhebliche Verzögerung bei der Cursorbewegung bemerken würden. Dieses Flag hat in einer Anwendung im Fenstermodus keine Auswirkungen. Einige Grafikkarten implementieren Hardwarefarbcursor. Dieses Flag hat keine Auswirkungen auf diese Karten.

Wert

Bedeutung

D3DCURSOR_IMMEDIATE_UPDATE

Aktualisieren Sie den Cursor mit der Aktualisierungsrate.

Wenn dieses Flag angegeben wird, garantiert das System, dass der Cursor mindestens mit der Hälfte der Anzeigeaktualisierungsrate aktualisiert wird, aber niemals häufiger als die Anzeigeaktualisierungsrate. Andernfalls verzögert die Methode Cursorupdates bis zum nächsten IDirect3DDevice9::P resent-Aufruf . Das Festlegen dieses Flags führt in der Regel zu einer besseren Leistung, als wenn das Flag festgelegt ist. Anwendungen sollten dieses Flag jedoch festlegen, wenn die Rate der Aufrufe von Present so niedrig ist, dass Benutzer eine erhebliche Verzögerung bei der Cursorbewegung bemerken würden. Dieses Flag hat in einer Anwendung im Fenstermodus keine Auswirkungen. Einige Grafikkarten implementieren Hardwarefarbcursor. Dieses Flag hat keine Auswirkungen auf diese Karten.

Rückgabewert

Keine

Bemerkungen

Bei der Ausführung im Vollbildmodus sind Die Koordinaten des Bildschirmraums die Rückpufferkoordinaten, die entsprechend auf den aktuellen Anzeigemodus skaliert werden. Bei der Ausführung im Fenstermodus sind die Bildschirmraumkoordinaten die Desktopkoordinaten. Das Cursorbild wird an der angegebenen Position abzüglich des durch die SetCursorProperties-Methode angegebenen Hotspotoffsets gezeichnet.

Wenn der Cursor von ShowCursor ausgeblendet wurde, wird der Cursor nicht gezeichnet.