Funzione SystemParametersInfoForDpi (winuser.h)

  • Articolo

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

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 NULL per questo parametro. Per informazioni sul tipo di dati PVOID , vedere Tipi di dati di Windows.

[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