Funzione SystemParametersInfoForDpi (winuser.h)

Articolo
11/05/2023

Recupera il valore di uno dei parametri a livello di sistema, tenendo conto del valore DPI specificato.

Sintassi

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

Parametri

[in] uiAction

Parametro a livello di sistema da recuperare. Questa funzione è destinata solo all'uso con SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICS o SPI_GETNONCLIENTMETRICS. Per altre informazioni su questi valori, vedere SystemParametersInfo .

[in] uiParam

Parametro il cui utilizzo e formato dipende dal parametro di sistema sottoposto a query. Per altre informazioni sui parametri a livello di sistema, vedere il parametro uiAction . Se non diversamente indicato, è necessario specificare zero per questo parametro.

[in, out] pvParam

[in] fWinIni

Non ha alcun effetto per l'API. Questo parametro ha un effetto solo se si imposta il parametro.

[in] dpi

DPI da usare per ridimensionare la metrica.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Questa funzione restituisce un risultato simile a SystemParametersInfo, ma lo ridimensiona in base a un DPI arbitrario fornito (se appropriato). Viene ridimensionata solo con i valori possibili seguenti per uiAction: SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICS, SPI_GETNONCLIENTMETRICS. Altri valori uiAction possibili non forniscono il comportamento ForDPI e quindi questa funzione restituisce 0 se chiamata con loro.

Per i valori uiAction che contengono stringhe all'interno delle strutture associate, solo le stringhe Unicode (LOGFONTW) sono supportate in questa funzione.

Requisiti


Client minimo supportato	Windows 10 versione 1607 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll

Condividi tramite