QWindow Class

멤버 함수 문서

[explicit] QWindow::QWindow(QScreen *targetScreen = nullptr)

targetScreen 에 최상위 레벨로 창을 만듭니다.

setVisible(true), show() 등을 호출할 때까지 창이 표시되지 않습니다.

setScreen()도 참조하세요 .

[explicit] QWindow::QWindow(QWindow *parent)

주어진 parent 창의 자식으로 창을 만듭니다.

창은 부모 창 안에 포함되며, 좌표는 부모를 기준으로 합니다.

화면은 부모로부터 상속됩니다.

setParent()도 참조하세요 .

[virtual noexcept] QWindow::~QWindow()

창을 파괴합니다.

[slot] void QWindow::alert(int msec)

msec 밀리초 동안 알림을 표시합니다. msec (기본값)이 0 인 경우 창이 다시 활성화될 때까지 알림이 무기한 표시됩니다. 이 기능은 활성 창에는 영향을 미치지 않습니다.

경고 상태에서는 창이 깜박이거나 작업 표시줄 항목이 튕기는 등의 방법으로 주의가 필요하다는 것을 나타냅니다.

QSize QWindow::baseSize() const

창의 기본 크기를 반환합니다.

setBaseSize()도 참조하세요 .

[slot] bool QWindow::close()

창을 닫습니다.

그러면 창이 닫히면서 destroy()가 호출되고 애플리케이션이 종료될 수 있습니다. 성공하면 true 을 반환하고, 상위 창이 있는 경우 false를 반환합니다(이 경우 최상위 창이 대신 닫혀야 합니다).

destroy(), QGuiApplication::quitOnLastWindowClosed() 및 closeEvent()도 참조하세요 .

[virtual protected] void QWindow::closeEvent(QCloseEvent *ev)

닫기 이벤트를 처리하려면 이 함수를 재정의합니다(ev).

이 함수는 창을 닫으라는 요청이 있을 때 호출됩니다. 창이 닫히지 않도록 하려면 이벤트에서 QEvent::ignore()를 호출하세요.

close()도 참조하세요 .

void QWindow::create()

창과 관련된 플랫폼 리소스를 할당합니다.

이 시점에서 setFormat()를 사용하여 설정한 서페이스 형식이 실제 네이티브 서페이스로 확인됩니다. 그러나 setVisible()가 호출될 때까지 창은 숨겨진 상태로 유지됩니다.

이 함수는 show(), setVisible(), winId() 및 플랫폼 리소스에 액세스해야 하는 다른 함수에 의해 암시적으로 호출되므로 일반적으로 직접 호출할 필요는 없습니다.

필요한 경우 destroy()를 호출하여 플랫폼 리소스를 해제하세요.

destroy()도 참조하세요 .

QCursor QWindow::cursor() const

이 창의 커서 모양

setCursor() 및 unsetCursor()도 참조하세요 .

void QWindow::destroy()

이 창과 관련된 기본 플랫폼 리소스를 해제합니다.

create()도 참조하세요 .

qreal QWindow::devicePixelRatio() const

창의 물리적 픽셀과 디바이스 독립 픽셀 사이의 비율을 반환합니다. 이 값은 창이 표시되는 화면에 따라 달라지며 창을 이동하면 변경될 수 있습니다.

일반적인 값은 일반 디스플레이의 경우 1.0, Apple '레티나' 디스플레이의 경우 2.0입니다.

QScreen::devicePixelRatio()도 참조하세요 .

[override virtual protected] bool QWindow::event(QEvent *ev)

다시 구현합니다: QObject::event(QEvent *e).

창으로 전송된 모든 이벤트(ev)를 처리하려면 이 함수를 재정의합니다. 이벤트가 인식되어 처리되면 true 을 반환합니다.

마우스 이벤트, 키 이벤트, 크기 조정 이벤트 등이 평소처럼 전송되도록 하려면 베이스 클래스 버전을 호출하는 것을 잊지 마세요.

[virtual protected] void QWindow::exposeEvent(QExposeEvent *ev)

노출 이벤트(ev)는 창이 노출되지 않은 상태와 노출된 상태 사이를 이동할 때 창 시스템에서 전송합니다.

노출된 창은 사용자에게 표시될 가능성이 있습니다. 창이 화면 밖으로 이동하거나 다른 창에 완전히 가려지거나 최소화되거나 이와 유사한 경우 이 함수가 호출되고 isExposed() 값이 false로 변경될 수 있습니다. 이 이벤트를 사용하여 창이 노출되었을 때만 애니메이션과 같은 비용이 많이 드는 작업이 실행되도록 제한할 수 있습니다.

