Configuration.ScreenWidthDp プロパティ

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

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

プロパティ値

使用できる画面スペースの幅 (密度に依存しないピクセル単位)、または幅が指定されていない場合は 0。

属性

RegisterAttribute

注釈

使用可能な画面領域の幅 (dp 単位)。

"note"><b>Note:</b> アプリのターゲットが <c>android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM</c> 以降の場合、幅の測定値は、インセットを除外せずにウィンドウ サイズを反映します。 それ以外の場合、アプリが <c>android.view.Window#setDecorFitsSystemWindows(boolean) Window#setDecorFitsSystemWindows(boolean)</c>.< を使用してエッジに表示されている場合でも、ウィンドウのインセットは除外されます/aside>

<c>android.view.WindowMetrics#getBounds()</c> を使用して、アプリまたは埋め込みアクティビティで使用できる水平方向の表示領域 (ウィンドウインセットによって占有される領域を含む) を常に取得します。 API のバージョンは、 <c>androidx.window.layout.WindowMetrics</c> を通じて古いプラットフォームでも使用できます。

使用可能な幅リソース修飾子に対応します。 幅が指定されていない場合、既定値は #SCREEN_WIDTH_DP_UNDEFINED です。

マルチウィンドウ モードでは、デバイス画面の使用可能な表示領域ではなく、アプリ ウィンドウの使用可能な表示領域の幅と等しくなります (たとえば、アプリが横向きの分割画面モードで並べて表示される場合)。

埋め込みアクティビティの場合、アプリ ウィンドウやデバイス画面の幅ではなく、個々のアクティビティの幅と等しくなります。

複数画面のシナリオでは、幅の測定は画面にまたがることができます。 たとえば、アプリがデュアルスクリーン デバイスの両方の画面にまたがって (画面が並べて表示されている) 場合、 screenWidthDp は、ウィンドウインセットによって占有される領域を除く両方の画面の幅を表します。 アプリが複数画面環境で 1 つの画面に制限されている場合、 screenWidthDp は、ウィンドウのインセットを除く、アプリが表示される画面の幅です。

アプリが android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM 以降を対象とする場合、 android.view.WindowMetricsと同じですが、px ではなく最も近い dp に丸められます。

それ以外の場合は、幅の測定にウィンドウインセットを含めず、pxではなくdpで測定を表現することで、 android.view.WindowMetrics とは異なります。 screenWidthDpを使用して、アプリまたは埋め込みアクティビティで使用できる表示領域の幅を取得します。ウィンドウのインセットによって占有される領域は除きます。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。