Partager via


IDirect3DDevice9 ::SetCursorPosition, méthode (d3d9.h)

Définit la position du curseur et les options de mise à jour.

Syntaxe

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

Paramètres

[in] X

Type : INT

Nouvelle position X du curseur dans les coordonnées du bureau virtuel. Consultez la section Notes.

[in] Y

Type : INT

Nouvelle position Y du curseur dans les coordonnées du bureau virtuel. Consultez la section Notes.

[in] Flags

Type : DWORD

Spécifie les options de mise à jour du curseur. Actuellement, un seul indicateur est défini.

Valeur Signification
D3DCURSOR_IMMEDIATE_UPDATE
Mettez à jour le curseur au taux d’actualisation.

Si cet indicateur est spécifié, le système garantit que le curseur sera mis à jour à un minimum de la moitié du taux d’actualisation de l’affichage, mais jamais plus fréquemment que le taux d’actualisation d’affichage. Sinon, la méthode retarde les mises à jour du curseur jusqu’au prochain appel IDirect3DDevice9 ::P resent . Le fait de ne pas définir cet indicateur entraîne généralement de meilleures performances que si l’indicateur est défini. Toutefois, les applications doivent définir cet indicateur si le taux d’appels à Présent est suffisamment faible pour que les utilisateurs remarquent un retard important dans le mouvement du curseur. Cet indicateur n’a aucun effet dans une application en mode fenêtré. Certaines cartes vidéo implémentent des curseurs de couleur matériels. Cet indicateur n’a pas d’effet sur ces cartes.

Valeur de retour

None

Remarques

Lors de l’exécution en mode plein écran, les coordonnées d’espace d’écran sont les coordonnées de mémoire tampon arrière correctement mises à l’échelle vers le mode d’affichage actuel. Lors de l’exécution en mode fenêtré, les coordonnées d’espace d’écran sont les coordonnées du bureau. L’image de curseur est dessinée à la position spécifiée moins le décalage de point d’accès spécifié par la méthode SetCursorProperties .

Si le curseur a été masqué par ShowCursor, le curseur n’est pas dessiné.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d9.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DDevice9

SetCursorProperties

ShowCursor