GetSystemMetrics, fonction (winuser.h)

Récupère la métrique système ou le paramètre de configuration système spécifié.

Notez que toutes les dimensions récupérées par GetSystemMetrics sont en pixels.

Syntaxe

int GetSystemMetrics(
  [in] int nIndex
);

Paramètres

[in] nIndex

Type : int

Paramètre de configuration ou de métrique système à récupérer. Ce paramètre peut prendre les valeurs suivantes. Notez que toutes les valeurs SM_CX* sont des largeurs et que toutes les valeurs SM_CY* sont des hauteurs. Notez également que tous les paramètres conçus pour renvoyer des données booléennes représentent TRUE comme toute valeur différente de zéro, et FALSE comme une valeur zéro.

Valeur Signification
SM_ARRANGE
56
Indicateurs qui spécifient la façon dont le système a organisé les fenêtres réduites. Pour plus d’informations, consultez la section Remarques de cette rubrique.
SM_CLEANBOOT
67
Valeur qui spécifie la façon dont le système est démarré :
  • 0 Démarrage normal
  • 1 Démarrage sécurisé
  • 2 Échec sécurisé avec démarrage réseau
Un démarrage sans échec (également appelé démarrage sans échec, mode sans échec ou démarrage sans échec) contourne les fichiers de démarrage de l’utilisateur.
SM_CMONITORS
80
Nombre de moniteurs d’affichage sur un bureau. Pour plus d’informations, consultez la section Remarques de cette rubrique.
SM_CMOUSEBUTTONS
43
Nombre de boutons sur une souris, ou zéro si aucune souris n’est installée.
SM_CONVERTIBLESLATEMODE
0x2003
Reflète l’état de l’ordinateur portable ou du mode ardoise, 0 pour le mode Ardoise et non zéro dans le cas contraire. Lorsque cette métrique système change, le système envoie un message de diffusion via WM_SETTINGCHANGE avec « ConvertibleSlateMode » dans le LPARAM. Notez que cette métrique système ne s’applique pas aux PC de bureau. Dans ce cas, utilisez GetAutoRotationState.
SM_CXBORDER
5
Largeur d’une bordure de fenêtre, en pixels. Cela équivaut à la valeur SM_CXEDGE pour les fenêtres avec l’apparence 3D.
SM_CXCURSOR
13
Largeur nominale d’un curseur, en pixels.
SM_CXDLGFRAME
7
Cette valeur est identique à SM_CXFIXEDFRAME.
SM_CXDOUBLECLK
36
Largeur du rectangle autour de l’emplacement d’un premier clic dans une séquence de double-clic, en pixels. Le deuxième clic doit se produire dans le rectangle défini par SM_CXDOUBLECLK et SM_CYDOUBLECLK pour que le système considère les deux clics comme un double-clic. Les deux clics doivent également se produire dans un délai spécifié.

Pour définir la largeur du rectangle de double-clic, appelez SystemParametersInfo avec SPI_SETDOUBLECLKWIDTH.

SM_CXDRAG
68
Nombre de pixels de chaque côté d’un point vers le bas de la souris que le pointeur de la souris peut déplacer avant le début d’une opération de glissement. Cela permet à l’utilisateur de cliquer et de relâcher facilement le bouton de la souris sans démarrer involontairement une opération de glissement. Si cette valeur est négative, elle est soustraite de la gauche du point vers le bas de la souris et ajoutée à sa droite.
SM_CXEDGE
45
Largeur d’une bordure 3D, en pixels. Cette métrique est l’équivalent 3D de SM_CXBORDER.
SM_CXFIXEDFRAME
7
Épaisseur du cadre autour du périmètre d’une fenêtre qui a un légende mais n’est pas importante, en pixels. SM_CXFIXEDFRAME est la hauteur de la bordure horizontale et SM_CYFIXEDFRAME est la largeur de la bordure verticale.

Cette valeur est identique à SM_CXDLGFRAME.

SM_CXFOCUSBORDER
83
Largeur des bords gauche et droit du rectangle de focus que dessine DrawFocusRect . Cette valeur est exprimée en pixels.

Windows 2000 : Cette valeur n’est pas prise en charge.

SM_CXFRAME
32
Cette valeur est identique à SM_CXSIZEFRAME.
SM_CXFULLSCREEN
16
Largeur de la zone cliente pour une fenêtre plein écran sur le moniteur d’affichage principal, en pixels. Pour obtenir les coordonnées de la partie de l’écran qui n’est pas masquée par la barre des tâches système ou par les barres d’outils du bureau d’application, appelez la fonction SystemParametersInfo avec la valeur SPI_GETWORKAREA.
SM_CXHSCROLL
21
Largeur de la bitmap de flèche sur une barre de défilement horizontale, en pixels.
SM_CXHTHUMB
10
Largeur de la zone de pouce dans une barre de défilement horizontale, en pixels.
SM_CXICON
11
Grande largeur système d’une icône, en pixels. La fonction LoadIcon peut charger uniquement les icônes avec les dimensions que SM_CXICON et SM_CYICON spécifient. Pour plus d’informations, consultez Tailles des icônes .
SM_CXICONSPACING
38
Largeur d’une cellule de grille pour les éléments en mode icône de grande taille, en pixels. Chaque élément tient dans un rectangle de taille SM_CXICONSPACING par SM_CYICONSPACING lorsqu’il est organisé. Cette valeur est toujours supérieure ou égale à SM_CXICON.
SM_CXMAXIMIZED
61
Largeur par défaut, en pixels, d’une fenêtre de niveau supérieur agrandie sur le moniteur d’affichage principal.
SM_CXMAXTRACK
59
Largeur maximale par défaut d’une fenêtre qui a un légende et des bordures de dimensionnement, en pixels. Cette métrique fait référence à l’ensemble du bureau. L’utilisateur ne peut pas faire glisser le cadre de fenêtre vers une taille supérieure à ces dimensions. Une fenêtre peut remplacer cette valeur en traitant le message WM_GETMINMAXINFO .
SM_CXMENUCHECK
71
Largeur du menu par défaut case activée bitmap de marque, en pixels.
SM_CXMENUSIZE
54
Largeur des boutons de la barre de menus, comme le bouton de fermeture de la fenêtre enfant utilisé dans l’interface de plusieurs documents, en pixels.
SM_CXMIN
28
Largeur minimale d’une fenêtre, en pixels.
SM_CXMINIMIZED
57
Largeur d’une fenêtre réduite, en pixels.
SM_CXMINSPACING
47
Largeur d’une cellule de grille pour une fenêtre réduite, en pixels. Chaque fenêtre réduite s’intègre dans un rectangle de cette taille lorsqu’elle est organisée. Cette valeur est toujours supérieure ou égale à SM_CXMINIMIZED.
SM_CXMINTRACK
34
Largeur de suivi minimale d’une fenêtre, en pixels. L’utilisateur ne peut pas faire glisser le cadre de fenêtre vers une taille inférieure à ces dimensions. Une fenêtre peut remplacer cette valeur en traitant le message WM_GETMINMAXINFO .
SM_CXPADDEDBORDER
92
Quantité de remplissage de bordure pour les fenêtres sous-titrés, en pixels.

Windows XP/2000 : Cette valeur n’est pas prise en charge.

SM_CXSCREEN
0
Largeur de l’écran du moniteur d’affichage principal, en pixels. Il s’agit de la même valeur obtenue en appelant GetDeviceCaps comme suit : GetDeviceCaps( hdcPrimaryMonitor, HORZRES).
SM_CXSIZE
30
Largeur d’un bouton dans une fenêtre légende ou barre de titre, en pixels.
SM_CXSIZEFRAME
32
Épaisseur de la bordure de dimensionnement autour du périmètre d’une fenêtre qui peut être redimensionnée, en pixels. SM_CXSIZEFRAME est la largeur de la bordure horizontale et SM_CYSIZEFRAME correspond à la hauteur de la bordure verticale.

Cette valeur est identique à SM_CXFRAME.

SM_CXSMICON
49
Petite largeur système d’une icône, en pixels. Les petites icônes s’affichent généralement dans les sous-titres des fenêtres et dans la vue des petites icônes. Pour plus d’informations, consultez Tailles des icônes .
SM_CXSMSIZE
52
Largeur des petits boutons légende, en pixels.
SM_CXVIRTUALSCREEN
78
Largeur de l’écran virtuel, en pixels. L’écran virtuel est le rectangle englobant de tous les moniteurs d’affichage. La SM_XVIRTUALSCREEN métrique est les coordonnées du côté gauche de l’écran virtuel.
SM_CXVSCROLL
2
Largeur d’une barre de défilement verticale, en pixels.
SM_CYBORDER
6
Hauteur d’une bordure de fenêtre, en pixels. Cela équivaut à la valeur SM_CYEDGE pour les fenêtres avec l’apparence 3D.
SM_CYCAPTION
4
Hauteur d’une zone légende, en pixels.
SM_CYCURSOR
14
Hauteur nominale d’un curseur, en pixels.
SM_CYDLGFRAME
8
Cette valeur est identique à SM_CYFIXEDFRAME.
SM_CYDOUBLECLK
37
Hauteur du rectangle autour de l’emplacement d’un premier clic dans une séquence de double-clic, en pixels. Le deuxième clic doit se produire dans le rectangle défini par SM_CXDOUBLECLK et SM_CYDOUBLECLK pour que le système considère les deux clics comme un double-clic. Les deux clics doivent également se produire dans un délai spécifié.

Pour définir la hauteur du rectangle double-clic, appelez SystemParametersInfo avec SPI_SETDOUBLECLKHEIGHT.

SM_CYDRAG
69
Nombre de pixels au-dessus et en dessous d’un point bas que le pointeur de la souris peut déplacer avant le début d’une opération de glissement. Cela permet à l’utilisateur de cliquer et de relâcher facilement le bouton de la souris sans démarrer involontairement une opération de glissement. Si cette valeur est négative, elle est soustraite au-dessus du point bas de la souris et ajoutée en dessous.
SM_CYEDGE
46
Hauteur d’une bordure 3D, en pixels. Il s’agit du équivalent 3D de SM_CYBORDER.
SM_CYFIXEDFRAME
8
Épaisseur du cadre autour du périmètre d’une fenêtre qui a une légende mais n’est pas importante, en pixels. SM_CXFIXEDFRAME correspond à la hauteur de la bordure horizontale et SM_CYFIXEDFRAME est la largeur de la bordure verticale.

Cette valeur est identique à SM_CYDLGFRAME.

SM_CYFOCUSBORDER
84
Hauteur des bords supérieur et inférieur du rectangle de focus dessiné par DrawFocusRect. Cette valeur est en pixels.

Windows 2000 : Cette valeur n’est pas prise en charge.

SM_CYFRAME
33
Cette valeur est identique à SM_CYSIZEFRAME.
SM_CYFULLSCREEN
17
Hauteur de la zone cliente d’une fenêtre plein écran sur le moniteur d’affichage principal, en pixels. Pour obtenir les coordonnées de la partie de l’écran qui n’est pas masquée par la barre des tâches système ou par les barres d’outils de bureau de l’application, appelez la fonction SystemParametersInfo avec la valeur SPI_GETWORKAREA.
SM_CYHSCROLL
3
Hauteur d’une barre de défilement horizontale, en pixels.
SM_CYICON
12
Hauteur système d’une icône, en pixels. La fonction LoadIcon peut charger uniquement les icônes avec les dimensions que SM_CXICON et SM_CYICON spécifient. Pour plus d’informations, consultez Tailles des icônes .
SM_CYICONSPACING
39
Hauteur d’une cellule de grille pour les éléments en mode grandes icônes, en pixels. Chaque élément s’intègre dans un rectangle de taille SM_CXICONSPACING par SM_CYICONSPACING lorsqu’il est organisé. Cette valeur est toujours supérieure ou égale à SM_CYICON.
SM_CYKANJIWINDOW
18
Pour les versions de jeu de caractères double octet du système, il s’agit de la hauteur de la fenêtre Kanji en bas de l’écran, en pixels.
SM_CYMAXIMIZED
62
Hauteur par défaut, en pixels, d’une fenêtre de niveau supérieur agrandie sur l’écran d’affichage principal.
SM_CYMAXTRACK
60
Hauteur maximale par défaut d’une fenêtre qui a un légende et des bordures de dimensionnement, en pixels. Cette métrique fait référence à l’ensemble du bureau. L’utilisateur ne peut pas faire glisser le cadre de fenêtre vers une taille supérieure à ces dimensions. Une fenêtre peut remplacer cette valeur en traitant le message WM_GETMINMAXINFO .
SM_CYMENU
15
Hauteur d’une barre de menus monoligne, en pixels.
SM_CYMENUCHECK
72
Hauteur du menu par défaut case activée bitmap de marque, en pixels.
SM_CYMENUSIZE
55
Hauteur des boutons de la barre de menus, tels que le bouton de fermeture de la fenêtre enfant utilisé dans l’interface de plusieurs documents, en pixels.
SM_CYMIN
29
Hauteur minimale d’une fenêtre, en pixels.
SM_CYMINIMIZED
58
Hauteur d’une fenêtre réduite, en pixels.
SM_CYMINSPACING
48
Hauteur d’une cellule de grille pour une fenêtre réduite, en pixels. Chaque fenêtre réduite s’intègre dans un rectangle de cette taille lorsqu’elle est organisée. Cette valeur est toujours supérieure ou égale à SM_CYMINIMIZED.
SM_CYMINTRACK
35
Hauteur de suivi minimale d’une fenêtre, en pixels. L’utilisateur ne peut pas faire glisser le cadre de fenêtre vers une taille inférieure à ces dimensions. Une fenêtre peut remplacer cette valeur en traitant le message WM_GETMINMAXINFO .
SM_CYSCREEN
1
Hauteur de l’écran du moniteur d’affichage principal, en pixels. Il s’agit de la même valeur obtenue en appelant GetDeviceCaps comme suit : GetDeviceCaps( hdcPrimaryMonitor, VERTRES).
SM_CYSIZE
31
Hauteur d’un bouton dans une fenêtre légende ou une barre de titre, en pixels.
SM_CYSIZEFRAME
33
Épaisseur de la bordure de dimensionnement autour du périmètre d’une fenêtre qui peut être redimensionnée, en pixels. SM_CXSIZEFRAME est la largeur de la bordure horizontale et SM_CYSIZEFRAME correspond à la hauteur de la bordure verticale.

Cette valeur est identique à SM_CYFRAME.

SM_CYSMCAPTION
51
Hauteur d’un petit légende, en pixels.
SM_CYSMICON
50
Petite hauteur système d’une icône, en pixels. Les petites icônes s’affichent généralement dans les sous-titres des fenêtres et dans la vue des petites icônes. Pour plus d’informations, consultez Tailles des icônes .
SM_CYSMSIZE
53
Hauteur des petits boutons légende, en pixels.
SM_CYVIRTUALSCREEN
79
Hauteur de l’écran virtuel, en pixels. L’écran virtuel est le rectangle englobant de tous les moniteurs d’affichage. La SM_YVIRTUALSCREEN métrique est les coordonnées du haut de l’écran virtuel.
SM_CYVSCROLL
20
Hauteur de l’image bitmap de flèche sur une barre de défilement verticale, en pixels.
SM_CYVTHUMB
9
Hauteur de la zone de pouce dans une barre de défilement verticale, en pixels.
SM_DBCSENABLED
42
Différent de zéro si User32.dll prend en charge DBCS ; sinon, 0.
SM_DEBUG
22
Différent de zéro si la version de débogage de User.exe est installée ; sinon, 0.
SM_DIGITIZER
94
Différent de zéro si le système d’exploitation actuel est Windows 7 ou Windows Server 2008 R2 et que le service d’entrée Tablet PC est démarré ; sinon, 0. La valeur de retour est un masque de bits qui spécifie le type d’entrée du numériseur pris en charge par l’appareil. Pour plus d'informations, consultez la section Notes.

Windows Server 2008, Windows Vista et Windows XP/2000 : Cette valeur n’est pas prise en charge.

SM_IMMENABLED
82
Différent de zéro si le gestionnaire de méthodes d’entrée/la méthode d’entrée Rédacteur fonctionnalités sont activées ; sinon, 0.

SM_IMMENABLED indique si le système est prêt à utiliser un IME basé sur Unicode sur une application Unicode. Pour vous assurer qu’un IME dépendant de la langue fonctionne, case activée SM_DBCSENABLED et la page de codes ANSI système. Sinon, la conversion ANSI-Unicode risque de ne pas être effectuée correctement, ou certains composants tels que les polices ou les paramètres de Registre peuvent ne pas être présents.

SM_MAXIMUMTOUCHES
95
Différent de zéro s’il y a des numériseurs dans le système ; sinon, 0.

SM_MAXIMUMTOUCHES retourne la valeur maximale agrégée du nombre maximal de contacts pris en charge par chaque numériseur dans le système. Si le système n’a que des numériseurs tactiles, la valeur de retour est 1. Si le système dispose de numériseurs multi-touch, la valeur de retour est le nombre de contacts simultanés que le matériel peut fournir.

Windows Server 2008, Windows Vista et Windows XP/2000 : Cette valeur n’est pas prise en charge.

SM_MEDIACENTER
87
Différent de zéro si le système d’exploitation actuel est Windows XP, Media Center Edition, 0 si ce n’est pas le cas.
SM_MENUDROPALIGNMENT
40
Différent de zéro si les menus déroulants sont alignés à droite avec l’élément de barre de menus correspondant ; 0 si les menus sont alignés à gauche.
SM_MIDEASTENABLED
74
Différent de zéro si le système est activé pour l’hébreu et l’arabe, 0 si ce n’est pas le cas.
SM_MOUSEPRESENT
19
Différent de zéro si une souris est installée ; sinon, 0. Cette valeur est rarement nulle, en raison de la prise en charge des souris virtuelles et parce que certains systèmes détectent la présence du port au lieu de la présence d’une souris.
SM_MOUSEHORIZONTALWHEELPRESENT
91
Différent de zéro si une souris avec une roulette de défilement horizontale est installée ; sinon 0.
SM_MOUSEWHEELPRESENT
75
Différent de zéro si une souris avec une roulette de défilement verticale est installée ; sinon 0.
SM_NETWORK
63
Le bit le moins significatif est défini si un réseau est présent ; sinon, il est effacé. Les autres bits sont réservés pour une utilisation ultérieure.
SM_PENWINDOWS
41
Différent de zéro si les extensions Microsoft Windows for Pen computing sont installées ; zéro dans le cas contraire.
SM_REMOTECONTROL
0x2001
Cette métrique système est utilisée dans un environnement Terminal Services pour déterminer si la session Terminal Server actuelle est contrôlée à distance. Sa valeur est différente de zéro si la session active est contrôlée à distance ; sinon, 0.

Vous pouvez utiliser des outils de gestion des services Terminal Server tels que le Gestionnaire des services Terminal (tsadmin.msc) et shadow.exe pour contrôler une session à distance. Lorsqu’une session est contrôlée à distance, un autre utilisateur peut afficher le contenu de cette session et éventuellement interagir avec celle-ci.

SM_REMOTESESSION
0x1000
Cette métrique système est utilisée dans un environnement Terminal Services. Si le processus appelant est associé à une session cliente Terminal Services, la valeur de retour est différente de zéro. Si le processus appelant est associé à la session de console Terminal Services, la valeur de retour est 0. Windows Server 2003 et Windows XP : La session de console n’est pas nécessairement la console physique. Pour plus d’informations, consultez WTSGetActiveConsoleSessionId.
SM_SAMEDISPLAYFORMAT
81
Différent de zéro si tous les moniteurs d’affichage ont le même format de couleur, sinon, 0. Deux écrans peuvent avoir la même profondeur de bits, mais des formats de couleurs différents. Par exemple, les pixels rouge, vert et bleu peuvent être encodés avec différents nombres de bits, ou ces bits peuvent se trouver à différents emplacements dans une valeur de couleur de pixel.
SM_SECURE
44
Cette métrique système doit être ignorée ; elle retourne toujours 0.
SM_SERVERR2
89
Numéro de build si le système est Windows Server 2003 R2 ; sinon, 0.
SM_SHOWSOUNDS
70
Différent de zéro si l’utilisateur exige qu’une application présente visuellement des informations dans des situations où elle ne présenterait l’information que sous forme sonore ; sinon, 0.
SM_SHUTTINGDOWN
0x2000
Différent de zéro si la session active s’arrête ; sinon, 0.

Windows 2000 : Cette valeur n’est pas prise en charge.

SM_SLOWMACHINE
73
Différent de zéro si l’ordinateur a un processeur bas de bout (lent) ; sinon, 0.
SM_STARTER
88
Différent de zéro si le système d’exploitation actuel est Windows 7 Édition Starter Edition, Windows Vista Starter ou Windows XP Starter Edition ; sinon, 0.
SM_SWAPBUTTON
23
Différent de zéro si les significations des boutons gauche et droit de la souris sont permutées ; sinon, 0.
SM_SYSTEMDOCKED
0x2004
Reflète l’état du mode d’ancrage, 0 pour le mode sans ancrage et non zéro dans le cas contraire. Lorsque cette métrique système change, le système envoie un message de diffusion via WM_SETTINGCHANGE avec « SystemDockMode » dans le LPARAM.
SM_TABLETPC
86
Différent de zéro si le système d’exploitation actuel est l’édition Tablette PC windows XP ou si le système d’exploitation actuel est Windows Vista ou Windows 7 et que le service d’entrée Tablet PC est démarré ; sinon, 0. Le paramètre SM_DIGITIZER indique le type d’entrée du numériseur pris en charge par un appareil exécutant Windows 7 ou Windows Server 2008 R2. Pour plus d'informations, consultez la section Notes.
SM_XVIRTUALSCREEN
76
Coordonnées du côté gauche de l’écran virtuel. L’écran virtuel est le rectangle englobant de tous les moniteurs d’affichage. La métrique SM_CXVIRTUALSCREEN est la largeur de l’écran virtuel.
SM_YVIRTUALSCREEN
77
Coordonnées du haut de l’écran virtuel. L’écran virtuel est le rectangle englobant de tous les moniteurs d’affichage. La métrique SM_CYVIRTUALSCREEN est la hauteur de l’écran virtuel.

Valeur retournée

Type : int

Si la fonction réussit, la valeur de retour est la métrique système ou le paramètre de configuration demandé.

Si la fonction échoue, la valeur de retour est 0. GetLastError ne fournit pas d’informations étendues sur les erreurs.

Remarques

Les métriques système peuvent varier d’un affichage à l’autre.

GetSystemMetrics(SM_CMONITORS) compte uniquement les moniteurs d’affichage visibles. Cela est différent de EnumDisplayMonitors, qui énumère à la fois les moniteurs d’affichage visibles et les pseudo-moniteurs invisibles associés aux pilotes de mise en miroir. Un pseudo-moniteur invisible est associé à un pseudo-appareil utilisé pour miroir dessin d’application à des fins de communication à distance ou à d’autres fins.

Le paramètre SM_ARRANGE spécifie la façon dont le système organise les fenêtres réduites et se compose d’une position de départ et d’une direction. La position de départ peut être l’une des valeurs suivantes.

Valeur Signification
ARW_BOTTOMLEFT Commencez dans le coin inférieur gauche de l’écran. Position par défaut.
ARW_BOTTOMRIGHT Commencez dans le coin inférieur droit de l’écran. Équivalent à ARW_STARTRIGHT.
ARW_TOPLEFT Commencez dans le coin supérieur gauche de l’écran. Équivalent à ARW_STARTTOP.
ARW_TOPRIGHT Démarrez dans le coin supérieur droit de l’écran. Équivalent à ARW_STARTTOP | SRW_STARTRIGHT.
 

La direction dans laquelle organiser les fenêtres réduites peut être l’une des valeurs suivantes.

Valeur Signification
ARW_DOWN Organisez verticalement, de haut en bas.
ARW_HIDE Masquez les fenêtres réduites en les déplaçant hors de la zone visible de l’écran.
ARW_LEFT Organisez horizontalement, de gauche à droite.
ARW_RIGHT Organisez horizontalement, de droite à gauche.
ARW_UP Organisez verticalement, de bas en haut.
 

Le paramètre SM_DIGITIZER spécifie le type de numériseurs installés sur un appareil exécutant Windows 7 ou Windows Server 2008 R2. La valeur de retour est un masque de bits qui spécifie une ou plusieurs des valeurs suivantes.

Valeur Signification
NID_INTEGRATED_TOUCH

0x01

L’appareil dispose d’un numériseur tactile intégré.
NID_EXTERNAL_TOUCH

0x02

L’appareil dispose d’un numériseur tactile externe.
NID_INTEGRATED_PEN

0x04

L’appareil dispose d’un numériseur de stylet intégré.
NID_EXTERNAL_PEN

0x08

L’appareil dispose d’un numériseur de stylet externe.
NID_MULTI_INPUT

0x40

L’appareil prend en charge plusieurs sources d’entrée du numériseur.
NID_READY

0x80

L’appareil est prêt à recevoir l’entrée du numériseur.
 

Cette API n’est pas compatible avec DPI et ne doit pas être utilisée si le thread appelant prend en charge le DPI par moniteur. Pour obtenir la version prenant en charge DPI de cette API, consultez GetSystemMetricsForDPI. Pour plus d’informations sur la sensibilisation aux PPP, consultez la documentation Windows High DPI.

Exemples

L’exemple suivant utilise la fonction GetSystemMetrics pour déterminer si une souris est installée et si les boutons de la souris sont échangés. L’exemple utilise également la fonction SystemParametersInfo pour récupérer le seuil et la vitesse de la souris. Il affiche les informations dans la console.

#include <windows.h>
#include <stdio.h>
#pragma comment(lib, "user32.lib")

void main()
{
   BOOL fResult;
   int aMouseInfo[3];
 
   fResult = GetSystemMetrics(SM_MOUSEPRESENT); 
 
   if (fResult == 0) 
      printf("No mouse installed.\n"); 
   else 
   { 
      printf("Mouse installed.\n");

      // Determine whether the buttons are swapped. 

      fResult = GetSystemMetrics(SM_SWAPBUTTON); 
 
      if (fResult == 0) 
         printf("Buttons not swapped.\n"); 
      else printf("Buttons swapped.\n");
 
      // Get the mouse speed and the threshold values. 
 
      fResult = SystemParametersInfo(
         SPI_GETMOUSE,  // get mouse information 
         0,             // not used 
         &aMouseInfo,   // holds mouse information 
         0);            // not used 

      if( fResult )
      { 
         printf("Speed: %d\n", aMouseInfo[2]); 
         printf("Threshold (x,y): %d,%d\n", 
            aMouseInfo[0], aMouseInfo[1]); 
      }
   } 
}

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
Ensemble d’API ext-ms-win-ntuser-sysparams-ext-l1-1-0 (introduit dans Windows 8)

Voir aussi

EnumDisplayMonitors

GetSystemMetricsForDPI

SystemParametersInfo