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

Article
02/26/2024

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

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é.