Display.GetRealMetrics(DisplayMetrics) Método

[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

Parámetros

Atributos

RegisterAttribute

Comentarios

Obtiene el tamaño de la región más grande de la pantalla accesible para una aplicación en el estado actual del sistema, sin restar ninguna decoración de ventana o aplicar factores de escalado.

El tamaño se ajusta en función de la rotación actual de la pantalla.

El tamaño devuelto caerá en uno de estos escenarios: <ol><li>El dispositivo no tiene particiones en la pantalla. El valor devuelto es la región más grande de la pantalla a la que se puede acceder a una aplicación en el estado actual del sistema, independientemente del modo de ventana.</li li><>El dispositivo divide una sola pantalla en varias particiones. Una aplicación está restringida a una parte de la pantalla. Esto es común en los dispositivos en los que la pantalla cambia de tamaño, como plegables o pantallas grandes. El tamaño devuelto coincidirá con la parte de la pantalla a la que está restringida la aplicación.</li li><>El administrador de ventanas emula un tamaño de pantalla diferente, mediante .adb shell wm size El tamaño devuelto coincidirá con el tamaño de presentación emulado.</li></ol></p>

El valor devuelto es <b>no adecuado para usar al ajustar el tamaño y colocar elementos< de la interfaz de usuario/b>, ya que no refleja el tamaño de la ventana de la aplicación en ninguno de estos escenarios. WindowManager#getCurrentWindowMetrics() es una alternativa que devuelve el tamaño de la ventana de aplicación actual, incluso si la ventana está en un dispositivo con una pantalla con particiones. Esto ayuda a evitar errores de interfaz de usuario en los que los elementos de la interfaz de usuario están mal alineados o colocados más allá de los límites de la ventana.

Controlar correctamente el modo de varias ventanas es necesario, ya que las aplicaciones no siempre son de pantalla completa. Un usuario de un dispositivo de pantalla grande, como una tableta o dispositivos ChromeOS, es más probable que use modos de varias ventanas.

Por ejemplo, considere un dispositivo con una pantalla con particiones en dos mitades. El usuario puede tener abierta una aplicación de pantalla completa en la primera partición. Pueden tener dos aplicaciones abiertas en pantalla dividida (un ejemplo del modo de varias ventanas) en la segunda partición, con cada aplicación que consume la mitad de la partición. En este caso, WindowManager#getCurrentWindowMetrics() informa de que la ventana de pantalla completa tiene la mitad del tamaño de la pantalla y cada ventana de pantalla dividida es un cuarto del tamaño de la pantalla. Por otro lado, #getRealMetrics informa de la mitad del tamaño de pantalla de todas las ventanas, ya que las ventanas de aplicación están restringidas a sus respectivas particiones. </p>

Este miembro está en desuso. Use WindowManager#getCurrentWindowMetrics() para identificar el tamaño actual de la ventana de actividad. El trabajo relacionado con la interfaz de usuario, como elegir diseños de interfaz de usuario, debe basarse en WindowMetrics#getBounds(). Use Configuration#densityDpi para obtener la densidad actual.

Documentación de Java para android.view.Display.getRealMetrics(android.util.DisplayMetrics).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a