Qt 窗口类型、窗口标志和窗口属性

一、窗口类型

Qt 窗口标志枚举类型用于指定小部件的各种窗口系统属性。其中一些标志取决于底层窗口管理器是否支持它们。以下是窗口类型作用一览表：

窗口类型	描述
Qt::QWidget	这是 QWidget 的默认类型。如果它们有父级，这种类型的部件是子部件，如果没有父控件，则为独立窗口。
Qt::Window	通常具有窗口系统框架和标题栏。请注意，如果部件没有父控件，则无法取消设置此标记（可以用在弹出子窗口比父窗口大很多的情况下）。
Qt::Dialog	对话框(通常标题栏中没有最大化或最小化按钮)。dget这是 QDialog 的默认类型。如果要将其用作模态对话框，则应从另一个窗口启动它。
Qt::Sheet	macOS 表单式窗口。由于使用工作表意味着窗口模态，推荐的方法是使用QWidget :: setWindowModality()或QDialog :: open()。
Qt::Drawer	macOS 抽屉式窗口。
Qt::Popup	弹出式顶层窗口，即它是模态的，但具有适合弹出菜单的窗口系统框架。
Qt::Tool	工具窗口。工具窗口通常是一个小窗口，其标题栏和装饰比通常小，通常用于工具按钮的集合。 如果有父部件，则工具窗口将始终保持在其上。
Qt::Tooltip	工具提示窗口。 这在内部用于实现工具提示，没有标题栏和窗口边框。
Qt::SplashScreen	闪屏。 这是 QSplashScreen 的默认类型。
Qt::SubWindow	子窗口，例如 QMdiSubWindow 窗口小部件。
Qt::ForeignWindow	表示由另一个进程创建的本机平台窗口或手动使用本机代码的句柄。
Qt::CoverWindow	代表一个封面窗口，例如，当应用程序在 BlackBerry 平台上最小化时显示。

二、窗口标志

以下为可以设置多个的窗口标志对照表：

