Fungsi SystemParametersInfoForDpi (winuser.h)

Artikel
11/05/2023

Mengambil nilai salah satu parameter di seluruh sistem, dengan mempertimbangkan nilai DPI yang disediakan.

Sintaks

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

Parameter

[in] uiAction

Parameter seluruh sistem yang akan diambil. Fungsi ini hanya ditujukan untuk digunakan dengan SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICS, atau SPI_GETNONCLIENTMETRICS. Lihat SystemParametersInfo untuk informasi selengkapnya tentang nilai-nilai ini.

[in] uiParam

Parameter yang penggunaan dan formatnya bergantung pada parameter sistem yang sedang dikueri. Untuk informasi selengkapnya tentang parameter di seluruh sistem, lihat parameter uiAction . Jika tidak ditunjukkan sebaliknya, Anda harus menentukan nol untuk parameter ini.

[in, out] pvParam

[in] fWinIni

Tidak berpengaruh dengan API ini. Parameter ini hanya berpengaruh jika Anda mengatur parameter.

[in] dpi

DPI yang digunakan untuk menskalakan metrik.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi ini mengembalikan hasil yang sama dengan SystemParametersInfo, tetapi menskalakannya sesuai dengan DPI arbitrer yang Anda berikan (jika sesuai). Ini hanya menskalakan dengan nilai yang mungkin berikut untuk uiAction: SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICS, SPI_GETNONCLIENTMETRICS. Nilai uiAction lain yang mungkin tidak memberikan perilaku ForDPI, dan oleh karena itu fungsi ini mengembalikan 0 jika dipanggil dengannya.

Untuk nilai uiAction yang berisi string dalam struktur terkaitnya, hanya string Unicode (LOGFONTW) yang didukung dalam fungsi ini.

Persyaratan


Klien minimum yang didukung	Windows 10, versi 1607 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll

Share via