Display.GetRealMetrics(DisplayMetrics) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient la taille de la plus grande région de l’affichage accessible à une application dans l’état système actuel, sans soustraire de décor de fenêtre ou appliquer des facteurs de mise à l’échelle.
[Android.Runtime.Register("getRealMetrics", "(Landroid/util/DisplayMetrics;)V", "GetGetRealMetrics_Landroid_util_DisplayMetrics_Handler")]
public virtual void GetRealMetrics (Android.Util.DisplayMetrics? outMetrics);
[<Android.Runtime.Register("getRealMetrics", "(Landroid/util/DisplayMetrics;)V", "GetGetRealMetrics_Landroid_util_DisplayMetrics_Handler")>]
abstract member GetRealMetrics : Android.Util.DisplayMetrics -> unit
override this.GetRealMetrics : Android.Util.DisplayMetrics -> unit
Paramètres
- outMetrics
- DisplayMetrics
Objet DisplayMetrics
à recevoir les métriques.
- Attributs
Remarques
Obtient la taille de la plus grande région de l’affichage accessible à une application dans l’état système actuel, sans soustraire de décor de fenêtre ou appliquer des facteurs de mise à l’échelle.
La taille est ajustée en fonction de la rotation actuelle de l’affichage.
La taille retournée se situe dans l’un des scénarios suivants : <ol><li>L’appareil n’a pas de partitions sur l’affichage. La valeur retournée est la plus grande région de l’affichage accessible à une application dans l’état système actuel, quel que soit le mode de fenêtrage.</li li><>L’appareil divise un affichage unique en plusieurs partitions. Une application est limitée à une partie de l’affichage. Cela est courant dans les appareils où l’affichage change de taille, comme les pliables ou les grands écrans. La taille retournée correspond à la partie de l’affichage à l’application.</li li><>Le gestionnaire de fenêtres émule une autre taille d’affichage, en utilisant .adb shell wm size
La taille retournée correspond à la taille d’affichage émulée.</li></ol></p>
La valeur retournée n’est <>pas adaptée à utiliser lors du dimensionnement et du placement d’éléments< d’interface utilisateur/b>, car elle ne reflète pas la taille de la fenêtre d’application dans l’un de ces scénarios. WindowManager#getCurrentWindowMetrics()
est une alternative qui retourne la taille de la fenêtre d’application active, même si la fenêtre se trouve sur un appareil avec un affichage partitionné. Cela permet d’éviter les bogues de l’interface utilisateur où les éléments de l’interface utilisateur sont mal alignés ou placés au-delà des limites de la fenêtre.
La gestion correcte du mode multi-fenêtre est nécessaire, car les applications ne sont pas toujours en mode plein écran. Un utilisateur sur un appareil grand écran, tel qu’une tablette ou des appareils ChromeOS, est plus susceptible d’utiliser des modes multi-fenêtres.
Par exemple, considérez un appareil avec un affichage partitionné en deux moitiés. L’utilisateur peut avoir une application plein écran ouverte sur la première partition. Ils peuvent avoir deux applications ouvertes en écran fractionné (un exemple de mode multi-fenêtre) sur la deuxième partition, chaque application consommant la moitié de la partition. Dans ce cas, WindowManager#getCurrentWindowMetrics()
les rapports indiquent que la fenêtre plein écran est de la moitié de l’écran en taille, et chaque fenêtre d’écran fractionnée est un quart de l’écran en taille. En revanche, signale #getRealMetrics
la moitié de la taille de l’écran pour toutes les fenêtres, car les fenêtres d’application sont toutes limitées à leurs partitions respectives. </p>
Ce membre est déconseillé. Permet WindowManager#getCurrentWindowMetrics()
d’identifier la taille actuelle de la fenêtre d’activité. Le travail lié à l’interface utilisateur, tel que le choix des dispositions de l’interface utilisateur, doit s’appuyer sur WindowMetrics#getBounds()
. Permet Configuration#densityDpi
d’obtenir la densité actuelle.
Documentation Java pour android.view.Display.getRealMetrics(android.util.DisplayMetrics)
.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.