QScreen Class
QScreen 클래스는 화면 속성을 쿼리하는 데 사용됩니다. 더 보기...
| Header: | #include <QScreen> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 상속합니다: | QObject |
속성
|
|
공공 기능
| int | angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b) const |
| QRect | availableGeometry() const |
| QSize | availableSize() const |
| QRect | availableVirtualGeometry() const |
| QSize | availableVirtualSize() const |
| int | depth() const |
| qreal | devicePixelRatio() const |
| QRect | geometry() const |
| QPixmap | grabWindow(WId window = 0, int x = 0, int y = 0, int width = -1, int height = -1) |
| QPlatformScreen * | handle() const |
| bool | isLandscape(Qt::ScreenOrientation o) const |
| bool | isPortrait(Qt::ScreenOrientation o) const |
| qreal | logicalDotsPerInch() const |
| qreal | logicalDotsPerInchX() const |
| qreal | logicalDotsPerInchY() const |
| QString | manufacturer() const |
| QRect | mapBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &rect) const |
| QString | model() const |
| QString | name() const |
| QNativeInterface * | nativeInterface() const |
| Qt::ScreenOrientation | nativeOrientation() const |
| Qt::ScreenOrientation | orientation() const |
| qreal | physicalDotsPerInch() const |
| qreal | physicalDotsPerInchX() const |
| qreal | physicalDotsPerInchY() const |
| QSizeF | physicalSize() const |
| Qt::ScreenOrientation | primaryOrientation() const |
| qreal | refreshRate() const |
| QString | serialNumber() const |
| QSize | size() const |
| QTransform | transformBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &target) const |
| QRect | virtualGeometry() const |
| QScreen * | virtualSiblingAt(QPoint point) |
| QList<QScreen *> | virtualSiblings() const |
| QSize | virtualSize() const |
신호
| void | availableGeometryChanged(const QRect &geometry) |
| void | geometryChanged(const QRect &geometry) |
| void | logicalDotsPerInchChanged(qreal dpi) |
| void | orientationChanged(Qt::ScreenOrientation orientation) |
| void | physicalDotsPerInchChanged(qreal dpi) |
| void | physicalSizeChanged(const QSizeF &size) |
| void | primaryOrientationChanged(Qt::ScreenOrientation orientation) |
| void | refreshRateChanged(qreal refreshRate) |
| void | virtualGeometryChanged(const QRect &rect) |
자세한 설명
논리적 인치당 도트와 물리적 인치당 도트에 대한 참고 사항: 물리적 DPI는 가능한 경우 실제 물리적 픽셀 크기를 기반으로 하며, 인쇄 미리보기 및 화면에 표시되는 콘텐츠의 정확한 물리적 치수를 알고 싶은 경우에 유용합니다.
논리적 인치당 도트는 글꼴 및 사용자 인터페이스 요소를 포인트 크기에서 픽셀 크기로 변환하는 데 사용되며 물리적 인치당 도트 수와 다를 수 있습니다. 논리적 인치당 도트는 데스크톱 환경의 설정 패널에서 사용자가 설정할 수 있어 사용자가 여러 애플리케이션에서 UI 및 글꼴 크기를 전역적으로 제어할 수 있습니다.
참고: 물리적 및 논리적 DPI는 모두 장치에 독립적인 도트로 표현됩니다. QScreen::devicePixelRatio ()를 곱하면 디바이스별 밀도를 구할 수 있습니다.
속성 문서
[read-only] availableGeometry : const QRect
이 속성은 화면의 사용 가능한 지오메트리를 픽셀 단위로 저장합니다.
사용 가능한 지오메트리는 작업 표시줄 및 시스템 메뉴와 같은 창 관리자 예약 영역을 제외한 지오메트리입니다.
X11에서는 모니터가 하나이고 창 관리자가 _NET_WORKAREA 아톰을 설정한 시스템에서만 실제 사용 가능한 지오메트리가 반환된다는 점에 유의하세요. 다른 모든 경우에는 geometry()와 같습니다. 이는 X11 창 관리자 사양의 제한 사항입니다.
함수 액세스:
| QRect | availableGeometry() const |
알림 신호:
| void | availableGeometryChanged(const QRect &geometry) |
[read-only] availableSize : const QSize
이 속성은 화면의 사용 가능한 크기를 픽셀 단위로 저장합니다.
사용 가능한 크기는 작업 표시줄 및 시스템 메뉴와 같은 창 관리자 예약 영역을 제외한 크기입니다.
액세스 기능:
| QSize | availableSize() const |
알림 신호:
| void | availableGeometryChanged(const QRect &geometry) |
[read-only] availableVirtualGeometry : const QRect
이 프로퍼티는 이 화면이 속한 가상 데스크톱의 사용 가능한 지오메트리를 보유합니다.
이 화면에 해당하는 가상 데스크톱의 사용 가능한 지오메트리를 반환합니다.
이것은 가상 형제의 개별 사용 가능한 지오메트리의 합입니다.
함수에 액세스합니다:
| QRect | availableVirtualGeometry() const |
알림 신호:
| void | virtualGeometryChanged(const QRect &rect) |
availableGeometry() 및 virtualSiblings()도 참조하세요 .
[read-only] availableVirtualSize : const QSize
이 속성은 이 화면이 속한 가상 데스크톱의 사용 가능한 크기를 보유합니다.
이 화면에 해당하는 가상 데스크톱의 사용 가능한 픽셀 크기를 반환합니다.
이 크기는 가상 형제의 개별 사용 가능한 지오메트리의 합산 크기입니다.
기능에 액세스합니다:
| QSize | availableVirtualSize() const |
알림 신호:
| void | virtualGeometryChanged(const QRect &rect) |
availableSize() 및 virtualSiblings()도 참조하세요 .
[read-only] depth : const int
이 속성은 화면의 색 농도를 유지합니다.
함수에 액세스합니다:
| int | depth() const |
[read-only] devicePixelRatio : const qreal
이 속성은 화면의 물리적 픽셀과 디바이스 독립 픽셀 간의 비율을 보유합니다.
화면의 물리적 픽셀과 디바이스 독립 픽셀 사이의 비율을 반환합니다.
일반적인 값은 일반 디스플레이의 경우 1.0, '망막' 디스플레이의 경우 2.0입니다. 더 높은 값도 가능합니다.
액세스 기능:
| qreal | devicePixelRatio() const |
알림 신호:
| void | physicalDotsPerInchChanged(qreal dpi) |
QWindow::devicePixelRatio() 및 QGuiApplication::devicePixelRatio()도 참조하세요 .
[read-only] geometry : const QRect
이 속성은 화면의 지오메트리를 픽셀 단위로 보유합니다.
예를 들어 QRect(0, 0, 1280, 1024)를 반환하거나 가상 데스크톱 설정에서는 QRect(1280, 0, 1280, 1024)를 반환할 수 있습니다.
기능에 액세스합니다:
| QRect | geometry() const |
알림 신호:
| void | geometryChanged(const QRect &geometry) |
[read-only] logicalDotsPerInch : const qreal
이 속성은 인치당 논리적 도트 또는 픽셀 수를 보유합니다.
이 값은 글꼴 포인트 크기를 픽셀 크기로 변환하는 데 사용할 수 있습니다.
이 속성은 logicalDotsPerInchX 및 logicalDotsPerInchY 속성의 평균값인 편의용 속성입니다.
액세스 기능:
| qreal | logicalDotsPerInch() const |
알림 신호:
| void | logicalDotsPerInchChanged(qreal dpi) |
logicalDotsPerInchX() 및 logicalDotsPerInchY()도 참조하세요 .
[read-only] logicalDotsPerInchX : const qreal
이 속성은 가로 방향의 인치당 논리적 점 또는 픽셀 수를 보유합니다.
이 값은 글꼴 포인트 크기를 픽셀 크기로 변환하는 데 사용됩니다.
함수에 액세스합니다:
| qreal | logicalDotsPerInchX() const |
알림 신호:
| void | logicalDotsPerInchChanged(qreal dpi) |
logicalDotsPerInchY()도 참조하세요 .
[read-only] logicalDotsPerInchY : const qreal
이 속성은 세로 방향의 인치당 논리적 도트 또는 픽셀 수를 보유합니다.
이 값은 글꼴 포인트 크기를 픽셀 크기로 변환하는 데 사용됩니다.
함수에 액세스합니다:
| qreal | logicalDotsPerInchY() const |
알림 신호:
| void | logicalDotsPerInchChanged(qreal dpi) |
logicalDotsPerInchX()도 참조하세요 .
[read-only] manufacturer : const QString
이 속성은 화면의 제조업체를 보유합니다.
액세스 함수입니다:
| QString | manufacturer() const |
[read-only] model : const QString
이 속성은 화면의 모델을 보유합니다.
액세스 함수를 저장합니다:
| QString | model() const |
[read-only] name : const QString
이 프로퍼티는 화면을 나타내는 사용자 표시 가능 문자열을 보유합니다.
예를 들어, X11에서는 일반적으로 "VGA1", "HDMI1" 등의 XRandr 화면 이름에 해당합니다.
참고: 사용자 표시 가능 문자열은 네이티브 API의 결과와 일치한다는 보장이 없으므로 화면을 고유하게 식별하는 데 사용해서는 안 됩니다.
기능 액세스:
| QString | name() const |
[read-only] nativeOrientation : const Qt::ScreenOrientation
이 속성은 기본 화면 방향을 보유합니다.
화면의 기본 방향은 디바이스의 로고 스티커가 올바른 방향으로 표시되는 방향 또는 플랫폼에서 이 기능을 지원하지 않는 경우 Qt::PrimaryOrientation 입니다.
기본 방향은 하드웨어의 속성이며 변경되지 않습니다.
기능 액세스:
| Qt::ScreenOrientation | nativeOrientation() const |
[read-only] orientation : const Qt::ScreenOrientation
이 속성은 화면 방향을 유지합니다.
orientation 속성은 창 시스템 관점에서 화면의 방향을 알려줍니다.
대부분의 모바일 장치와 태블릿 컴퓨터에는 가속도계 센서가 포함되어 있습니다. Qt Sensors 모듈은 이 센서를 직접 읽을 수 있는 기능을 제공합니다. 그러나 창 시스템은 화면이 유지되는 방식에 따라 전체 화면을 자동으로 회전할 수 있으며, 이 경우 orientation 속성이 변경됩니다.
액세스 기능:
| Qt::ScreenOrientation | orientation() const |
알림 신호:
| void | orientationChanged(Qt::ScreenOrientation orientation) |
primaryOrientation() 및 QWindow::contentOrientation()도 참조하세요 .
[read-only] physicalDotsPerInch : const qreal
이 속성은 인치당 물리적 도트 또는 픽셀 수를 보유합니다.
이 값은 화면 디스플레이의 픽셀 밀도를 나타냅니다. 기본 시스템이 제공하는 정보에 따라 값이 완전히 정확하지 않을 수 있습니다.
이 값은 physicalDotsPerInchX 및 physicalDotsPerInchY 속성의 평균인 편의상 속성입니다.
참고: 물리적 DPI는 디바이스와 무관한 점으로 표시됩니다. QScreen::devicePixelRatio ()를 곱하면 디바이스별 밀도를 구할 수 있습니다.
함수에 액세스합니다:
| qreal | physicalDotsPerInch() const |
알림 신호:
| void | physicalDotsPerInchChanged(qreal dpi) |
physicalDotsPerInchX() 및 physicalDotsPerInchY()도 참조하세요 .
[read-only] physicalDotsPerInchX : const qreal
이 속성은 가로 방향의 인치당 물리적 도트 수 또는 픽셀 수를 보유합니다.
이 값은 화면 디스플레이의 실제 수평 픽셀 밀도를 나타냅니다. 기본 시스템이 제공하는 정보에 따라 값이 완전히 정확하지 않을 수 있습니다.
참고: 물리적 DPI는 장치에 독립적인 점으로 표시됩니다. QScreen::devicePixelRatio ()를 곱하면 디바이스별 밀도를 구할 수 있습니다.
기능에 액세스합니다:
| qreal | physicalDotsPerInchX() const |
알림 신호:
| void | physicalDotsPerInchChanged(qreal dpi) |
physicalDotsPerInchY()도 참조하세요 .
[read-only] physicalDotsPerInchY : const qreal
이 속성은 수직 방향의 인치당 물리적 도트 또는 픽셀 수를 보유합니다.
이 값은 화면 디스플레이의 실제 수직 픽셀 밀도를 나타냅니다. 기본 시스템이 제공하는 정보에 따라 값이 완전히 정확하지 않을 수 있습니다.
참고: 물리적 DPI는 장치에 독립적인 점으로 표시됩니다. QScreen::devicePixelRatio ()를 곱하면 디바이스별 밀도를 구할 수 있습니다.
기능에 액세스합니다:
| qreal | physicalDotsPerInchY() const |
알림 신호:
| void | physicalDotsPerInchChanged(qreal dpi) |
physicalDotsPerInchX()도 참조하세요 .
[read-only] physicalSize : const QSizeF
이 속성은 화면의 물리적 크기(밀리미터)를 보유합니다.
물리적 크기는 화면 디스플레이의 실제 물리적 치수를 나타냅니다.
기본 시스템이 제공하는 정보에 따라 값이 완전히 정확하지 않을 수 있습니다.
액세스 기능:
| QSizeF | physicalSize() const |
알림 신호:
| void | physicalSizeChanged(const QSizeF &size) |
[read-only] primaryOrientation : const Qt::ScreenOrientation
이 속성은 기본 화면 방향을 유지합니다.
기본 화면 방향은 화면 지오메트리의 너비가 높이보다 크거나 같으면 Qt::LandscapeOrientation, 그렇지 않으면 Qt::PortraitOrientation 입니다. 이 속성은 화면 방향이 변경될 때(즉, 디스플레이가 회전될 때) 변경될 수 있습니다. 그러나 이 동작은 플랫폼에 따라 다르며 애플리케이션 매니페스트 파일에서 지정할 수 있는 경우가 많습니다.
액세스 기능:
| Qt::ScreenOrientation | primaryOrientation() const |
알림 신호:
| void | primaryOrientationChanged(Qt::ScreenOrientation orientation) |
[read-only] refreshRate : const qreal
이 속성은 화면의 대략적인 수직 재생률(Hz)을 보유합니다.
경고: QChronoTimer 와 같은 타이머를 통해 애니메이션을 구동하는 데 화면의 새로 고침 빈도를 사용하지 마세요. 대신 QWindow::requestUpdate()를 사용하십시오.
기능에 액세스합니다:
| qreal | refreshRate() const |
알림 신호:
| void | refreshRateChanged(qreal refreshRate) |
QWindow::requestUpdate()도 참조하세요 .
[read-only] serialNumber : const QString
이 속성에는 화면의 일련 번호가 저장됩니다.
액세스 함수를 저장합니다:
| QString | serialNumber() const |
[read-only] size : const QSize
이 속성은 화면의 픽셀 해상도를 보유합니다.
액세스 함수:
| QSize | size() const |
알림 신호:
| void | geometryChanged(const QRect &geometry) |
[read-only] virtualGeometry : const QRect
이 속성은 이 화면이 속한 가상 데스크톱의 픽셀 지오메트리를 보유합니다.
이 화면에 해당하는 가상 데스크톱의 픽셀 지오메트리를 반환합니다.
이것은 가상 형제의 개별 지오메트리를 합친 것입니다.
함수에 액세스합니다:
| QRect | virtualGeometry() const |
알림 신호:
| void | virtualGeometryChanged(const QRect &rect) |
virtualSiblings()도 참조하세요 .
[read-only] virtualSize : const QSize
이 속성은 이 화면이 속한 가상 데스크톱의 픽셀 크기를 보유합니다.
이 화면에 해당하는 가상 데스크톱의 픽셀 크기를 반환합니다.
이 크기는 가상 형제의 개별 지오메트리를 합친 크기입니다.
함수에 액세스합니다:
| QSize | virtualSize() const |
알림 신호:
| void | virtualGeometryChanged(const QRect &rect) |
virtualSiblings()도 참조하세요 .
멤버 함수 문서
int QScreen::angleBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b) const
회전 a 에서 회전 b 으로 가기 위한 회전 각도를 계산하는 편의 기능입니다.
결과는 0, 90, 180 또는 270이 됩니다.
Qt::PrimaryOrientation 는 화면의 primaryOrientation()로 해석됩니다.
QPixmap QScreen::grabWindow(WId window = 0, int x = 0, int y = 0, int width = -1, int height = -1)
QRect(x, y, width, height)에 의해 제한되는 주어진 window 의 콘텐츠를 가져와서 구성된 픽셀맵을 생성하고 반환합니다. window 가 0이면 전체 화면이 캡처됩니다.
인자 (x, y)는 창에서 오프셋을 지정하고 (width, height)는 복사할 영역을 지정합니다. width 이 음수이면 함수는 모든 내용을 창의 오른쪽 테두리로 복사합니다. height 이 음수이면 함수는 모든 것을 창 하단으로 복사합니다.
오프셋 및 크기 인수는 디바이스 독립 픽셀로 지정됩니다. 높은 DPI 화면에서 가져올 경우 반환되는 픽셀맵이 요청된 크기보다 클 수 있습니다. QPixmap::devicePixelRatio ()를 호출하여 이 경우인지 확인하세요.
창 시스템 식별자(WId)는 QWidget::winId() 함수를 사용하여 검색할 수 있습니다. QWidget 이 아닌 창 식별자를 사용하는 이유는 애플리케이션의 일부가 아닌 창, 창 시스템 프레임 등을 캡처할 수 있도록 하기 위해서입니다.
경고: 샌드박싱/보안이 애플리케이션이 소유하지 않은 창의 픽셀을 읽지 못하게 하는 iOS와 같은 시스템에서는 애플리케이션의 일부가 아닌 창을 잡는 기능이 지원되지 않습니다.
grabWindow() 함수는 창이 아닌 화면에서 픽셀을 가져옵니다. 즉, 잡는 창 위에 다른 창이 부분적으로 또는 전체적으로 있는 경우, 그 위에 있는 창에서도 픽셀을 가져옵니다. 마우스 커서는 일반적으로 잡히지 않습니다.
X11에서 주어진 window 의 깊이가 루트 창과 같지 않고 다른 창이 잡는 창을 부분적으로 또는 전체적으로 가리는 경우 위쪽 창에서 픽셀을 가져오지 못한다는 점에 유의하세요. 픽셀맵에서 가려진 영역의 내용은 정의되지 않고 초기화되지 않습니다.
Windows Vista 이상에서는 Qt::WA_TranslucentBackground 속성을 설정하여 만든 레이어 창을 잡는 것이 작동하지 않습니다. 대신 데스크톱 위젯을 잡으면 작동합니다.
경고: 일반적으로 화면 외부의 영역을 잡는 것은 안전하지 않습니다. 이는 기본 창 시스템에 따라 다릅니다.
QPlatformScreen *QScreen::handle() const
플랫폼 화면 핸들을 가져옵니다.
Qt 플랫폼 추상화(QPA)도 참조하십시오 .
bool QScreen::isLandscape(Qt::ScreenOrientation o) const
o 이 가로 또는 반전 가로인 경우 true 을 반환하고, 그렇지 않으면 false 을 반환하는 편의 함수입니다.
Qt::PrimaryOrientation 는 화면의 primaryOrientation()로 해석됩니다.
bool QScreen::isPortrait(Qt::ScreenOrientation o) const
o 이 세로 또는 반전 세로인 경우 true 을 반환하고, 그렇지 않으면 false 을 반환하는 편의 함수입니다.
Qt::PrimaryOrientation 는 화면의 primaryOrientation()로 해석됩니다.
QRect QScreen::mapBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &rect) const
두 화면 방향 사이에 직사각형을 매핑합니다.
방향 a 이 Qt::PortraitOrientation 또는 Qt::InvertedPortraitOrientation 이고 방향 b 이 Qt::LandscapeOrientation 또는 Qt::InvertedLandscapeOrientation 인 경우 사각형 rect 의 x 및 y 치수가 뒤집히거나 그 반대의 경우도 마찬가지입니다.
Qt::PrimaryOrientation 는 화면의 primaryOrientation()로 해석됩니다.
template <typename QNativeInterface> QNativeInterface *QScreen::nativeInterface() const
화면에 대해 지정된 유형의 네이티브 인터페이스를 반환합니다.
이 함수는 QNativeInterface 네임스페이스에 정의된 QScreen 의 플랫폼별 기능에 대한 액세스를 제공합니다:
화면에 대한 네이티브 인터페이스 | |
Wayland의 화면에 대한 네이티브 인터페이스 | |
화면에 대한 기본 인터페이스 |
요청된 인터페이스를 사용할 수 없는 경우 nullptr 이 반환됩니다.
[signal] void QScreen::orientationChanged(Qt::ScreenOrientation orientation)
이 신호는 orientation 인수를 사용하여 화면의 방향이 변경될 때 발생합니다.
참고: orientation 속성에 대한 알림 신호입니다.
orientation()도 참조하세요 .
[signal] void QScreen::primaryOrientationChanged(Qt::ScreenOrientation orientation)
이 신호는 orientation 인수를 사용하여 화면의 기본 방향이 변경될 때 발생합니다.
참고: primaryOrientation 속성에 대한 알림 신호입니다.
primaryOrientation()도 참조하세요 .
QTransform QScreen::transformBetween(Qt::ScreenOrientation a, Qt::ScreenOrientation b, const QRect &target) const
방향 a 으로 정의된 좌표계에서 방향 b 과 대상 치수 target 로 정의된 좌표계로 매핑하는 변환을 계산하는 편의 함수입니다.
예를 들어 a 은 Qt::Landscape, b 은 Qt::Portrait, target 은 QRect(0, 0, w, h)인 경우 결과 변환은 점 QPoint(0, 0)이 QPoint(0, w)에 매핑되고 QPoint(h, w)가 QPoint(0, h)에 매핑되는 식으로 이루어집니다. 따라서 가로 좌표계 QRect(0, 0, h, w)는 세로 좌표계 QRect(0, 0, w, h)에 매핑됩니다(90도 회전).
Qt::PrimaryOrientation 는 화면의 primaryOrientation()로 해석됩니다.
QScreen *QScreen::virtualSiblingAt(QPoint point)
QScreen::virtualSiblings() 세트 내에서 point 또는 화면 외부의 경우 nullptr 에서 화면을 반환합니다.
point 은 각 가상 형제 집합의 virtualGeometry()과 관련되어 있습니다.
QList<QScreen *> QScreen::virtualSiblings() const
화면의 가상 형제자매를 가져옵니다.
가상 형제자매는 동일한 가상 데스크톱을 공유하는 화면 인스턴스입니다. 이들은 공통 좌표계를 공유하므로 다시 만들 필요 없이 창을 자유롭게 이동하거나 배치할 수 있습니다.
© 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.
