GetScaleFactorForMonitor, fonction (shellscalingapi.h)

Article
08/26/2023

Obtient le facteur de mise à l’échelle d’un moniteur spécifique. Cette fonction remplace GetScaleFactorForDevice.

Syntaxe

HRESULT GetScaleFactorForMonitor(
  [in]  HMONITOR            hMon,
  [out] DEVICE_SCALE_FACTOR *pScale
);

Paramètres

[in] hMon

Handle du moniteur.

[out] pScale

Lorsque cette fonction retourne correctement, cette valeur pointe vers l’une des valeurs DEVICE_SCALE_FACTOR qui spécifient le facteur d’échelle du moniteur spécifié.

Si l’appel de fonction échoue, cette valeur pointe vers un facteur de mise à l’échelle valide afin que les applications puissent choisir de continuer avec des ressources de taille incorrecte.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Votre code doit gérer le message WM_WINDOWPOSCHANGED en plus de l’événement de modification de mise à l’échelle enregistré via RegisterScaleChangeEvent, car la fenêtre d’application peut être déplacée entre les moniteurs. En réponse au message WM_WINDOWPOSCHANGED , appelez MonitorFromWindow, suivi de GetScaleFactorForMonitor pour obtenir le facteur de mise à l’échelle du moniteur sur lequel se trouve la fenêtre d’application. Votre code peut ensuite réagir à toute modification de points par pouce (ppp) en rechargeant les ressources et en modifiant la disposition.

Configuration requise


Client minimal pris en charge	Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shellscalingapi.h
Bibliothèque	Shcore.lib
DLL	Shcore.dll

Voir aussi

RegisterScaleChangeEvent

DésinscrireScaleChangeEvent

Partager via