GetThemeMetric-Funktion (uxtheme.h)

Ruft den Wert einer Metrikeigenschaft ab.

Syntax

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

Parameter

[in] hTheme

Typ: HTHEME

Behandeln Sie die angegebenen Designdaten eines Fensters. Verwenden Sie OpenThemeData , um ein HTHEME zu erstellen.

[in] hdc

Typ: HDC

HDC. Dieser Parameter kann auf NULL festgelegt werden.

[in] iPartId

Typ: int

Wert vom Typ int , der den Teil angibt, der die Metrikeigenschaft enthält. Weitere Informationen finden Sie unter Teile und Zustände.

[in] iStateId

Typ: int

Wert des Typs int , der den Zustand des Teils angibt. Weitere Informationen finden Sie unter Teile und Zustände.

[in] iPropId

Typ: int

Wert des Typs int , der die abzurufende Eigenschaft angibt. Kann einer der folgenden Werte sein.

Wert	Bedeutung
TMT_ALPHALEVEL	Der für DrawThemeIcon verwendete Alphawert (0-255).
TMT_ALPHATHRESHOLD	Der minimale Alphawert (0-255), den ein Pixel als undurchsichtig betrachten muss.
TMT_BORDERSIZE	Die Stärke des Rahmens, der gezeichnet wird, wenn dieses Teil eine Rahmenfüllung verwendet.
TMT_GLYPHINDEX	Der Zeichenindex in der ausgewählten Schriftart, die für die Glyphe verwendet wird, wenn das Teil eine schriftartbasierte Glyphe verwendet.
TMT_GRADIENTRATIO1	Die Menge der ersten Farbverlaufsfarbe, die beim Zeichnen des Teils verwendet werden soll. Dieser Wert kann zwischen 0 und 255 sein, aber dieser Wert plus die Werte der gradientratio-Werte müssen sich auf 255 summieren. Sehen Sie sich den TMT_GRADIENTCOLOR1 Wert von GetThemeColor an.
TMT_GRADIENTRATIO2	Die Menge der zweiten Farbverlaufsfarbe, die beim Zeichnen des Teils verwendet werden soll.
TMT_GRADIENTRATIO3	Die Menge der dritten Farbverlaufsfarbe, die beim Zeichnen des Teils verwendet werden soll.
TMT_GRADIENTRATIO4	Die Menge der vierten Farbverlaufsfarbe, die beim Zeichnen des Teils verwendet werden soll.
TMT_GRADIENTRATIO5	Die Menge der fünften Farbverlaufsfarbe, die beim Zeichnen des Teils verwendet werden soll.
TMT_HEIGHT	Die Höhe des Teils.
TMT_IMAGECOUNT	Die Anzahl der Zustandsbilder, die in einer Imagedatei vorhanden sind.
TMT_MINDPI1	Der minimale DPI-Wert, für den die erste Bilddatei entworfen wurde. Siehe GetThemeFilename.
TMT_MINDPI2	Der minimale DPI-Wert, für den die zweite Bilddatei entworfen wurde.
TMT_MINDPI3	Die minimale dpi-Datei, für die die dritte Bilddatei entworfen wurde.
TMT_MINDPI4	Der minimale DPI-Wert, für den die vierte Bilddatei entworfen wurde.
TMT_MINDPI5	Der minimale DPI-Wert, für den die fünfte Bilddatei entworfen wurde.
TMT_PROGRESSCHUNKSIZE	Die Größe der "Block"-Shapes des Statussteuerelements, die definieren, wie weit ein Vorgang fortgeschritten ist.
TMT_PROGRESSSPACESIZE	Die Gesamtgröße aller "Blöcke" des Fortschrittssteuerelements.
TMT_ROUNDCORNERWIDTH	Die Rundheit (0-100 %) der Ecken des Teils.
TMT_ROUNDCORNERHEIGHT	Die Rundheit (0-100 %) der Ecken des Teils.
TMT_SATURATION	Die Menge der Sättigung (0-255), die auf ein mit DrawThemeIcon gezeichnetes Symbol angewendet werden soll.
TMT_TEXTBORDERSIZE	Die Stärke des Rahmens, der um Textzeichen gezeichnet wird.
TMT_TRUESIZESTRETCHMARK	Der Prozentsatz der originalen Größe eines Bilds, mit dem das Bild gestreckt wird.
TMT_WIDTH	Die Breite des Teils.

[out] piVal

Typ: int*

Zeiger auf ein int , das den Metrikeigenschaftswert empfängt.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uxtheme.h
Bibliothek	UxTheme.lib
DLL	UxTheme.dll

Weitere Informationen

Eigenschaftsbezeichner