Fonction CreateCursor (winuser.h)
Crée un curseur monochrome avec la taille, les modèles de bits et le point chaud spécifiés.
Pour créer un curseur de couleur au moment de l’exécution, vous pouvez utiliser la fonction CreateIconIndirect , qui crée un curseur en fonction du contenu d’une structure ICONINFO .
Syntaxe
HCURSOR CreateCursor(
[in, optional] HINSTANCE hInst,
[in] int xHotSpot,
[in] int yHotSpot,
[in] int nWidth,
[in] int nHeight,
[in] const VOID *pvANDPlane,
[in] const VOID *pvXORPlane
);
Paramètres
[in, optional] hInst
Type : HINSTANCE
Handle de la instance actuelle de l’application qui crée le curseur.
[in] xHotSpot
Type : int
Position horizontale du point chaud du curseur.
[in] yHotSpot
Type : int
Position verticale du point chaud du curseur.
[in] nWidth
Type : int
Largeur du curseur, en pixels.
[in] nHeight
Type : int
Hauteur du curseur, en pixels.
[in] pvANDPlane
Type : const VOID*
Tableau d’octets qui contient les valeurs de bits du masque AND du curseur, comme dans une bitmap monochrome. Consultez la section Remarques.
[in] pvXORPlane
Type : const VOID*
Tableau d’octets qui contient les valeurs de bits du masque XOR du curseur, comme dans une bitmap monochrome. Consultez la section Remarques.
Valeur retournée
Type : HCURSOR
Si la fonction réussit, la valeur de retour est un handle vers le curseur.
Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Pour déterminer la taille nominale d’un curseur, utilisez la fonction GetSystemMetrics , en spécifiant la valeur SM_CXCURSOR ou SM_CYCURSOR . Vous pouvez également utiliser la version prenant en charge les ppp de cette API, consultez (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi). Pour plus d’informations, consultez Développement d’applications de bureau high DPI sur Windows.
Pour plus d’informations sur les paramètres pvANDPlane et pvXORPlane , consultez la description du paramètre lpBits de la fonction CreateBitmap .
CreateCursor applique la table de vérité suivante aux masques de bits AND et XOR :
| MASQUE DE BITS AND | Masque de bits XOR | Affichage |
|---|---|---|
| 0 | 0 | Noir |
| 0 | 1 | White |
| 1 | 0 | Screen |
| 1 | 1 | Écran inverse |
Avant de se fermer, une application doit appeler la fonction DestroyCursor pour libérer toutes les ressources système associées au curseur.
Virtualisation DPI
Cette API ne participe pas à la virtualisation DPI. La sortie retournée est en termes de coordonnées physiques et n’est pas affectée par le DPI du thread appelant. Notez que le curseur créé peut toujours être mis à l’échelle pour correspondre à l’ppp de n’importe quelle fenêtre donnée dans laquelle il est dessiné.Exemples
Pour obtenir un exemple, consultez Création d’un curseur.
Configuration requise
| 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 |