이 이벤트는 페인팅에 사용해서는 안 됩니다. 페인팅을 처리하려면 paintEvent()를 대신 구현하세요.

크기 조정 이벤트는 항상 창이 처음 표시될 때 노출 이벤트 전에 전송됩니다.

paintEvent() 및 isExposed()도 참조하세요 .

QString QWindow::filePath() const

이 창이 나타내는 파일 이름입니다.

setFilePath()도 참조하세요 .

[virtual protected] void QWindow::focusInEvent(QFocusEvent *ev)

이벤트에서 포커스를 처리하려면 이를 재정의합니다(ev).

이벤트 내 포커스는 창이 키보드 포커스를 받을 때 전송됩니다.

focusOutEvent()도 참조하세요 .

[virtual] QObject *QWindow::focusObject() const

키 이벤트와 같이 포커스가 묶인 이벤트의 최종 수신자가 될 QObject 을 반환합니다.

[signal] void QWindow::focusObjectChanged(QObject *object)

이 신호는 포커스에 연결된 이벤트의 최종 수신자가 object 로 변경될 때 발생합니다.

focusObject()도 참조하세요 .

[virtual protected] void QWindow::focusOutEvent(QFocusEvent *ev)

포커스 아웃 이벤트를 처리하려면 이를 재정의합니다(ev).

포커스 아웃 이벤트는 창이 키보드 포커스를 잃을 때 전송됩니다.

focusInEvent()도 참조하세요 .

[override virtual] QSurfaceFormat QWindow::format() const

재구현합니다: QSurface::format() const.

이 창의 실제 형식을 반환합니다.

창이 생성된 후 이 함수는 창의 실제 표면 형식을 반환합니다. 플랫폼에서 요청된 형식을 충족할 수 없는 경우 요청된 형식과 다를 수 있습니다. 또한 특정 버퍼 크기가 요청된 것보다 클 수 있는 등 상위 집합일 수도 있습니다.

setFormat(), create(), requestedFormat() 및 QOpenGLContext::format()도 참조하세요 .

QRect QWindow::frameGeometry() const

창 프레임을 포함한 창의 지오메트리를 반환합니다.

지오메트리는 해당 화면의 가상 지오메트리()와 관련되어 있습니다.

geometry() 및 frameMargins()도 참조하세요 .

QMargins QWindow::frameMargins() const

창을 둘러싼 창 프레임 여백을 반환합니다.

geometry() 및 frameGeometry()도 참조하세요 .

QPoint QWindow::framePosition() const

창 프레임을 포함하여 창의 왼쪽 상단 위치를 반환합니다.

frameGeometry().topLeft()와 동일한 값을 반환합니다.

setFramePosition(), geometry() 및 frameGeometry()도 참조하세요 .

[static] QWindow *QWindow::fromWinId(WId id)

다른 프로세스나 Qt 아래의 네이티브 라이브러리를 사용하여 만든 창의 로컬 표현을 만듭니다.

네이티브 창에 id 핸들이 주어지면, 이 메서드는 setParent() 및 setTransientParent() 같은 메서드를 호출할 때 창을 표현하는 데 사용할 수 있는 QWindow 객체를 생성합니다.

이를 지원하는 플랫폼에서는 네이티브 창 안에 QWindow 을 임베드하거나 QWindow 안에 네이티브 창을 임베드하는 데 사용할 수 있습니다.

외부 창이 지원되지 않거나 플랫폼 플러그인에서 네이티브 창 임베딩에 실패한 경우 이 함수는 nullptr 을 반환합니다.

setParent()도 참조하세요 .

QRect QWindow::geometry() const

창 프레임을 제외한 창의 지오메트리를 반환합니다.

지오메트리는 해당 화면의 가상 지오메트리()와 관련되어 있습니다.

setGeometry(), frameMargins() 및 frameGeometry()도 참조하세요 .

[slot] void QWindow::hide()

창을 숨깁니다.

setVisible(거짓)을 호출하는 것과 동일합니다.

show() 및 setVisible()도 참조하세요 .

[virtual protected] void QWindow::hideEvent(QHideEvent *ev)

숨기기 이벤트를 처리하려면 이 함수를 재정의하세요(ev).

이 함수는 창이 창 시스템에서 숨기기를 요청했을 때 호출됩니다.

QIcon QWindow::icon() const

창 시스템에서 창의 아이콘을 반환합니다.

setIcon()도 참조하세요 .

bool QWindow::isActive() const

창이 활성화되어 있으면 true 을 반환합니다.

입력 포커스가 있는 창과 포커스 창과 동일한 상위/임시 상위 체인에 있는 창이 이에 해당합니다.

일반적으로 활성 창은 스타일 관점에서 활성 상태로 표시되어야 합니다.

현재 포커스가 있는 창을 가져오려면 QGuiApplication::focusWindow()를 사용합니다.

requestActivate()도 참조하세요 .

bool QWindow::isAncestorOf(const QWindow *child, QWindow::AncestorMode mode = IncludeTransients) const

주어진 창이 child 의 조상인 경우 true 을 반환합니다. mode 이 IncludeTransients 인 경우 임시 부모도 조상으로 간주됩니다.

bool QWindow::isExposed() const

이 창이 창 표시 시스템에 노출된 경우 반환합니다.

창이 노출되지 않으면 애플리케이션에 표시되지만 창 표시 시스템에는 여전히 표시되지 않으므로 애플리케이션은 애니메이션 및 기타 그래픽 활동을 최소화해야 합니다.

이 값이 변경될 때마다 exposeEvent()가 전송됩니다.

exposeEvent()도 참조하세요 .

bool QWindow::isModal() const

창이 모달 창인지 여부를 반환합니다.

모달 창은 다른 창에서 입력을 받지 못하도록 합니다.

QWindow::modality 를참조하세요 .

bool QWindow::isTopLevel() const

창이 최상위 창인지, 즉 상위 창이 없는지 반환합니다.

[virtual protected] void QWindow::keyPressEvent(QKeyEvent *ev)

키 누르기 이벤트를 처리하려면 이를 재정의합니다 (ev).

keyReleaseEvent()도 참조하세요 .

[virtual protected] void QWindow::keyReleaseEvent(QKeyEvent *ev)

키 릴리스 이벤트를 처리하려면 이를 재정의합니다(ev).

keyPressEvent()도 참조하세요 .

[slot] void QWindow::lower()

창 시스템에서 창을 내립니다.

창을 다른 창 아래에 표시하도록 창을 낮추도록 요청합니다.

[since 6.0] QPointF QWindow::mapFromGlobal(const QPointF &pos) const

전역 화면 좌표 pos 를 창 좌표로 변환합니다.

이 함수는 Qt 6.0에 도입되었습니다.

mapToGlobal()도 참조하십시오 .

QPoint QWindow::mapFromGlobal(const QPoint &pos) const

과부하가 걸린 기능입니다.

[since 6.0] QPointF QWindow::mapToGlobal(const QPointF &pos) const

창 좌표 pos 를 전역 화면 좌표로 변환합니다. 예를 들어 mapToGlobal(QPointF(0,0)) 은 창의 왼쪽 상단 픽셀의 전역 좌표를 제공합니다.

이 함수는 Qt 6.0에 도입되었습니다.

mapFromGlobal()도 참조하세요 .

QPoint QWindow::mapToGlobal(const QPoint &pos) const

과부하가 걸린 기능입니다.

QRegion QWindow::mask() const

창에 설정된 마스크를 반환합니다.

마스크는 애플리케이션이 지정된 영역 외부의 마우스 또는 터치 입력을 받지 않으려는 윈도우 시스템에 대한 힌트입니다.

setMask()도 참조하세요 .

QSize QWindow::maximumSize() const

창의 최대 크기를 반환합니다.

setMaximumSize()도 참조하세요 .

QSize QWindow::minimumSize() const

창의 최소 크기를 반환합니다.

setMinimumSize()도 참조하세요 .

[signal] void QWindow::modalityChanged(Qt::WindowModality modality)

이 신호는 Qwindow::modality 속성이 modality 로 변경될 때 발생합니다.

[virtual protected] void QWindow::mouseDoubleClickEvent(QMouseEvent *ev)

마우스 더블 클릭 이벤트를 처리하려면 이를 재정의합니다 (ev).

mousePressEvent() 및 QStyleHints::mouseDoubleClickInterval()도 참조하세요 .

[virtual protected] void QWindow::mouseMoveEvent(QMouseEvent *ev)

마우스 이동 이벤트를 처리하려면 이를 재정의합니다(ev).

[virtual protected] void QWindow::mousePressEvent(QMouseEvent *ev)

마우스 누르기 이벤트를 처리하려면 이를 재정의합니다 (ev).

mouseReleaseEvent()도 참조하세요 .

[virtual protected] void QWindow::mouseReleaseEvent(QMouseEvent *ev)

마우스 릴리스 이벤트를 처리하려면 이를 재정의합니다 (ev).

mousePressEvent()도 참조하세요 .

