【Qt】QWidget类详解(函数篇)

蔚落 2022-11-14 13:26 484阅读 0赞

## 00. 目录 ##

### 文章目录 ###

*   *  00. 目录
     *  01. 概述
     *  02. Reimplemented Public Functions
     *  03. Public Slots
     *  04. Signals
     *  05. Static Public Members
     *  06. Protected Functions
     *  07. Reimplemented Protected Functions
     *  08. Protected Slots
     *  09. Macros
     *  10. 函数
     *  11. 附录

## 01. 概述 ##

QWidget类是所有用户界面对象的基类。

## 02. Reimplemented Public Functions ##

virtual QPaintEngine *paintEngine() const override

## 03. Public Slots ##

bool close()
     void hide()
     void lower()
     void raise()
     void repaint()
     void setDisabled(bool disable)
     void setEnabled(bool)
     void setFocus()
     void setHidden(bool hidden)
     void setStyleSheet(const QString &styleSheet)
     virtual void setVisible(bool visible)
     void setWindowModified(bool)
     void setWindowTitle(const QString &)
     void show()
     void showFullScreen()
     void showMaximized()
     void showMinimized()
     void showNormal()
     void update()

## 04. Signals ##

void customContextMenuRequested(const QPoint &pos)
     void windowIconChanged(const QIcon &icon)
     void windowTitleChanged(const QString &title)

## 05. Static Public Members ##

