CreateCursor, fonction (winuser.h)
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
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 |