[virtual protected] void QWindow::moveEvent(QMoveEvent *ev)

이를 재정의하여 창 이동 이벤트를 처리합니다(ev).

[virtual protected] bool QWindow::nativeEvent(const QByteArray &eventType, void *message, qintptr *result)

플랫폼 종속 이벤트를 처리하려면 이 값을 재정의합니다. eventType , message 및 result 이 주어집니다.

이로 인해 애플리케이션이 이식성이 떨어질 수 있습니다.

이벤트가 처리된 경우에만 참을 반환해야 합니다.

[virtual protected, since 6.0] void QWindow::paintEvent(QPaintEvent *ev)

페인트 이벤트(ev)는 창을 처음 표시하거나 다른 창을 이동하여 창 일부가 가려지는 등 창 영역에 다시 페인트가 필요할 때마다 창 시스템에서 전송됩니다.

애플리케이션은 창이 노출된 상태와 관계없이 페인트 이벤트에 응답하여 창에 렌더링할 것으로 예상됩니다. 예를 들어, 창이 노출되기 전에 페인트 이벤트를 전송하여 사용자에게 표시할 준비를 할 수 있습니다.

이 기능은 Qt 6.0에 도입되었습니다.

exposeEvent()도 참조하세요 .

QWindow *QWindow::parent(QWindow::AncestorMode mode = ExcludeTransients) const

상위 창이 있으면 반환합니다.

mode 이 IncludeTransients 인 경우 부모가 없는 경우 임시 부모가 반환됩니다.

부모가 없는 창을 최상위 창이라고 합니다.

setParent()도 참조하세요 .

QPoint QWindow::position() const

창 프레임을 제외한 바탕화면의 창 위치를 반환합니다.

setPosition()도 참조하세요 .

[slot] void QWindow::raise()

창 시스템에서 창을 올립니다.

창을 다른 창 위에 표시하도록 창을 올리도록 요청합니다.

[slot] void QWindow::requestActivate()

창을 활성화하도록 요청합니다(즉, 키보드 포커스를 받도록 요청합니다).

isActive() 및 QGuiApplication::focusWindow()도 참조하세요 .

[slot] void QWindow::requestUpdate()

이 창에 QEvent::UpdateRequest 이벤트가 전달되도록 예약합니다.

이벤트는 디스플레이 동기화와 동기화가 가능한 플랫폼에서는 디스플레이와 동기화하여 전달됩니다. 그렇지 않은 경우 이벤트는 최대 5ms의 지연 후에 전달됩니다. 창과 연결된 화면에서 60Hz보다 높은 refresh rate 을 보고하면 간격이 5보다 작은 값으로 축소됩니다. 이 추가 시간은 이벤트 루프에 시스템 이벤트를 수집할 수 있는 약간의 유휴 시간을 제공하기 위한 것으로, QT_QPA_UPDATE_IDLE_TIME 환경 변수를 사용하여 재정의할 수 있습니다.

애니메이션을 구동할 때 이 함수는 드로잉이 완료된 후 한 번만 호출해야 합니다. 이 함수를 여러 번 호출하면 단일 이벤트가 창에 전달됩니다.

QWindow 의 서브클래스는 event()를 다시 구현하고 이벤트를 가로채서 애플리케이션의 렌더링 코드를 호출한 다음 기본 클래스 구현을 호출해야 합니다.

QSurfaceFormat QWindow::requestedFormat() const

이 창의 요청된 서피스 포맷을 반환합니다.

요청된 형식이 플랫폼 구현에서 지원되지 않는 경우 요청된 형식은 실제 창 형식과 다를 수 있습니다.

setFormat()로 설정된 값입니다.

setFormat() 및 format()도 참조하세요 .

void QWindow::resize(const QSize &newSize)

창 프레임을 제외한 창 크기를 다음과 같이 설정합니다. newSize

size() 및 geometry()도 참조하세요 .

void QWindow::resize(int w, int h)

창 프레임을 제외한 창 크기를 너비 w 및 높이로 구성된 QSize 로 설정합니다. h

대화형으로 창 크기를 조정하려면 startSystemResize()를 참조하세요.

size() 및 geometry()도 참조하세요 .

[virtual protected] void QWindow::resizeEvent(QResizeEvent *ev)

크기 조정 이벤트를 처리하려면 이를 재정의합니다(ev).

크기 조정 이벤트는 창 크기 조정 시스템에서 창 크기가 조정될 때마다 setGeometry() 또는 resize() 요청을 승인하는 창 시스템을 통해 직접적으로 또는 사용자가 수동으로 창 크기를 조정하는 방식을 통해 간접적으로 호출됩니다.

