このページでは

Screen QML Type

Screen attachedオブジェクトは、アイテムまたはウィンドウが表示されているスクリーンに関する情報を提供します。詳細...

Import Statement: import QtQuick

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

付属メソッド

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

詳細説明

Screenアタッチオブジェクトは、コンポーネント完了後のItemまたはItem派生型の内部で有効である。これらのアイテムの内部では、アイテムが現在表示されている画面を参照します。

アタッチされたオブジェクトは、コンポーネント完了後、WindowまたはWindow派生型の内部でも有効です。この場合、Windowが作成された画面を参照します。マルチスクリーンのデスクトップコンピュータでは、ユーザはWindowを複数のスクリーンにまたがる位置にドラッグすることができるからです。この場合、あるアイテムは1つのスクリーンに、他のアイテムは別のスクリーンに表示されます。

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

import QtQuick.Window 2.2

これは、ウィンドウシステムの機能にアクセスすることなくQML環境を持つことができるようにするための独立したインポートです。

ScreenタイプはComponent.onCompletedの時点では無効であることに注意してください。

Qt Quick Examples - Window and Screenも参照してください

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

Screen.desktopAvailableHeight : int [read-only]

タスクバーやシステムメニューのようなウィンドウマネージャが予約した領域を除いた、仮想デスクトップを構成するスクリーンの集合の利用可能な高さがピクセル単位で格納されます。ウィンドウをデスクトップの一番下に配置したい場合は、次のようにバインドします:

y: Screen.desktopAvailableHeight - height

Screen.desktopAvailableWidth : int [read-only]

タスクバーやシステムメニューのようなウィンドウマネージャが予約した領域を除いた、仮想デスクトップを構成するスクリーンの集合の利用可能な幅がピクセル単位で格納されます。ウィンドウをデスクトップの右側に配置したい場合は、次のようにバインドします:

x: Screen.desktopAvailableWidth - width

Screen.devicePixelRatio : real [read-only]

スクリーンの物理ピクセルとデバイスに依存しないピクセルの比率。

一般的な値は、通常のディスプレイでは1.0、アップルの「retina」ディスプレイでは2.0。

Screen.height : int [read-only]

画面の高さをピクセル単位で指定する。

Screen.manufacturer : string [read-only]

スクリーンの製造元。

Screen.model : string [read-only]

スクリーンのモデル。

Screen.name : string [read-only]

画面の名前。

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

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

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

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

Screen.pixelDensity : real [read-only]

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

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

画面の主な向きを表します。画面の高さが幅より大きい場合はQt.PortraitOrientation、そうでない場合はQt.LandscapeOrientationになります。

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

Screen.serialNumber : string [read-only]

スクリーンのシリアル番号。

Screen.virtualX : int [read-only]

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

Screen.virtualY : int [read-only]

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

Screen.width : int [read-only]

画面の幅をピクセル単位で指定します。

添付メソッドのドキュメント

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

指定された画面の向きab の間の回転角度を度単位で返す。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.