CreateCursor, fonction (winuser.h)

Article
11/20/2024

Crée un curseur monochrome ayant la taille, les modèles de bits et les points chauds spécifiés.

Pour créer un curseur coloré au moment de l’exécution, vous pouvez utiliser la fonction CreateIconIndirect , qui crée un curseur basé sur le 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 l’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 pour le masque AND du curseur, comme dans une bitmap monochrome. Voir les remarques.

[in] pvXORPlane

Type : const VOID*

Tableau d’octets qui contient les valeurs de bits pour le masque XOR du curseur, comme dans une bitmap monochrome. Voir les remarques.

Valeur de retour

Type : HCURSOR

Si la fonction réussit, la valeur de retour est un handle au curseur.

Si la fonction échoue, la valeur de retour est NULL . Pour obtenir des informations d’erreur étendues, 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. En outre, vous pouvez utiliser la version prenant en charge les ppp de cette API, consultez GetSystemMetricsForDpi. Pour plus d’informations, consultez développement d’applications de bureau haute résolution sur Windows.

Pour plus d’informations sur les paramètres pvANDPlane et pvXORPlane, consultez la description de paramètre lpBits de fonction CreateBitmap.

CreateCursor applique le tableau de vérité suivant aux masques de bits AND et XOR :

Masque de bits AND	Masque de bits XOR	Montrer
0	0	Noir
0	1	Blanc
1	0	Écran
1	1	Écran inverse

Avant de fermer, une application doit appeler la fonction DestroyCursor pour libérer les ressources système associées au curseur.

virtualisation d'ppp

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 l’ppp du thread appelant. Notez que le curseur créé peut toujours être mis à l’échelle pour correspondre à l’ppp d’une fenêtre donnée dans laquelle il est dessiné.

Exemples

Pour obtenir un exemple, consultez Création d’un curseur.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include Windows.h)
bibliothèque	User32.lib
DLL	User32.dll