Configuration.ScreenHeightDp Eigenschaft

[Android.Runtime.Register("screenHeightDp")]
public int ScreenHeightDp { get; set; }

[<Android.Runtime.Register("screenHeightDp")>]
member this.ScreenHeightDp : int with get, set

Eigenschaftswert

Attribute

RegisterAttribute

Hinweise

Die Höhe des verfügbaren Bildschirmbereichs in Dp-Einheiten.

"note"><b>Note:</b> If the app targets <c>android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM</c> or after, the height measurement reflects the window size without excluding insets. Andernfalls schließt die Messung Fensterinsets aus, auch wenn die App mit <c>android.view.Window#setDecorFitsSystemWindows(boolean) Window#setDecorFitsSystemWindows(boolean) Window#setDecorFitsSystemWindows(boolean)</c> edge angezeigt wird.</aside>

Verwenden Sie <c>android.view.WindowMetrics#getBounds()</c> , um immer den vertikalen Anzeigebereich abzurufen, der für eine App oder eingebettete Aktivität verfügbar ist, einschließlich des Bereichs, der von Fenstersets belegt wird. Eine Version der API ist auch für die Verwendung auf älteren Plattformen über <c>androidx.window.layout.WindowMetrics</c> verfügbar.

Entspricht dem verfügbaren Ressourcenqualifizierer für Höhe . #SCREEN_HEIGHT_DP_UNDEFINED Wird standardmäßig festgelegt, wenn keine Höhe angegeben wird.

Im Mehrfenstermodus entspricht der Höhe des verfügbaren Anzeigebereichs des App-Fensters und nicht dem verfügbaren Anzeigebereich des Gerätebildschirms (z. B. wenn Apps im Hochformat übereinander angezeigt werden).

Bei eingebetteten Aktivitäten entspricht die Höhe der einzelnen Aktivitäten, nicht der Höhe des App-Fensters oder des Gerätebildschirms.

In Szenarien mit mehreren Bildschirmen kann die Höhenmessung Bildschirme umfassen. Wenn die App z. B. beide Bildschirme eines Dual-Screen-Geräts um 90 Grad gedreht hat (ein Bildschirm über dem anderen), screenHeightDp stellt die Höhe beider Bildschirme dar, mit Ausnahme des Bereichs, der von Fenstermengen belegt wird. Wenn die App auf einen einzelnen Bildschirm in einer Umgebung mit mehreren Bildschirmen beschränkt ist, ist die Höhe des Bildschirms, screenHeightDp auf dem die App ohne Fenstereinsets angezeigt wird.

Wenn die App auf android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM oder nach dem Ziel ausgerichtet ist, ist sie identisch mit android.view.WindowMetrics, wird jedoch auf den nächstgelegenen Dp statt auf px gerundet.

Andernfalls unterscheidet sich dies von android.view.WindowMetrics der Nichteinschluss von Fenstersets in der Höhenmessung und durch Ausdrücken der Maßeinheit in dp statt px. Dient screenHeightDp zum Abrufen der Höhe des Anzeigebereichs, der für eine App oder eingebettete Aktivität verfügbar ist, mit Ausnahme des Bereichs, der von Fenstersets belegt wird.

Java Dokumentation für android.content.res.Configuration.screenHeightDp.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.