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

返回该窗口的物理像素与设备无关像素之间的比例。该值取决于窗口所在的屏幕，当窗口被移动时，该值可能会发生变化。

当设备像素比例发生变化时，QWindow 实例会接收一个类型为QEvent::DevicePixelRatioChange 的事件。

常见值为：普通显示屏上为 1.0，Apple “视网膜”显示屏上为 2.0。

另请参阅 QScreen::devicePixelRatio() 和QEvent::DevicePixelRatioChange 。

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

重写：QObject::event(QEvent *e)。

重写此函数以处理发送到窗口的任何事件（ev ）。如果事件已被识别并处理，则返回true 。

若希望鼠标事件、键盘事件、调整大小事件等仍按常规方式分发，请务必调用基类的版本。

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

当窗口在“未显示”和“显示”状态之间切换时，窗口系统会发送“expose”事件（ev ）。

处于“暴露”状态的窗口可能被用户看到。如果窗口移出屏幕、被另一个窗口完全遮挡、被最小化，或者发生类似情况，该函数可能会被调用，且isExposed() 的返回值可能会变为 false。您可以利用此事件，将动画等耗时操作限制为仅在窗口处于“暴露”状态时运行。

不应使用此事件进行绘制。若要处理绘制操作，请改用paintEvent()。

当窗口首次显示时，resize 事件总会先于 expose 事件触发。

另请参阅 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

返回窗口的几何信息，包括其窗口边框。

该几何信息是相对于其屏幕的 virtualGeometry() 而言的。

另请参阅 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 ，该方法将创建一个QWindow 对象，该对象可在调用setParent() 和setTransientParent() 等方法时用于表示该窗口。

在支持该功能的平台上，可利用此功能将QWindow 嵌入原生窗口中，或将原生窗口嵌入QWindow 中。

如果平台插件不支持外部窗口，或者将原生窗口嵌入失败，则该函数返回 `nullptr`。

另请参阅 setParent()。

QRect QWindow::geometry() const

返回窗口的几何形状，不包括窗口边框。

该几何信息相对于其屏幕的 virtualGeometry() 而言。

另请参阅 setGeometry()、frameMargins() 和frameGeometry()。

[slot] void QWindow::hide()

隐藏窗口。

等同于调用setVisible(false)。

另请参阅 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 。

这可能会导致您的应用程序无法移植。

仅当事件已被处理时，才应返回 true。

[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 事件发送至该窗口。

在支持该功能的平台上，该事件会与显示器的垂直同步（vsync）保持同步交付。否则，该事件会在最多延迟 5 毫秒后交付。如果窗口关联的屏幕报告的refresh rate 高于 60 Hz，则该间隔会缩放为小于 5 的值。 额外的时间是为了给事件循环留出一些空闲时间以收集系统事件，并可通过 QT_QPA_UPDATE_IDLE_TIME 环境变量进行覆盖。

在驱动动画时，应在绘制完成后调用此函数一次。多次调用此函数将导致单个事件被传递给窗口。

QWindow 的子类应重写event()，拦截该事件并调用应用程序的渲染代码，然后调用基类的实现。

QSurfaceFormat QWindow::requestedFormat() const

返回此窗口的请求表面格式。

如果平台实现不支持请求的格式，则 requestedFormat 将与实际的窗口格式不同。

这是通过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 ）。

每当窗口在窗口系统中被调整大小时，都会触发 resize 事件，无论是窗口系统直接响应setGeometry() 或resize() 请求，还是用户手动调整窗口大小所导致的间接触发。

[since 6.9] QMargins QWindow::safeAreaMargins() const

返回窗口的安全区域边距。

安全区域是指窗口中可以安全放置内容的部分，在此区域内，内容不会被其他 UI 元素（例如系统 UI）遮挡，也不会与之发生冲突。

这些边距相对于窗口的内部几何形状，即QRect(0, 0,width()、height()。

void PaintDeviceWindow::paintEvent(QPaintEvent *)
{
    QPainter painter(this);
    QRect rect(0, 0, width(), height());
    painter.fillRect(rect, QGradient::SunnyMorning);
    painter.fillRect(rect - safeAreaMargins(), QGradient::DustyGrass);
}

该函数在 Qt 6.9 中引入。

另请参阅 geometry() 和safeAreaMarginsChanged()。

[signal, since 6.9] void QWindow::safeAreaMarginsChanged(QMargins margins)

当安全区域边界发生变化时，会发出此信号，具体变化为margins 。

该函数于 Qt 6.9 版本中引入。

另请参阅 safeAreaMargins()。

QScreen *QWindow::screen() const

返回显示该窗口的屏幕；如果没有，则返回 null。

对于子窗口，此函数将返回相应顶级窗口的屏幕。

另请参阅 setScreen() 和QScreen::virtualSiblings()。

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

当窗口的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 ）的左上角位置，包括窗口边框。

该位置是以其屏幕的 virtualGeometry() 为基准的。

另请参阅 framePosition()、setGeometry() 和frameGeometry()。

[since 6.12] void QWindow::setFramePosition(int x, int y)

将窗口（包括窗口边框）的左上角位置设置为x ，y

该位置相对于其屏幕的 virtualGeometry() 而言。

该函数在 Qt 6.12 中引入。

另请参阅 setGeometry() 和frameGeometry()。

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

将窗口（不包括窗口边框）的几何形状设置为rect 。

该几何尺寸与其屏幕的 virtualGeometry() 相关。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        window, qOverload(&QWindow::setGeometry));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        window, [receiver = window](const QRect &rect) { receiver->setGeometry(rect); });

