Display.GetRealSize(Point) メソッド

定義

ウィンドウの装飾を差し引いたり、拡大縮小要因を適用したりすることなく、現在のシステム状態のアプリからアクセスできるディスプレイの最大領域のサイズを取得します。

[Android.Runtime.Register("getRealSize", "(Landroid/graphics/Point;)V", "GetGetRealSize_Landroid_graphics_Point_Handler")]
public virtual void GetRealSize (Android.Graphics.Point? outSize);
[<Android.Runtime.Register("getRealSize", "(Landroid/graphics/Point;)V", "GetGetRealSize_Landroid_graphics_Point_Handler")>]
abstract member GetRealSize : Android.Graphics.Point -> unit
override this.GetRealSize : Android.Graphics.Point -> unit

パラメーター

outSize
Point

ディスプレイの実際のサイズに設定します。

属性

注釈

ウィンドウの装飾を差し引いたり、拡大縮小要因を適用したりすることなく、現在のシステム状態のアプリからアクセスできるディスプレイの最大領域のサイズを取得します。

サイズは、ディスプレイの現在の回転に基づいて調整されます。

返されるサイズは、次のいずれかのシナリオに分類されます。 <ol><li>デバイスには、ディスプレイにパーティションがありません。 戻り値は、ウィンドウ モードに関係なく、現在のシステム状態のアプリからアクセスできるディスプレイの最大領域です。</li li><>デバイスは、1 つのディスプレイを複数のパーティションに分割します。 アプリケーションは、ディスプレイの一部に制限されます。 これは、折りたたみ式や大画面など、ディスプレイのサイズが変更されるデバイスで一般的です。 返されるサイズは、アプリケーションが制限されているディスプレイの部分と一致します。</li li><>ウィンドウ マネージャーは、 を使用してadb shell wm size別の表示サイズをエミュレートしています。 返されるサイズは、エミュレートされた表示サイズと一致します。</li></ol></p>

返される値は <、>これらのシナリオではアプリケーション ウィンドウのサイズが反映されないため、UI 要素</b> のサイズを変更して配置するときに使用するのに適していません。 WindowManager#getCurrentWindowMetrics() は、ウィンドウがパーティション分割されたディスプレイを備えたデバイス上にある場合でも、現在のアプリケーション ウィンドウのサイズを返す代替手段です。 これにより、UI 要素がずれている、またはウィンドウの境界を超えて配置される UI のバグを防ぐことができます。

アプリケーションが常に全画面表示であるとは限らないため、マルチウィンドウ モードを正しく処理する必要があります。 タブレットや ChromeOS デバイスなどの大画面デバイスのユーザーは、マルチウィンドウ モードを使用する可能性が高くなります。

たとえば、ディスプレイを 2 つの半分に分割したデバイスについて考えてみます。 ユーザーは、最初のパーティションで全画面表示アプリケーションを開いている可能性があります。 2 つ目のパーティションで分割画面 (マルチウィンドウ モードの例) で 2 つのアプリケーションを開き、各アプリケーションがパーティションの半分を使用する場合があります。 この場合、 WindowManager#getCurrentWindowMetrics() 全画面表示ウィンドウのサイズは画面の半分であり、分割された各画面ウィンドウのサイズは画面の 4 分の 1 です。 一方、 #getRealSize アプリケーション ウィンドウはすべてそれぞれのパーティションに制限されているため、すべてのウィンドウの画面サイズの半分を報告します。 </p>

このメンバーは非推奨とされます。 アクティビティ ウィンドウの現在のサイズを識別するには、 を使用 WindowManager#getCurrentWindowMetrics() します。 UI レイアウトの選択など、UI 関連の作業は に依存 WindowMetrics#getBounds()する必要があります。

の Java ドキュメント android.view.Display.getRealSize(android.graphics.Point)

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

適用対象