QWidget *createWindowContainer(QWindow *window, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
     QWidget *find(WId id)
     QWidget *keyboardGrabber()
     QWidget *mouseGrabber()
     void setTabOrder(QWidget *first, QWidget *second)

## 06. Protected Functions ##

virtual void actionEvent(QActionEvent *event)
     virtual void changeEvent(QEvent *event)
     virtual void closeEvent(QCloseEvent *event)
     virtual void contextMenuEvent(QContextMenuEvent *event)
     void create(WId window = 0, bool initializeWindow = true, bool destroyOldWindow = true)
     void destroy(bool destroyWindow = true, bool destroySubWindows = true)
     virtual void dragEnterEvent(QDragEnterEvent *event)
     virtual void dragLeaveEvent(QDragLeaveEvent *event)
     virtual void dragMoveEvent(QDragMoveEvent *event)
     virtual void dropEvent(QDropEvent *event)
     virtual void enterEvent(QEvent *event)
     virtual void focusInEvent(QFocusEvent *event)
     bool focusNextChild()
     virtual bool focusNextPrevChild(bool next)
     virtual void focusOutEvent(QFocusEvent *event)
     bool focusPreviousChild()
     virtual void hideEvent(QHideEvent *event)
     virtual void inputMethodEvent(QInputMethodEvent *event)
     virtual void keyPressEvent(QKeyEvent *event)
     virtual void keyReleaseEvent(QKeyEvent *event)
     virtual void leaveEvent(QEvent *event)
     virtual void mouseDoubleClickEvent(QMouseEvent *event)
     virtual void mouseMoveEvent(QMouseEvent *event)
     virtual void mousePressEvent(QMouseEvent *event)
     virtual void mouseReleaseEvent(QMouseEvent *event)
     virtual void moveEvent(QMoveEvent *event)
     virtual bool nativeEvent(const QByteArray &eventType, void *message, long *result)
     virtual void paintEvent(QPaintEvent *event)
     virtual void resizeEvent(QResizeEvent *event)
     virtual void showEvent(QShowEvent *event)
     virtual void tabletEvent(QTabletEvent *event)
     virtual void wheelEvent(QWheelEvent *event)

## 07. Reimplemented Protected Functions ##

virtual bool event(QEvent *event) override
     virtual void initPainter(QPainter *painter) const override
     virtual int metric(QPaintDevice::PaintDeviceMetric m) const override

## 08. Protected Slots ##

void updateMicroFocus()

## 09. Macros ##

QWIDGETSIZE_MAX

## 10. 函数 ##

QWidget::QWidget(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
    构造函数  父控件为parent，标志有f指定。
    如果parent是nullptr，则新窗口Widget将成为一个窗口。如果parent是另一个Widget，则此Widget将成为parent内的子窗口。删除其父项时，将删除新的窗口Widget。
    Widget标志参数f通常为0，但可以将其设置为自定义窗口的框架（即父级必须为nullptr）。要自定义框架，请使用由任何窗口标志的按位“或”组成的值。
    如果将子窗口Widget添加到已经可见的窗口Widget，则必须显式显示该子窗口以使其可见。
    请注意，Qt的X11版本可能无法在所有系统上提供样式标志的所有组合。这是因为在X11上，Qt只能询问窗口管理器，并且窗口管理器可以覆盖应用程序的设置。在Windows上，Qt可以设置所需的任何标志。    
        
    [slot] bool QWidget::close()    
    关闭此Widget。返回true如果Widget被关闭；否则返回false。
    
    首先，它向Widget发送QCloseEvent。如果Widget接受关闭事件，则将其隐藏。如果它忽略该事件，则什么也不会发生。QWidget :: closeEvent（）的默认实现接受close事件。
    
    如果该窗口Widget具有Qt :: WA_DeleteOnClose标志，则该窗口Widget也将被删除。无论窗口Widget是否可见，关闭事件都会传递到窗口Widget。
    
    所述的QApplication :: lastWindowClosed当最后可见主窗口（即没有父窗口）与（）信号被发射的Qt :: WA_QuitOnClose属性组是封闭的。默认情况下，将为除瞬态窗口（例如初始屏幕，工具窗口和弹出菜单）之外的所有窗口Widget设置此属性。    
        
    [signal] void QWidget::customContextMenuRequested(const QPoint &pos)
    当窗口小部件的contextMenuPolicy为Qt :: CustomContextMenu且用户已请求窗口小部件上的上下文菜单时，将发出此信号。位置pos是窗口小部件接收的上下文菜单事件的位置。通常，这是在小部件坐标中。此规则的例外是QAbstractScrollArea及其子类，这些子类将上下文菜单事件映射到viewport（）的坐标。
        
    [slot] void QWidget::hide()
    隐藏Widget。此函数等效于setVisible（false）。
    注意：如果您正在使用QDialog或其子类，并且在此函数之后调用show（）函数，则对话框将以其原始位置显示。    
        
    [slot] void QWidget::lower()
    将Widget降低到父Widget堆栈的底部。
    
    在此调用之后，小部件将在视觉上位于任何重叠的同级小部件之后（并因此而被其遮盖）。   
        
    [slot] void QWidget::raise()
    将此小部件提升到父小部件堆栈的顶部。
    在此调用之后，该小部件将在视觉上位于任何重叠的同级小部件之前。    
    
    [slot] void QWidget::repaint()
    除非立即禁用更新或隐藏小部件，否则立即通过调用paintEvent（）直接重绘小部件。
        
    [slot] void QWidget::setDisabled(bool disable)    
    如果disable为true，则禁用窗口小部件输入事件；否则，禁用窗口小部件输入事件。否则启用输入事件。    
        
    [slot] void QWidget::setFocus()    
    如果此窗口小部件或其父级之一是活动窗口，则将键盘输入焦点赋予该窗口小部件（或其焦点代理）。    
        
    [slot] void QWidget::setHidden(bool hidden)
    便利功能，等效于setVisible（！hidden）。
        
    [slot] void QWidget::show()
    显示窗口小部件及其子窗口小部件。
        
    [slot] void QWidget::showFullScreen()    
    以全屏模式显示小部件。
    调用此函数仅影响Windows。
    要从全屏模式返回，请调用showNormal（）。    
        
    [slot] void QWidget::showMaximized()  
    显示最大化的小部件。
    
    调用此函数仅影响Windows。
        
    [slot] void QWidget::showMinimized()    
    将最小化的小部件显示为图标。
    
    调用此函数仅影响Windows。    
        
    [slot] void QWidget::showNormal()    
    在最大化或最小化窗口小部件后对其进行还原。    
    
    [slot] void QWidget::update()    
    除非禁用更新或隐藏小部件，否则更新小部件。    
        
    [protected slot] void QWidget::updateMicroFocus()
    更新小部件的微焦点。    
        
    [signal] void QWidget::windowIconChanged(const QIcon &icon)    
    当窗口的图标更改时，以新图标作为参数，将发出此信号。    
        
    [signal] void QWidget::windowTitleChanged(const QString &title)    
    当窗口的标题更改时，以新标题作为参数，将发出此信号。    
        
    [virtual] QWidget::~QWidget()    
    析构函数   
        
    [virtual protected] void QWidget::actionEvent(QActionEvent *event)    
    每当更改窗口小部件的动作时，都会使用给定事件调用此事件处理程序。
        
    QList<QAction *> QWidget::actions() const    
    返回此小部件操作的列表（可能为空）。    
        
    void QWidget::activateWindow()    
    将包含此窗口小部件的顶层窗口小部件设置为活动窗口。    
        
    void QWidget::addAction(QAction *action)    
    将操作操作追加到此小部件的操作列表中。    
        
        
    void QWidget::addActions(QList<QAction *> actions)    
    将操作actions追加到此小部件的操作列表中。    
        
    void QWidget::adjustSize()    
    调整窗口小部件的大小以适合其内容。    
        
    QPalette::ColorRole QWidget::backgroundRole() const    
    返回窗口小部件的背景角色。    
        
    QBackingStore *QWidget::backingStore() const    
    背景角色从小部件的调色板中定义用于渲染背景的笔刷。
        
    [virtual protected] void QWidget::changeEvent(QEvent *event)    
    可以重新实现此事件处理程序以处理状态更改。    
        
    QWidget *QWidget::childAt(int x, int y) const    
    返回小部件坐标系统中位置（x，y）的可见子小部件。如果在指定位置没有可见的子窗口小部件，则该函数返回nullptr。
    
    QWidget *QWidget::childAt(const QPoint &p) const
    返回窗口小部件自身坐标系统中p点处的可见子窗口小部件。   
        
    void QWidget::clearFocus()    
    从小部件获取键盘输入焦点。    
        
    void QWidget::clearMask()
    删除所有有setMask设置的Mask。    
        
    [virtual protected] void QWidget::closeEvent(QCloseEvent *event)    
    当Qt从窗口系统收到对顶级窗口小部件的窗口关闭请求时，将使用给定事件调用此事件处理程序。    
     void MainWindow::closeEvent(QCloseEvent *event)
     { 
         if (maybeSave()) { 
             writeSettings();
             event->accept();
         } else { 
             event->ignore();
         }
     }
    
    
    QMargins QWidget::contentsMargins() const
    contentMargins函数返回小部件的内容边距。    
        
    QRect QWidget::contentsRect() const    
    返回窗口小部件内的区域。    
        
    [virtual protected] void QWidget::contextMenuEvent(QContextMenuEvent *event)    
    可以在子类中重新实现此事件处理程序（用于event event），以接收小部件上下文菜单事件。    
        
    [protected] void QWidget::create(WId window = 0, bool initializeWindow = true, bool destroyOldWindow = true)    
    创建一个新的窗口小部件窗口。    
        
    [static] QWidget *QWidget::createWindowContainer(QWindow *window, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())    
    创建一个QWidget，可以将窗口嵌入到基于QWidget的应用程序中。    
        
    [protected] void QWidget::destroy(bool destroyWindow = true, bool destroySubWindows = true)    
    释放窗口系统资源。如果destroyWindow为true，则销毁窗口小部件窗口。
        
    [virtual protected] void QWidget::dragEnterEvent(QDragEnterEvent *event)    
    当拖动正在进行中并且鼠标进入该小部件时，将调用此事件处理程序。该事件在event参数中传递。    
        
    [virtual protected] void QWidget::dragLeaveEvent(QDragLeaveEvent *event)
     当拖动正在进行中并且鼠标离开该小部件时，将调用此事件处理程序。该事件在event参数中传递。   
        
        
    [virtual protected] void QWidget::dragMoveEvent(QDragMoveEvent *event)    
    如果正在进行拖动，并且发生以下任何一种情况，则将调用此事件处理程序：光标进入此窗口小部件，光标在该窗口小部件内移动，或者在此窗口小部件获得焦点时按下键盘上的修改键。该事件在event参数中传递。    
        
        
    [virtual protected] void QWidget::dropEvent(QDropEvent *event)    
    当将拖动拖放到此小部件上时，将调用此事件处理程序。该事件在event参数中传递。    
        
        
    WId QWidget::effectiveWinId() const    
    返回窗口小部件的有效窗口系统标识符，即本机父级的窗口系统标识符。    
        
    void QWidget::ensurePolished() const    
    确保小部件及其子级已被QStyle抛光（即具有正确的字体和调色板）。    
        
    [virtual protected] void QWidget::enterEvent(QEvent *event)    
    可以在子类中重新实现此事件处理程序，以接收在事件参数中传递的小部件输入事件。    
        
    [override virtual protected] bool QWidget::event(QEvent *event)
    这是主事件处理程序；它处理事件event。您可以在子类中重新实现此功能，但是我们建议改用一种专用的事件处理程序。    
        
    [static] QWidget *QWidget::find(WId id)    
    返回指向带有窗口标识符/句柄id的窗口小部件的指针。    
        
    [virtual protected] void QWidget::focusInEvent(QFocusEvent *event)    
    可以在子类中重新实现此事件处理程序，以接收小部件的键盘焦点事件（接收到焦点）。该事件在event参数中传递    
        
    [protected] bool QWidget::focusNextChild()    
    查找一个新的窗口小部件，以使其适合于Tab键盘焦点，true如果可以找到新的窗口小部件，则返回，否则返回false。
        
    [virtual protected] bool QWidget::focusNextPrevChild(bool next)    
    根据Tab和Shift + Tab键，true找到一个使键盘焦点对准的新窗口小部件，如果可以找到一个新窗口小部件，则返回，否则返回false。    
        
        
    [virtual protected] void QWidget::focusOutEvent(QFocusEvent *event)    
    可以在子类中重新实现此事件处理程序，以接收小部件的键盘焦点事件（焦点丢失）。事件在event参数中传递。    
        
        
    [protected] bool QWidget::focusPreviousChild()    
    根据Shift + Tab键，找到一个使键盘焦点对准true的新窗口小部件，如果可以找到一个新窗口小部件，则返回，否则返回false。    
        
        
    QWidget *QWidget::focusProxy() const    
     返回焦点代理，nullptr如果没有焦点代理，则返回。   
        
    QWidget *QWidget::focusWidget() const    
    返回已调用setFocus的此小部件的最后一个子级。对于顶级窗口小部件，此窗口小部件将在激活此窗口的情况下获得焦点    
        
    QFontInfo QWidget::fontInfo() const    
    返回小部件当前字体的字体信息。等同于QFontInfo(widget->font())。    
        
    QFontMetrics QWidget::fontMetrics() const
    返回小部件当前字体的字体指标。等同于QFontMetrics(widget->font())。    
        
    QPalette::ColorRole QWidget::foregroundRole() const    
    返回前台角色。  
        
    QPixmap QWidget::grab(const QRect &rectangle = QRect(QPoint(0, 0), QSize(-1, -1)))
    将窗口小部件渲染为受给定矩形限制的像素图。如果小部件有任何子代，则它们也将被绘制在适当的位置。    
        
    void QWidget::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())    
    用特定标志将小部件订阅给定手势。    
        
    void QWidget::grabKeyboard()    
    抓取键盘输入。    
        
    void QWidget::grabMouse()
    抓住鼠标输入。    
        
    void QWidget::grabMouse(const QCursor &cursor)    
    抓住鼠标输入并更改光标形状。    
        
        
    int QWidget::grabShortcut(const QKeySequence &key, Qt::ShortcutContext context = Qt::WindowShortcut)    
    在Qt的快捷方式系统中添加一个快捷方式，该快捷方式在给定的上下文中监视给定的键序列。如果上下文是Qt :: ApplicationShortcut，则快捷方式将应用于整个应用程序。否则，它不是此窗口小部件Qt :: WidgetShortcut的本地窗口，还是该窗口本身的Qt :: WindowShortcut的本地窗口。    
        
    QGraphicsEffect *QWidget::graphicsEffect() const    
    graphicsEffect函数返回指向小部件的图形效果的指针。    
        
    QGraphicsProxyWidget *QWidget::graphicsProxyWidget() const    
    返回图形视图中相应嵌入式窗口小部件的代理窗口小部件；否则返回nullptr。   
        
        
    bool QWidget::hasEditFocus() const
    返回true此窗口小部件当前是否具有编辑焦点；否则为假。
        
    [virtual] bool QWidget::hasHeightForWidth() const    
    true如果小部件的首选高度取决于其宽度，则返回；否则返回false。否则返回false。
        
        
    [virtual] int QWidget::heightForWidth(int w) const    
    给定宽度w，返回此小部件的首选高度。    
        
    [virtual protected] void QWidget::hideEvent(QHideEvent *event)    
    可以在子类中重新实现此事件处理程序，以接收小部件隐藏事件。该事件在event参数中传递。    
        
    [override virtual protected] void QWidget::initPainter(QPainter *painter) const    
    将绘画笔，背景和字体初始化为与给定小部件相同的颜色。在QWidget上打开绘制器时，将自动调用此函数。
        
    [virtual protected] void QWidget::inputMethodEvent(QInputMethodEvent *event)    
    可以在子类中重新实现此事件处理程序（用于event event），以接收Input Method组合事件。当输入方法的状态更改时，将调用此处理程序。    
        
        
    [virtual] QVariant QWidget::inputMethodQuery(Qt::InputMethodQuery query) const    
    此方法仅与输入窗口小部件有关。输入法使用它来查询窗口小部件的一组属性，以便能够支持复杂的输入法操作，以支持周围的文本和重新转换。    
        
    void QWidget::insertAction(QAction *before, QAction *action)    
    插入动作的动作，以行动这个小部件的列表，在行动之前之前。如果before是nullptr或before不是此小部件的有效操作，它将追加操作。
        
    void QWidget::insertActions(QAction *before, QList<QAction *> actions)    
    在之前的动作之前，将动作动作插入到此小部件的动作列表中。如果before是或before不是此小部件的有效操作，它将追加操作。nullptr
        
    bool QWidget::isAncestorOf(const QWidget *child) const    
    返回true如果这个小部件是父母（或祖父母等任何级别），给定的孩子，和两个小部件都是在同一窗口; 否则返回false。    
        
    bool QWidget::isEnabledTo(const QWidget *ancestor) const
    true如果启用了祖先，则返回此小部件是否将被启用；否则返回false。    
        
    bool QWidget::isHidden() const
    返回true如果控件是隐藏的，否则返回false。
        
    bool QWidget::isVisibleTo(const QWidget *ancestor) const
    返回：true如果显示祖先，则此小部件是否将变为可见；否则返回false。
        
    bool QWidget::isWindow() const    
    返回true如果控件是一个独立的窗口，否则返回false。
        
    [virtual protected] void QWidget::keyPressEvent(QKeyEvent *event)
    可以在子类中重新实现此事件处理程序（用于event event），以接收小部件的按键事件。    
        
    [virtual protected] void QWidget::keyReleaseEvent(QKeyEvent *event)
    可以在子类中重新实现此事件处理程序（用于event event），以接收小部件的关键释放事件。
        
    [static] QWidget *QWidget::keyboardGrabber()
    返回当前正在获取键盘输入的小部件。
        
    QLayout *QWidget::layout() const
    返回安装在此窗口小部件上的布局管理器，或者返回未安装的nullptr布局管理器。
        
        
    [virtual protected] void QWidget::leaveEvent(QEvent *event)    
    可以在子类中重新实现此事件处理程序，以接收在event参数中传递的小部件离开事件。    
        
    QPoint QWidget::mapFrom(const QWidget *parent, const QPoint &pos) const    
    将小部件坐标pos从父级坐标系转换为该小部件的坐标系。该家长切不可nullptr且必须调用控件的父。    
        
    QPoint QWidget::mapFromGlobal(const QPoint &pos) const    
    将全局屏幕坐标pos转换为小部件坐标。    
        
    QPoint QWidget::mapFromParent(const QPoint &pos) const    
    将父窗口小部件坐标pos转换为窗口小部件坐标。    
        
    QPoint QWidget::mapTo(const QWidget *parent, const QPoint &pos) const   
    将小部件坐标pos转换为parent的坐标系。该家长切不可nullptr且必须调用控件的父。  
        
    QPoint QWidget::mapToGlobal(const QPoint &pos) const    
    将小部件坐标pos转换为全局屏幕坐标。例如，mapToGlobal(QPoint(0,0))将给出小部件的左上像素的全局坐标。
    
        
    QPoint QWidget::mapToParent(const QPoint &pos) const    
    将小部件坐标pos转换为父小部件中的坐标。   
        
        
    QRegion QWidget::mask() const    
    返回当前在窗口小部件上设置的蒙版。如果未设置任何掩码，则返回值将为空白区域。    
        
    [override virtual protected] int QWidget::metric(QPaintDevice::PaintDeviceMetric m) const    
    重新实现：QPaintDevice :: metric（QPaintDevice :: PaintDeviceMetric指标）常量。    
        
    [virtual protected] void QWidget::mouseDoubleClickEvent(QMouseEvent *event)    
    可以在子类中重新实现该事件处理程序（用于event event），以接收该小部件的鼠标双击事件。   
        
        
    [static] QWidget *QWidget::mouseGrabber()    
    返回当前正在捕获鼠标输入的小部件。
        
    [virtual protected] void QWidget::mouseMoveEvent(QMouseEvent *event)    
    可以在子类中重新实现该事件处理程序（用于event event），以接收该小部件的鼠标移动事件。    
        
    [virtual protected] void QWidget::mousePressEvent(QMouseEvent *event)
    可以在子类中重新实现此事件处理程序（用于event event），以接收小部件的鼠标按下事件。    
        
    [virtual protected] void QWidget::mouseReleaseEvent(QMouseEvent *event)
    可以在子类中重新实现该事件处理程序（用于event event），以接收该小部件的鼠标释放事件。
        
        
    void QWidget::move(int x, int y)
        
    [virtual protected] void QWidget::moveEvent(QMoveEvent *event)
    可以在子类中重新实现此事件处理程序，以接收在event参数中传递的小部件移动事件。当窗口小部件接收到此事件时，它已经处于新位置。
        
        
    [virtual protected] bool QWidget::nativeEvent(const QByteArray &eventType, void *message, long *result)    
    可以在子类中重新实现此特殊事件处理程序，以接收由eventType标识的本机平台事件，这些事件在message参数中传递。
        
    QWidget *QWidget::nativeParentWidget() const    
    返回此窗口小部件的本机父级，即具有系统标识符或下一个没有系统父级的下一个祖先窗口小部件nullptr。    
        
    QWidget *QWidget::nextInFocusChain() const    
    返回此小部件的焦点链中的下一个小部件。
        
    void QWidget::overrideWindowFlags(Qt::WindowFlags flags)    
    将窗口小部件的窗口标志设置为flags，而无需告知窗口系统。    
        
    [override virtual] QPaintEngine *QWidget::paintEngine() const    
     返回小部件的绘制引擎。   
        
    [virtual protected] void QWidget::paintEvent(QPaintEvent *event)    
    可以在子类中重新实现此事件处理程序，以接收在event中传递的绘画事件。    
        
    QWidget *QWidget::parentWidget() const    
    返回此窗口小部件的父级，或者nullptr如果它没有任何父窗口小部件，则返回。    
        
    QWidget *QWidget::previousInFocusChain() const    
     previousInFocusChain函数返回此小部件的焦点链中的上一个小部件。
        
        
    void QWidget::releaseKeyboard()    
    释放键盘。    
        
        
    void QWidget::releaseMouse()    
    释放鼠标    
        
    void QWidget::releaseShortcut(int id)   
    从Qt的快捷方式系统中删除具有给定ID的快捷方式。该小部件将不再接收该快捷方式的键序列的QEvent :: Shortcut事件（除非它具有具有相同键序列的其他快捷方式）。    
        
    void QWidget::removeAction(QAction *action)    
     从此小部件的动作列表中删除动作动作。   
        
    void QWidget::repaint(int x, int y, int w, int h)    
    在小部件内重新绘制了一个矩形（x，y，w，h）。    
        
    void QWidget::repaint(const QRect &rect)    
    重新绘制了小部件内部的矩形rect。
        
    void QWidget::repaint(const QRegion &rgn)    
        
        
    void QWidget::resize(int w, int h)    
    对应于resize（QSize（w，h））。    
        
    [virtual protected] void QWidget::resizeEvent(QResizeEvent *event)    
        
        
    bool QWidget::restoreGeometry(const QByteArray &geometry)    
    恢复存储在字节数组geometry中的顶级窗口小部件的几何形状和状态。true成功回报；否则返回false。
        
        
    QByteArray QWidget::saveGeometry() const    
    保存顶级小部件的当前几何图形和状态。    
        
    QScreen *QWidget::screen() const    
    返回窗口小部件所在的屏幕。    
        
    void QWidget::scroll(int dx, int dy)    
    将小部件及其子dx像素向右滚动，并dy向下滚动。这两个DX和DY可能是负的。    
        
    void QWidget::scroll(int dx, int dy, const QRect &r)    
        
    void QWidget::setAttribute(Qt::WidgetAttribute attribute, bool on = true)    
    如果on为true，则在此小部件上设置attribute属性；否则为false。否则清除属性。
        
    void QWidget::setBackgroundRole(QPalette::ColorRole role)    
    将窗口小部件的后台角色设置为role。    
        
    void QWidget::setBaseSize(int basew, int baseh)    
    这对应于setBaseSize（QSize（basew，baseh））。将小部件的基本大小设置为width basew和height baseh。    
        
    void QWidget::setContentsMargins(int left, int top, int right, int bottom)
    将窗口小部件内容周围的边距设置为left，top，right和bottom。边距由布局系统使用，并且可由子类用于指定要绘制的区域（例如，不包括框架）。    
        
    void QWidget::setContentsMargins(const QMargins &margins)    
    setContentsMargins函数设置小部件内容周围的边距。    
        
    void QWidget::setEditFocus(bool enable)    
        
    void QWidget::setFixedHeight(int h)    
    在不更改宽度的情况下，将小部件的最小和最大高度都设置为h。提供方便。    
        
    void QWidget::setFixedSize(const QSize &s)
    窗口小部件的最小和最大大小都设置为s，从而防止窗口小部件增大或缩小。    
        
    void QWidget::setFixedSize(int w, int h)    
        
        
    void QWidget::setFixedWidth(int w)    
    将窗口小部件的最小和最大宽度都设置为w而不更改高度。提供方便。    
        
    void QWidget::setFocus(Qt::FocusReason reason)    
    如果此窗口小部件或其父级之一是活动窗口，则将键盘输入焦点赋予该窗口小部件（或其焦点代理）。该理由参数将被传递给这个函数发送的任何焦点事件，它是用来给的是什么引起的小部件获得焦点的解释。如果该窗口不处于活动状态，则当该窗口变为活动状态时，将为小部件提供焦点。    
        
        
    void QWidget::setFocusProxy(QWidget *w)
    将窗口小部件的焦点代理设置为窗口小部件w。如果w是nullptr，则函数会将此窗口小部件重置为没有焦点代理。    
        
    void QWidget::setForegroundRole(QPalette::ColorRole role)    
     将小部件的前台角色设置为role。   
        
    void QWidget::setGeometry(int x, int y, int w, int h)    
        
    void QWidget::setGraphicsEffect(QGraphicsEffect *effect)
    setGraphicsEffect函数用于设置小部件的图形效果。    
        
    void QWidget::setLayout(QLayout *layout)    
    将此窗口小部件的布局管理器设置为layout。
        
    void QWidget::setMask(const QBitmap &bitmap)    
    仅使小部件的位图具有对应的1位的像素可见。如果该区域包括小部件的rect（）外部的像素，则取决于平台，该区域中的窗口系统控件可能可见，也可能不可见。
        
    void QWidget::setMask(const QRegion &region)    
        
    void QWidget::setMaximumSize(int maxw, int maxh)    
    void QWidget::setMinimumSize(int minw, int minh)
        
    void QWidget::setParent(QWidget *parent)    
    将窗口小部件的父级设置为parent，并重置窗口标志。小部件将移动到其新父级的位置（0，0）。    
        
    void QWidget::setParent(QWidget *parent, Qt::WindowFlags f)    
    
        
       
     void QWidget::setShortcutAutoRepeat(int id, bool enable = true)
     如果enable为true，则启用具有给定id的自动重复快捷方式；否则禁用。    
    
         
    void QWidget::setShortcutEnabled(int id, bool enable = true)
    如果enable为true，则启用具有给定id的快捷方式；否则为false 。否则，快捷方式将被禁用。
        
    void QWidget::setSizeIncrement(int w, int h)    
    void QWidget::setSizePolicy(QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical)    
    void QWidget::setStyle(QStyle *style)
    将窗口小部件的GUI样式设置为style。样式对象的所有权不会转移。    
    
        
    [static] void QWidget::setTabOrder(QWidget *first, QWidget *second)    
     放第二后插件第一在聚焦顺序部件。   
    
    void QWidget::setWindowFlag(Qt::WindowType flag, bool on = true)    
    如果on为true，则在此小部件上设置窗口标志标志；否则为false。否则清除标志。    
        
    void QWidget::setWindowRole(const QString &role)
    将窗口的角色设置为role。这仅对X11上的Windows有意义。    
        
    void QWidget::setWindowState(Qt::WindowStates windowState)
    将窗口状态设置为windowState。窗口状态是Qt :: WindowState：Qt :: WindowMinimized，Qt :: WindowMaximized，Qt :: WindowFullScreen和Qt :: WindowActive的OR组合。
        
        
    void QWidget::setupUi(QWidget *widget)    
    设置指定窗口小部件的用户界面。    
        
        
    [virtual protected] void QWidget::showEvent(QShowEvent *event)    
    可以在子类中重新实现此事件处理程序，以接收在事件参数中传递的窗口小部件显示事件。    
        
    void QWidget::stackUnder(QWidget *w)    
    将小部件放置在父小部件堆栈中的w下。    
        
    QStyle *QWidget::style() const    
    
        
    [virtual protected] void QWidget::tabletEvent(QTabletEvent *event)
        
    bool QWidget::underMouse() const
    返回true小部件是否在鼠标光标下；否则返回false。    
        
        
    void QWidget::ungrabGesture(Qt::GestureType gesture)    
    从给定的手势类型退订窗口小部件    
        
    void QWidget::update(int x, int y, int w, int h)    
    void QWidget::update(const QRegion &rgn)    
        
    void QWidget::updateGeometry()    
    通知布局系统此窗口小部件已更改，并且可能需要更改几何形状。    
        
        
    QRegion QWidget::visibleRegion() const    
    返回可以发生绘制事件的未遮挡区域。    
        
        
    [virtual protected] void QWidget::wheelEvent(QWheelEvent *event)    
    可以在子类中重新实现该事件处理程序（用于event event），以接收该小部件的转轮事件。
        
    WId QWidget::winId() const    
    返回窗口小部件的窗口系统标识符。    
      
    QWidget *QWidget::window() const    
    返回此窗口小部件的窗口，即具有（或可能具有）窗口系统框架的下一个祖先窗口小部件。
        
    QWindow *QWidget::windowHandle() const    
    果这是本机窗口小部件，则返回关联的QWindow。否则返回null。
        
    QString QWidget::windowRole() const    
    返回窗口的角色，或一个空字符串。
        
    Qt::WindowStates QWidget::windowState() const    
    返回当前窗口状态。窗口状态是Qt :: WindowState：Qt :: WindowMinimized，Qt :: WindowMaximized，Qt :: WindowFullScreen和Qt :: WindowActive的OR组合。    
        
        
    Qt::WindowType QWidget::windowType() const    
    返回此窗口小部件的窗口类型。这与windowFlags（）和Qt :: WindowType_Mask相同。

## 11. 附录 ##

**11.1 Qt教程汇总**  
网址：[https://dengjin.blog.csdn.net/article/details/115174639][https_dengjin.blog.csdn.net_article_details_115174639]

[https_dengjin.blog.csdn.net_article_details_115174639]: https://dengjin.blog.csdn.net/article/details/115174639