Screen QML Type

화면 첨부 객체는 항목 또는 창이 표시되는 화면에 대한 정보를 제공합니다. 더 보기...

Import Statement: import QtQuick

첨부된 속성

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)

상세 설명

화면 첨부 객체는 컴포넌트 완료 후 아이템 또는 아이템 파생 유형 내에서 유효합니다. 이러한 항목 내부에서는 항목이 현재 표시되고 있는 화면을 나타냅니다.

첨부된 객체는 컴포넌트 완료 후 창 또는 창 파생 유형 내부에서도 유효합니다. 이 경우 창이 생성된 화면을 가리킵니다. 멀티스크린 데스크톱 컴퓨터에서는 사용자가 창을 여러 화면에 걸쳐 있는 위치로 드래그할 수 있으므로 일반적으로 관련 항목에서 화면에 액세스하는 것이 더 좋습니다. 이 경우 일부 항목은 한 화면에 표시되고 다른 항목은 다른 화면에 표시됩니다.

이 유형을 사용하려면 다음 줄을 사용하여 모듈을 가져와야 합니다:

import QtQuick.Window 2.2

창 시스템 기능에 액세스하지 않고도 QML 환경을 사용할 수 있도록 하기 위한 별도의 가져오기입니다.

이때까지 항목 또는 창이 화면에 표시되지 않았기 때문에 Component.onCompleted에서는 Screen 유형이 유효하지 않습니다.

Qt Quick 예제 - 창 및 화면을참조하십시오 .

첨부된 속성 문서

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, Apple '망막' 디스플레이에서는 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]

밀리미터당 물리적 픽셀 수입니다.

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

여기에는 화면의 기본 방향이 포함됩니다. 화면의 높이가 너비보다 크면 방향은 Qt.PortraitOrientation이고, 그렇지 않으면 Qt.LandscapeOrientation입니다.

디바이스 방향에 따라 레이아웃이 변경되는 애플리케이션을 디자인하는 경우, 레이아웃을 결정하기 위해 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)

지정된 화면 방향 a 과 b 사이의 회전 각도(도)를 반환합니다.

© 2025 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.