QMainWindow

QMainWindow

QMainWindow是一个为用户提供主窗口程序的类，包含一个菜单栏（menu bar）、多个工具栏(tool bars)、多个停靠部件(dock widgets)、一个状态栏(status bar)及一个中心部件(central widget)，是许多应用程序的基础，如文本编辑器，图片编辑器等。

菜单栏

一个主窗口最多只有一个菜单栏。位于主窗口顶部、主窗口标题栏下面。

1. 通过QMainWindow类的menubar（）函数获取主窗口菜单栏指针，如果当前窗口没有菜单栏，该函数会自动创建一个。

  

  QMenuBar *    menuBar() const;

1. 创建菜单，调用QMenu的成员函数addMenu来添加菜单

   

 QAction* addMenu(QMenu * menu);

    QMenu* addMenu(const QString & title);

    QMenu* addMenu(const QIcon & icon, const QString & title);

1. 创建菜单项，调用QMenu的成员函数addAction来添加菜单项

   

QAction* activeAction() const;

    QAction* addAction(const QString & text);

    QAction* addAction(const QIcon & icon, const QString & text);

    QAction* addAction(const QString & text, const QObject * receiver,

     const char * member, const QKeySequence & shortcut = 0);

    QAction* addAction(const QIcon & icon, const QString & text,

    const QObject * receiver, const char * member,

    const QKeySequence & shortcut = 0);

Qt 并没有专门的菜单项类，只是使用一个QAction类，抽象出公共的动作。当我们把QAction对象添加到菜单，就显示成一个菜单项，添加到工具栏，就显示成一个工具按钮。用户可以通过点击菜单项、点击工具栏按钮、点击快捷键来激活这个动作。

工具栏

主窗口的工具栏上可以有多个工具条，通常采用一个菜单对应一个工具条的的方式，也可根据需要进行工具条的划分。

1. 1. 调用QMainWindowd对象的成员函数addToolBar（）,该函数每次调用都会创建一个新的工具栏，并且返回该工具栏的指针。
   2. 插入属于工具条的项，这时工具条上添加项也是用QAction。

通过QToolBar类的addAction函数添加。

1. 1. 工具条是一个可移动的窗口，它的停靠区域由QToolBar的allowAreas决定，包括（以下值可以通过查帮助文档allowAreas来索引到）：
      1. Qt::LeftToolBarArea           停靠在左侧
      2. Qt::RightToolBarArea         停靠在右侧
      3. Qt::TopToolBarArea           停靠在顶部
      4. Qt::BottomToolBarArea   停靠在底部
      5. Qt::AllToolBarAreas           以上四个位置都可停靠

使用setAllowedAreas（）函数指定停靠区域：

setAllowedAreas（Qt::LeftToolBarArea | Qt::RightToolBarArea）

使用setFloatable（trueOrFalse）函数来设定工具栏可否浮动

使用setMoveable（trueOrFalse）函数设定工具栏的可移动性：

setMoveable（false）//工具条不可移动, 只能停靠在初始化的位置上

​​​​​​​状态栏

一个QMainWindow的程序最多只有一个状态栏。QMainWindow中可以有多个的部件都使用add…名字的函数，而只有一个的部件，就直接使用获取部件的函数，如menuBar。同理状态栏也提供了一个获取状态栏的函数statusBar()，没有就自动创建一个并返回状态栏的指针。

   

QMenuBar *    menuBar() const;

1. 添加小部件（从状态栏左侧添加）

   

 void addWidget(QWidget * widget, int stretch = 0);

    //插入小部件

    int insertWidget(int index, QWidget * widget, int stretch = 0);

    //删除小部件

    void removeWidget(QWidget * widget);

1. 添加小部件（从状态栏右侧添加）

void addPermenentWidget (QWidget *widget, int stretch = 0);

 

​​​​​​​停靠部件（也称为铆接部件、浮动窗口）

停靠部件 QDockWidget，也称浮动窗口，可以有多个。

   

 QDockWidget * dock = new QDockWidget("标题",this);

    //添加停靠部件到mainWindow中，并且设定默认停靠在左边

    addDockWidget(Qt::LeftDockWidgetArea,dock);

    //设定停靠部件允许停靠的范围

    dock->setAllowedAreas(Qt::LeftDockWidgetArea |

     Qt::RightDockWidgetArea | Qt::TopDockWidgetArea);

​​​​​​​核心部件（中心部件）

除了以上几个部件，中心显示的部件都可以作为核心部件，例如一个记事本程序中，就是一个QTextEdit（编辑框控件）做核心部件

QTextEdit * edit = new QTextEdit(this);

//设置mainWindow的核心部件

setCentralWidget(edit);