Screen QML Type

Screen 付属オブジェクトは、アイテムやウィンドウが表示されている画面に関する情報を提供します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧
• 非推奨のメンバ

アタッチされたプロパティ

• desktopAvailableHeight : int
• desktopAvailableWidth : int
• devicePixelRatio : real
• height : int
• manufacturer : string
• model : string
• name : string
• orientation : Qt::ScreenOrientation
• pixelDensity : real
• primaryOrientation : Qt::ScreenOrientation
• serialNumber : string
• virtualX : int
• virtualY : int
• width : int

添付のメソッド

• int angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b)

詳細説明

Screen 添付オブジェクトは、コンポーネントのコンストラクタ実行完了後、Item または Item の派生型内で有効になります。これらのアイテム内では、そのアイテムが現在表示されている画面を指します。

このアタッチメントオブジェクトは、コンポーネントの完了後、`Window` または `Window` の派生型内でも有効です。その場合、このオブジェクトは `Window` が作成された画面を指します。ただし、マルチスクリーンのデスクトップコンピュータでは、ユーザーが `Window` を複数の画面にまたがる位置にドラッグして配置できるため、一般的には関連する `Item` から `Screen` にアクセスする方が望ましいです。 その場合、一部のItemは1つの画面にあり、他のItemは別の画面にあることになります。

この型を使用するには、次の行でモジュールをインポートする必要があります。

import QtQuick.Window 2.2

これは、ウィンドウシステムの機能にアクセスできないQML環境でも利用できるようにするための、独立したインポートです。

なお、この時点ではItemやWindowがまだ画面に表示されていないため、Component.onCompletedではScreen型は有効ではありません。

「Qt Quick の例 - WindowとScreen」も参照してください 。

添付プロパティのドキュメント

Screen.desktopAvailableHeight : int [read-only attached]

ここには、タスクバーやシステムメニューなど、ウィンドウマネージャーによって予約されている領域を除いた、仮想デスクトップを構成する一連の画面の利用可能な高さがピクセル単位で指定されています。ウィンドウをデスクトップの下部に配置したい場合は、次のようにバインドすることができます：

y: Screen.desktopAvailableHeight - height

Screen.desktopAvailableWidth : int [read-only attached]

ここには、仮想デスクトップを構成する一連の画面の有効幅（ピクセル単位）が指定されます。ただし、タスクバーやシステムメニューなど、ウィンドウマネージャーによって予約されている領域は除きます。ウィンドウをデスクトップの右側に配置したい場合は、次のようにバインドします：

x: Screen.desktopAvailableWidth - width

Screen.devicePixelRatio : real [read-only attached]

画面における物理ピクセルとデバイス非依存ピクセルの比率。

一般的な値として、通常のディスプレイでは1.0、Appleの「Retina」ディスプレイでは2.0が挙げられます。

Screen.height : int [read-only attached]

ここには、画面の高さ（ピクセル単位）が格納されています。

Screen.manufacturer : string [read-only attached]

そのスクリーンの製造元。

Screen.model : string [read-only attached]

スクリーンのモデル。

Screen.name : string [read-only attached]

画面の名前。

Screen.orientation : Qt::ScreenOrientation [read-only attached]

これには、ウィンドウシステムの観点から見た画面の現在の向きが含まれています。

ほとんどのモバイルデバイスやタブレットコンピュータには加速度センサーが搭載されています。ウィンドウシステムは、デバイスの持ち方に応じて画面全体を自動的に回転させたり、デスクトップモニターの場合は設定を通じて手動で回転させたりすることがあります。その場合、この `orientation ` プロパティの値が変化します。

「 primaryOrientation 」および「QWindow::contentOrientation()」も参照してください 。

Screen.pixelDensity : real [read-only attached]

1ミリメートルあたりの物理ピクセル数。

Screen.primaryOrientation : Qt::ScreenOrientation [read-only attached]

ここには画面の主な向きが格納されています。画面の高さが幅よりも大きい場合、向きは Qt.PortraitOrientation となり、そうでない場合は Qt.LandscapeOrientation となります。

デバイスの向きに応じてレイアウトを変更するアプリケーションを設計する場合、レイアウトを決定するために primaryOrientation を使用することをお勧めします。これは、デスクトップコンピュータでは、たとえ加速度センサーが搭載されていなくても、ユーザーがオペレーティングシステムのコントロールパネルを介して画面を回転させると、primaryOrientation が変更されることが予想されるためです。 同様に、加速度センサーを搭載しているほとんどのハンドヘルドコンピュータでは、オペレーティングシステムが画面全体を自動的に回転させるため、ここでも `primaryOrientation` が変化することがあります。

Screen.serialNumber : string [read-only attached]

画面のシリアル番号。

Screen.virtualX : int [read-only attached]

仮想デスクトップ内の画面のx座標。

Screen.virtualY : int [read-only attached]

仮想デスクトップ内の画面のY座標。

Screen.width : int [read-only attached]

画面の幅（ピクセル単位）が格納されています。

関連するメソッドのドキュメント

[attached] int angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b)

指定された画面の向き `a ` と `b` の間の回転角度（度単位）を返します。