Display.GetRealMetrics(DisplayMetrics) Metodo

Definizione

Spazio dei nomi:

Android.Views

Assembly:

Mono.Android.dll

Ottiene le dimensioni dell'area più grande dello schermo accessibile a un'app nello stato del sistema corrente, senza sottrarre alcun arredamento della finestra o applicare fattori di ridimensionamento.

[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

Parametri

outMetrics

DisplayMetrics

Oggetto DisplayMetrics per ricevere le metriche.

Attributi

RegisterAttribute

Commenti

Ottiene le dimensioni dell'area più grande dello schermo accessibile a un'app nello stato del sistema corrente, senza sottrarre alcun arredamento della finestra o applicare fattori di ridimensionamento.

Le dimensioni vengono regolate in base alla rotazione corrente dello schermo.

Le dimensioni restituite rientrano in uno di questi scenari: <ol><li>Il dispositivo non ha partizioni sullo schermo. Il valore restituito è l'area più grande dello schermo accessibile a un'app nello stato del sistema corrente, indipendentemente dalla modalità di finestra.</li><li>Il dispositivo divide un singolo display in più partizioni. Un'applicazione è limitata a una parte dello schermo. Questo è comune nei dispositivi in cui le dimensioni dello schermo cambiano, ad esempio piegabili o schermi di grandi dimensioni. La dimensione restituita corrisponderà alla parte della visualizzazione a cui l'applicazione è limitata.</li><li>Il gestore finestre sta simulando una dimensione di visualizzazione diversa, usando adb shell wm size. Le dimensioni restituite corrispondono alle dimensioni di visualizzazione emulate.</li></ol></p>

Il valore restituito non è <>adatto all'uso durante il ridimensionamento e l'inserimento di elementi< dell'interfaccia utente/b>, poiché non riflette le dimensioni della finestra dell'applicazione in uno di questi scenari. WindowManager#getCurrentWindowMetrics() è un'alternativa che restituisce le dimensioni della finestra dell'applicazione corrente, anche se la finestra si trova in un dispositivo con una visualizzazione partizionata. Ciò consente di evitare bug dell'interfaccia utente in cui gli elementi dell'interfaccia utente non sono allineati o posizionati oltre i limiti della finestra.

La gestione corretta della modalità a più finestre è necessaria perché le applicazioni non sono sempre a schermo intero. Un utente su un dispositivo di grandi dimensioni, ad esempio un tablet o un dispositivo ChromeOS, è più probabile che usi modalità multi-finestra.

Si consideri, ad esempio, un dispositivo con un display partizionato in due metà. L'utente potrebbe avere un'applicazione a schermo intero aperta nella prima partizione. Possono avere due applicazioni aperte in split screen (un esempio di modalità multi-finestra) nella seconda partizione, con ogni applicazione che utilizza metà della partizione. In questo caso, WindowManager#getCurrentWindowMetrics() segnala che la finestra a schermo intero è la metà dello schermo di dimensioni e ogni finestra dello schermo diviso è un quarto della dimensione dello schermo. D'altra parte, #getRealMetrics segnala la metà delle dimensioni dello schermo per tutte le finestre, poiché le finestre dell'applicazione sono tutte limitate alle rispettive partizioni. </p>

Questo membro è deprecato. Usare WindowManager#getCurrentWindowMetrics() per identificare le dimensioni correnti della finestra dell'attività. Il lavoro correlato all'interfaccia utente, ad esempio la scelta dei layout dell'interfaccia utente, deve basarsi su WindowMetrics#getBounds(). Usare Configuration#densityDpi per ottenere la densità corrente.

Documentazione java per android.view.Display.getRealMetrics(android.util.DisplayMetrics).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.