Freigeben über


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