Configuration.ScreenHeightDp 屬性

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

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

屬性值

屬性

RegisterAttribute

備註

可用螢幕空間的高度（以 dp 單位計）。

「注意」><b 註：</b> 如果應用程式目標為 <c android.os.Build.VERSION_CODES>#VANILLA_ICE_CREAM</c> 或之後，高度測量會反映視窗大小，且不>排除內集。 否則，即使應用程式 <以 c>android.view.Window#setDecorFitsSystemWindows（boolean） 視窗#setDecorFitsSystemWindows（布林<）/c> 從邊到邊顯示，測量仍會排除視窗內嵌。</旁白>

使用 <c>android.view.WindowMetrics#getBounds（）</c> 來取得應用程式或嵌入活動可用的垂直顯示區域，包括視窗介面所佔據的區域。 API 的版本也可透過 <c>、androidx.window.layout.WindowMetrics</c> 在較舊平台上使用。

對應 於可用高度 資源限定符。 若未指定高度，則預設為 #SCREEN_HEIGHT_DP_UNDEFINED 。

在多視窗模式下，為應用程式視窗可用顯示區域的高度，而非裝置螢幕的可用顯示區域（例如，當應用程式以分割畫面方式以直向方式重疊顯示時）。

對於嵌入式活動，等於各個活動的高度，而不是應用程式視窗或裝置螢幕的高度。

在多螢幕情境下，高度測量可以跨越多個螢幕。 例如，若應用程式橫跨雙螢幕裝置的兩個螢幕，且旋轉90度（一個螢幕上方 screenHeightDp ），則代表兩個螢幕的高度，但不含視窗插圖所佔用的區域。 當應用程式在多螢幕環境中限制為單一螢幕時， screenHeightDp 是應用程式顯示螢幕（不含視窗內嵌套）的高度。

如果應用程式目標為 android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM 或 之後，則與 相同 android.view.WindowMetrics，但以四捨五入的方式表示為最近的 DP，而非 px。

否則，與 android.view.WindowMetrics 未包含窗戶嵌入高度測量，且以 dp 而非 px 表示測量值的不同。 可取得 screenHeightDp 應用程式或嵌入活動可用顯示區域的高度，但不包括視窗插圖所佔用的區域。

Java 文件 android.content.res.Configuration.screenHeightDp。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。