转自:http://zlhwhj.blog.163.com/blog/static/253900342008125114147389/
一个主窗口中央区域内能够提供多个文档的程序称之为多文档程序,或者MDI程序。在Qt中,一个MDI程序是由QWorkspace类实现的,把QWorkspace做为中央控件,每一个文档窗口做为QWorkspace的子控件。
MDI
程序的惯例是提供一个window菜单,管理窗口的显示方式和当前打开的窗口列表。正在活动的窗口由选中记号标示。用户可以点击window菜单中窗口列表中的一个窗口把它激活。
在这一节中,我们实现一个图6.16所示的MDI编辑程序,介绍如何创建MDI程序,如何实现window菜单。
Figure 6.16. The MDI Editor application
这个应用程序包含两个类:MainWindow和Editor类。程序中大部分代码和第一部分的Spreadsheet程序相似,这里我们只介绍新增的代码。
Figure 6.17. The MDI Editor application's menus
首先看一下MainWindow类:
MainWindow::MainWindow()
{
workspace = new QWorkspace;
setCentralWidget(workspace);
connect(workspace, SIGNAL(windowActivated(QWidget *)),
this, SLOT(updateMenus()));
createActions();
createMenus();
createToolBars();
createStatusBar();
setWindowTitle(tr("MDI Editor"));
setWindowIcon(QPixmap(":/images/icon.png"));
}
在MainWindow的构造函数中,我们创建了一个QWorkSpace控件,并把这个控件做为一个中央控件。连接QWorkSpace的windowActivated()信号和updateMenus()函数,对window菜单进行更新。
void MainWindow::newFile()
{
Editor *editor = createEditor();
editor->newFile();
editor->show();
}
函数newFile()用来对应File|New菜单,调用createEditor()私有函数创建一个子控件Editor。
Editor *MainWindow::createEditor()
{
Editor *editor = new Editor;
connect(editor, SIGNAL(copyAvailable(bool)),
cutAction, SLOT(setEnabled(bool)));
connect(editor, SIGNAL(copyAvailable(bool)),
copyAction, SLOT(setEnabled(bool)));
workspace->addWindow(editor);
windowMenu->addAction(editor->windowMenuAction());
windowActionGroup->addAction(editor->windowMenuAction());
return editor;
}
函数createEditor()创建一个Editor控件,连接两个信号和槽,这保证了Edit|Cut菜单和Edit|Copy菜单的使能状态依赖于是否有选中的文本,如果有选中的文本,Edit|Cut菜单和Edit|Copy菜单变为可用状态。
因为是MDI程序,主窗口中可能有多个Editor控件。问题是当前活动的Editor窗口发出的copyAvailable(bool)信号才能改变菜单的状态。实际上也只有当前活动的窗口能够发出信号,所以这个问题也不用考虑。
一旦新加了一个Editor控件,我们在Window菜单中增加一个QAction激活这个窗口。这个QAction是Editor类提供的,稍后会介绍。我们也向QActionGroup对象中添加了该Action,这样QActionGroup保证了窗口菜单中一次只有一项是选中的,即只有一个窗口是激活的。
void MainWindow::open()
{
Editor *editor = createEditor();
if (editor->open()) {
editor->show();
} else {
editor->close();
}
}
函数open()对应菜单File|Open。为新文档创建一个Editor,并在Editor上调用open()函数。这样保证了文件操作的实现是在Editor类中实现而非MainWindow类,因为每个Editor类需要维护自己的独立状态。
如果open()失败,关闭Editor,错误的原因由Editor类已经告诉用户。我们不必显式的删除Editor对象,在Editor的构造函数中,设置了Qt::WA_DeleteOn_Close属性,在关闭的同时Editor会自动删除自己。
void MainWindow::save()
{
if (activeEditor())
activeEditor()->save();
}
槽save()功能:如果有一活动Editor,则调用当前活动的Editor::save()。具体的实现操作也是在Editor中实现。
Editor *MainWindow::activeEditor()
{
return qobject_cast<Editor *>(workspace->activeWindow());
}
函数activeEditor()返回当前活动的Editor类型的子窗口指针,如果没有活动窗口,则返回一个空指针。
void MainWindow::cut()
{
if (activeEditor())
activeEditor()->cut();
}
槽cut()调用当前活动的Editor::cut(),copy(),paste()函数和cut()函数相同,在此略去不谈。
void MainWindow::updateMenus()
{
bool hasEditor = (activeEditor() != 0);
bool hasSelection = activeEditor()
&& activeEditor()->textCursor().hasSelection();
saveAction->setEnabled(hasEditor);
saveAsAction->setEnabled(hasEditor);
pasteAction->setEnabled(hasEditor);
cutAction->setEnabled(hasSelection);
copyAction->setEnabled(hasSelection);
closeAction->setEnabled(hasEditor);
closeAllAction->setEnabled(hasEditor);
tileAction->setEnabled(hasEditor);
cascadeAction->setEnabled(hasEditor);
nextAction->setEnabled(hasEditor);
previousAction->setEnabled(hasEditor);
separatorAction->setVisible(hasEditor);
if (activeEditor())
activeEditor()->windowMenuAction()->setChecked(true);
}
当激活一个窗口或者关闭最后一个窗口时,调用updateMenus()槽更新菜单,updateMenus()是槽函数,在MainWindow的构造函数调用了这个函数,使程序启动时也能更新菜单。
只要有一个活动窗口,大部分菜单都是有意义的,如果没有活动窗口,这些菜单都被禁止。最后,调用QAction::setChecked()标示活动窗口。由于使用了QActionGroup,以前标示的活动窗口自动取消。
void MainWindow::createMenus()
{
...
windowMenu = menuBar()->addMenu(tr("&Window"));
windowMenu->addAction(closeAction);
windowMenu->addAction(closeAllAction);
windowMenu->addSeparator();
windowMenu->addAction(tileAction);
windowMenu->addAction(cascadeAction);
windowMenu->addSeparator();
windowMenu->addAction(nextAction);
windowMenu->addAction(previousAction);
windowMenu->addAction(separatorAction);
...
}
列出的这部分的createMenu()这段代码实现了window菜单。这些QAction能够很容易通过QWorkspace的成员函数实现,如,closeActiveWindow(),closeAllWindow(),tile(),cascade(),只要打开一个新的子窗口,就在window菜单中加一个Action。当用户关闭一个窗口时,相应的window菜单项就会删除,这个Action会自动从Window菜单中删除。
void MainWindow::closeEvent(QCloseEvent *event)
{
workspace->closeAllWindows();
if (activeEditor()) {
event->ignore();
} else {
event->accept();
}
}
虚函数closeEvent()给每一个子窗口发送关闭事件,关闭子窗口。如果还有一个子窗口,这很可能是因为用户在“unsaved changes”消息对话框中选择了cancel按钮,因此忽略这个关闭事件。如果没有活动窗口,Qt关闭所有的窗口。如果我们不在MainWindow类中重写closeEvent(),用户就没有机会保存文档的改变。
以上是MainWindow部分的代码。接着看Editor类的实现。Editor类代表的是一个子窗口。它继承自QTextEdit,基类中提供了文本编辑函数。Qt中的所有控件都可以做为一个独立的窗口,因此也能做为MDI中的一个子窗口。
类定义如下:
class Editor : public QTextEdit
{
Q_OBJECT
public:
Editor(QWidget *parent = 0);
void newFile();
bool open();
bool openFile(const QString &fileName);
bool save();
bool saveAs();
QSize sizeHint() const;
QAction *windowMenuAction() const { return action; }
protected:
void closeEvent(QCloseEvent *event);
private slots:
void documentWasModified();
private:
bool okToContinue();
bool saveFile(const QString &fileName);
void setCurrentFile(const QString &fileName);
bool readFile(const QString &fileName);
bool writeFile(const QString &fileName);
QString strippedName(const QString &fullFileName);
QString curFile;
bool isUntitled;
QString fileFilters;
QAction *action;
};
在Spreadsheet程序中的四个私有函数,也同样出现在Editor类中:okToContinue(),saveFile(),setCurrentFile(),stripptedName()。
Editor::Editor(QWidget *parent)
: QTextEdit(parent)
{
action = new QAction(this);
action->setCheckable(true);
connect(action, SIGNAL(triggered()), this, SLOT(show()));
connect(action, SIGNAL(triggered()), this, SLOT(setFocus()));
isUntitled = true;
fileFilters = tr("Text files (*.txt)\n"
"All files (*)");
connect(document(), SIGNAL(contentsChanged()),
this, SLOT(documentWasModified()));
setWindowIcon(QPixmap(":/images/document.png"));
setAttribute(Qt::WA_DeleteOnClose);
}
在构造函数中,我们首先创建一个QAction,把它添加到Window菜单中表示一个editor,并把这个QAction发出的消息triggered()和窗口的show(),setFocus()槽连接起来。
这个MDI程序允许用户创建任意数量的Editor窗口,因此我们必须在新建时给文档一个默认的名字,这样在保存时才能把不同的文档区分开。通常的做法是用一个包含一个数字的名字,例如,document1.txt。变量isUntitled区分文档的名字是用户输入的还是程序自动生成的。
我们连接文档的contentsChanged()信号和documentWasModified()槽,这个函数只是调用setWindowModified(true)。
最后设置属性Qt::WA_DeleteOnClose,在关闭Editor窗口时自动删除它,避免内存泄漏。
void Editor::newFile()
{
static int documentNumber = 1;
curFile = tr("document%1.txt").arg(documentNumber);
setWindowTitle(curFile + "[*]");
action->setText(curFile);
isUntitled = true;
++documentNumber;
}
在newFile()函数中给新建的文档一个类似document1.txt的名字。这段代码放在了newFile()中而不是在构造函数中,是因为documentNumber是一个静态的变量,在所有的Editor类型的对象中只有一个实例,我们不想调用open()函数来打开一个已存在的文档时也浪费该数字,增加documentNumber的值。
主窗口标题中的[*]是一个位置标识号。在非Mac OS X平台上表示文档有需要保存。这个标识号在第三章也出现过。
bool Editor::open()
{
QString fileName =
QFileDialog::getOpenFileName(this, tr("Open"), ".",
fileFilters);
if (fileName.isEmpty())
return false;
return openFile(fileName);
}
函数open()通过使用openFile()打开一个已经存在的文件。
bool Editor::save()
{
if (isUntitled) {
return saveAs();
} else {
return saveFile(curFile);
}
}
如果isUntitled为true,则调用函数saveAs()让用户给文档输入一个名字,如果isUntitled为false,调用saveFile()函数。
void Editor::closeEvent(QCloseEvent *event)
{
if (okToContinue()) {
event->accept();
} else {
event->ignore();
}
}
closeEvent()
函数是重写实现的,允许用户保存文档的改变。用户是否保存在okToContinue()函数中实现,弹出对话框“Do you want to save your changes?”,如果okToContinue()返回为true,接受这个关闭事件,否则,忽略这个事件,不关闭窗口。
void Editor::setCurrentFile(const QString &fileName)
{
curFile = fileName;
isUntitled = false;
action->setText(strippedName(curFile));
document()->setModified(false);
setWindowTitle(strippedName(curFile) + "[*]");
setWindowModified(false);
}
函数setCurrentFile()在openFile()和saveFile()中被调用,用以改变curFile和isUtitled变量的值,设置窗口标题和子窗口对应的QAction的名称,设置document()->setModified(false)。如果用户改变了文档中的文本,QTextDocument会发出contentsChanged()信号,把“modified”值为true。
QSize Editor::sizeHint() const
{
return QSize(72 * fontMetrics().width('x'),
25 * fontMetrics().lineSpacing());
}
用字母“X”的宽度和一行字符的高度做参考,sizeHint()函数返回一个尺寸,QWorkspace用这个尺寸初始化窗口大小。
以下是这个函数的main.cpp文件:
#include <QApplication>
#include "mainwindow.h"
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QStringList args = app.arguments();
MainWindow mainWin;
if (args.count() > 1) {
for (int i = 1; i < args.count(); ++i)
mainWin.openFile(args[i]);
} else {
mainWin.newFile();
}
mainWin.show();
return app.exec();
}
如果用户在命令行上指定了一个文件,则打开这个文件,否则新建一个空文档。Qt指定的选项如-style和-font自动由QApplication的构造函数从参数列表中删除,因此如果在命令行上这样写:
mdieditor -style motif readme.txt
QApplication::arguments()
返回一个包含两个字符串(mdieditor和readme.text)的QStringList,程序打开文档readme.txt。
MDI
是同时处理多个文档的一种方法。在Mac OS X上,较好的方法是使用多个顶层的窗口,在第三章“多文档”中有介绍。