Condividi tramite

Funzione GetThemeMetric (uxtheme.h)

  • Articolo

Recupera il valore di una proprietà metrica.

Sintassi

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

Parametri

[in] hTheme

Tipo: HTHEME

Handle per i dati del tema specificati di una finestra. Usare OpenThemeData per creare un HTHEME.

[in] hdc

Tipo: HDC

HDC. Questo parametro può essere impostato su NULL.

[in] iPartId

Tipo: int

Valore di tipo int che specifica la parte che contiene la proprietà metrica. Vedere Parti e stati.

[in] iStateId

Tipo: int

Valore di tipo int che specifica lo stato della parte. Vedere Parti e stati.

[in] iPropId

Tipo: int

Valore di tipo int che specifica la proprietà da recuperare. Può essere uno dei valori seguenti.

Valore Significato
TMT_ALPHALEVEL
 Valore alfa (0-255) utilizzato per DrawThemeIcon.
TMT_ALPHATHRESHOLD
 Valore alfa minimo (0-255) che un pixel deve essere considerato opaco.
TMT_BORDERSIZE
 Spessore del bordo disegnato se questa parte utilizza un riempimento del bordo.
TMT_GLYPHINDEX
 Indice dei caratteri nel tipo di carattere selezionato che verrà utilizzato per il glifo, se la parte utilizza un glifo basato sul tipo di carattere.
TMT_GRADIENTRATIO1
 Quantità del primo colore sfumato da utilizzare per disegnare la parte. Questo valore può essere compreso tra 0 e 255, ma questo valore più i valori di ognuno dei valori GRADIENTRATIO devono essere aggiunti fino a 255. Vedere il valore TMT_GRADIENTCOLOR1 di GetThemeColor.
TMT_GRADIENTRATIO2
 Quantità del secondo colore sfumato da utilizzare per disegnare la parte.
TMT_GRADIENTRATIO3
 Quantità del terzo colore sfumato da utilizzare per disegnare la parte.
TMT_GRADIENTRATIO4
 Quantità del quarto colore sfumato da utilizzare per disegnare la parte.
TMT_GRADIENTRATIO5
 Quantità del quinto colore sfumato da utilizzare per disegnare la parte.
TMT_HEIGHT
 Altezza della parte.
TMT_IMAGECOUNT
 Numero di immagini di stato presenti in un file di immagine.
TMT_MINDPI1
 Valore DPI minimo per il quale è stato progettato il primo file di immagine. Vedere GetThemeFilename.
TMT_MINDPI2
 Valore DPI minimo per il quale è stato progettato il secondo file di immagine.
TMT_MINDPI3
 Valore DPI minimo per il quale è stato progettato il terzo file di immagine.
TMT_MINDPI4
 Valore DPI minimo per il quale è stato progettato il quarto file di immagine.
TMT_MINDPI5
 Valore DPI minimo per il quale è stato progettato il quinto file di immagine.
TMT_PROGRESSCHUNKSIZE
 Dimensioni delle forme "blocchi" del controllo di stato che definiscono la distanza di avanzamento di un'operazione.
TMT_PROGRESSSPACESIZE
 Dimensioni totali di tutti i controlli di stato "blocchi".
TMT_ROUNDCORNERWIDTH
 Arrotondamento (0-100%) degli angoli della parte.
TMT_ROUNDCORNERHEIGHT
 Arrotondamento (0-100%) degli angoli della parte.
TMT_SATURATION
 Quantità di saturazione (0-255) da applicare a un'icona disegnata utilizzando DrawThemeIcon.
TMT_TEXTBORDERSIZE
 Spessore del bordo disegnato intorno ai caratteri di testo.
TMT_TRUESIZESTRETCHMARK
 Percentuale delle dimensioni originali di un'immagine di dimensioni reali in corrispondenza della quale verrà estesa l'immagine.
TMT_WIDTH
 Larghezza della parte.

[out] piVal

Tipo: int*

Puntatore a un valore int che riceve il valore della proprietà metrica.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione uxtheme.h
Libreria UxTheme.lib
DLL UxTheme.dll

Vedi anche

Identificatori di proprietà