Fonction SetCursor (winuser.h)

Article
03/13/2024

Définit la forme du curseur.

Syntaxe

HCURSOR SetCursor(
  [in, optional] HCURSOR hCursor
);

Paramètres

[in, optional] hCursor

Type : HCURSOR

Poignée du curseur.

Le curseur doit avoir été créé par la fonction CreateCursor ou CreateIconIndirect , ou chargé par la fonction LoadCursor ou LoadImage .

Si ce paramètre a la valeur NULL, le curseur est supprimé de l’écran.

Valeur retournée

Type : HCURSOR

La valeur de retour est le handle du curseur précédent, le cas échéant.

S’il n’y avait pas de curseur précédent, la valeur de retour est NULL.

Remarques

Le curseur est défini uniquement si le nouveau curseur est différent du curseur précédent ; sinon, la fonction retourne immédiatement.

Le curseur est une ressource partagée. Une fenêtre doit définir la forme du curseur uniquement lorsque le curseur se trouve dans sa zone cliente ou lorsque la fenêtre capture l’entrée de la souris. Dans les systèmes sans souris, la fenêtre doit restaurer le curseur précédent avant que le curseur ne quitte la zone cliente ou avant qu’il ne abandonne le contrôle vers une autre fenêtre.

Si votre application doit définir le curseur alors qu’elle se trouve dans une fenêtre, assurez-vous que le curseur de classe de la classe de la fenêtre spécifiée a la valeur NULL. Si le curseur de classe n’est pas NULL, le système restaure le curseur de classe chaque fois que la souris est déplacée.

Le curseur n’apparaît pas à l’écran si le nombre d’affichage du curseur interne est inférieur à zéro. Cela se produit si l’application utilise la fonction ShowCursor pour masquer le curseur plus de fois que pour afficher le curseur.

Exemples

Pour obtenir un exemple, consultez Affichage d’un curseur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll