Share via

GetThemeMetric, fonction (uxtheme.h)

  • Article

Récupère la valeur d’une propriété de métrique.

Syntaxe

HRESULT GetThemeMetric(
  [in]  HTHEME hTheme,
  [in]  HDC    hdc,
  [in]  int    iPartId,
  [in]  int    iStateId,
  [in]  int    iPropId,
  [out] int    *piVal
);

Paramètres

[in] hTheme

Type : HTHEME

Gérez les données de thème spécifiées d’une fenêtre. Utilisez OpenThemeData pour créer un HTHEME.

[in] hdc

Type : HDC

HDC. Ce paramètre peut être défini sur NULL.

[in] iPartId

Type : int

Valeur de type int qui spécifie la partie qui contient la propriété de métrique. Consultez Parties et états.

[in] iStateId

Type : int

Valeur de type int qui spécifie l’état du composant. Consultez Parties et états.

[in] iPropId

Type : int

Valeur de type int qui spécifie la propriété à récupérer. Il peut s’agir de l’une des valeurs suivantes.

Valeur Signification
TMT_ALPHALEVEL
 Valeur alpha (0-255) utilisée pour DrawThemeIcon.
TMT_ALPHATHRESHOLD
 Valeur alpha minimale (0-255) qu’un pixel doit être considéré comme opaque.
TMT_BORDERSIZE
 Épaisseur de la bordure dessinée si cette partie utilise un remplissage de bordure.
TMT_GLYPHINDEX
 Index de caractères dans la police sélectionnée qui sera utilisée pour le glyphe, si la partie utilise un glyphe basé sur la police.
TMT_GRADIENTRATIO1
 Quantité de la première couleur de dégradé à utiliser pour dessiner la partie. Cette valeur peut être comprise entre 0 et 255, mais cette valeur plus les valeurs de chacune des valeurs GRADIENTRATIO doivent ajouter jusqu’à 255. Consultez la valeur TMT_GRADIENTCOLOR1 de GetThemeColor.
TMT_GRADIENTRATIO2
 Quantité de la deuxième couleur de dégradé à utiliser pour dessiner la partie.
TMT_GRADIENTRATIO3
 Quantité de la troisième couleur de dégradé à utiliser pour dessiner le composant.
TMT_GRADIENTRATIO4
 Quantité de la quatrième couleur de dégradé à utiliser pour dessiner la partie.
TMT_GRADIENTRATIO5
 Quantité de la cinquième couleur de dégradé à utiliser pour dessiner la partie.
TMT_HEIGHT
 Hauteur de la pièce.
TMT_IMAGECOUNT
 Nombre d’images d’état présentes dans un fichier image.
TMT_MINDPI1
 Ppp minimum pour lequel le premier fichier image a été conçu. Consultez GetThemeFilename.
TMT_MINDPI2
 Ppp minimum pour lequel le deuxième fichier image a été conçu.
TMT_MINDPI3
 Ppp minimum pour lequel le troisième fichier image a été conçu.
TMT_MINDPI4
 Ppp minimum pour lequel le quatrième fichier image a été conçu.
TMT_MINDPI5
 Ppp minimum pour lequel le cinquième fichier image a été conçu.
TMT_PROGRESSCHUNKSIZE
 Taille des formes « blocs » du contrôle de progression qui définissent la progression d’une opération.
TMT_PROGRESSSPACESIZE
 Taille totale de tous les « blocs » du contrôle de progression.
TMT_ROUNDCORNERWIDTH
 Arrondi (0-100 %) des coins de la pièce.
TMT_ROUNDCORNERHEIGHT
 Arrondi (0-100 %) des coins de la pièce.
TMT_SATURATION
 Quantité de saturation (0-255) à appliquer à une icône dessinée à l’aide de DrawThemeIcon.
TMT_TEXTBORDERSIZE
 Épaisseur de la bordure dessinée autour des caractères de texte.
TMT_TRUESIZESTRETCHMARK
 Pourcentage de la taille d’origine d’une image de taille réelle à laquelle l’image sera étirée.
TMT_WIDTH
 Largeur de la pièce.

[out] piVal

Type : int*

Pointeur vers un int qui reçoit la valeur de la propriété de métrique.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête uxtheme.h
Bibliothèque UxTheme.lib
DLL UxTheme.dll

Voir aussi

Identificateurs de propriété