QScreen Class

속성 설명서

[read-only] availableGeometry : QRect

이 속성은 화면의 사용 가능한 지오메트리를 픽셀 단위로 저장합니다.

사용 가능한 지오메트리는 작업 표시줄이나 시스템 메뉴와 같이 창 관리자가 예약한 영역을 제외한 지오메트리입니다.

참고: X11 환경에서 이 함수는 모니터가 하나뿐인 시스템에서, 그리고 윈도우 매니저가 _NET_WORKAREA 아톰을 설정한 경우에만 실제 사용 가능한 지오메트리를 반환합니다. 그 외의 모든 경우에는 이 값이 ` geometry()`와 동일합니다. 이는 X11 윈도우 매니저 사양의 제한 사항입니다.

액세스 함수:

알림 신호:

[read-only] availableSize : QSize

이 속성은 화면의 사용 가능한 크기를 픽셀 단위로 저장합니다.

사용 가능한 크기는 작업 표시줄 및 시스템 메뉴와 같이 창 관리자가 예약한 영역을 제외한 크기를 의미합니다.

액세스 함수:

알림 신호:

[read-only] availableVirtualGeometry : QRect

이 속성은 이 화면이 속한 가상 데스크톱의 사용 가능한 지오메트리를 포함합니다.

이 화면에 해당하는 가상 데스크톱의 사용 가능한 지오메트리를 반환합니다.

이는 가상 형제 데스크톱들의 개별 사용 가능한 지오메트리들의 합집합입니다.

액세스 함수:

알림 신호:

availableGeometry() 및 virtualSiblings()도 참조하십시오 .

[read-only] availableVirtualSize : QSize

이 속성은 이 화면이 속한 가상 데스크톱의 사용 가능한 크기를 나타냅니다.

이 화면에 해당하는 가상 데스크톱의 사용 가능한 픽셀 크기를 반환합니다.

이는 가상 형제 창들의 개별 사용 가능한 지오메트리 크기를 합친 것입니다.

액세스 함수:

알림 신호:

availableSize() 및 virtualSiblings()도 참조하십시오 .

[read-only] depth : const int

이 속성은 화면의 색상 심도를 나타냅니다.

액세스 함수:

[read-only] devicePixelRatio : qreal

이 속성은 화면의 물리적 픽셀과 장치 독립 픽셀 간의 비율을 나타냅니다.

화면의 물리적 픽셀과 장치 독립 픽셀 간의 비율을 반환합니다.

이 함수는 예를 들어 Wayland에서 소수점 스케일링을 사용하거나, 표면 해상도에 영향을 미치는 창 속성이 설정된 경우 등, ` QWindow::devicePixelRatio()`와 다른 값을 반환할 수 있습니다. 대신 ` QWindow::devicePixelRatio()`를 사용하는 것이 좋습니다.

액세스 함수:

Notifier 시그널:

QWindow::devicePixelRatio() 및 QGuiApplication::devicePixelRatio()도 참조하십시오 .

[read-only] geometry : QRect

이 속성은 화면의 기하학적 정보를 픽셀 단위로 저장합니다.

예를 들어, 이 속성은 QRect(0, 0, 1280, 1024)를 반환하거나, 가상 데스크톱 환경에서는 QRect(1280, 0, 1280, 1024)를 반환할 수 있습니다.

액세스 함수:

Notifier 신호:

[read-only] logicalDotsPerInch : qreal

이 속성은 인치당 논리 도트 수 또는 픽셀 수를 나타냅니다.

이 값을 사용하여 글꼴 포인트 크기를 픽셀 크기로 변환할 수 있습니다.

이 속성은 ' logicalDotsPerInchX ' 및 ' logicalDotsPerInchY ' 속성의 평균값을 반환하는 편의 속성입니다.

액세스 함수:

알림 신호:

logicalDotsPerInchX() 및 logicalDotsPerInchY()도 참조하십시오 .

[read-only] logicalDotsPerInchX : qreal

이 속성은 수평 방향의 인치당 논리 도트 수 또는 픽셀 수를 나타냅니다.

이 값은 글꼴 포인트 크기를 픽셀 크기로 변환하는 데 사용됩니다.

액세스 함수:

알림 신호:

logicalDotsPerInchY()도 참조하십시오 .

[read-only] logicalDotsPerInchY : qreal

이 속성은 수직 방향의 인치당 논리 도트 수 또는 픽셀 수를 나타냅니다.

이 값은 글꼴 포인트 크기를 픽셀 크기로 변환하는 데 사용됩니다.

액세스 함수:

알림 신호:

logicalDotsPerInchX()도 참조하십시오 .

[read-only] manufacturer : const QString

이 속성은 화면의 제조사를 나타냅니다

액세스 기능:

[read-only] model : const QString

이 속성은 화면의 모델을 저장합니다

액세스 기능:

[read-only] name : const QString

이 속성은 화면을 나타내는, 사용자가 확인할 수 있는 문자열을 포함합니다.

예를 들어, X11 환경에서는 이 값이 XRandr 화면 이름(일반적으로 "VGA1", "HDMI1" 등)과 일치합니다.

액세스 함수:

[read-only] nativeOrientation : Qt::ScreenOrientation

