IDirect3DDevice9::SetCursorPosition-Methode (d3d9.h)

Artikel
02/26/2024

Legt die Cursorposition und die Updateoptionen 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 ist, garantiert das System, dass der Cursor mindestens mit der hälfte der Anzeigeaktualisierungsrate aktualisiert wird, aber nie 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 normalerweise zu einer besseren Leistung, als wenn das Flag festgelegt ist. Anwendungen sollten dieses Flag jedoch festlegen, wenn die Rate der Aufrufe von Present niedrig genug ist, dass Benutzer eine erhebliche Verzögerung der Cursorbewegung bemerken würden. Dieses Flag hat keine Auswirkungen in einer Anwendung im Fenstermodus. 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 ist, garantiert das System, dass der Cursor mindestens mit der hälfte der Anzeigeaktualisierungsrate aktualisiert wird, aber nie 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 normalerweise zu einer besseren Leistung, als wenn das Flag festgelegt ist. Anwendungen sollten dieses Flag jedoch festlegen, wenn die Rate der Aufrufe von Present niedrig genug ist, dass Benutzer eine erhebliche Verzögerung der Cursorbewegung bemerken würden. Dieses Flag hat keine Auswirkungen in einer Anwendung im Fenstermodus. Einige Grafikkarten implementieren Hardwarefarbcursor. Dieses Flag hat keine Auswirkungen auf diese Karten.

Rückgabewert

Keine

Bemerkungen

Wenn Sie im Vollbildmodus ausgeführt werden, sind die Koordinaten des Bildschirmraums die Rückenpufferkoordinaten, 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 von der SetCursorProperties-Methode angegebenen Hotspotoffsets gezeichnet.

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