Fonction SetSystemCursor (winuser.h)

Article
03/04/2024

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