이 속성은 기기의 기본 화면 방향을 나타냅니다.

화면의 기본 방향이란 기기의 로고 스티커가 올바른 방향으로 표시되는 방향을 말하며, 플랫폼에서 이 기능을 지원하지 않는 경우에는 Qt::PrimaryOrientation 를 의미합니다.

기본 방향은 하드웨어의 속성이며 변경되지 않습니다.

접근 기능:

[read-only] orientation : Qt::ScreenOrientation

이 속성은 화면 방향을 나타냅니다.

orientation 속성은 윈도우 시스템의 관점에서 본 화면의 방향을 나타냅니다.

대부분의 모바일 기기와 태블릿 컴퓨터에는 가속도계 센서가 탑재되어 있습니다. ` Qt Sensors ` 모듈은 이 센서의 값을 직접 읽어올 수 있는 기능을 제공합니다. 그러나 윈도우 시스템은 기기를 잡은 방식에 따라 화면 전체를 자동으로 회전시킬 수 있으며, 이 경우 ` orientation ` 속성의 값이 변경됩니다.

액세스 함수:

알림 신호:

primaryOrientation() 및 QWindow::contentOrientation()도 참조하십시오 .

[read-only] physicalDotsPerInch : qreal

이 속성은 인치당 물리적 도트 또는 픽셀 수를 나타냅니다.

이 값은 화면의 픽셀 밀도를 나타냅니다. 기본 시스템에서 제공하는 정보에 따라 이 값이 완전히 정확하지 않을 수도 있습니다.

이 속성은 편의상 제공되는 것으로, 단순히 ‘ physicalDotsPerInchX ’ 및 ‘ physicalDotsPerInchY ’ 속성의 평균값입니다.

액세스 함수:

알림 신호:

physicalDotsPerInchX() 및 physicalDotsPerInchY()도 참조하십시오 .

[read-only] physicalDotsPerInchX : qreal

이 속성은 수평 방향의 인치당 물리적 도트 또는 픽셀 수를 나타냅니다.

이 값은 화면 디스플레이의 실제 수평 픽셀 밀도를 나타냅니다. 기본 시스템이 제공하는 정보에 따라 이 값이 완전히 정확하지 않을 수도 있습니다.

액세스 함수:

알림 신호:

physicalDotsPerInchY()도 참조하십시오 .

[read-only] physicalDotsPerInchY : qreal

이 속성은 수직 방향의 인치당 물리적 도트 또는 픽셀 수를 나타냅니다.

이 값은 화면 디스플레이의 실제 수직 픽셀 밀도를 나타냅니다. 기본 시스템이 제공하는 정보에 따라 이 값이 완전히 정확하지 않을 수도 있습니다.

액세스 함수:

알림 신호:

physicalDotsPerInchX()도 참조하십시오 .

[read-only] physicalSize : QSizeF

이 속성은 화면의 물리적 크기(밀리미터 단위)를 나타냅니다.

물리적 크기는 화면 디스플레이의 실제 물리적 치수를 나타냅니다.

기본 시스템이 제공하는 정보에 따라 이 값이 완전히 정확하지 않을 수도 있습니다.

액세스 함수:

알림 신호:

[read-only] primaryOrientation : Qt::ScreenOrientation

이 속성은 기본 화면 방향을 나타냅니다.

주 화면 방향은 화면 기하 구조의 너비가 높이보다 크거나 같을 경우 ` Qt::LandscapeOrientation `이며, 그 외의 경우에는 ` Qt::PortraitOrientation `입니다. 이 속성은 화면 방향이 변경될 때(즉, 디스플레이가 회전될 때) 변경될 수 있습니다. 그러나 이 동작은 플랫폼에 따라 다르며, 종종 애플리케이션 매니페스트 파일에서 지정할 수 있습니다.

액세스 함수:

Notifier 신호:

[read-only] refreshRate : qreal

이 속성은 화면의 대략적인 수직 재생 빈도(Hz)를 나타냅니다.

액세스 함수:

Notifier 신호:

참조: QWindow::requestUpdate().

[read-only] serialNumber : const QString

이 속성에는 화면의 일련번호가 저장됩니다

사용 가능한 기능:

[read-only] size : QSize

이 속성은 화면의 픽셀 해상도를 나타냅니다.

액세스 함수:

알림 신호:

[read-only] virtualGeometry : QRect

이 속성은 이 화면이 속한 가상 데스크톱의 픽셀 지오메트리를 포함합니다.

이 화면에 해당하는 가상 데스크톱의 픽셀 지오메트리를 반환합니다.

이는 가상 형제 데스크톱들의 개별 지오메트리를 합친 것입니다.

액세스 함수:

알림 신호:

virtualSiblings()도 참조하십시오 .

[read-only] virtualSize : QSize

이 속성은 이 화면이 속한 가상 데스크톱의 픽셀 크기를 나타냅니다.

이 화면에 해당하는 가상 데스크톱의 픽셀 크기를 반환합니다.

이는 가상 형제 데스크톱들의 개별 지오메트리 크기를 합산한 것입니다.

액세스 함수:

알림 신호:

virtualSiblings()도 참조하십시오 .