DisplayInformation クラス

リファレンス

定義

名前空間:: Windows.Graphics.Display

重要

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

編集

アプリケーションビューの表示関連情報を監視および制御します。クラスは、クライアントが、ビューが存在するディスプレイに影響を与えるアプリケーションビューの変更と、アプリケーションビューに影響を与える可能性があるディスプレイの変更を監視できるようにするイベントを提供します。

public ref class DisplayInformation sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DisplayInformation final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DisplayInformation

Public NotInheritable Class DisplayInformation

継承: Object Platform::Object IInspectable DisplayInformation

属性: ContractVersionAttribute MarshalingBehaviorAttribute

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

DisplayInformation インスタンスは特定のディスプレイにマップされませんが、代わりにアプリケーションビューが配置されている場所に関する表示関連情報を追跡します。 GetForCurrentView を呼び出すと、常に現在のスレッドの CoreApplicationView の単一インスタンスが返されます。 DisplayInformation のインスタンスは、作成されたスレッドからのみ使用できます。

DisplayInformation イベントを処理するには、特定のイベントのイベントハンドラーを使用します。たとえば、 DisplayInformation.DpiChanged の場合は、"TypedEventHandler<DisplayInformation, Object> DpiChanged" を使用します。

DisplayInformation のプロパティ変更イベントは、アプリが 1 つのモニターから別のモニターに移動された場合にトリガーされる可能性があります。 ColorProfileChanged は、ディスプレイのカラープロファイルが変更されたときにトリガーされます。 DpiChanged は、ユーザーが別のズームレベルを選択したか、画面解像度を変更したために LogicalDpi、 ResolutionScale、および RawPixelsPerViewPixel プロパティが変更されたときにトリガーされます。 OrientationChanged は、ユーザーが画面の向きを変更するとトリガーされます。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1511	10586	DiagonalSizeInInches
1607	14393	ScreenHeightInRawPixels
1607	14393	ScreenWidthInRawPixels
1803	17134	AdvancedColorInfoChanged
1803	17134	GetAdvancedColorInfo

プロパティ

AutoRotationPreferences	アプリの優先方向を取得および設定します。
CurrentOrientation	四角形のモニターの現在の向きを取得します。
DiagonalSizeInInches	ディスプレイの対角線のサイズ (インチ単位)。
LogicalDpi	現在の環境の論理インチあたりのピクセル数を取得します。
NativeOrientation	ディスプレイモニターのネイティブの向きを取得します。これは通常、デバイス上のボタンがモニターの向きと一致する向きです。
RawDpiX	ディスプレイモニターの x 軸に沿って生の 1 インチあたりのドット数 (DPI) を取得します。
RawDpiY	ディスプレイモニターの y 軸に沿って生の 1 インチあたりのドット数 (DPI) を取得します。
RawPixelsPerViewPixel	各ビュー (レイアウト) ピクセルの生 (物理) ピクセルの数を表す値を取得します。
ResolutionScale	アプリウィンドウのスケールファクターを取得します。
ScreenHeightInRawPixels	論理モニターの現在の高さの解像度を返します。
ScreenWidthInRawPixels	論理モニターの現在の幅の解像度を返します。
StereoEnabled	デバイスが立体 3D をサポートしているかどうかを示す値を取得します。

メソッド

GetAdvancedColorInfo()	詳細な色の情報を取得します。
GetColorProfileAsync()	物理ディスプレイに関連付けられている既定の国際色コンソーシアム (ICC) カラープロファイルを非同期的に取得します。
GetForCurrentView()	現在のスレッドの CoreApplicationView に関連付けられている DisplayInformation インスタンスを取得します。この DisplayInformation インスタンスはビューに関連付けられており、他のスレッドからは使用できません。

イベント

AdvancedColorInfoChanged	高度な色情報が変更されたときに発生します。
ColorProfileChanged	物理ディスプレイのカラープロファイルが変更されたときに発生します。
DisplayContentsInvalidated	表示に再描画が必要な場合に発生します。
DpiChanged	表示のピクセル/インチ (PPI) が変化するため、 LogicalDpi プロパティが変更されたときに発生します。
OrientationChanged	モードの変更またはモニターの変更により CurrentOrientation プロパティまたは NativeOrientation プロパティが変更されたときに発生します。
StereoEnabledChanged	ステレオスコピック 3D のサポートが変更されたため、 StereoEnabled プロパティが変更されたときに発生します。

適用対象