窗口标志	描述
Qt::MSWindowsFixedSizeDialogHint	Windows系统固定大小窄边框窗口
Qt::X11BypassWindowManagerHint	无窗口边框的窗口，完全忽视窗口管理器和用户无法使用键盘进行输入 (除非手动调用QWidget::activateWindow()函数
Qt::FramelessWindowHint	无法移动和改变大小的无窗口边框的窗口
Qt::NoDropShadowWindowHint	禁用窗口阴影
Qt::WindowTitleHint	带标题栏的窗口
Qt::WindowSystemMenuHint	带系统菜单和尽可能地添加一个关闭按钮的窗口
Qt::CustomizeWindowHint	关闭默认窗口标题提示栏
Qt::WindowMinimizeButtonHint	窗口添加一个最小化按钮
Qt::WindowMaximizeButtonHint	窗口添加一个最大化按钮
Qt::WindowCloseButtonHint	窗口添加一个关闭按钮
Qt::WindowContextHelpButtonHint	窗口添加一个帮助按钮
Qt::WindowShadeButtonHint	如果窗口管理器支持，则在最小化按钮的位置添加一个阴影按钮
Qt::WindowStaysOnTopHint	通知窗口系统置顶窗口
Qt::WindowStaysOnBottomHint	通知窗口系统置于最底层窗口

• 常用示例：

  // 设置无窗口边框 | 窗口置顶
  this->setWindowFlags(Qt::FramelessWindowHint | Qt::WindowStaysOnTopHint);
  

• Qt 有一个 Demo 叫 Window Flags，展示了如何使用 Qt 中可用的窗口标志类型来指定窗口系统属性。在QtCreator软件可以找到：

三、窗口属性

通过 setAttribute 函数可以对 QWidget 对象设置 Qt::WidgetAttribute 枚举属性，从而改变 QWidget 对象的某些特性。

• Qt::WA_AcceptDrops：接受拖放，QWidget::setAcceptDrops()是此设置的便捷函数。

• Qt::WA_DeleteOnClose：QWidget 关闭时被 delete。

• Qt::WA_Disabled：设置小部件（注意是小部件，对窗口无效）被禁用（相对于调用setEnabled(false);）。

• Qt::WA_ForceUpdatesDisabled：禁用更新，即使其所有祖先都设置为启用更新状态，它仍将保持禁用状态。（相当于调用QWidget::setUpdatesEnabled()）。

• Qt::WA_Hover：当鼠标进入或离开小部件时，强制 Qt 生成绘制事件。此功能通常在实现自定义样式时使用。

• Qt::WA_InputMethodEnabled：启用亚洲语言的输入法。创建自定义文本编辑小部件时必须设置。

• Qt::WA_KeyboardFocusChange：当用户使用键盘（tab、backtab 或快捷键）时更改焦点。用于顶层窗口设置。

• Qt::WA_NoChildEventsForParent：小部件不希望将 ChildAdded 或 ChildRemoved 事件发送到其父级。

• Qt::WA_NoChildEventsFromChildren：小部件不希望接收从其子部件发送的 ChildAdded 或 ChildRemoved 事件。

• Qt::WA_NoMousePropagation：禁止将鼠标事件传播到小部件的父级。默认情况下禁用此属性。

• Qt::WA_TransparentForMouseEvents：将禁用向小部件及其子部件传递鼠标事件。默认情况下禁用此属性。

• Qt::WA_NoSystemBackground：小部件没有背景，即当小部件接收到绘制事件时，背景不会自动重新绘制。窗口设置这个效果就是全黑。

• Qt::WA_OpaquePaintEvent：小部件在接收到绘制事件时绘制其所有像素。因此，在生成绘制事件之前，不需要更新、调整大小、滚动和焦点更改等操作来擦除小部件。

• Qt::WA_PaintUnclipped：使在此小部件上操作的所有 QPainter 对象的绘制都不裁剪（即 QPainter 设置裁剪区域无效）。只有设置了Qt::WA_PaintOnScreen标志的小部件才支持此标志。

• Qt::WA_PaintOnScreen：表示小部件要直接在屏幕上绘制。具有此属性集的小部件不参与组合管理，即它们不能是半透明的或通过半透明重叠小部件发光。它将禁用双缓冲。

• Qt::WA_QuitOnClose：小部件作为最后一个接受closeEvent()时，使 Qt 退出应用程序。可以使用QApplication::quitOnLastWindowClosed属性修改此行为。默认情况下，该属性为 Qt::Window 类型的所有小部件设置。

• Qt::WA_Resized：指示小部件具有明确的大小。该标志由QWidget::resize()和QWidget::setGeometry()设置或清除。

• Qt::WA_AlwaysShowToolTips：设置窗口（注意是窗口，当 QWidget 作为子部件时无效）为非活动时也显示提示信息。（setToolTip()设置了窗口提示信息）

下面重点介绍几个常用或特殊的属性：

3.1 Qt::WA_TransparentForMouseEvents

Qt 助手中对Qt::WA_TransparentForMouseEvents的解释如下：

When enabled, this attribute disables the delivery of mouse events to the widget and its children. Mouse events are delivered to other widgets as if the widget and its children were not present in the widget hierarchy; mouse clicks and other events effectively "pass through" them. This attribute is disabled by default.

大意是：

当该属性被激活启用时，将会使所有发送到窗体和窗体内部子控件的鼠标事件无效。鼠标事件被分发到其它的窗体部件，就像本窗体部件及本窗体内的子控件没有出现在窗体层次体系中。鼠标单击和鼠标其它事件高效地穿过（即绕开）本窗体部件及其内的子控件，这个属性默认是禁用未开启的。

示例可以参考：Qt::WA_TransparentForMouseEvents用法

3.2 Qt::WA_StaticContents

Qt 官方对Qt::WA_StaticContents解释如下：

Indicates that the widget contents are north-west aligned and static. On resize, such a widget will receive paint events only for parts of itself that are newly visible. This flag is set or cleared by the widget's author.

翻译为中文的意思就是：指示窗体内容靠西北方向即左上角对齐且是静态的。当窗体大小调整时，仅仅只有那些新露出来的可见窗体部分才会绘制。这个标识由窗体的开发者清除或设置。

通常情况下，当重新定义一个窗口部件大小时，Qt 会为窗口部件的整个可见区域生成一个绘制事件。但是如果该窗口部件在创建时使用了 Qt::WA_StaticContens 属性，那么绘制事件的区域就会被严格限定在之前没有被显示最近刚露出的部分上。这也就意味着，如果重新把窗口部件改变为比原来还要小的尺寸，那么就根本不会产生任何绘制事件。这在某些情况下，可以提到性能，降低 cpu 效率，当以前绘制的东西很费时间时（如：某个曲线、某个图形是经过某个复杂的数学运算得出的），不重绘、不重新计算，这将节约很多 cpu 时间，大大提高效率。

示例可以参考：Qt::WA_StaticContents标识作用

3.3 Qt::WA_OpaquePaintEvent

Qt 助手中对Qt::WA_OpaquePaintEvent解释如下：

Indicates that the widget paints all its pixels when it receives a paint event. Thus, it is not required for operations like updating, resizing, scrolling and focus changes to erase the widget before generating paint events. The use of WA_OpaquePaintEvent provides a small optimization by helping to reduce flicker on systems that do not support double buffering and avoiding computational cycles necessary to erase the background prior to painting. Note: Unlike WA_NoSystemBackground, WA_OpaquePaintEvent makes an effort to avoid transparent window backgrounds. This flag is set or cleared by the widget's author.

其含义大体是说：

指示窗体在收到绘制事件时，绘制它的所有像素。因此，在收到绘制事件之前，对于更新、大小调整、滚动条滚动、焦点更变等操作时，并不要求窗体擦除窗体背景。使用该标志对那些不支持双缓冲区的系统提供了小小的优化，从而减小闪烁；同时避免在绘制之前因擦除背景需要计算而耗费时间。不同于 WA_NoSystemBackground 标志，WA_OpaquePaintEvent 尽量避免窗体背景透明，这个标志是由窗体的开发者设置或清除。

注：有时候设置 WA_OpaquePaintEvent 属性，会影响用样式表设置窗口的背景颜色。

以上是 Qt 官方的解释。个人理解如下：

• 指示窗体在收到绘制事件时，绘制它的所有像素。这里“收到绘制事件”个人理解应该是第一次收到绘制事件时，也即窗体构建时，就把窗体所有的像素绘制一遍。

• 窗体一旦在完成，上面说的绘制完一遍所有像素后，此后所有有关窗体的更新、大小改变，焦点改变、滚动条滚动等操作都不会擦除窗体背景。也就是说以前画的东西都不会擦除重绘。也就是以前画的不重新计算、不重新绘制。当以前绘制的东西很费时间时（如：某个曲线、某个图形是经过某个复杂的数学运算得出的），不重绘、不重新计算，这将节约很多 cpu 时间大大提高效率（这也就是设置本标志后，不闪烁的原因吧）。

示例可以参考：Qt::WA_OpaquePaintEvent理解

3.4 Qt::WA_NoMousePropagation

在 Qt 中，鼠标事件包含：鼠标按键按下，鼠标按键释放，鼠标双击事件，鼠标移动事件。分别由下面的 event handler（事件处理器，实际上就是一些可override的函数）来处理：

virtual void mousePressEvent(QMouseEvent *event);
virtual void mouseReleaseEvent(QMouseEvent *event);
virtual void mouseDoubleClickEvent(QMouseEvent *event);
virtual void mouseMoveEvent(QMouseEvent *event);

鼠标事件属于冒泡事件，鼠标事件会一直随着其父链一直路由下去，直到有其祖先所在的 widget 接受它，或者有事件过滤器消耗它。

注意：如果鼠标事件被路由到包含Qt:: WA_NoMousePropagation窗口属性（即该属性设置为 true）的窗口小部件，该鼠标事件不会进一步沿着父控件链路由。

示例可以参考：Qt::WA_NoMousePropagation用法