QScreen *QWindow::screen() const

창이 표시되는 화면을 반환하거나, 창이 없는 경우 null을 반환합니다.

하위 창의 경우 해당 최상위 창의 화면을 반환합니다.

setScreen() 및 QScreen::virtualSiblings()도 참조하세요 .

[signal] void QWindow::screenChanged(QScreen *screen)

이 신호는 setScreen()로 명시적으로 설정하거나 창 화면이 제거될 때 자동으로 창 screen 이 변경될 때 발생합니다.

void QWindow::setBaseSize(const QSize &size)

창의 기본 size 을 설정합니다.

창이 sizeIncrement()를 정의하는 경우 기본 크기는 적절한 창 크기를 계산하는 데 사용됩니다.

setMinimumSize(), setMaximumSize(), setSizeIncrement() 및 baseSize()도 참조하세요 .

void QWindow::setCursor(const QCursor &cursor)

이 창의 커서 모양을 설정합니다.

재정의 커서가 설정되어 있지 않으면 마우스 cursor 가 이 창 위에 있을 때 이 모양을 취합니다. 유용한 다양한 모양은 list of predefined cursor objects 을 참조하세요.

커서가 설정되어 있지 않거나 unsetCursor()를 호출한 후에는 상위 창의 커서가 사용됩니다.

기본적으로 커서는 Qt::ArrowCursor 모양입니다.

일부 기본 창 구현에서는 마우스를 잡더라도 커서가 창을 벗어나면 커서가 초기화됩니다. 창 밖에 있을 때에도 모든 창에 커서를 설정하려면 QGuiApplication::setOverrideCursor()를 사용하세요.

cursor() 및 QGuiApplication::setOverrideCursor()도 참조하세요 .

void QWindow::setFilePath(const QString &filePath)

이 창이 표시할 파일 이름을 설정합니다.

창 표시 시스템에서는 filePath 을 사용하여 이 창이 표시하고 있는 문서의 경로를 타일 막대에 표시할 수 있습니다.

filePath()도 참조하세요 .

void QWindow::setFlag(Qt::WindowType flag, bool on = true)

on 이 참이면 이 창에 창 플래그 flag 를 설정하고, 그렇지 않으면 플래그를 지웁니다.

setFlags(), flags() 및 type()도 참조하세요 .

void QWindow::setFormat(const QSurfaceFormat &format)

창의 표면을 설정합니다 format.

이 형식은 색 농도, 알파, 깊이 및 스텐실 버퍼 크기 등과 같은 속성을 결정합니다. 예를 들어, 창에 투명한 배경을 부여하려면(창 시스템이 합성을 지원하고 창 내의 다른 콘텐츠가 다시 불투명하게 만들지 않는다면) 창을 투명하게 만들 수 있습니다:

QSurfaceFormat format;
format.setAlphaBufferSize(8);
window.setFormat(format);

표면 형식은 create() 함수에서 해결됩니다. create () 함수가 호출된 후 이 함수를 호출하면 기본 서페이스의 서페이스 형식이 다시 확인되지 않습니다.

이 함수를 통해 형식을 명시적으로 설정하지 않은 경우 QSurfaceFormat::defaultFormat()에서 반환된 형식이 사용됩니다. 즉, 여러 개의 창이 있는 경우 이 함수에 대한 개별 호출을 첫 번째 창을 만들기 전에 QSurfaceFormat::setDefaultFormat()를 한 번 호출하는 것으로 대체할 수 있습니다.

format(), create(), destroy() 및 QSurfaceFormat::setDefaultFormat()도 참조하세요 .

void QWindow::setFramePosition(const QPoint &point)

창 프레임을 포함하여 창(point)의 왼쪽 상단 위치를 설정합니다.

이 위치는 해당 화면의 가상 지오메트리()를 기준으로 합니다.

framePosition(), setGeometry() 및 frameGeometry()도 참조하세요 .

[slot] void QWindow::setGeometry(const QRect &rect)

창 프레임을 제외한 창의 지오메트리를 rect 로 설정합니다.

지오메트리는 해당 화면의 가상 지오메트리()와 관련되어 있습니다.

geometry()도 참조하세요 .

[slot] void QWindow::setGeometry(int posx, int posy, int w, int h)

창 프레임을 제외한 창의 지오메트리를 posx, posy, w 및 h 에서 구성한 직사각형으로 설정합니다.

지오메트리는 해당 화면의 가상 지오메트리()와 관련되어 있습니다.

geometry()도 참조하세요 .

void QWindow::setIcon(const QIcon &icon)

