Méthode IDirect3DDevice9::SetCursorPosition (d3d9helper.h)

Article
08/23/2023

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 à la fréquence d’actualisation. Si cet indicateur est spécifié, le système garantit que le curseur sera mis à jour à un minimum de la moitié de la fréquence d’actualisation de l’affichage, mais jamais plus fréquemment que la fréquence 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 à Present 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érielle. Cet indicateur n’a pas d’effet sur ces cartes.

Valeur

Signification

D3DCURSOR_IMMEDIATE_UPDATE

Mettez à jour le curseur à la fréquence d’actualisation.

Si cet indicateur est spécifié, le système garantit que le curseur sera mis à jour à un minimum de la moitié de la fréquence d’actualisation de l’affichage, mais jamais plus fréquemment que la fréquence 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 à Present 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érielle. Cet indicateur n’a pas d’effet sur ces cartes.

Valeur de retour

None

Notes

Lors de l’exécution en mode plein écran, les coordonnées d’espace d’écran sont les coordonnées de mémoire tampon d’arrière-mémoire correctement mises à l’échelle vers le mode d’affichage actuel. Lors de l’exécution en mode fenêtré, les coordonnées de l’espace d’écran sont les coordonnées du bureau. L’image du 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é.