Configuration.ScreenWidthDp 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
可用螢幕空間的寬度（以 dp 單位計算）。
[Android.Runtime.Register("screenWidthDp")]
public int ScreenWidthDp { get; set; }[<Android.Runtime.Register("screenWidthDp")>]
member this.ScreenWidthDp : int with get, set屬性值
可用螢幕空間寬度以密度無關像素為單位，或若未指定寬度則為0。
- 屬性
備註
可用螢幕空間的寬度（以 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_WIDTH_DP_UNDEFINED 。
在多視窗模式下，等於應用程式視窗可用顯示區域的寬度，而非裝置螢幕的可用顯示區域（例如，當應用程式以分割畫面並排並排顯示並排呈現時，橫向呈現）。
對於嵌入式活動，則等於各個活動的寬度，而不是應用程式視窗或裝置螢幕的寬度。
在多螢幕情境下，寬度測量可以跨越多個螢幕。 例如，若應用程式橫跨雙螢幕裝置的兩個螢幕（螢幕並排）， screenWidthDp 則代表兩個螢幕的寬度，但不含視窗插圖所佔用的區域。 當應用程式在多螢幕環境中限制為單一畫面時， screenWidthDp 是應用程式顯示螢幕的寬度（不含視窗內嵌）。
如果應用程式目標為 android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM 或 之後，則與 相同 android.view.WindowMetrics，但以四捨五入的方式表示為最近的 DP，而非 px。
否則，與 android.view.WindowMetrics 不同之處在於未將窗戶插入納入寬度測量，且以 dp 而非 px 表示測量。 用 screenWidthDp 來取得應用程式或嵌入活動可用顯示區域的寬度，但不包括視窗嵌套所佔用的區域。
Java 文件 android.content.res.Configuration.screenWidthDp。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。