Compartilhar via


Função OpenThemeDataForDpi (uxtheme.h)

Uma variante de OpenThemeData que abre um identificador de tema associado a uma DPI específica.

Sintaxe

HTHEME OpenThemeDataForDpi(
  HWND    hwnd,
  LPCWSTR pszClassList,
  UINT    dpi
);

Parâmetros

hwnd

O identificador da janela para a qual os dados do tema são necessários.

pszClassList

Um ponteiro para uma cadeia de caracteres que contém uma lista separada por ponto e vírgula de classes.

dpi

O valor de DPI especificado ao qual associar o identificador de tema. A função retornará um erro se esse valor estiver fora daqueles que correspondem ao conjunto de monitores conectados.

Retornar valor

Consulte OpenThemeData.

Comentários

OpenThemeData criará identificadores de tema associados ao DPI de uma janela quando usado com janelas Por Monitor v2. OpenThemeDataForDpi permite que você abra um identificador de tema para uma DPI específica quando você não tem uma janela nesse DPI.

O comportamento do identificador de tema retornado será prejudicado se o valor de DPI solicitado não corresponder a uma exibição conectada no momento. O sistema de temas carrega apenas ativos de tema para o conjunto de valores de DPI correspondentes às exibições conectadas no momento .

O identificador de tema se tornará inválido sempre que o sistema recarregar os dados do tema. Os aplicativos são necessários para monitorar WM_THEMECHANGED e fechar e reabrir todos os identificadores de tema em resposta. Esse comportamento é o mesmo, independentemente de os identificadores terem sido abertos por meio de OpenThemeData ou OpenThemeDataForDpi.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1703 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uxtheme.h
Biblioteca uxtheme.lib
DLL uxtheme.dll

Confira também

OpenThemeData