Fonction SetSystemCursor (winuser.h)

Permet à une application de personnaliser les curseurs système. Il remplace le contenu du curseur système spécifié par le paramètre id par le contenu du curseur spécifié par le paramètre hcur , puis détruit hcur.

Syntaxe

BOOL SetSystemCursor(
  [in] HCURSOR hcur,
  [in] DWORD   id
);

Paramètres

[in] hcur

Type : HCURSOR

Poignée du curseur. La fonction remplace le contenu du curseur système spécifié par id par le contenu du curseur géré par hcur.

Le système détruit hcur en appelant la fonction DestroyCursor . Par conséquent, hcur ne peut pas être un curseur chargé à l’aide de la fonction LoadCursor . Pour spécifier un curseur chargé à partir d’une ressource, copiez le curseur à l’aide de la fonction CopyCursor , puis passez la copie à SetSystemCursor.

[in] id

Type : DWORD

Curseur système à remplacer par le contenu de hcur. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
OCR_NORMAL
32512
Sélection normale
OCR_IBEAM
32513
Sélection de texte
OCR_WAIT
32514
Busy
OCR_CROSS
32515
Sélection de précision
OCR_UP
32516
Sélection alternative
OCR_SIZENWSE
32642
Redimensionnement diagonal 1
OCR_SIZENESW
32643
Redimensionnement diagonal 2
OCR_SIZEWE
32644
Redimensionnement horizontal
OCR_SIZENS
32645
Redimensionnement vertical
OCR_SIZEALL
32646
Déplacer
OCR_NO
32648
Non disponible
OCR_HAND
32649
Sélectionner un lien
OCR_APPSTARTING
32650
Travailler en arrière-plan

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Pour qu’une application utilise l’une des constantes OCR_, la constante OEMRESOURCE doit être définie avant d’inclure le fichier d’en-tête Windows.h.

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

Curseurs

DestroyCursor

LoadCursor

LoadCursorFromFile

Référence

SetCursor