Fonction CreateCursor (winuser.h)

Article
01/27/2024

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