창 열기 시스템에서 창의 icon 을 설정합니다.

창 아이콘은 창을 꾸미거나 작업 전환기에서 창을 표시하는 등의 창 시스템에서 사용할 수 있습니다.

icon() 및 setFilePath()도 참조하세요 .

bool QWindow::setKeyboardGrabEnabled(bool grab)

키보드 잡기를 활성화할지 여부를 설정합니다(grab).

반환값이 참이면 창은 setKeyboardGrabEnabled(false)가 호출될 때까지 모든 키 이벤트를 수신하고, 다른 창은 키 이벤트를 전혀 수신하지 않습니다. 마우스 이벤트는 영향을 받지 않습니다. 이를 가져오려면 setMouseGrabEnabled()를 사용하세요.

setMouseGrabEnabled()도 참조하세요 .

void QWindow::setMask(const QRegion &region)

창의 마스크를 설정합니다.

마스크는 애플리케이션이 지정된 region 외부의 마우스 또는 터치 입력을 받지 않으려는 윈도우 시스템에 대한 힌트입니다.

창 관리자는 마스크에 포함되지 않은 창 영역을 표시하도록 선택할 수도 있고 표시하지 않을 수도 있으므로 마스크에 포함되지 않은 영역을 투명하게 지우는 것은 애플리케이션의 책임입니다.

mask()도 참조하세요 .

void QWindow::setMaximumSize(const QSize &size)

창의 최대 크기를 설정합니다.

지정된 size 이상으로 크기가 조정되지 않도록 창 관리자에게 알려주는 힌트입니다.

setMinimumSize() 및 maximumSize()도 참조하세요 .

void QWindow::setMinimumSize(const QSize &size)

창의 최소 크기를 설정합니다.

지정된 size 이하로 크기가 조정되지 않도록 창 관리자에게 알려주는 힌트입니다.

setMaximumSize() 및 minimumSize()도 참조하세요 .

bool QWindow::setMouseGrabEnabled(bool grab)

마우스 잡기를 활성화할지 여부를 설정합니다(grab).

반환값이 참이면 창은 setMouseGrabEnabled(false)가 호출될 때까지 모든 마우스 이벤트를 수신하고, 다른 창은 마우스 이벤트를 전혀 수신하지 않습니다. 키보드 이벤트는 영향을 받지 않습니다. 이를 가져오려면 setKeyboardGrabEnabled()를 사용하세요.

setKeyboardGrabEnabled()도 참조하세요 .

void QWindow::setParent(QWindow *parent)

parent 창을 설정합니다. 이렇게 하면 창 클립을 관리하는 창 시스템이 parent 창에 클립되도록 합니다.

parent 을 nullptr 으로 설정하면 해당 창이 최상위 창이 됩니다.

parent 가 fromWinId()에 의해 생성된 창인 경우 플랫폼에서 지원하는 경우 현재 창이 parent 안에 포함됩니다.

parent()도 참조하세요 .

void QWindow::setPosition(const QPoint &pt)

바탕화면에서 창의 위치를 다음과 같이 설정합니다. pt

위치는 해당 화면의 가상 지오메트리()를 기준으로 합니다.

대화형으로 창을 이동하려면 startSystemMove()를 참조하세요. 창 크기를 대화형으로 조정하려면 startSystemResize()를 참조하세요.

position() 및 startSystemMove()도 참조하세요 .

void QWindow::setPosition(int posx, int posy)

바탕화면의 창 위치를 posx 로 설정합니다, posy

위치는 해당 화면의 가상 지오메트리()를 기준으로 합니다.

position()도 참조하세요 .

void QWindow::setScreen(QScreen *newScreen)

창이 표시될 화면을 설정합니다.

창이 생성된 경우 newScreen 에 창이 다시 생성됩니다.

이 함수는 최상위 창에서만 작동합니다.

screen() 및 QScreen::virtualSiblings()도 참조하세요 .

void QWindow::setSizeIncrement(const QSize &size)

창의 크기 증분(size)을 설정합니다.

사용자가 창 크기를 조정할 때 크기는 baseSize()를 기준으로 가로로 sizeIncrement().width() 픽셀, 세로로 sizeIncrement().height() 픽셀 단위로 이동합니다.

기본적으로 이 속성에는 너비와 높이가 0인 크기가 포함됩니다.

창 시스템은 크기 증분을 지원하지 않을 수 있습니다.

sizeIncrement(), setBaseSize(), setMinimumSize() 및 setMaximumSize()도 참조하세요 .

void QWindow::setSurfaceType(QSurface::SurfaceType surfaceType)

