概述
简述
QMdiArea(Multiple Document Interface Area)提供了一个可以同时显示多个文档窗口的区域。
本质上来说,QMdiArea就像是多文档窗口的窗口管理器。例如,它将它所管理的窗口绘制在它上面,并且以级联或者平铺的方式放置这些窗口。通常情况下,QMdiArea用作QMainWindow的中心控件,以此来创建一个MDI应用程序。但是,它也可以被放置在任何布局类中。
QMdiArea支持所有的窗口标志,只要这些窗口标志被当前控件样式支持。
功能详述
QMdiArea中的子窗口是QMdiSubWindow的实例化对象。通过调用addSubWindow来将他们加入MDI区域。通常情况下是传递一个QWidget作为内部控件给这个函数。但是直接传递QMdiSubWindow也是可以的。
当一个子窗口获得键盘焦点或者setFocus被调用,这个子窗口便被激活。当激活窗口改变时,subWindowActivated信号会被触发。activeSubWindow函数会返回当前激活的窗口。
subWindowList是一个十分方便的函数,可以用来返回所有子窗口列表。这个信息可以被用在包含窗口列表的弹出菜单上面。
WindowOrder用来指定子窗口的排列规则。子窗口的排列规则直接影响到subWindowList()、activateNextSubWindow()以及activatePreviousSubWindow()。而且,当窗口使用级联或者平铺时,这个信息也很有用。
QMdiArea为子窗口提供了两个内建的布局策略:cascadeSubWindows()和tileSubWindows()。这两个策略都是槽函数而且很容易与菜单条目连接。
注意 QMdiArea的默认滚动条属性是Qt::ScrolBarAlwaysOff。
使用
上面是Qt Designer的设计窗口,这种多窗口效果多半就是用QMdiArea实现的。
上面是Qt自带的example,用于实现多文本窗口同时编辑。
这是我自己写的小例子,源码如下
QGroupBox *groupBox_0 = new QGroupBox("互斥单选按钮组");
QRadioButton *radioBtn_0 = new QRadioButton("&Radio Button 1");
QRadioButton *radioBtn_1 = new QRadioButton("R&adio Button 2");
QRadioButton *radioBtn_2 = new QRadioButton("Ra&dio Button 3");
QVBoxLayout *vLayout_0 = new QVBoxLayout;
vLayout_0->addWidget(radioBtn_0);
vLayout_0->addWidget(radioBtn_1);
vLayout_0->addWidget(radioBtn_2);
groupBox_0->setLayout(vLayout_0);
QGroupBox *groupBox_1 = new QGroupBox("非互斥多选按钮组");
QCheckBox *checkBox_0 = new QCheckBox("&Checkbox 1");
QCheckBox *checkBox_1 = new QCheckBox("C&heckbox 2");
QCheckBox *checkBox_2 = new QCheckBox("&Tri-state Button");
checkBox_2->setTristate(true);
QVBoxLayout *vLayout_1 = new QVBoxLayout;
vLayout_1->addWidget(checkBox_0);
vLayout_1->addWidget(checkBox_1);
vLayout_1->addWidget(checkBox_2);
groupBox_1->setLayout(vLayout_1);
QMdiArea *mdiArea = new QMdiArea;
mdiArea->tileSubWindows();
mdiArea->cascadeSubWindows();
mdiArea->setDocumentMode(true);
mdiArea->addSubWindow(groupBox_0);
mdiArea->addSubWindow(groupBox_1);
QMainWindow *mainWindow = new QMainWindow;
mainWindow->setCentralWidget(mdiArea);
QGridLayout *gridLayout = new QGridLayout;
gridLayout->addWidget(mainWindow);
this->setLayout(gridLayout);
常用设置
添加与移除子窗口
添加子窗口使用addSubWindow,移除窗口使用removeSubWindow
mdiArea->addSubWindow(groupBox_0);
mdiArea->removeSubWindow(groupBox_0);
设置背景色
工作空间背景色默认为灰色,可以使用setBackground来设置
mdiArea->setBackground(QBrush(Qt::green));
效果
设置最大化模式
当活动子窗口最大化时,默认行为是最大化下一个激活的子窗口。如果不希望出现这种情况,可以通过下面的方法来设置
mdiArea->setOption(QMdiArea::DontMaximizeSubWindowOnActivation);
默认情况
设置之后
设置视图模式
有两种视图模式,可以通过setViewMode来设置。
常量 | 值 | 描述 |
---|---|---|
QMdiArea::SubWindowView | 0 | 显示带有窗口框架的子窗口(默认)。 |
QMdiArea::TabbedView | 1 | 在选项卡栏中显示带有选项卡的子窗口。 |
效果
在该模式下,setTabPositon、setTabShape、setTabClosable、setTabsMovable灯标签栏相关函数可用,具体效果见Qt之容器空间(QTabWidget)。
设置激活顺序
指定用于对由subWindowList()返回的子窗口列表进行排序的条件。排列窗口时,函数cascadeSubWindows()和tileSubWindows()遵循此顺序。
常量 | 值 | 描述 |
---|---|---|
QMdiArea::CreationOrder | 0 | 窗口按其创建顺序返回。 |
QMdiArea::StackingOrder | 1 | 窗口按其堆叠顺序返回,最上面的窗口在列表的最后。 |
QMdiArea::ActivationHistoryOrder | 2 | 窗口将按照它们被激活的顺序返回。 |
信号槽
槽
名称 | 描述 |
---|---|
activateNextSubWindow() | 激活下一个窗口 |
activatePreviousSubWindow() | 激活上一个窗口 |
cascadeSubWindows() | 级联排布子窗口 |
closeActiveSubWindow() | 关闭活动窗口 |
closeAllSubWindows() | 关闭所有窗口 |
setActiveSubWindow(QMdiSubWindow *window) | 设置特定窗口为活动窗口 |
testOption(QMdiArea::AreaOption option) const | 平铺排布子窗口 |
信号
名称 | 描述 |
---|---|
subWindowActivated(QMdiSubWindow *window) | 特定子窗口被激活时触发,参数为当前激活的QMdiSubWindow指针 |
引用
[1] Qt助手
最后
以上就是不安人生为你收集整理的Qt之容器控件(QMdiArea)简述功能详述常用设置信号槽引用的全部内容,希望文章能够帮你解决Qt之容器控件(QMdiArea)简述功能详述常用设置信号槽引用所遇到的程序开发问题。
如果觉得靠谱客网站的内容还不错,欢迎将靠谱客网站推荐给程序员好友。
发表评论 取消回复