Qt入门系列开发教程【基础控件篇】QMainWindow主窗口

@[toc]

描述

主窗口为构建应用程序的用户界面提供了一个框架。 Qt 有 QMainWindow 及其相关的主窗口管理类。 QMainWindow 有自己的布局，您可以在其中添加 QToolBars、QDockWidgets、QMenuBar 和 QStatusBar。 布局有一个中心区域，可以被任何类型的小部件占据。 您可以在下面看到布局的图像。

注意：不支持创建没有中央小部件的主窗口。 即使它只是一个占位符，您也必须有一个中央小部件

创建主窗口组件

中央部件通常是标准的 Qt 部件，例如 QTextEdit 或 QGraphicsView。 自定义小部件也可用于高级应用程序。 您可以使用 setCentralWidget() 设置中央小部件。 主窗口具有单个 (SDI) 或多个 (MDI) 文档界面。 您可以使用 QMdiArea 作为中央小部件在 Qt 中创建 MDI 应用程序。 我们现在将检查可以添加到主窗口的每个其他小部件。 我们举例说明如何创建和添加它们。

void MainWindow::createMenus()

{

fileMenu = menuBar()->addMenu(tr("&File"));

fileMenu->addAction(newAct);

fileMenu->addAction(openAct);

fileMenu->addAction(saveAct);

}

createPopupMenu() 函数在主窗口接收到上下文菜单事件时创建弹出菜单。 默认实现会生成一个菜单，其中包含来自停靠小部件和工具栏的可检查操作。 您可以为自定义菜单重新实现 createPopupMenu()。

创建工具栏

工具栏在 QToolBar 类中实现。 使用 addToolBar() 将工具栏添加到主窗口。 您可以通过将工具栏分配给特定的 Qt::ToolBarArea 来控制工具栏的初始位置。 您可以通过插入工具栏分隔符来分割区域 - 将其视为文本编辑中的换行符 - 使用 addToolBarBreak() 或 insertToolBarBreak()。 您还可以使用 QToolBar::setAllowedAreas() 和 QToolBar::setMovable() 限制用户放置。 可以使用 iconSize() 检索工具栏图标的大小。 尺寸取决于平台； 您可以使用 setIconSize() 设置固定大小。 您可以使用 setToolButtonStyle() 更改工具栏中所有工具按钮的外观。 工具栏创建示例如下：

void MainWindow::createToolBars()

{

fileToolBar = addToolBar(tr("File"));

fileToolBar->addAction(newAct);

}

创建 Dock 小部件

Dock 小部件在 QDockWidget 类中实现。 停靠小部件是可以停靠在主窗口中的窗口。 您可以使用 addDockWidget() 将停靠小部件添加到主窗口。 Qt::DockWidgetArea 枚举给出了四个停靠小部件区域：左、右、上和下。 您可以使用 setCorner() 指定哪个停靠小部件区域应占据区域重叠的角落。 默认情况下，每个区域只能包含一行（垂直或水平）停靠小部件，但如果您使用 setDockNestingEnabled() 启用嵌套，则可以在任一方向添加停靠小部件。 两个停靠小部件也可以相互堆叠。 然后使用 QTabBar 选择应该显示哪些小部件。 我们举例说明如何创建停靠小部件并将其添加到主窗口：

QDockWidget *dockWidget = new QDockWidget(tr("Dock Widget"), this);

dockWidget->setAllowedAreas(Qt::LeftDockWidgetArea |

Qt::RightDockWidgetArea);

dockWidget->setWidget(dockWidgetContents);

addDockWidget(Qt::LeftDockWidgetArea, dockWidget);

状态栏

您可以使用 setStatusBar() 设置状态栏，但在第一次调用 statusBar()（返回主窗口的状态栏）时会创建一个状态栏。 有关如何使用它的信息，请参阅 QStatusBar。 存储状态 QMainWindow 可以使用 saveState() 存储其布局的状态； 稍后可以使用 restoreState() 检索它。 它是存储的工具栏和停靠小部件的位置和大小（相对于主窗口的大小）。

API

#ifndef QDYNAMICMAINWINDOW_H

#define QDYNAMICMAINWINDOW_H

#include

#include

#if QT_CONFIG(tabwidget)

#include

#endif

QT_REQUIRE_CONFIG(mainwindow);

QT_BEGIN_NAMESPACE

class QDockWidget;

class QMainWindowPrivate;

class QMenuBar;

class QStatusBar;

class QToolBar;

class QMenu;

class Q_WIDGETS_EXPORT QMainWindow : public QWidget

{

Q_OBJECT

Q_PROPERTY(QSize iconSize READ iconSize WRITE setIconSize)

Q_PROPERTY(Qt::ToolButtonStyle toolButtonStyle READ toolButtonStyle WRITE setToolButtonStyle)

#if QT_CONFIG(dockwidget)

Q_PROPERTY(bool animated READ isAnimated WRITE setAnimated)

#if QT_CONFIG(tabbar)

Q_PROPERTY(bool documentMode READ documentMode WRITE setDocumentMode)

#endif // QT_CONFIG(tabbar)

#if QT_CONFIG(tabwidget)

Q_PROPERTY(QTabWidget::TabShape tabShape READ tabShape WRITE setTabShape)

#endif // QT_CONFIG(tabwidget)

Q_PROPERTY(bool dockNestingEnabled READ isDockNestingEnabled WRITE setDockNestingEnabled)

#endif // QT_CONFIG(dockwidget)

Q_PROPERTY(DockOptions dockOptions READ dockOptions WRITE setDockOptions)

#if QT_CONFIG(toolbar)

Q_PROPERTY(bool unifiedTitleAndToolBarOnMac READ unifiedTitleAndToolBarOnMac

WRITE setUnifiedTitleAndToolBarOnMac)

#endif

public:

enum DockOption {

AnimatedDocks = 0x01,

AllowNestedDocks = 0x02,

AllowTabbedDocks = 0x04,

ForceTabbedDocks = 0x08, // implies AllowTabbedDocks, !AllowNestedDocks

VerticalTabs = 0x10, // implies AllowTabbedDocks

GroupedDragging = 0x20 // implies AllowTabbedDocks

};

Q_ENUM(DockOption)

Q_DECLARE_FLAGS(DockOptions, DockOption)

Q_FLAG(DockOptions)

//构造函数

explicit QMainWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags());