另请参阅 geometry()。

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

将窗口（不包括窗口边框）的几何形状设置为由posx 、posy 、w 和h 构成的矩形。

该几何形状与其屏幕的 virtualGeometry() 相关。

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        window, qOverload(&QWindow::setGeometry));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        window, [receiver = window](int posx, int posy, int w, int h) { receiver->setGeometry(posx, posy, w, h); });

另请参阅 geometry()。

void QWindow::setIcon(const QIcon &icon)

在窗口系统中设置窗口的icon

窗口图标可能会被窗口系统用于装饰窗口，以及/或在任务切换器中显示。

另请参阅 icon() 和setFilePath()。

bool QWindow::setKeyboardGrabEnabled(bool grab)

设置是否启用键盘捕获（grab ）。

如果返回值为 true，则该窗口将接收所有键事件，直到调用 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 ）。

如果返回值为 true，则该窗口将接收所有鼠标事件，直到调用 setMouseGrabEnabled(false) 为止；其他窗口则完全无法接收鼠标事件。键盘事件不受影响。若需捕获键盘事件，请使用setKeyboardGrabEnabled()。

另请参阅 setKeyboardGrabEnabled()。

void QWindow::setParent(QWindow *parent)

设置“parent ”窗口。这将导致窗口管理系统对该窗口进行裁剪，使其被裁剪为“parent ”窗口的大小。

将parent 设置为nullptr 将使该窗口成为顶级窗口。

如果parent 是由fromWinId()创建的窗口，且平台支持该功能，则当前窗口将被嵌入到parent 中。

另请参阅 parent()。

void QWindow::setPosition(const QPoint &pt)

将窗口在桌面上的位置设置为pt

该位置是以其屏幕的 virtualGeometry() 为基准的。

有关交互式移动窗口，请参阅startSystemMove()。有关交互式调整窗口大小，请参阅startSystemResize()。

另请参阅 position() 和startSystemMove()。

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

将窗口在桌面上的位置设置为posx ，posy

该位置是相对于其屏幕的 virtualGeometry() 而言的。

另请参阅 position()。

void QWindow::setScreen(QScreen *newScreen)

设置应显示该窗口的屏幕。

如果窗口已创建，则会在newScreen 上重新创建该窗口。

此函数仅适用于顶级窗口。

另请参阅 screen() 和QScreen::virtualSiblings()。

void QWindow::setSizeIncrement(const QSize &size)

设置窗口的大小增量（size ）。

当用户调整窗口大小时，窗口尺寸将以sizeIncrement() 为步长进行调整：水平方向为width() 像素，垂直方向为sizeIncrement()height() 像素，以baseSize() 为基准。

默认情况下，该属性包含一个宽度和高度均为零的尺寸。

窗口系统可能不支持尺寸增量。

另请参阅 sizeIncrement()、setBaseSize()、setMinimumSize() 和setMaximumSize()。

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

设置窗口的surfaceType 。

指定该窗口是用于QBackingStore 的栅格渲染，还是用于QOpenGLContext 的OpenGL渲染。

当在create()函数中创建本机表面时，将使用surfaceType 。在本机表面创建完成后调用此函数，需要先调用destroy()和create()来释放旧的本机表面并创建一个新的。

另请参阅 surfaceType()、QBackingStore 、QOpenGLContext 、create() 以及destroy()。

void QWindow::setVulkanInstance(QVulkanInstance *instance)

将此窗口与指定的 Vulkaninstance 关联。

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

如果已设置关联的 Vulkan 实例，则返回该实例；否则返回 `nullptr`。

另请参阅 setVulkanInstance()。

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

重写此方法以处理鼠标滚轮或其他滚轮事件（ev ）。

WId QWindow::winId() const

返回窗口的平台 ID。

对于可能需要此标识符的平台，返回的值将唯一地标识对应屏幕中的该窗口。

另请参阅 screen()。

Qt::WindowState QWindow::windowState() const

窗口的屏幕占用状态

另请参阅 setWindowState() 和windowStates()。

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

当windowState 发生变化时，会触发此信号，这种变化可能是通过显式调用setWindowStates()设置的，也可能是当用户点击标题栏上的某个按钮或其他方式时自动触发的。

Qt::WindowStates QWindow::windowStates() const

窗口的屏幕占用状态

窗口可能处于多种状态的组合中。例如，如果窗口同时处于最小化和最大化状态，则窗口将显示为最小化状态，但点击任务栏中的窗口图标会将其恢复为最大化状态。

另请参阅 setWindowStates()。