Fonction SetCursor (winuser.h)
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 |
Voir aussi
Conceptuel
Référence