//析构函数

~QMainWindow();

//工具类icon大小

QSize iconSize() const;

void setIconSize(const QSize &iconSize);

//工具栏按钮样式

Qt::ToolButtonStyle toolButtonStyle() const;

void setToolButtonStyle(Qt::ToolButtonStyle toolButtonStyle);

#if QT_CONFIG(dockwidget)

bool isAnimated() const;

bool isDockNestingEnabled() const;

#endif

#if QT_CONFIG(tabbar)

bool documentMode() const;

void setDocumentMode(bool enabled);

#endif

#if QT_CONFIG(tabwidget)

QTabWidget::TabShape tabShape() const;

void setTabShape(QTabWidget::TabShape tabShape);

QTabWidget::TabPosition tabPosition(Qt::DockWidgetArea area) const;

void setTabPosition(Qt::DockWidgetAreas areas, QTabWidget::TabPosition tabPosition);

#endif // QT_CONFIG(tabwidget)

//设置dock配置

void setDockOptions(DockOptions options);

DockOptions dockOptions() const;

bool isSeparator(const QPoint &pos) const;

//菜单栏相关

#if QT_CONFIG(menubar)

QMenuBar *menuBar() const;

void setMenuBar(QMenuBar *menubar);

QWidget *menuWidget() const;

void setMenuWidget(QWidget *menubar);

#endif

#if QT_CONFIG(statusbar)

QStatusBar *statusBar() const;

void setStatusBar(QStatusBar *statusbar);

#endif

//获取中心部件

QWidget *centralWidget() const;

void setCentralWidget(QWidget *widget);

//删除中心部件

QWidget *takeCentralWidget();

#if QT_CONFIG(dockwidget)

void setCorner(Qt::Corner corner, Qt::DockWidgetArea area);

Qt::DockWidgetArea corner(Qt::Corner corner) const;

#endif

//工具栏相关

#if QT_CONFIG(toolbar)

void addToolBarBreak(Qt::ToolBarArea area = Qt::TopToolBarArea);

void insertToolBarBreak(QToolBar *before);

void addToolBar(Qt::ToolBarArea area, QToolBar *toolbar);

void addToolBar(QToolBar *toolbar);

QToolBar *addToolBar(const QString &title);

void insertToolBar(QToolBar *before, QToolBar *toolbar);

void removeToolBar(QToolBar *toolbar);

void removeToolBarBreak(QToolBar *before);

bool unifiedTitleAndToolBarOnMac() const;

Qt::ToolBarArea toolBarArea(const QToolBar *toolbar) const;

bool toolBarBreak(QToolBar *toolbar) const;

#endif // QT_CONFIG(toolbar)

#if QT_CONFIG(dockwidget)

//添加dock

void addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget);

void addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget,

Qt::Orientation orientation);

//将第一个停靠小部件覆盖的空间分成两部分，将第一个停靠小部件移动到第一部分，并将第二个停靠小部件移动到第二部分。

void splitDockWidget(QDockWidget *after, QDockWidget *dockwidget,

Qt::Orientation orientation);

#if QT_CONFIG(tabbar)

void tabifyDockWidget(QDockWidget *first, QDockWidget *second);

QList tabifiedDockWidgets(QDockWidget *dockwidget) const;

#endif

//删除dock

void removeDockWidget(QDockWidget *dockwidget);

//恢复dock

bool restoreDockWidget(QDockWidget *dockwidget);

Qt::DockWidgetArea dockWidgetArea(QDockWidget *dockwidget) const;

void resizeDocks(const QList &docks,

const QList &sizes, Qt::Orientation orientation);

#endif // QT_CONFIG(dockwidget)

QByteArray saveState(int version = 0) const;

bool restoreState(const QByteArray &state, int version = 0);

#if QT_CONFIG(menu)

virtual QMenu *createPopupMenu();

#endif

public Q_SLOTS:

#if QT_CONFIG(dockwidget)

void setAnimated(bool enabled);

void setDockNestingEnabled(bool enabled);

#endif

#if QT_CONFIG(toolbar)

void setUnifiedTitleAndToolBarOnMac(bool set);

#endif

Q_SIGNALS:

void iconSizeChanged(const QSize &iconSize);

void toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle);

#if QT_CONFIG(dockwidget)

void tabifiedDockWidgetActivated(QDockWidget *dockWidget);

#endif

protected:

#ifndef QT_NO_CONTEXTMENU

void contextMenuEvent(QContextMenuEvent *event) override;

#endif

//事件函数

bool event(QEvent *event) override;

private:

Q_DECLARE_PRIVATE(QMainWindow)

Q_DISABLE_COPY(QMainWindow)

};

Q_DECLARE_OPERATORS_FOR_FLAGS(QMainWindow::DockOptions)

QT_END_NAMESPACE

#endif // QDYNAMICMAINWINDOW_H

Posted in 共创计划 by admin
Copyright © 2088 国电神策网游活动网 All Rights Reserved.
友情链接