Função SystemParametersInfoForDpi (winuser.h)

  • Artigo

Recupera o valor de um dos parâmetros de todo o sistema, levando em conta o valor de DPI fornecido.

Sintaxe

BOOL SystemParametersInfoForDpi(
  [in]      UINT  uiAction,
  [in]      UINT  uiParam,
  [in, out] PVOID pvParam,
  [in]      UINT  fWinIni,
  [in]      UINT  dpi
);

Parâmetros

[in] uiAction

O parâmetro de todo o sistema a ser recuperado. Essa função destina-se apenas ao uso com SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICS ou SPI_GETNONCLIENTMETRICS. Consulte SystemParametersInfo para obter mais informações sobre esses valores.

[in] uiParam

Um parâmetro cujo uso e formato dependem do parâmetro do sistema que está sendo consultado. Para obter mais informações sobre parâmetros em todo o sistema, consulte o parâmetro uiAction . Se não for indicado de outra forma, você deverá especificar zero para esse parâmetro.

[in, out] pvParam

Um parâmetro cujo uso e formato dependem do parâmetro do sistema que está sendo consultado. Para obter mais informações sobre parâmetros em todo o sistema, consulte o parâmetro uiAction . Se não for indicado de outra forma, você deverá especificar NULL para esse parâmetro. Para obter informações sobre o tipo de dados PVOID , consulte Tipos de dados do Windows.

[in] fWinIni

Não tem nenhum efeito para com essa API. Esse parâmetro só terá efeito se você estiver definindo o parâmetro .

[in] dpi

O DPI a ser usado para dimensionar a métrica.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Essa função retorna um resultado semelhante a SystemParametersInfo, mas o dimensiona de acordo com um DPI arbitrário fornecido (se apropriado). Ele só é dimensionado com os seguintes valores possíveis para uiAction: SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICSSPI_GETNONCLIENTMETRICS. Outros valores possíveis de uiAction não fornecem o comportamento de ForDPI e, portanto, essa função retorna 0 se chamada com eles.

Para valores uiAction que contêm cadeias de caracteres dentro de suas estruturas associadas, somente cadeias de caracteres Unicode (LOGFONTW) têm suporte nessa função.

Requisitos

   
Cliente mínimo com suporte Windows 10, versão 1607 [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 winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll