Display.GetMetrics(DisplayMetrics) メソッド

定義

名前空間:: Android.Views

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

このディスプレイのサイズと密度を取得します。

[Android.Runtime.Register("getMetrics", "(Landroid/util/DisplayMetrics;)V", "GetGetMetrics_Landroid_util_DisplayMetrics_Handler")]
public virtual void GetMetrics(Android.Util.DisplayMetrics? outMetrics);

[<Android.Runtime.Register("getMetrics", "(Landroid/util/DisplayMetrics;)V", "GetGetMetrics_Landroid_util_DisplayMetrics_Handler")>]
abstract member GetMetrics : Android.Util.DisplayMetrics -> unit
override this.GetMetrics : Android.Util.DisplayMetrics -> unit

パラメーター

outMetrics: DisplayMetrics

表示メトリックを受け取る DisplayMetrics オブジェクト。

属性: RegisterAttribute

注釈

このディスプレイのサイズと密度を取得します。

返されるサイズは、ディスプレイの実際のサイズ (ネイティブ解像度) を必ずしも表すわけではありません。返されるサイズは、常に表示される特定のシステム装飾要素を除外するように調整するか、サイズをスケーリングして、小さいディスプレイ用に設計された古いアプリケーションとの互換性を提供する場合があります。

返されるサイズは、表示に関連付けられている WindowManager によっても異なる場合があります。 <ul><li>アクティビティからメトリックが要求された場合 ( getWindowManager() または getSystemService(Context.WINDOW_SERVICE)によってアクセスされる WindowManager を使用する場合)、返されるメトリックは現在のアプリウィンドウのサイズを提供します。その結果、マルチウィンドウモードでは、返されるサイズはデバイス画面のサイズよりも小さくなることがあります。システム装飾の処理は API レベルによって異なる場合があります。 <ul><li>API レベル 35 以上では、ウィンドウサイズが返されます。 <li>API レベル 34 以下では、ウィンドウサイズからシステム装飾領域を引いた値と表示切り欠きが返されます。 </ul><li>アクティビティ以外のコンテキスト (たとえば、WindowManager が getApplicationContext().getSystemService(Context.WINDOW_SERVICE) によってアクセスされるアプリケーションコンテキスト) からメトリックが要求された場合、返されるサイズは API レベル ( <ul><li>API レベル 29 以下の &mdash) によって異なる場合があります。返されるメトリックは、ディスプレイ全体のサイズ (現在の回転に基づく) からシステム装飾領域を引いたサイズを提供します。 <li>API レベル 30 以上 >返されるメトリックは、現在のプロセスで最も実行されているアクティビティのサイズを提供します。現在のプロセスに実行中のアクティビティがない場合、メトリックは、システム装飾領域を含む、デバイスの既定の表示のサイズを提供します。 </ul></ul>

このメンバーは非推奨です。 WindowMetrics#getBounds()を使用して、アプリケーションウィンドウのディメンションを取得します。 WindowMetrics#getDensity()を使用して、アプリケーションウィンドウの密度を取得します。

Javaドキュメント。

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

適用対象