Share via


Função OpenThemeDataEx (uxtheme.h)

Abre os dados de tema associados a uma janela para classes de tema especificadas.

Sintaxe

HTHEME OpenThemeDataEx(
  [in] HWND    hwnd,
  [in] LPCWSTR pszClassList,
  [in] DWORD   dwFlags
);

Parâmetros

[in] hwnd

Tipo: HWND

Um identificador para uma janela ou controle do qual o tema deve ser recuperado.

[in] pszClassList

Tipo: LPCWSTR

Uma lista separada por ponto e vírgula de nomes de classe a serem correspondentes.

[in] dwFlags

Tipo: DWORD

Sinalizadores opcionais que controlam como retornar os dados do tema. Pode ser definido como uma combinação dos valores a seguir.

Valor Significado
OTD_FORCE_RECT_SIZING
Força as imagens desenhadas desse tema a se alongarem para se ajustarem aos retângulos especificados pelas funções de desenho.
OTD_NONCLIENT
Permite que elementos de tema sejam desenhados na área não cliente da janela.

Valor retornado

Tipo: HTHEME

Se uma correspondência for encontrada, um identificador válido para um tema será retornado. Caso contrário, um valor NULL será retornado.

Comentários

A cadeia de caracteres especificada por pszClassIdList será tokenizada usando ponto-e-vírgula como delimitador. Os nomes são correspondidos com nomes de classe um token de cada vez. Se nenhuma correspondência for encontrada para um token específico, o próximo token será correspondido. Se uma correspondência for encontrada, o valor retornado da função será o identificador de tema associado à classe correspondente.

Os nomes de classe para o tema Aero são definidos em AeroStyle.xml.

Requisitos

   
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

OpenThemeData