창의 surfaceType 을 설정합니다.

창이 QBackingStore 을 사용한 래스터 렌더링용인지, QOpenGLContext 을 사용한 OpenGL 렌더링용인지 지정합니다.

surfaceType 은 create() 함수에서 네이티브 서페이스가 생성될 때 사용됩니다. 네이티브 서페이스가 생성된 후 이 함수를 호출하려면 destroy() 및 create()을 호출하여 이전 네이티브 서페이스를 해제하고 새 서페이스를 만들어야 합니다.

surfaceType(), QBackingStore, QOpenGLContext, create() 및 destroy()도 참조하세요 .

void QWindow::setVulkanInstance(QVulkanInstance *instance)

이 창을 지정된 벌칸 instance 과 연결합니다.

instance 이 QWindow 인스턴스가 존재하는 한 유효해야 합니다.

vulkanInstance()도 참조하세요 .

void QWindow::setWindowState(Qt::WindowState state)

창의 화면 점유 상태 설정하기

state 창은 창이 창 표시 시스템에서 최대화, 최소화, 전체 화면 또는 일반으로 표시되는지 여부를 나타냅니다.

열거형 값 Qt::WindowActive 은 허용되지 않는 매개변수입니다.

windowState(), showNormal(), showFullScreen(), showMinimized(), showMaximized() 및 setWindowStates()도 참조하세요 .

void QWindow::setWindowStates(Qt::WindowStates state)

창의 화면 점유 상태 설정하기

state 창은 창이 창 표시 시스템에서 최대화, 최소화 및/또는 전체 화면으로 표시되는지 여부를 나타냅니다.

창은 여러 가지 상태를 조합하여 표시할 수 있습니다. 예를 들어 창이 최소화 및 최대화 상태인 경우 창이 최소화 상태로 표시되지만 작업 표시줄 항목을 클릭하면 창이 최대화 상태로 복원됩니다.

열거형 값 Qt::WindowActive 을 설정해서는 안 됩니다.

windowStates(), showNormal(), showFullScreen(), showMinimized() 및 showMaximized()도 참조하세요 .

[slot] void QWindow::show()

창을 표시합니다.

하위 창의 경우 showNormal()를 호출하는 것과 같습니다. 그렇지 않으면 창 유형 및 플래그에 대한 플랫폼의 기본 동작에 따라 showFullScreen(), showMaximized() 또는 showNormal()를 호출하는 것과 같습니다.

showFullScreen(), showMaximized(), showNormal(), hide(), QStyleHints::showIsFullScreen() 및 flags()도 참조하세요 .

[virtual protected] void QWindow::showEvent(QShowEvent *ev)

이 함수를 재정의하여 표시 이벤트(ev)를 처리합니다.

이 함수는 창이 표시를 요청할 때 호출됩니다.

창 표시 시스템에 의해 창이 성공적으로 표시되면 크기 조정 및 노출 이벤트가 이어집니다.

[slot] void QWindow::showFullScreen()

창을 전체 화면으로 표시합니다.

setWindowStates(Qt::WindowFullScreen)를 호출한 다음 setVisible(true)를 호출하는 것과 동일합니다.

플랫폼별 고려 사항 및 제한 사항은 QWidget::showFullScreen() 문서를 참조하세요.

setWindowStates() 및 setVisible()도 참조하세요 .

[slot] void QWindow::showMaximized()

창을 최대로 표시합니다.

setWindowStates(Qt::WindowMaximized)를 호출한 다음 setVisible(true)를 호출하는 것과 동일합니다.

setWindowStates() 및 setVisible()도 참조하세요 .

[slot] void QWindow::showMinimized()

창을 최소화한 상태로 표시합니다.

setWindowStates(Qt::WindowMinimized)를 호출한 다음 setVisible(true)를 호출하는 것과 동일합니다.

setWindowStates() 및 setVisible()도 참조하세요 .

[slot] void QWindow::showNormal()

창을 최대화, 최소화, 전체 화면이 아닌 정상 상태로 표시합니다.

setWindowStates(Qt::WindowNoState)를 호출한 다음 setVisible(true)를 호출하는 것과 동일합니다.

setWindowStates() 및 setVisible()도 참조하세요 .

[override virtual] QSize QWindow::size() const

재구현합니다: QSurface::size() const.

창 프레임을 제외한 창 크기를 반환합니다.

resize()도 참조하세요 .

QSize QWindow::sizeIncrement() const

창의 크기 증분을 반환합니다.

setSizeIncrement()도 참조하세요 .

[slot] bool QWindow::startSystemMove()

시스템별 이동 작업 시작하기

