(已读)第十四章 单文档界面的程序

第十四章单文档界面的程序
用VC++的AppWizard生成的程序有三种样式的界面，它们是单文档、多文档和对话框界面。

前面各章我们都生成对话框样式的界面，这可以方便我们学习各种常用控件的设计，本章要学习如何生成一个单文档界面的应用程序，以及文档类和视图类的概念和相互关系。

本章要点
1 用AppWizard生成单文档界面的操作方法
2 文档类和视图类的概念
3 如何保持文档和视图的同步关联。

14.1 生成单文档界面的文本编辑器
用AppWizard生成单文档界面的操作方法和生成对话框界面的操作方法稍有不同，我们通过建立一个“文本编辑器”应用程序MyNote.exe来演示，具体过程如下：
1 打开应用程序向导，在d:\myVC\CH14创建应用程序MyNote。

2 在Step1中选择“单文档”和“文档/视图支持”,如图chap14-01.
图chap14-01
3 在step2和step3对话框中都用默认的。

在step4中如图chap14-02选择前五项，当然也可以按你的需要选择。

图chap14-02
4 在Step5中选择MFC标准、加备注和静态连接库。

图chap14-03
图chap14-03
5 在step6中选择视图的基类(base class)，因为我们需要的是文本编辑器，所以要选类CEditView作为基类。

点击[完成]按纽，应用程序的框架就创建好了。

14.2 文档类和视图类的概念
向导工作完成以后马上编译和连接，运行后就可以看到一个已经能够使用的文本编辑器，它不仅可以输入文字，还可以保存或打开文件，与Windows的记事本差不多了，只是没有设置字体的功能。

图chap14-04是它运行时的窗口。

chap14-04
菜单和工具栏的响应函数都已经生成了相应的代码，我们没有做任何编写工作就得到了一个“完整”的应用程序，甚至还创建了一个帮助文件呢。

这就是VC++开发环境的巨大威力！我们从上图中可以看到，编辑菜单中的复制和剪切都已经有效了。

图中的窗口是主框架，对应于类CMainFrame，而其中的“编辑区域”叫用户区，对应于视图类CMyNoteView，而被编辑的文本对应于一个文档类CMyNoteDoc。

另外，每个程序还有一个对应于应用程序本身的类，本例中是CMyNoteApp。

这四个类就是向导自动生成的应用程序框架类，打开工作区的类classView页区，就可以看到，如图chap14-05。

展开视图类，可以找到一个函数GetDocument()，它是使视图（的内容）和文档保持同步关联的纽带。

它返回一个CMyNoteDoc类型的对象指针m_pDocument。

使用它在视图中访问文档的内容。

在文档类中有一个OnNewDocument()函数，在“新建文件”和程序第一次运行时被调用，它打开一个新文档供用户编辑。

我们来看一下它的代码：
BOOL CMyNoteDoc::OnNewDocument()
{
if (!CDocument::OnNewDocument())
return FALSE;
((CEditView*)m_viewList.GetHead())->SetWindowText(NULL);
return TRUE;
}
if语句调用其父类的同名函数，第二个语句设置编辑区的文本为空白。

你试着用“这是一个新文档”来代替NULL，重新编译和运行，那每次打开时编辑区会出现这句话。

文档类中还有一个叫Serialize，把它系列化对象CArchive& ar设置为按行系列化，这是纯文本文件存取时所需要的。

下面是它的代码。

void CMyNoteDoc::Serialize(CArchive& ar)
{
// CEditView contains an edit control which handles all serialization
((CEditView*)m_viewList.GetHead())->SerializeRaw(ar);
}
在下一节中，我们将通过一个例程来演示，如何在文档对象和视图对象之间互相访问和交换数据。

14.3 Circle程序的界面和功能
Circle程序的功能是：用鼠标左键在用户区域任意的点一下，就以这一点为圆心画一个半径为50的圆。

程序的界面和上例一样，都是单文档程序的基本形式么。

但是其客户区年输入文字，是画图形式的。

图chap14-06
下面我们就来制作这一程序。

1 创建工程
打开应用程序向导，在d:\myVC\CH14创建应用程序Circle。

选择“单文档”，后面的应答与上例一样。

不同的是最后一步视图基类的选择，不是选CEditView而是选CView。

CEditView 类是CView类的子类，适合于需要文字编辑的场合。

2 添加变量
画圆需要与圆心和半径，为了文档和视图的同步，我们需要给两者都引进三个变量m_PosX、m_PosY和m_Reduse。

定义要写在他们的构造函数中：
public:
int m_PosX, m_PosY;
int m_Reduse ;
3 编写代码
(1)函数OnDraw(CDC* pDC)的功能是在客户区画图，我们用它以试图中的变量值来画圆，代码如下：
void CCircleView::OnDraw(CDC* pDC)
{
CCircleDoc* pDoc = GetDocument();
ASSERT_VALID(pDoc);
// TODO: add draw code for native data here
//Draw a circle
RECT rect;
rect.left= m_PosX - m_Reduse ;
rect.top = m_PosY - m_Reduse ;
rect.right = m_PosX + m_Reduse ;
rect.bottom= m_PosY + m_Reduse ;
pDC->Ellipse(&rect);
}
其中pDC是由参数表传递过来的屏幕设备对象，可以画图。

RECT是表示举行的数据结构。

是画图圆需要的参数。

(2)变量m_PosX等的值在初始更新函数OnInitialUpdate()中给定，而值是从文档的同名函数中传递过来的。

???
CCircleDoc* pDoc = GetDocument();
m_PosX = pDoc->m_PosX ;
m_PosY = pDoc->m_PosY ;
m_Reduse = pDoc->m_Reduse ;
(3)要求当“按下鼠标时画圆”，就要添加OnLButtonDown函数，其中使用Invalidate()，它会调用函数OnDraw重新画客户区，其代码如下：
void CCircleView::OnLButtonDown(UINT nFlags, CPoint point)
{
// TODO: Add your message handler code here and/or call default
m_PosX = point.x ;
m_PosY = point.y ;
Invalidate();
CCircleDoc* pDoc = GetDocument();
pDoc->m_PosX = m_PosX;
pDoc->m_PosY = m_PosY;
pDoc->SetModifiedFlag(TRUE);
CView::OnLButtonDown(nFlags, point);
}
变量point对应的是鼠标当前点的位置，传递给视图的变量，然后画圆；再把它传递给文档，这就保证视图和文档数据的一致性。

语句
pDoc->SetModifiedFlag(TRUE);
设置文档已经被修改的标志，这使得程序在退出时会询问“是否要保存？”。

(4)在文档类中有一个函数OnNewDocument()，它是在按“文件/新建”时被调用的。

我们用它给出圆的初始值：
m_PosX = 100;
m_PosY = 100;
m_Reduse = 50 ;
需要的代码就这些了，现在可以编译和运行之。

思考和练习
1 文档类应用程序是如何保持视图和文档数据的一致性的？
2 在MyNote程序中添加菜单及其代码，扩展它的功能。

例如，增加文字的大小和颜色等。

3 在Circle程序中添加菜单及其代码，扩展它的功能。

例如，可变的半径，画不同的图形等。