QWidget Class

成员函数文档

这些便捷函数会创建一个新的操作，其中包含文本text 、图标icon 和快捷方式shortcut （如果有）。

这些函数将新创建的操作添加到 widget 的操作列表中，并将其返回。

QWidget 该函数获取返回的 的所有权。QAction

该函数在 Qt 6.3 中引入。

这是一个重载函数。

该便捷函数创建一个新的操作，其中包含文本text 、图标icon 和快捷方式shortcut （如果有）。

该操作的triggered() 信号连接到receiver 的member 插槽。函数将新创建的操作添加到 widget 的操作列表中并返回。

QWidget 该函数获取返回的 的所有权。QAction

该函数在 Qt 6.3 中引入。

这是一个重载函数。

这些便捷函数创建了一个新的操作，其中包含文本text 、图标icon 和快捷方式shortcut （如果有）。

该操作的triggered() 信号通过调用QObject::connect （操作，&QAction::triggered ，参数......）连接，完美转发args ，包括可能的Qt::ConnectionType 。

函数将新创建的操作添加到 widget 的操作列表中并返回。

QWidget 该函数获取返回的 的所有权。QAction

该函数在 Qt 6.3 中引入。

[explicit] QWidget::QWidget(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

构造一个 widget，它是parent 的子 widget，widget 标志设置为f 。

如果parent 是nullptr ，新 widget 将成为一个窗口。如果parent 是另一个 widget，则该 widget 将成为parent 内的一个子窗口。当parent 被删除时，新部件也会被删除。

窗口部件标志参数f 通常为 0，但可以设置为自定义窗口框架（即parent 必须是nullptr ）。要自定义框架，可使用由window flags 中任意一个的 bitwise OR 组成的值。

如果要为已经可见的窗口部件添加子窗口部件，则必须显式显示子窗口部件，使其可见。

请注意，X11 版本的 Qt 可能无法在所有系统上提供所有的样式标志组合。这是因为在 X11 上，Qt 只能询问窗口管理器，而窗口管理器可以覆盖应用程序的设置。而在 Windows 上，Qt 可以设置您想要的任何标志。

另请参见 windowFlags 。

[virtual noexcept] QWidget::~QWidget()

销毁 widget。

首先删除该 widget 的所有子 widget。如果该 widget 是主 widget，应用程序将退出。

[virtual protected] void QWidget::actionEvent(QActionEvent *event)

每当小部件的操作发生变化时，该事件处理程序就会以给定的event 调用。

另请参阅 addAction(),insertAction(),removeAction(),actions() 和QActionEvent 。

QList<QAction *> QWidget::actions() const

返回此 widget 的操作列表（可能为空）。

另请参阅 contextMenuPolicy,insertAction() 和removeAction()。

void QWidget::activateWindow()

将包含此 widget 的顶层 widget 设置为活动窗口。

活动窗口是指具有键盘输入焦点的可见顶层窗口。

此函数执行的操作与在顶层窗口标题栏上单击鼠标相同。在 X11 上，结果取决于窗口管理器。如果要确保窗口也堆叠在顶部，则还应调用raise()。请注意，窗口必须是可见的，否则 activateWindow() 将不起作用。

在 Windows 系统中，如果应用程序当前不是活动窗口，则调用此函数不会使其成为活动窗口。它将改变任务栏条目的颜色，以表明窗口已发生某种变化。这是因为微软不允许应用程序中断用户当前正在另一个应用程序中进行的操作。

另请参阅 isActiveWindow()、window() 和show()。

void QWidget::addAction(QAction *action)

将操作action 添加到该 widget 的操作列表中。

所有 QWidget 都有一个QActions 的列表。不过，它们可以用许多不同的方式以图形表示。QAction 列表（由actions() 返回）的默认用途是创建上下文QMenu 。

QWidget 的每个操作只能有一个，添加已拥有的操作不会导致同一操作在 widget 中出现两次。

action 的所有权不会转移到该QWidget 。

另请参阅 removeAction(),insertAction(),actions() 和QMenu 。

void QWidget::addActions(const QList<QAction *> &actions)

将操作actions 添加到此 widget 的操作列表中。

另请参阅 removeAction()、QMenu 和addAction()。

void QWidget::adjustSize()

调整 widget 的大小以适应其内容。

如果sizeHint() 有效，即尺寸提示的宽度和高度大于等于 0，则使用该函数。否则，该函数会将尺寸设置为覆盖所有子窗口部件的子矩形（所有子窗口部件矩形的集合）。

对于窗口，屏幕尺寸也会考虑在内。如果sizeHint() 小于 (200, 100)，且大小策略为expanding ，则窗口的大小至少为 (200, 100)。窗口的最大尺寸是屏幕宽度和高度的 2/3。

另请参阅 sizeHint() 和childrenRect()。

QPalette::ColorRole QWidget::backgroundRole() const

返回 widget 的背景角色。

背景角色定义了 widgetpalette 中用于渲染背景的笔刷。

如果没有设置明确的背景角色，该 widget 将继承其父 widget 的背景角色。

另请参阅 setBackgroundRole() 和foregroundRole()。

QBackingStore *QWidget::backingStore() const

返回该 widget 将绘制到的QBackingStore 。

[virtual protected] void QWidget::changeEvent(QEvent *event)

该事件处理程序可以重新实现，以处理状态变化。

在此事件中发生变化的状态可通过提供的event 进行检索。

更改事件包括QEvent::ToolBarChange,QEvent::ActivationChange,QEvent::EnabledChange,QEvent::FontChange,QEvent::StyleChange,QEvent::PaletteChange,QEvent::WindowTitleChange,QEvent::IconTextChange,QEvent::ModifiedChange,QEvent::MouseTrackingChange,QEvent::ParentChange,QEvent::WindowStateChange,QEvent::LanguageChange,QEvent::LocaleChange,QEvent::LayoutDirectionChange,QEvent::ReadOnlyChange 。

QWidget *QWidget::childAt(int x, int y) const

返回位于 widget 坐标系中 (x,y) 位置的可见子 widget。如果在指定位置没有可见的子 widget，函数将返回nullptr 。

QWidget *QWidget::childAt(const QPoint &p) const

这是一个重载函数。

返回 Widget 坐标系中p 点的可见子 Widget。

[since 6.8] QWidget *QWidget::childAt(const QPointF &p) const

这是一个重载函数。

返回 Widget 自身坐标系中p 点的可见子 Widget。

此函数在 Qt 6.8 中引入。

void QWidget::clearFocus()

获取部件的键盘输入焦点。

如果该部件有活动焦点，则会向该部件发送focus out event ，告知它已失去焦点。

要获取键盘输入焦点，该部件必须启用焦点设置；也就是说，它必须调用setFocusPolicy() 。

另请参阅 hasFocus(),setFocus(),focusInEvent(),focusOutEvent(),setFocusPolicy() 和QApplication::focusWidget().

void QWidget::clearMask()

删除setMask() 设置的任何掩码。

另请参见 setMask().

[slot] bool QWidget::close()

关闭此 widget。如果 widget 已关闭，则返回true ；否则返回false 。

首先，它会向 Widget 发送QCloseEvent 。如果 Widgetaccepts 关闭事件，则hidden 。如果ignores 事件，则不会发生任何事情。QWidget::closeEvent() 的默认实现接受关闭事件。

如果 widget 带有Qt::WA_DeleteOnClose 标志，该 widget 也会被删除。无论窗口部件是否可见，都会向窗口部件发送关闭事件。

当设置了Qt::WA_QuitOnClose 属性的最后一个可见主窗口（即没有父窗口的窗口）关闭时，就会发出QGuiApplication::lastWindowClosed() 信号。默认情况下，除了瞬时窗口（如闪屏、工具窗口和弹出菜单）外，所有窗口部件都设置了该属性。

[virtual protected] void QWidget::closeEvent(QCloseEvent *event)

当 Qt Widgets 从窗口系统接收到顶层 widget 的窗口关闭请求时，该事件处理程序将被调用，给定值为event 。

默认情况下，该事件被接受，窗口部件被关闭。您可以重新实现该函数，以改变窗口部件响应窗口关闭请求的方式。例如，可以通过在所有事件中调用ignore() 来阻止窗口关闭。

主窗口应用程序通常使用该函数的重新实现来检查用户的工作是否已保存，并在关闭前征求用户许可。

另请参阅 event()、hide()、close() 和QCloseEvent 。

QMargins QWidget::contentsMargins() const

contentsMargins 函数返回 widget 的内容页边距。

另请参阅 setContentsMargins() 和contentsRect()。

QRect QWidget::contentsRect() const

返回 widget 边距内的区域。

另请参阅 setContentsMargins() 和contentsMargins()。

[virtual protected] void QWidget::contextMenuEvent(QContextMenuEvent *event)

该事件处理程序用于事件event ，可在子类中重新实现，以接收部件上下文菜单事件。

当部件的contextMenuPolicy 是Qt::DefaultContextMenu 时，该处理程序将被调用。

默认实现会忽略上下文事件。详情请参见QContextMenuEvent 文档。

另请参阅 event(),QContextMenuEvent, 和customContextMenuRequested().

[protected] void QWidget::create(WId window = 0, bool initializeWindow = true, bool destroyOldWindow = true)

创建新的 widget 窗口。

在 Qt XML 5 中，参数window 、initializeWindow 和destroyOldWindow 将被忽略。请使用QWindow::fromWinId() 创建一个封装外来窗口的QWindow ，并将其传递给QWidget::createWindowContainer() 。

另请参阅 createWindowContainer() 和QWindow::fromWinId()。

[static] QWidget *QWidget::createWindowContainer(QWindow *window, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

创建QWidget ，以便将window 嵌入基于QWidget 的应用程序。

窗口容器是作为parent 的子窗口创建的，并带有窗口标志flags 。

窗口嵌入容器后，容器将控制窗口的几何形状和可见性。不建议在嵌入窗口上明确调用QWindow::setGeometry(),QWindow::show() 或QWindow::hide() 。

容器将接管window 的所有权。可以通过调用QWindow::setParent() 将窗口从窗口容器中移除。

窗口容器作为本机子窗口附加到它是其子窗口的顶层窗口。当窗口容器作为QAbstractScrollArea 或QMdiArea 的子窗口使用时，它将为其父链中的每个部件创建一个native window ，以便在这种使用情况下进行适当的堆叠和剪切。为窗口容器创建本地窗口也可以实现正确的堆叠和剪切。这必须在显示窗口容器之前完成。有许多本地子窗口的应用程序可能会出现性能问题。

窗口容器有一些已知的限制：

• 堆叠顺序；嵌入式窗口将以不透明框的形式堆叠在窗口部件层次结构的顶部。多个重叠窗口容器实例的堆叠顺序未定义。
• 渲染集成；窗口容器不能与QGraphicsProxyWidget 、QWidget::render() 或类似功能互操作。
• 焦点处理；可以让窗口容器实例拥有任何焦点策略，它将通过调用QWindow::requestActivate() 把焦点委托给窗口。不过，从QWindow 实例返回正常焦点链将取决于QWindow 实例本身的实现。此外，QWindow::requestActivate() 是否会真正给予窗口焦点也与平台有关。

  自 6.8 版起，如果嵌入基于Qt Quick 的窗口，按下制表符会进出嵌入的 QML 窗口，允许焦点移动到窗口容器链中的下一个或上一个可聚焦对象。

• 在基于QWidget 的应用程序中使用多个窗口容器实例会大大降低应用程序的整体性能。
• 自 6.7 起，如果window 属于一个窗口部件（即window 是通过调用windowHandle() 收到的），则不会创建容器。取而代之的是，该函数将在重新泛型到parent 之后返回部件本身。由于不会创建容器，flags 将被忽略。换句话说，如果window 属于一个部件，可以考虑将该部件重新转到parent ，而不是使用此函数。

[signal] void QWidget::customContextMenuRequested(const QPoint &pos)

当窗口小部件的contextMenuPolicy 是Qt::CustomContextMenu ，且用户请求在窗口小部件上使用上下文菜单时，就会发出该信号。位置pos 是 widget 接收到的上下文菜单事件的位置。通常这是以部件坐标为单位的。但QAbstractScrollArea 及其子类除外，它们将上下文菜单事件映射到viewport() 的坐标上。

另请参阅 mapToGlobal(),QMenu, 和contextMenuPolicy 。

[protected] void QWidget::destroy(bool destroyWindow = true, bool destroySubWindows = true)

释放窗口系统资源。如果destroyWindow 为 true，则销毁窗口小部件。

destroy()会递归调用所有子窗口小部件，并为destroyWindow 参数传递destroySubWindows 。要对子窗口小部件的销毁有更多控制，可先有选择地销毁子窗口小部件。

该函数通常从QWidget 析构函数中调用。

[virtual protected] void QWidget::dragEnterEvent(QDragEnterEvent *event)

拖动过程中，鼠标进入该部件时，将调用该事件处理程序。该事件通过event 参数传递。

如果忽略该事件，该部件将不会收到任何drag move events 。

有关如何在应用程序中提供拖放功能的概述，请参阅拖放文档。

另请参阅 QDrag 和QDragEnterEvent 。

[virtual protected] void QWidget::dragLeaveEvent(QDragLeaveEvent *event)

拖动过程中，鼠标离开该部件时，将调用该事件处理程序。该事件通过event 参数传递。

有关如何在应用程序中提供拖放功能的概述，请参阅拖放文档。

另请参阅 QDrag 和QDragLeaveEvent 。

[virtual protected] void QWidget::dragMoveEvent(QDragMoveEvent *event)

如果正在进行拖动，并且出现以下任何一种情况：光标进入此 widget、光标在此 widget 内移动，或者在此 widget 拥有焦点时按下键盘上的修改键，则会调用此事件处理程序。事件将通过event 参数传递。

有关如何在应用程序中提供拖放功能的概述，请参阅拖放文档。

另请参阅 QDrag 和QDragMoveEvent 。

[virtual protected] void QWidget::dropEvent(QDropEvent *event)

拖放到该部件上时，该事件处理程序将被调用。该事件通过event 参数传递。

有关如何在应用程序中提供拖放功能的概述，请参阅拖放文档。

另请参阅 QDrag 和QDropEvent 。

WId QWidget::effectiveWinId() const

返回 widget 的有效窗口系统标识符，即本地父窗口系统标识符。

如果 widget 是本地 widget，该函数将返回本地 widget ID。否则，将返回第一个本地父 widget（即包含该 widget 的顶级 widget）的窗口 ID。

另请参见 nativeParentWidget()。

void QWidget::ensurePolished() const

确保 Widget 及其子控件已通过QStyle 进行了润色（即具有合适的字体和调色板）。

QWidget 在完全构建后但首次显示前调用此函数。如果您想在执行操作前确保 widget 已抛光，例如，在重新实现 widget 的 () 时可能需要正确的字体大小，则可以调用此函数。请注意，该函数是从 () 的默认实现中调用sizeHint sizeHint的。

抛光功能适用于在调用所有构造函数（基类和子类的构造函数）后必须进行的最终初始化。

如果需要在部件抛光时更改某些设置，可重新实现event() 并处理QEvent::Polish 事件类型。

注：该函数声明为常量，因此可以从其他常量函数（如sizeHint()) 中调用。

另请参见 event()。

[virtual protected] void QWidget::enterEvent(QEnterEvent *event)

该事件处理程序可在子类中重新实现，以接收通过event 参数传递的部件进入事件。

当鼠标光标进入部件时，事件将被发送到部件。

另请参阅 leaveEvent()、mouseMoveEvent() 和event()。

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

重实现：QObject::event(QEvent *e)。

这是主事件处理程序；它处理事件event 。您可以在子类中重新实现该函数，但我们建议您使用专门的事件处理程序。

按键按下和松开事件的处理方式与其他事件不同。event() 会检查 Tab 和 Shift+Tab 并尝试适当移动焦点。如果没有可移动焦点的部件（或按键不是 Tab 或 Shift+Tab），event() 会调用keyPressEvent()。

鼠标和平板电脑事件处理也略显特殊：只有当窗口部件是enabled 时，event() 才会调用专门的处理程序，如mousePressEvent()；否则就会丢弃事件。

如果事件被识别，则该函数返回true ，否则返回false 。如果已识别的事件被接受（参见QEvent::accepted ），则会停止任何进一步的处理，例如将事件传播到父部件。

另请参阅 closeEvent(),focusInEvent(),focusOutEvent(),enterEvent(),keyPressEvent(),keyReleaseEvent(),leaveEvent(),mouseDoubleClickEvent(),mouseMoveEvent(),mousePressEvent(),mouseReleaseEvent(),moveEvent(),paintEvent(),resizeEvent(),QObject::event(), 和QObject::timerEvent() 。

[static] QWidget *QWidget::find(WId id)

返回带有窗口标识符/句柄id 的 widget 指针。

窗口标识符类型取决于底层窗口系统，实际定义请参见qwindowdefs.h 。如果没有具有此标识符的窗口部件，则返回nullptr 。

[virtual protected] void QWidget::focusInEvent(QFocusEvent *event)

该事件处理程序可在子类中重新实现，以接收部件的键盘焦点事件（收到焦点）。事件在event 参数中传递。

通常，部件必须将setFocusPolicy() 设为Qt::NoFocus 以外的值，才能接收焦点事件。(请注意，应用程序编程人员可以在任何部件上调用setFocus() ，即使是那些通常不接受焦点的部件。）

默认实现会更新窗口部件（未指定focusPolicy() 的窗口除外）。

另请参阅 focusOutEvent(),setFocusPolicy(),keyPressEvent(),keyReleaseEvent(),event() 和QFocusEvent 。

[protected] bool QWidget::focusNextChild()

根据Tab 的情况，查找一个新的窗口部件来给予键盘焦点，如果能找到新的窗口部件，则返回true ，如果找不到，则返回 false。

另请参阅 focusPreviousChild() 。

[virtual protected] bool QWidget::focusNextPrevChild(bool next)

根据 Tab 和 Shift+Tab 的情况，查找一个新的部件，将键盘焦点赋予该部件，如果能找到新部件，则返回true ；如果找不到，则返回 false。

如果next 为真，则向前搜索，如果next 为假，则向后搜索。

有时，您需要重新实现这个函数。例如，网络浏览器可能会重新执行该函数，以向前或向后移动 "当前活动链接"，并仅在到达 "页面 "上的最后或第一个链接时才调用 focusNextPrevChild()。

子窗口部件会调用父窗口部件的 focusNextPrevChild()，但只有包含子窗口部件的窗口才会决定将焦点重定向到哪里。通过为一个对象重新实现该函数，您就可以控制所有子窗口部件的焦点遍历。

另请参见 focusNextChild() 和focusPreviousChild()。

[virtual protected] void QWidget::focusOutEvent(QFocusEvent *event)

该事件处理程序可在子类中重新实现，以接收部件的键盘焦点事件（焦点丢失）。事件将通过event 参数传递。

要接收焦点事件，部件通常必须将setFocusPolicy() 设为Qt::NoFocus 以外的值。(请注意，应用程序编程人员可以在任何部件上调用setFocus() ，即使是那些通常不接受焦点的部件。）

默认实现会更新窗口部件（未指定focusPolicy() 的窗口除外）。

另请参阅 focusInEvent(),setFocusPolicy(),keyPressEvent(),keyReleaseEvent(),event() 和QFocusEvent 。

[protected] bool QWidget::focusPreviousChild()

根据Shift+Tab 的情况，查找一个新的窗口部件来给予键盘焦点，如果能找到新的窗口部件，则返回true ，如果找不到，则返回 false。

另请参阅 focusNextChild() 。

QWidget *QWidget::focusProxy() const

返回焦点代理，如果没有焦点代理，则返回nullptr 。

另请参阅 setFocusProxy().

QWidget *QWidget::focusWidget() const

返回setFocus 调用过的本窗口部件的最后一个子窗口部件。对于顶层窗口部件，这是在本窗口被激活时获得焦点的窗口部件。

这与QApplication::focusWidget() 不同，后者返回的是当前活动窗口中的焦点部件。

QFontInfo QWidget::fontInfo() const

返回 widget 当前字体的字体信息。等同于QFontInfo(widget->font()) 。

另请参阅 font()、fontMetrics() 和setFont()。

QFontMetrics QWidget::fontMetrics() const

返回 widget 当前字体的度量值。等同于QFontMetrics(widget->font()) 。

另请参阅 font()、fontInfo() 和setFont()。

QPalette::ColorRole QWidget::foregroundRole() const

返回前景角色。

前景角色定义了用于绘制前景的部件palette 中的颜色。

如果没有设置明确的前景角色，函数将返回一个与背景角色形成对比的角色。

另请参阅 setForegroundRole() 和backgroundRole()。

[invokable] QPixmap QWidget::grab(const QRect &rectangle = QRect(QPoint(0, 0), QSize(-1, -1)))

将 widget 渲染成受给定rectangle 限制的像素图。如果 widget 有任何子控件，也会在适当的位置绘制。

如果指定的矩形大小无效（默认），则会绘制整个 widget。

另请参阅 render() 和QPixmap 。

void QWidget::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())

通过特定flags 将 widget 订阅到指定的gesture 。

另请参阅 ungrabGesture() 和QGestureEvent 。

void QWidget::grabKeyboard()

抓取键盘输入。

在调用releaseKeyboard() 之前，该部件会接收所有键盘事件；其他部件则不会接收任何键盘事件。鼠标事件不受影响。如果要抓取鼠标事件，请使用grabMouse() 。

除了不会接收任何键盘事件外，焦点部件不受影响。setFocus() 会像往常一样移动焦点，但新的焦点部件只有在调用releaseKeyboard() 后才会接收键盘事件。

如果当前有其他部件正在抓取键盘输入，则会先释放该部件的抓取。

另请参阅 releaseKeyboard()、grabMouse()、releaseMouse() 和focusWidget()。

void QWidget::grabMouse()

抓取鼠标输入。

在调用releaseMouse() 之前，该 widget 会接收所有鼠标事件；其他 widget 则不会接收任何鼠标事件。键盘事件不受影响。如果要抓取键盘事件，请使用grabKeyboard() 。

使用 Qt 时很少需要抓取鼠标，因为 Qt 抓取和释放鼠标都很合理。特别是，当鼠标按钮被按下时，Qt 会抓取鼠标，并一直保持到最后一个按钮被释放。

另请参阅 releaseMouse()、grabKeyboard() 和releaseKeyboard()。

void QWidget::grabMouse(const QCursor &cursor)

此函数重载 grabMouse()。

抓取鼠标输入并改变光标形状。

光标将呈现cursor 的形状（只要鼠标焦点被抓取），在调用releaseMouse()() 之前，该窗口小部件将是唯一一个接收鼠标事件的窗口小部件。

另请参见 releaseMouse()、grabKeyboard()、releaseKeyboard() 和setCursor()。

int QWidget::grabShortcut(const QKeySequence &key, Qt::ShortcutContext context = Qt::WindowShortcut)

为 Qt 的快捷方式系统添加快捷方式，该快捷方式会在给定的context 中观察给定的key 序列。如果context 是Qt::ApplicationShortcut ，则快捷方式适用于整个应用程序。否则，它要么是本窗口部件（Qt::WidgetShortcut ）的本地快捷方式，要么是窗口本身（Qt::WindowShortcut ）的本地快捷方式。

如果同一个key 序列已被多个部件抓取，则当key 序列出现时，将以非确定的顺序向其适用的所有部件发送QEvent::Shortcut 事件，但 "明确 "标志将设为 true。

另请参见 releaseShortcut() 和setShortcutEnabled()。

QGraphicsEffect *QWidget::graphicsEffect() const

graphicsEffect 函数返回指向 widget 图形效果的指针。

如果 widget 没有图形效果，则返回nullptr 。

另请参阅 setGraphicsEffect().

QGraphicsProxyWidget *QWidget::graphicsProxyWidget() const

返回图形视图中相应嵌入部件的代理部件；否则返回nullptr 。

另请参阅 QGraphicsProxyWidget::createProxyForChildWidget() 和QGraphicsScene::addWidget()。

bool QWidget::hasEditFocus() const

如果此 widget 当前具有编辑焦点，则返回true ；否则返回 false。

此功能仅在 Qt for Embedded Linux 中可用。

另请参阅 setEditFocus() 和QApplication::navigationMode()。

[virtual] bool QWidget::hasHeightForWidth() const

如果 widget 的首选高度取决于其宽度，则返回true ；否则返回false 。

[virtual] int QWidget::heightForWidth(int w) const

在给定宽度w 的情况下，返回此 widget 的首选高度。

如果此 widget 有布局，默认实现将返回布局的首选高度。如果没有布局，默认实现将返回 -1 表示首选高度与宽度无关。

[slot] void QWidget::hide()

隐藏 widget。该函数等同于setVisible(false)。

另请参阅 hideEvent()、isHidden()、show()、setVisible()、isVisible() 和close()。

[virtual protected] void QWidget::hideEvent(QHideEvent *event)

该事件处理程序可在子类中重新实现，以接收部件隐藏事件。事件将通过event 参数传递。

隐藏事件会在部件隐藏后立即发送给部件。

注：当窗口系统改变窗口部件的映射状态时，该部件会接收自发显示和隐藏事件，例如，当用户最小化窗口时会接收自发隐藏事件，而当窗口再次恢复时又会接收自发显示事件。在收到自发隐藏事件后，根据isVisible() 的意义，部件仍被视为可见。

另请参见 visible 、event() 和QHideEvent 。

[override virtual protected] void QWidget::initPainter(QPainter *painter) const

初始化painter 钢笔、背景和字体，使其与给定 widget 的相同。当绘画器在QWidget 上打开时，该函数将被自动调用。

[virtual protected] void QWidget::inputMethodEvent(QInputMethodEvent *event)

该事件处理程序用于事件event ，可在子类中重新实现，以接收输入法组成事件。当输入法的状态发生变化时，该处理程序将被调用。

请注意，在创建自定义文本编辑部件时，必须明确设置Qt::WA_InputMethodEnabled window 属性（使用setAttribute() 函数），才能接收输入法事件。

默认实现调用 event->ignore()，它会拒绝输入法事件。详情请参见QInputMethodEvent 文档。

另请参阅 event() 和QInputMethodEvent 。

[virtual] QVariant QWidget::inputMethodQuery(Qt::InputMethodQuery query) const

该方法仅适用于输入部件。输入法使用它来查询 widget 的一组属性，以便支持复杂的输入法操作，如支持周围文本和重新转换。

query 指定要查询的属性。

另请参阅 inputMethodEvent(),QInputMethodEvent,QInputMethodQueryEvent, 和inputMethodHints 。

void QWidget::insertAction(QAction *before, QAction *action)

将操作action 插入该 widget 的操作列表，位于操作before 之前。如果before 是nullptr 或before 不是该 widget 的有效操作，则会追加该操作。

QWidget 的每个操作只能有一个。

另请参阅 removeAction(),addAction(),QMenu,contextMenuPolicy, 和actions() 。

void QWidget::insertActions(QAction *before, const QList<QAction *> &actions)

将操作actions 插入此 widget 的操作列表，位于操作before 之前。如果before 是nullptr 或before 不是该 widget 的有效操作，则会追加该操作。

一个QWidget 最多只能有一个动作。

另请参阅 removeAction(),QMenu,insertAction() 和contextMenuPolicy 。

bool QWidget::isAncestorOf(const QWidget *child) const

如果此窗口小部件是给定child 的父窗口（或祖窗口，依此类推，直到任意一级），且两个窗口小部件位于同一窗口内，则返回true ；否则返回false 。

bool QWidget::isEnabledTo(const QWidget *ancestor) const

如果ancestor 已启用，则返回true ；否则返回false 。

如果微件本身或ancestor 之前（不包括 ）的每个父代都未明确禁用，则会出现这种情况。

isEnabledTo(0) 如果此部件或其任何祖先被明确禁用，则返回 false。

这里的祖先指的是同一窗口中的父窗口部件。

因此，isEnabledTo(0) 只适用于此窗口部件的窗口，这与isEnabled() 不同，后者也会考虑父窗口。

另请参见 setEnabled() 和enabled 。

bool QWidget::isHidden() const

如果部件是隐藏的，则返回true ，否则返回false 。

只有在调用show() 时，隐藏的 widget 才会变为可见。当父部件显示时，它不会自动显示。

要检查可见性，请使用 !isVisible() 代替（注意感叹号）。

isHidden() 意味着 !isVisible()，但一个部件可以同时不可见和不隐藏。作为不可见部件的子部件的部件就属于这种情况。

在以下情况下，部件是隐藏的

• 它们是作为独立窗口创建的、
• 作为可见部件的子部件创建、
• hide() 或setVisible(false) 被调用。

bool QWidget::isVisibleTo(const QWidget *ancestor) const

如果在ancestor 显示时该窗口小部件将变为可见，则返回true ；否则返回false 。

如果窗口部件本身或任何父窗口（不包括ancestor ）都没有被明确隐藏，则返回 true。

如果窗口小部件被屏幕上的其他窗口遮挡，但如果它或它们被移动，该函数仍会返回 true。

isVisibleTo(0) 与isVisible() 相同。

另请参阅 show()、hide() 和isVisible()。

bool QWidget::isWindow() const

如果窗口部件是独立窗口，则返回true ，否则返回false 。

窗口是一个在视觉上不是任何其他窗口的子窗口，通常有一个框架和一个window title 。

窗口可以有一个parent widget 。窗口将与其父窗口分组，并在父窗口删除时被删除，在父窗口最小化时被最小化。如果窗口管理器支持，它还将与其父窗口拥有一个共同的任务栏条目。

QDialog 和 部件默认为窗口，即使在构造函数中指定了父部件。这一行为由 标志指定。QMainWindow Qt::Window

另请参阅 window()、isModal() 和parentWidget()。

[virtual protected] void QWidget::keyPressEvent(QKeyEvent *event)

event 的事件处理程序，可以在子类中重新实现，以接收部件的按键事件。

要接收按键事件，部件必须调用setFocusPolicy() 初始化接受焦点并拥有焦点。

如果重新实现该处理程序，如果不对按键采取行动，则必须调用基类的实现，这一点非常重要。

如果用户按下QKeySequence::Cancel 的按键序列（通常是 Escape 键），默认实现会关闭弹出窗口部件。否则，该事件将被忽略，以便窗口小部件的父类可以解释该事件。

请注意，QKeyEvent 以 isAccepted() == true 开始，因此无需调用QKeyEvent::accept() - 只要在按键时不调用基类实现即可。

另请参阅 keyReleaseEvent()、setFocusPolicy()、focusInEvent()、focusOutEvent()、event() 和QKeyEvent 。

[virtual protected] void QWidget::keyReleaseEvent(QKeyEvent *event)

该事件处理程序用于事件event ，可在子类中重新实现，以接收部件的按键释放事件。

要接收按键释放事件，部件必须在初始accept focus 和have focus 。

如果重新实现该处理程序，如果不对按键采取行动，则必须调用基类实现。

默认实现会忽略该事件，因此部件的父类可以解释该事件。

请注意，QKeyEvent 以 isAccepted() == true 开始，因此您不需要调用QKeyEvent::accept() - 只要不调用基类实现（如果您对按键采取行动）。

另请参见 keyPressEvent()、QEvent::ignore()、setFocusPolicy()、focusInEvent()、focusOutEvent()、event() 和QKeyEvent 。

[static] QWidget *QWidget::keyboardGrabber()

返回当前正在抓取键盘输入的部件。

如果此应用程序中没有当前正在抓取键盘输入的部件，则返回nullptr 。

另请参阅 grabMouse() 和mouseGrabber()。

QLayout *QWidget::layout() const

返回已安装在此 widget 上的布局管理器，如果未安装布局管理器，则返回nullptr 。

布局管理器会设置已添加到布局中的 widget 子控件的几何图形。

另请参阅 setLayout(),sizePolicy() 和布局管理。

[virtual protected] void QWidget::leaveEvent(QEvent *event)

该事件处理程序可在子类中重新实现，以接收通过event 参数传递的部件离开事件。

当鼠标光标离开部件时，离开事件就会发送到部件。

另请参阅 enterEvent()、mouseMoveEvent() 和event()。

[slot] void QWidget::lower()

将 widget 降到父 widget 堆栈的底部。

调用后，该 widget 将被任何重叠的同级 widget 遮挡。

另请参阅 raise() 和stackUnder()。

[since 6.0] QPointF QWidget::mapFrom(const QWidget *parent, const QPointF &pos) const

将 Widget 坐标pos 从parent 的坐标系转换为该 Widget 的坐标系。parent 必须不是nullptr ，而且必须是调用 widget 的父级。

此函数在 Qt 6.0 中引入。

另请参阅 mapTo()、mapFromParent()、mapFromGlobal() 和underMouse() 。

QPoint QWidget::mapFrom(const QWidget *parent, const QPoint &pos) const

这是一个重载函数。

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

将全局屏幕坐标pos 转换为部件坐标。

此函数在 Qt 6.0 中引入。

另请参阅 mapToGlobal()、mapFrom() 和mapFromParent()。

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

这是一个重载函数。

[since 6.0] QPointF QWidget::mapFromParent(const QPointF &pos) const

将父部件坐标pos 转换为部件坐标。

如果 widget 没有父级，则与mapFromGlobal() 相同。

此函数在 Qt 6.0 中引入。

另请参阅 mapToParent()、mapFrom()、mapFromGlobal() 和underMouse()。

QPoint QWidget::mapFromParent(const QPoint &pos) const

这是一个重载函数。

[since 6.0] QPointF QWidget::mapTo(const QWidget *parent, const QPointF &pos) const

将 widget 坐标pos 转换为parent 的坐标系。parent 必须不是nullptr ，并且必须是调用 widget 的父级。

此函数在 Qt 6.0 中引入。

另请参阅 mapFrom()、mapToParent()、mapToGlobal() 和underMouse() 。

QPoint QWidget::mapTo(const QWidget *parent, const QPoint &pos) const

这是一个重载函数。

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

将 Widget 坐标pos 转换为全局屏幕坐标。例如，mapToGlobal(QPointF(0,0)) 将给出 widget 左上角像素的全局坐标。

此函数在 Qt 6.0 中引入。

另请参阅 mapFromGlobal()、mapTo() 和mapToParent()。

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

这是一个重载函数。

[since 6.0] QPointF QWidget::mapToParent(const QPointF &pos) const

将 widget 坐标pos 转换为父 widget 中的坐标。

如果 widget 没有父 widget，则与mapToGlobal() 相同。

此函数在 Qt 6.0 中引入。

另请参阅 mapFromParent()、mapTo()、mapToGlobal() 和underMouse()。

QPoint QWidget::mapToParent(const QPoint &pos) const

这是一个重载函数。

QRegion QWidget::mask() const

返回当前在 widget 上设置的屏蔽。如果未设置掩码，返回值将是一个空区域。

另请参阅 setMask()、clearMask() 和QRegion::isEmpty()。

[override virtual protected] int QWidget::metric(QPaintDevice::PaintDeviceMetric m) const

重实现：QPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const.

虚拟QPaintDevice::metric() 函数的内部实现。

m 是要获取的度量值。

[virtual protected] void QWidget::mouseDoubleClickEvent(QMouseEvent *event)

该事件处理程序用于事件event ，可在子类中重新实现，以接收 widget 的鼠标双击事件。

默认实现调用mousePressEvent() 。

另请参阅 mousePressEvent(),mouseReleaseEvent(),mouseMoveEvent(),event() 和QMouseEvent 。

[static] QWidget *QWidget::mouseGrabber()

返回当前抓取鼠标输入的部件。

如果此应用程序中没有当前正在抓取鼠标的部件，则返回nullptr 。

另请参阅 grabMouse() 和keyboardGrabber()。

[virtual protected] void QWidget::mouseMoveEvent(QMouseEvent *event)

event 的事件处理程序，可以在子类中重新实现，以接收部件的鼠标移动事件。

如果关闭鼠标跟踪功能，只有在移动鼠标时按下鼠标按钮，才会发生鼠标移动事件。如果开启了鼠标跟踪功能，即使没有按下鼠标按钮，也会发生鼠标移动事件。

QMouseEvent::pos() 报告鼠标光标相对于此 widget 的位置。对于按下和松开事件，位置通常与上次鼠标移动事件的位置相同，但如果用户的手晃动，位置可能会不同。这是底层窗口系统的特性，与 Qt 无关。

如果您想在鼠标移动时立即显示工具提示（例如，使用 QMouseEvent::pos() 获取鼠标坐标并将其显示为工具提示），您必须首先如上所述启用鼠标跟踪。然后，为了确保立即更新工具提示，您必须在实现 mouseMoveEvent() 时调用QToolTip::showText() 而不是setToolTip()。

另请参阅 setMouseTracking()、mousePressEvent()、mouseReleaseEvent()、mouseDoubleClickEvent()、event()、QMouseEvent 和Scribble 示例。

[virtual protected] void QWidget::mousePressEvent(QMouseEvent *event)

event 的事件处理程序，可以在子类中重新实现，以接收部件的鼠标按压事件。

如果在 mousePressEvent() 中创建新的窗口小部件，mouseReleaseEvent() 可能不会出现在你期望的位置，这取决于底层窗口系统（或 X11 窗口管理器）、窗口小部件的位置以及其他因素。

默认实现会在点击窗口外时关闭弹出窗口部件。对于其他窗口小部件类型，则不执行任何操作。

另请参阅 mouseReleaseEvent(),mouseDoubleClickEvent(),mouseMoveEvent(),event(),QMouseEvent 和Scribble 示例。

[virtual protected] void QWidget::mouseReleaseEvent(QMouseEvent *event)

该事件处理程序用于事件event ，可在子类中重新实现，以接收部件的鼠标释放事件。

另请参阅 mousePressEvent(),mouseDoubleClickEvent(),mouseMoveEvent(),event(),QMouseEvent 和Scribble 示例。

void QWidget::move(int x, int y)

这是一个重载函数。

与 move(QPoint(x,y)) 相对应。

[virtual protected] void QWidget::moveEvent(QMoveEvent *event)

该事件处理程序可在子类中重新实现，以接收通过event 参数传递的部件移动事件。当部件接收到该事件时，它已处于新位置。

旧位置可通过QMoveEvent::oldPos() 访问。

另请参阅 resizeEvent(),event(),move() 和QMoveEvent 。

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

可以在子类中重新实现这个特殊事件处理程序，以接收由eventType 标识的本地平台事件，这些事件在message 参数中传递。

在重新实现此函数时，如果要停止 Qt 处理事件，则返回 true 并设置result 。result 参数仅对 Windows 有意义。如果返回 false，该本地事件将传回 Qt，Qt 会将事件转换为 Qt 事件并发送给 widgets。

另请参见 QAbstractNativeEventFilter 。

QWidget *QWidget::nativeParentWidget() const

返回此 widget 的原生父对象，即具有系统标识符的下一个祖先 widget，如果没有任何原生父对象，则返回nullptr 。

另请参见 effectiveWinId()。

QWidget *QWidget::nextInFocusChain() const

返回此 widget 焦点链中的下一个 widget。

另请参阅 previousInFocusChain()。

void QWidget::overrideWindowFlags(Qt::WindowFlags flags)

将窗口部件的窗口标志设置为flags ，而不告诉窗口系统。

另请参阅 setWindowFlags() 。

[override virtual] QPaintEngine *QWidget::paintEngine() const

重实现：QPaintDevice::paintEngine() 常量。

返回 widget 的绘制引擎。

请注意，用户不应明确调用此函数，因为它仅用于重新实现目的。该函数由 Qt 内部调用，默认实现可能并不总是返回有效指针。

[virtual protected] void QWidget::paintEvent(QPaintEvent *event)

该事件处理程序可在子类中重新实现，以接收event 中传递的绘制事件。

绘制事件是重新绘制全部或部分窗口部件的请求。发生该事件的原因如下：

• repaint(调用了（）或update （）、
• 窗口部件被遮挡，现在又被揭开，或者其他许多原因。
• 许多其他原因。

许多部件在被要求时可以简单地重新绘制整个表面，但有些速度较慢的部件需要进行优化，只绘制所要求的区域：QPaintEvent::region() 。这种速度优化不会改变结果，因为在事件处理过程中，绘制会被剪切到该区域。例如，QListView 和QTableView 就是这样做的。

Qt 还尝试通过将多个绘制事件合并为一个事件来加快绘制速度。当update() 被多次调用或窗口系统发送多个绘制事件时，Qt 会将这些事件合并为一个具有较大区域的事件（参见QRegion::united()）。repaint() 函数不允许进行这种优化，因此我们建议尽可能使用update()。

当绘制事件发生时，更新区域通常已被擦除，因此您是在部件的背景上进行绘制。

可以使用setBackgroundRole() 和setPalette() 设置背景。

自 Qt 4.0 起，QWidget 会自动对绘画进行双缓冲，因此无需在 paintEvent() 中编写双缓冲代码以避免闪烁。

另请参阅 event(),repaint(),update(),QPainter,QPixmap,QPaintEvent, 和模拟时钟。

QWidget *QWidget::parentWidget() const

返回此 widget 的父 widget，如果没有父 widget，则返回nullptr 。

QWidget *QWidget::previousInFocusChain() const

previousInFocusChain 函数返回此 widget 焦点链中的前一个 widget。

另请参阅 nextInFocusChain()。

[slot] void QWidget::raise()

将此 widget 提升到父 widget 堆栈的顶部。

调用此函数后，该窗口小部件在视觉上将位于任何重叠的同级窗口小部件之前。

另请参阅 lower() 和stackUnder()。

void QWidget::releaseKeyboard()

释放键盘抓取。

另请参阅 grabKeyboard()、grabMouse() 和releaseMouse()。

void QWidget::releaseMouse()

释放鼠标抓取。

另请参阅 grabMouse()、grabKeyboard() 和releaseKeyboard()。

void QWidget::releaseShortcut(int id)

从 Qt 的快捷方式系统中删除带有给定id 的快捷方式。该 widget 将不再接收该快捷方式按键序列的QEvent::Shortcut 事件（除非它有其他按键序列相同的快捷方式）。

另请参阅 grabShortcut() 和setShortcutEnabled()。

void QWidget::removeAction(QAction *action)

从该 widget 的操作列表中删除操作action 。

另请参阅 insertAction()、actions() 和insertAction()。

void QWidget::render(QPaintDevice *target, const QPoint &targetOffset = QPoint(), const QRegion &sourceRegion = QRegion(), QWidget::RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren))

使用renderFlags 决定渲染方式，将此 widget 的sourceRegion 渲染至target 。渲染从target 中的targetOffset 开始。例如：

QPixmap pixmap(widget->size());
widget->render(&pixmap);

如果sourceRegion 是空区域，该函数将使用QWidget::rect() 作为区域，即整个部件。

确保在渲染之前为target 设备的活动绘制器（如果有）调用QPainter::end() 。例如

QPainter painter(this);
...
painter.end();
myWidget->render(this);

void QWidget::render(QPainter *painter, const QPoint &targetOffset = QPoint(), const QRegion &sourceRegion = QRegion(), QWidget::RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren))

这是一个重载函数。

将 widget 渲染到painter 的QPainter::device() 中。

渲染时将使用应用于painter 的变换和设置。

另请参阅 QPainter::device() 。

[slot] void QWidget::repaint()

通过立即调用paintEvent() 直接重绘部件，除非已禁用更新或部件已隐藏。

我们建议只有在需要立即重绘（例如在动画期间）时才使用 repaint()。在大多数情况下，update() 更好，因为它允许 Qt 优化速度并尽量减少闪烁。

另请参阅 update()、paintEvent() 和setUpdatesEnabled()。

void QWidget::repaint(const QRect &rect)

这是一个重载函数。

该版本会在 widget 内重新绘制一个矩形rect 。

void QWidget::repaint(const QRegion &rgn)

这是一个重载函数。

该版本将重新绘制 widget 内部的一个区域rgn 。

void QWidget::repaint(int x, int y, int w, int h)

这是一个重载函数。

该版本会在 widget 内重新绘制一个矩形 (x,y,w,h)。

如果w 为负数，则替换为width() - x ；如果h 为负数，则替换为宽度height() - y 。

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

这是一个重载函数。

与 resize(QSize(w,h)) 相对应。

[virtual protected] void QWidget::resizeEvent(QResizeEvent *event)

该事件处理程序可在子类中重新实现，以接收通过event 参数传递的部件大小调整事件。调用 resizeEvent() 时，窗口部件已经有了新的几何尺寸。旧尺寸可通过QResizeEvent::oldSize() 访问。

处理完调整大小事件后，widget 将立即被擦除并收到一个绘制事件。无需（或不应）在此处理程序中进行绘制。

另请参阅 moveEvent(),event(),resize(),QResizeEvent,paintEvent() 和Scribble 示例。

bool QWidget::restoreGeometry(const QByteArray &geometry)

恢复存储在字节数组geometry 中的顶层部件的几何形状和状态。成功时返回true ，否则返回false 。

如果恢复的几何图形不在屏幕内，则会修改为在可用的屏幕几何图形内。

要恢复使用QSettings 保存的几何图形，可以使用以下代码：

QSettings settings("MyCompany", "MyApp");
myWidget->restoreGeometry(settings.value("myWidget/geometry").toByteArray());

有关窗口几何问题的概述，请参阅窗口几何文档。

使用QMainWindow::restoreState() 还原几何图形以及工具栏和停靠窗口小部件的状态。

另请参阅 saveGeometry(),QSettings,QMainWindow::saveState() 和QMainWindow::restoreState() 。

QByteArray QWidget::saveGeometry() const

保存顶层窗口部件的当前几何图形和状态。

要在窗口关闭时保存几何图形，可以执行类似的关闭事件：

void MyWidget::closeEvent(QCloseEvent *event)
{
    QSettings settings("MyCompany", "MyApp");
    settings.setValue("geometry", saveGeometry());
    QWidget::closeEvent(event);
}

有关窗口几何问题的概述，请参阅窗口几何文档。

使用QMainWindow::saveState() 保存几何图形以及工具栏和停靠窗口部件的状态。

另请参阅 restoreGeometry()、QMainWindow::saveState() 和QMainWindow::restoreState()。

QScreen *QWidget::screen() const

返回部件所在的屏幕。

另请参阅 setScreen() 和windowHandle()。

void QWidget::scroll(int dx, int dy)

向右滚动 Widget 及其子dx 像素，向下滚动dy 。dx 和dy 都可以是负数。

滚动后，部件将收到需要重新绘制区域的绘制事件。对于 Qt 知道是不透明的部件，这只是新露出的部分。例如，如果一个不透明部件向左滚动了 8 个像素，那么只有右边 8 个像素宽的条纹需要更新。

由于默认情况下，部件会传播其父部件的内容，因此需要设置autoFillBackground 属性，或使用setAttribute() 设置Qt::WA_OpaquePaintEvent 属性，才能使部件不透明。

对于使用内容传播的 widget，滚动将导致整个滚动区域的更新。

另请参见 Transparency and Double Buffering 。

void QWidget::scroll(int dx, int dy, const QRect &r)

这是一个重载函数。

该版本只滚动r ，不移动 widget 的子窗口。

如果r 为空或无效，则结果未定义。

另请参见 QScrollArea 。

void QWidget::setAttribute(Qt::WidgetAttribute attribute, bool on = true)

如果on 为 true，则设置该 widget 的属性attribute ；否则清除该属性。

另请参阅 testAttribute().

void QWidget::setBackgroundRole(QPalette::ColorRole role)

将 widget 的背景角色设置为role 。

背景角色定义了 widgetpalette 中用于渲染背景的笔刷。

如果role 是QPalette::NoRole ，那么 widget 将继承其父节点的背景角色。

请注意，样式可以自由选择调色板中的任何颜色。如果使用 setBackgroundRole() 达不到想要的效果，可以修改调色板或设置样式表。

另请参阅 backgroundRole() 和foregroundRole()。

void QWidget::setBaseSize(int basew, int baseh)

这是一个重载函数。

它与 setBaseSize(QSize(basew,baseh)) 相对应。将窗口小部件的基本尺寸设置为宽度basew 和高度baseh 。

void QWidget::setContentsMargins(int left, int top, int right, int bottom)

设置 widget 内容周围的边距大小为left,top,right, 和bottom 。边距由布局系统使用，子类可以使用边距指定要绘制的区域（例如，不包括框架）。

更改 margins 会触发resizeEvent().

另请参阅 contentsRect() 和contentsMargins()。

void QWidget::setContentsMargins(const QMargins &margins)

这是一个重载函数。

setContentsMargins 函数用于设置 widget 内容的边距。

设置 widget 内容周围的边距，其大小由margins 决定。边距由布局系统使用，子类可使用边距指定要绘制的区域（例如，不包括框架）。

更改边距将触发resizeEvent() 。

另请参阅 contentsRect() 和contentsMargins()。

[slot] void QWidget::setDisabled(bool disable)

如果disable 为 true，则禁用部件输入事件；否则启用输入事件。

更多信息请参阅enabled 文档。

另请参阅 isEnabledTo(),QKeyEvent,QMouseEvent, 和changeEvent().

void QWidget::setEditFocus(bool enable)

如果enable 为真，则使该 widget 具有编辑焦点，在这种情况下，Qt::Key_Up 和Qt::Key_Down 将正常传递给该 widget；否则，Qt::Key_Up 和Qt::Key_Down 用于更改焦点。

此功能仅在 Qt for Embedded Linux 中可用。

另请参阅 hasEditFocus() 和QApplication::navigationMode()。

void QWidget::setFixedHeight(int h)

将 widget 的最小和最大高度都设置为h ，而不改变宽度。提供方便。

另请参阅 sizeHint()、minimumSize()、maximumSize() 和setFixedSize()。

void QWidget::setFixedSize(const QSize &s)

将 widget 的最小和最大尺寸都设置为s ，从而防止其增大或缩小。

这将覆盖QLayout 设置的默认大小限制。

要移除限制，请将大小设置为QWIDGETSIZE_MAX 。

另外，如果您希望根据内容固定 widget 的大小，可以调用QLayout::setSizeConstraint(QLayout::SetFixedSize)；

另请参阅 maximumSize 和minimumSize 。

void QWidget::setFixedSize(int w, int h)

这是一个重载函数。

将小工具的宽度设为w ，高度设为h 。

void QWidget::setFixedWidth(int w)

将 widget 的最小和最大宽度都设置为w ，而不改变高度。提供方便。

另请参阅 sizeHint()、minimumSize()、maximumSize() 和setFixedSize()。

void QWidget::setFocus(Qt::FocusReason reason)

如果此窗口部件或其父级部件之一是active window ，则将键盘输入焦点赋予此窗口部件（或其焦点代理）。reason 参数将传入此函数发送的任何焦点事件中，用于解释导致窗口部件获得焦点的原因。如果窗口未激活，则当窗口激活时，该部件将获得焦点。

首先，会向焦点窗口部件（如果有）发送一个焦点即将改变事件，告诉它即将失去焦点。然后，焦点发生变化，焦点移出事件会发送到前一个焦点项，焦点移入事件会发送到新的焦点项，告诉它刚刚收到焦点。(如果焦点进入和焦点移出的部件相同，则不会发生任何情况）。

setFocus()会向窗口部件提供焦点，而不管其焦点策略如何，但不会清除任何键盘抓取（请参阅grabKeyboard() ）。

需要注意的是，如果窗口部件是隐藏的，则在显示之前不会接受焦点。

另请参阅 hasFocus(),clearFocus(),focusInEvent(),focusOutEvent(),setFocusPolicy(),focusWidget(),QApplication::focusWidget(),grabKeyboard(),grabMouse(),小工具中的键盘焦点，以及QEvent::RequestSoftwareInputPanel 。

[slot] void QWidget::setFocus()

这是一个重载函数。

如果此部件或其父级部件之一是active window ，则将键盘输入焦点赋予此部件（或其焦点代理）。

void QWidget::setFocusProxy(QWidget *w)

将 widget 的焦点代理设置为 widgetw 。如果w 是nullptr ，函数会重置该部件，使其没有焦点代理。

有些 widget 可以 "有焦点"，但会创建一个子 widget（如QLineEdit ）来实际处理焦点。在这种情况下，部件可以将行编辑设置为其焦点代理。

setFocusProxy() 设置了当 "此部件 "获得焦点时实际获得焦点的部件。如果存在焦点代理，setFocus() 和hasFocus() 将对焦点代理进行操作。如果 "此窗口部件 "是焦点窗口部件，则 setFocusProxy() 会将焦点移至新的焦点代理。

另请参见 focusProxy()。

void QWidget::setForegroundRole(QPalette::ColorRole role)

将 widget 的前景角色设置为role 。

前景角色定义了用于绘制前景的 widgetpalette 中的颜色。

如果role 是QPalette::NoRole ，widget 将使用与背景角色形成对比的前景角色。

请注意，样式可以自由选择调色板中的任何颜色。如果通过 setForegroundRole() 没有得到想要的结果，可以修改调色板或设置样式表。

另请参阅 foregroundRole() 和backgroundRole()。

void QWidget::setGeometry(int x, int y, int w, int h)

这是一个重载函数。

与 setGeometry(QRect(x,y,w,h)) 相对应。

void QWidget::setGraphicsEffect(QGraphicsEffect *effect)

setGraphicsEffect 函数用于设置 widget 的图形效果。

该函数将effect 设置为 widget 的效果。如果该 widget 上已安装了效果，QWidget 将在安装新的effect 之前删除现有效果。

如果effect 是安装在其他 widget 上的效果，setGraphicsEffect() 将删除该 widget 上的效果并将其安装到此 widget 上。

QWidget 获取 的所有权。effect

另请参阅 graphicsEffect() 。

[slot] void QWidget::setHidden(bool hidden)

方便函数，与setVisible(!hidden) 等价。

另请参见 isHidden().

void QWidget::setLayout(QLayout *layout)

将此 widget 的布局管理器设置为layout 。

如果该 widget 上已经安装了布局管理器，QWidget 不会让您安装另一个布局管理器。您必须先删除现有的布局管理器（由layout() 返回），然后才能使用新布局调用 setLayout()。

如果layout 是另一个部件上的布局管理器，setLayout() 将重新分配布局，使其成为此部件的布局管理器。

举例说明

    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(formWidget);
    setLayout(layout);

调用此函数的另一种方法是将此 widget 传递给布局的构造函数。

QWidget 将获得layout 的所有权。

另请参阅 layout() 和布局管理。

void QWidget::setMask(const QBitmap &bitmap)

只显示bitmap 对应 1 位的部件像素。如果该区域包括 widget 的rect() 以外的像素，则该区域的窗口系统控制可能可见，也可能不可见，具体取决于平台。

请注意，如果区域特别复杂，这种效果可能会很慢。

下面的代码展示了如何使用带有 alpha 通道的图像为 widget 生成遮罩：

    QLabel topLevelLabel;
    QPixmap pixmap(":/images/tux.png");
    topLevelLabel.setPixmap(pixmap);
    topLevelLabel.setMask(pixmap.mask());

这段代码所显示的标签将使用其包含的图像进行遮罩，看起来就像直接在屏幕上绘制了一幅不规则形状的图像。

蒙版部件仅在其可见部分接收鼠标事件。

另请参阅 mask()、clearMask() 和windowOpacity()。

void QWidget::setMask(const QRegion &region)

这是一个重载函数。

仅使窗口部件与region 重叠的部分可见。如果该区域包括 widgetrect() 以外的像素，则该区域的窗口系统控件可能可见也可能不可见，具体取决于平台。

由于QRegion 允许创建任意复杂的区域，因此可以根据最不规则的窗口形状制作 widget 遮罩，甚至允许显示带孔的 widget。需要注意的是，如果区域特别复杂，这种效果可能会比较慢。

窗口遮罩用于向窗口系统提示，应用程序不希望遮罩以外的区域出现鼠标事件。在大多数系统中，蒙版还会导致粗略的视觉剪切。如 "半透明背景 "示例所示，要获得平滑的窗口边缘，可使用半透明背景和反锯齿绘制。

另请参见 windowOpacity 。

void QWidget::setMaximumSize(int maxw, int maxh)

这是一个重载函数。

该函数对应于 setMaximumSize(QSize(maxw,maxh)) 。将最大宽度设为maxw ，最大高度设为maxh 。

void QWidget::setMinimumSize(int minw, int minh)

这是一个重载函数。

该函数对应于 setMinimumSize(QSize(minw, minh))。将最小宽度设为minw ，将最小高度设为minh 。

void QWidget::setParent(QWidget *parent)

将 widget 的父节点设置为parent ，并重置窗口标志。Widget 将移动到新父 Widget 的位置 (0, 0)。

如果新的父窗口小部件位于不同的窗口中，则重新设置父窗口小部件及其子窗口小部件会以与之前相同的内部顺序附加到新父窗口小部件的tab chain 末尾。如果其中一个被移动的部件有键盘焦点，setParent() 会调用该部件的clearFocus()。

如果新父窗口部件与旧父窗口部件位于同一窗口，则设置父窗口部件不会改变标签页顺序或键盘焦点。

如果 "新 "父窗口部件是旧父窗口部件，则此函数不起任何作用。

另请参见 setWindowFlags()。

void QWidget::setParent(QWidget *parent, Qt::WindowFlags f)

这是一个重载函数。

该函数还将 widget 标志f 作为参数。

void QWidget::setScreen(QScreen *screen)

将显示 widget 的屏幕设置为screen 。

设置屏幕只对窗口有意义。如有必要，widget 的窗口将在screen 上重新创建。

另请参阅 screen() 和QWindow::setScreen()。

void QWidget::setShortcutAutoRepeat(int id, bool enable = true)

如果enable 为 true，则启用自动重复给定id 的快捷方式；否则禁用。

另请参阅 grabShortcut() 和releaseShortcut()。

void QWidget::setShortcutEnabled(int id, bool enable = true)

如果enable 为 true，则启用给定id 的快捷方式；否则禁用该快捷方式。

另请参阅 grabShortcut() 和releaseShortcut()。

void QWidget::setSizeIncrement(int w, int h)

这是一个重载函数。

将 x（宽度）尺寸增量设置为w ，将 y（高度）尺寸增量设置为h 。

void QWidget::setSizePolicy(QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical)

这是一个重载函数。

将 widget 的尺寸策略设置为horizontal 和vertical ，采用标准拉伸，不以高换宽。

另请参阅 QSizePolicy::QSizePolicy() 。

void QWidget::setStyle(QStyle *style)

将窗口小部件的图形用户界面样式设置为style 。样式对象的所有权不会转移。

如果未设置样式，窗口小部件将使用应用程序的样式QApplication::style() 代替。

设置 widget 的样式对现有或未来的子 widget 没有影响。

另请参阅 style(),QStyle,QApplication::style(), 和QApplication::setStyle().

[static] void QWidget::setTabOrder(QWidget *first, QWidget *second)

将second 部件放在first 部件之后。

这实际上是从其焦点链中移除second 微件，并将其插入first 微件之后。

请注意，由于second widget 的选项卡顺序已更改，因此应按如下方式排序：

setTabOrder(a, b); // a to b
setTabOrder(b, c); // a to b to c
setTabOrder(c, d); // a to b to c to d

而不是这样：

// WRONG
setTabOrder(c, d); // c to d
setTabOrder(a, b); // a to b AND c to d
setTabOrder(b, c); // a to b to c, but not c to d

如果first 或second 有焦点代理，setTabOrder() 会正确替代该代理。

另请参阅 setFocusPolicy(),setFocusProxy() 和Widget 中的键盘焦点。

[static, since 6.6] void QWidget::setTabOrder(std::initializer_list<QWidget *> widgets)

这是一个重载函数。

通过调用QWidget::setTabOrder(QWidget *, QWidget *) 来设置widgets 列表中每对连续部件的制表符顺序。

与其像这样手动设置每对 widget：

setTabOrder(a, b); // a to b
setTabOrder(b, c); // a to b to c
setTabOrder(c, d); // a to b to c to d

你可以调用

setTabOrder({a, b, c, d}); // a to b to c to d

该调用不会创建一个封闭的标签聚焦循环。如果有更多 widget 采用Qt::TabFocus 焦点策略，则在d 上进行标签操作会将焦点移至这些 widget 中的一个，而不会移回a 。

该功能在 Qt 6.6 中引入。

另请参阅 setFocusPolicy(),setFocusProxy() 和部件中的键盘焦点。

void QWidget::setWindowFlag(Qt::WindowType flag, bool on = true)

如果on 为 true，则设置窗口标志flag ；否则清除该标志。

另请参阅 setWindowFlags()、windowFlags() 和windowType()。

void QWidget::setWindowRole(const QString &role)

将窗口的角色设置为role 。这只对 X11 上的窗口有意义。

另请参阅 windowRole() 。

void QWidget::setWindowState(Qt::WindowStates windowState)

将窗口状态设置为windowState 。窗口状态是Qt::WindowState ：Qt::WindowMinimized,Qt::WindowMaximized,Qt::WindowFullScreen, 和Qt::WindowActive 的 OR 编辑组合。

如果窗口不可见（即isVisible() 返回false ），窗口状态将在调用show() 时生效。对于可见窗口，变化是即时的。例如，要在全屏模式和正常模式之间切换，请使用以下代码：

w->setWindowState(w->windowState() ^ Qt::WindowFullScreen);