Metodo IDirect3DDevice9::SetCursorPosition (d3d9helper.h)

Articolo
08/23/2023

Imposta la posizione del cursore e le opzioni di aggiornamento.

Sintassi

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

Parametri

[in] X

Tipo: INT

Nuova posizione X del cursore nelle coordinate del desktop virtuale. Vedere la sezione Osservazioni.

[in] Y

Tipo: INT

Nuova posizione Y del cursore nelle coordinate del desktop virtuale. Vedere la sezione Osservazioni.

[in] Flags

Tipo: DWORD

Specifica le opzioni di aggiornamento per il cursore. Attualmente viene definito un solo flag.

Valore	Significato
D3DCURSOR_IMMEDIATE_UPDATE	Aggiornare il cursore alla frequenza di aggiornamento. Se questo flag viene specificato, il sistema garantisce che il cursore venga aggiornato almeno a metà della frequenza di aggiornamento dello schermo, ma mai più frequentemente della frequenza di aggiornamento visualizzato. In caso contrario, il metodo ritarda gli aggiornamenti del cursore fino alla successiva chiamata IDirect3DDevice9::P resent . L'impostazione di questo flag comporta in genere prestazioni migliori rispetto a se il flag è impostato. Tuttavia, le applicazioni devono impostare questo flag se la frequenza di chiamate a Present è abbastanza bassa che gli utenti noterebbero un ritardo significativo nel movimento del cursore. Questo flag non ha alcun effetto in un'applicazione in modalità finestra. Alcune schede video implementano cursori di colore hardware. Questo flag non ha effetto su queste schede.

Valore

Significato

D3DCURSOR_IMMEDIATE_UPDATE

Aggiornare il cursore alla frequenza di aggiornamento.

Se questo flag viene specificato, il sistema garantisce che il cursore venga aggiornato almeno a metà della frequenza di aggiornamento dello schermo, ma mai più frequentemente della frequenza di aggiornamento visualizzato. In caso contrario, il metodo ritarda gli aggiornamenti del cursore fino alla successiva chiamata IDirect3DDevice9::P resent . L'impostazione di questo flag comporta in genere prestazioni migliori rispetto a se il flag è impostato. Tuttavia, le applicazioni devono impostare questo flag se la frequenza di chiamate a Present è abbastanza bassa che gli utenti noterebbero un ritardo significativo nel movimento del cursore. Questo flag non ha alcun effetto in un'applicazione in modalità finestra. Alcune schede video implementano cursori di colore hardware. Questo flag non ha effetto su queste schede.

Valore restituito

nessuno

Osservazioni

Quando si esegue in modalità schermo intero, le coordinate dello spazio dello schermo sono le coordinate del buffer indietro ridimensionate in modo appropriato alla modalità di visualizzazione corrente. Quando si esegue in modalità finestra, le coordinate dello spazio dello schermo sono le coordinate desktop. L'immagine del cursore viene disegnata nella posizione specificata meno l'offset hotspot specificato dal metodo SetCursorProperties .

Se il cursore è stato nascosto da ShowCursor, il cursore non viene disegnato.