Configuration.ScreenHeightDp プロパティ

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

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

プロパティ値

属性

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_HEIGHT_DP_UNDEFINED されます。

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

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

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

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

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

Javaドキュメント。

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