이 함수를 호출하면 이를 지원하는 플랫폼에서 창에서 대화형 이동 작업이 시작됩니다. 실제 동작은 플랫폼에 따라 다를 수 있습니다. 일반적으로 마우스 버튼을 놓을 때까지 창이 마우스 커서를 따라 움직입니다.

이를 지원하는 플랫폼에서는 이 창 이동 방법이 setPosition 보다 선호되는데, 창 관리자가 이 창을 다른 창에 스냅하거나 화면 가장자리로 끌었을 때 애니메이션을 사용하여 특수 타일링 또는 크기 조정 동작을 하는 등 창 이동의 보다 자연스러운 모양과 느낌을 구현할 수 있기 때문입니다. 또한 Wayland와 같은 일부 플랫폼에서는 setPosition 이 지원되지 않으므로 애플리케이션이 위치에 영향을 줄 수 있는 유일한 방법입니다.

시스템에서 해당 작업이 지원되면 true를 반환합니다.

[slot] bool QWindow::startSystemResize(Qt::Edges edges)

시스템별 크기 조정 작업 시작

이를 호출하면 이를 지원하는 플랫폼별로 창에서 대화형 크기 조정 작업이 시작됩니다. 실제 동작은 플랫폼에 따라 다를 수 있습니다. 일반적으로 창 가장자리가 마우스 커서를 따르도록 창 크기를 조정합니다.

이를 지원하는 플랫폼에서는 이 창 크기 조정 방법이 setGeometry 보다 선호되는데, 창 관리자가 이 창을 다른 창에 스냅하거나 화면 가장자리로 끌면 애니메이션이 있는 특수 크기 조정 동작을 하는 등 창 크기 조정의 보다 네이티브한 모양과 느낌을 구현할 수 있기 때문입니다.

edges 는 단일 가장자리이거나 인접한 두 가장자리(모서리)여야 합니다. 다른 값은 허용되지 않습니다.

시스템에서 해당 작업이 지원되면 true를 반환합니다.

[override virtual] QSurface::SurfaceType QWindow::surfaceType() const

재구현합니다: QSurface::surfaceType() const.

창의 표면 유형을 반환합니다.

setSurfaceType()도 참조하십시오 .

[virtual protected] void QWindow::tabletEvent(QTabletEvent *ev)

태블릿 누르기, 이동 및 놓기 이벤트를 처리하려면 이를 재정의하세요(ev).

근접 입력 및 종료 이벤트는 창으로 전송되지 않고 애플리케이션 인스턴스로 전달됩니다.

[virtual protected] void QWindow::touchEvent(QTouchEvent *ev)

터치 이벤트를 처리하려면 이를 재정의합니다(ev).

Qt::WindowType QWindow::type() const

창의 유형을 반환합니다.

창이 대화상자인지, 툴팁인지, 팝업인지, 일반 창인지 등을 나타내는 창 플래그의 일부를 반환합니다.

flags() 및 setFlags()도 참조하세요 .

void QWindow::unsetCursor()

이 창의 기본 화살표 커서를 복원합니다.

QVulkanInstance *QWindow::vulkanInstance() const

연관된 벌칸 인스턴스가 설정된 경우, 그렇지 않으면 nullptr 을 반환합니다.

setVulkanInstance()도 참조하세요 .

[virtual protected] void QWindow::wheelEvent(QWheelEvent *ev)

마우스 휠 또는 기타 휠 이벤트를 처리하려면 이를 재정의합니다(ev).

WId QWindow::winId() const

창의 플랫폼 ID를 반환합니다.

이 ID가 유용할 수 있는 플랫폼의 경우 반환되는 값은 해당 화면 내부의 창을 고유하게 나타냅니다.

screen()도 참조하세요 .

Qt::WindowState QWindow::windowState() const

창의 화면 점유 상태

setWindowState() 및 windowStates()도 참조하세요 .

[signal] void QWindow::windowStateChanged(Qt::WindowState windowState)

이 신호는 setWindowStates()로 명시적으로 설정하거나 사용자가 제목 표시줄 버튼 중 하나를 클릭하거나 다른 방법으로 자동으로 windowState 가 변경될 때 발생합니다.

Qt::WindowStates QWindow::windowStates() const

창의 화면 점유 상태

창은 여러 가지 상태가 조합되어 있을 수 있습니다. 예를 들어 창이 최소화 및 최대화 상태인 경우 창이 최소화 상태로 표시되지만 작업 표시줄 항목을 클릭하면 창이 최대화 상태로 복원됩니다.

setWindowStates()도 참조하세요 .