SystemParametersInfoForDpi 函数 (winuser.h)
检索其中一个系统范围的参数的值,同时考虑提供的 DPI 值。
语法
BOOL SystemParametersInfoForDpi(
[in] UINT uiAction,
[in] UINT uiParam,
[in, out] PVOID pvParam,
[in] UINT fWinIni,
[in] UINT dpi
);
参数
[in] uiAction
要检索的系统范围参数。 此函数仅适用于 SPI_GETICONTITLELOGFONT、 SPI_GETICONMETRICS或 SPI_GETNONCLIENTMETRICS。 有关这些值的详细信息 ,请参阅 SystemParametersInfo 。
[in] uiParam
一个参数,其用法和格式取决于正在查询的系统参数。 有关系统范围参数的详细信息,请参阅 uiAction 参数。 如果未另行指示,则必须为此参数指定零。
[in, out] pvParam
一个参数,其用法和格式取决于正在查询的系统参数。 有关系统范围参数的详细信息,请参阅 uiAction 参数。 如果未另行指示,则必须为此参数指定 NULL 。 有关 PVOID 数据类型的信息,请参阅 Windows 数据类型。
[in] fWinIni
对此 API 不起作用。 仅当你正在设置参数时,此参数才有效。
[in] dpi
用于缩放指标的 DPI。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
此函数返回与 SystemParametersInfo 类似的结果,但会根据你提供的任意 DPI 进行缩放, ((如果适当)) 。 它仅使用 uiAction 的以下可能值进行缩放:SPI_GETICONTITLELOGFONT、SPI_GETICONMETRICS、SPI_GETNONCLIENTMETRICS。 其他可能的 uiAction 值不提供 ForDPI 行为,因此,如果用它们调用,此函数将返回 0。
对于在其关联结构中包含字符串的 uiAction 值,此函数仅支持 Unicode (LOGFONTW) 字符串。
要求
最低受支持的客户端 | Windows 10版本 1607 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2016 [仅限桌面应用] |
目标平台 | Windows |
标头 | winuser.h (包括 Windows.h) |
Library | User32.lib |
DLL | User32.dll |