Share via

Função GetThemeSysString (uxtheme.h)

  • Artigo

Recupera o valor de uma cadeia de caracteres do sistema.

Sintaxe

HRESULT GetThemeSysString(
  [in]  HTHEME hTheme,
  [in]  int    iStringId,
  [out] LPWSTR pszStringBuff,
  [in]  int    cchMaxStringChars
);

Parâmetros

[in] hTheme

Tipo: HTHEME

Manipular para dados de tema.

[in] iStringId

Tipo: int

Valor do tipo int que especifica uma cadeia de caracteres do sistema. Pode ser um dos valores a seguir.

Valor Significado
TMT_CSSNAME
 O nome do arquivo CSS associado ao tema especificado por hTheme.
TMT_XMLNAME
 O nome do arquivo XML associado ao tema especificado por hTheme.

[out] pszStringBuff

Tipo: LPWSTR

Ponteiro para o buffer que recebe o valor da cadeia de caracteres dessa função.

[in] cchMaxStringChars

Tipo: int

Valor do tipo int que especifica o número máximo de caracteres que o buffer de cadeia de caracteres pode conter.

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.

Comentários

Se o identificador de dados de tema não for um identificador NULL , essa função retornará a cadeia de caracteres desejada da seção SysMetrics do estilo visual. Se o identificador de dados de tema for NULL, essa função retornará o valor da métrica do sistema global do mesmo tipo.

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