Compartilhar via


Função GetThemeMetric (uxtheme.h)

Recupera o valor de uma propriedade de métrica.

Sintaxe

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

Parâmetros

[in] hTheme

Tipo: HTHEME

Manipule para os dados de tema especificados de uma janela. Use OpenThemeData para criar um HTHEME.

[in] hdc

Tipo: HDC

HDC. Esse parâmetro pode ser definido como NULL.

[in] iPartId

Tipo: int

Valor do tipo int que especifica a parte que contém a propriedade de métrica. Consulte Partes e Estados.

[in] iStateId

Tipo: int

Valor do tipo int que especifica o estado da parte. Consulte Partes e Estados.

[in] iPropId

Tipo: int

Valor do tipo int que especifica a propriedade a ser recuperada. Pode ser um dos valores a seguir.

Valor Significado
TMT_ALPHALEVEL
O valor alfa (0-255) usado para DrawThemeIcon.
TMT_ALPHATHRESHOLD
O valor alfa mínimo (0-255) que um pixel deve ser considerado opaco.
TMT_BORDERSIZE
A espessura da borda desenhada se essa parte usar um preenchimento de borda.
TMT_GLYPHINDEX
O índice de caracteres na fonte selecionada que será usada para o glifo, se a parte usar um glifo baseado em fonte.
TMT_GRADIENTRATIO1
A quantidade da primeira cor de gradiente a ser usada no desenho da parte. Esse valor pode ser de 0 a 255, mas esse valor mais os valores de cada um dos valores GRADIENTRATIO devem somar até 255. Consulte o valor TMT_GRADIENTCOLOR1 de GetThemeColor.
TMT_GRADIENTRATIO2
A quantidade da segunda cor de gradiente a ser usada no desenho da parte.
TMT_GRADIENTRATIO3
A quantidade da terceira cor de gradiente a ser usada no desenho da parte.
TMT_GRADIENTRATIO4
A quantidade da quarta cor de gradiente a ser usada no desenho da parte.
TMT_GRADIENTRATIO5
A quantidade da quinta cor de gradiente a ser usada no desenho da parte.
TMT_HEIGHT
A altura da parte.
TMT_IMAGECOUNT
O número de imagens de estado presentes em um arquivo de imagem.
TMT_MINDPI1
O dpi mínimo para o qual o primeiro arquivo de imagem foi projetado. Consulte GetThemeFilename.
TMT_MINDPI2
O dpi mínimo para o qual o segundo arquivo de imagem foi projetado.
TMT_MINDPI3
O dpi mínimo para o qual o terceiro arquivo de imagem foi projetado.
TMT_MINDPI4
O dpi mínimo para o qual o quarto arquivo de imagem foi projetado.
TMT_MINDPI5
O dpi mínimo para o qual o quinto arquivo de imagem foi projetado.
TMT_PROGRESSCHUNKSIZE
O tamanho das formas de "parte" do controle de progresso que definem até que ponto uma operação progrediu.
TMT_PROGRESSSPACESIZE
O tamanho total de todos os "blocos" do controle de progresso.
TMT_ROUNDCORNERWIDTH
A arredondamento (0-100%) dos cantos da parte.
TMT_ROUNDCORNERHEIGHT
A arredondamento (0-100%) dos cantos da parte.
TMT_SATURATION
A quantidade de saturação (0-255) a ser aplicada a um ícone desenhado usando DrawThemeIcon.
TMT_TEXTBORDERSIZE
A espessura da borda desenhada em torno de caracteres de texto.
TMT_TRUESIZESTRETCHMARK
A porcentagem do tamanho original de uma imagem de tamanho real em que a imagem será ampliada.
TMT_WIDTH
A largura da parte.

[out] piVal

Tipo: int*

Ponteiro para um int que recebe o valor da propriedade de métrica.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uxtheme.h
Biblioteca UxTheme.lib
DLL UxTheme.dll

Confira também

Identificadores de propriedade