Função SystemParametersInfoForDpi (winuser.h)

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