Share via

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
 要应用于使用 DrawThemeIcon 绘制的图标的饱和度 (0-255) 。
TMT_TEXTBORDERSIZE
 围绕文本字符绘制的边框的粗细。
TMT_TRUESIZESTRETCHMARK
 真实大小图像的原始大小的百分比，图像将被拉伸。
TMT_WIDTH
 部件的宽度。

[out] piVal

类型： int*

指向接收指标属性值的 int 的指针。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 uxtheme.h
Library UxTheme.lib
DLL UxTheme.dll

另请参阅

属性标识符