共用方式為

GetThemeMetric 函式 (uxtheme.h)

  • 發行項

擷取計量屬性的值。

語法

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

參數

[in] hTheme

類型： HTHEME

視窗指定之主題數據的句柄。 使用 OpenThemeData 建立 HTHEME。

[in] hdc

類型： HDC

HDC。 此參數可能設定為 NULL。

[in] iPartId

類型： int

int 類型的值，指定包含計量屬性的元件。 請參閱 元件和狀態。

[in] iStateId

類型： int

int 類型的值，指定元件的狀態。 請參閱 元件和狀態。

[in] iPropId

類型： int

int 類型的值，指定要擷取的屬性。 可以是下列其中一個值。

值 意義
TMT_ALPHALEVEL
 用於 DrawThemeIcon 的 alpha 值 (0-255) 。
TMT_ALPHATHRESHOLD
 最小 Alpha 值 (0-255) 像素必須視為不透明。
TMT_BORDERSIZE
 如果這個部分使用框線填滿，則繪製框線的粗細。
TMT_GLYPHINDEX
 如果元件使用字型圖像，則字元索引會用於字元的選取字型。
TMT_GRADIENTRATIO1
 繪製元件時要使用的第一個漸層色彩數量。 這個值可以是 0 到 255，但此值加上每個 GRADIENTRATIO 值的值必須加到最多 255。 請參閱 GetThemeColor 的TMT_GRADIENTCOLOR1值。
TMT_GRADIENTRATIO2
 繪製元件時要使用的第二個漸層色彩數量。
TMT_GRADIENTRATIO3
 繪製元件時要使用的第三個漸層色彩數量。
TMT_GRADIENTRATIO4
 繪製元件時要使用的第四個漸層色彩數量。
TMT_GRADIENTRATIO5
 繪製元件時要使用的第五個漸層色彩量。
TMT_HEIGHT
 元件的高度。
TMT_IMAGECOUNT
 映射檔中存在的狀態影像數目。
TMT_MINDPI1
 第一個圖像檔所設計的最低 dpi。 請參閱 GetThemeFilename。
TMT_MINDPI2
 第二個圖像檔所設計的最低 dpi。
TMT_MINDPI3
 第三個圖像文件設計的最低 dpi。
TMT_MINDPI4
 第四個圖像檔所設計的最低 dpi。
TMT_MINDPI5
 第五個圖像檔所設計的最低 dpi。
TMT_PROGRESSCHUNKSIZE
 進度控件「區塊」圖形的大小，可定義作業進度的程度。
TMT_PROGRESSSPACESIZE
 所有進度控件「區塊」的總大小。
TMT_ROUNDCORNERWIDTH
 圓角 (0-100%) 。
TMT_ROUNDCORNERHEIGHT
 圓角 (0-100%) 。
TMT_SATURATION
 (0-255) 的飽和度量，套用至使用 DrawThemeIcon 繪製的圖示。
TMT_TEXTBORDERSIZE
 在文字字元周圍繪製的框線粗細。
TMT_TRUESIZESTRETCHMARK
 將縮放影像的原始影像大小百分比。
TMT_WIDTH
 元件的寬度。

[out] piVal

類型： int*

接收計量屬性值之 int 的指標。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 uxtheme.h
程式庫 UxTheme.lib
Dll UxTheme.dll

另請參閱

屬性識別項