CScrollView

CScrollView 类是一个具有滚动性能的 CView 。你可以在任何一个从 CView 派生的类中通过重载消息映射的 OnHScroll 和 OnVScroll 成员函数来自己处理标

准的滚动。但是 CScrollView 给它的 CView 性能添加了下列特征：

它管理窗口和视口的大小和映射模式。
它响应滚动条消息自动滚动。
它响应来自键盘，非滚动鼠标或 IntelliMouse 滚轮的消

息自动滚动。

你可以通过重载消息映射的 OnMouseWheel 和 OnRegisteredMouseWheel 成员函数来自己处理鼠标轮的滚动。就象对于 CScrollView 一样，这些成员函数支持为轮旋转消息 WM_MOUSEWHEEL 推荐的行为。

要利用自动滚动的优点，可以从 CScrollView 派生你的视类来代替 CView 派生。当视第一次被创建时，如果你希望根据文档的大小来计算可滚动视的大小，可以从重载的 CView::OnInitialUpdate 或 CView::OnUpdate 中调用成员函数SetScrollSize s。（你必须编写自己的代码来查询文档的大小。参见在“ Visual C++ 教程 ” 中的 “ 增强视 ” 可以获得有关的示例。）

调用成员函数 SetSc rollSize 可以设置视的映射模式，可滚动视的总尺寸，以及可在水平或垂直方向上滚动的量。所有的尺寸都是以逻辑单位给出的。视的逻辑大小通常是由保存在文档中的数据计算出来的。但在某些情况下，你可能希望为视指定一个固定的尺寸。有关这两种方法的例子，参见CScrollView::SetScrollSize s。

你应该以逻辑单位指定在水平或垂直方向上滚动的量。缺省情况下，如果用户在滚动框之外单击了滚动条的条身，则 CScrollView 滚动一 “ 页 ” 。如果用户单击了滚动条两端的滚动箭头，则 CScrollView 滚动一 “ 行 ” 。缺省情况下，一页是指整个视的大小的 1/10 ；一行是指页大小的 1/10 。你可以通过传递给SetScrollSize 成员函数定制的尺寸来代替这些缺省值。例如，你可以将水平大小设置为宽度总尺寸的一部分，并将垂直大小设置为当前字体的一行的高度。

除了滚动之外， CScrollView 还可自动将视的大小按比例变换成当前窗口的大

小。在这种方式下，视没有滚动条，这个逻辑视被扩大或缩小以精确符合窗口的客户区。要使用这种 “ scale-to-fit ” 的功能，可以调用CScrollView::SetScaleToFitSize 。（调用 SetScaleToFitSize 或 SetScrollSize s，但不要都调用。）

在调用你的派生类的 OnDraw 成员函数之前， CScrollView 自动调整传递给

OnDraw 的 CPaintDC 设备环境对象的视口原点。

为了为滚动窗口调整视口原点， CScrollView 重载 CView::OnPrepareDC 。这种调整对于 CScrollView 传递给 OnDraw 的 CPaintDC 设备环境来说是自动的，但你必须为自己所使用的其它设备环境（例如 CClientDC ）自己调用CScrollView::OnPrepareDC 。你可以重载 CScrollView::OnPrepareDC 来设置画笔，背景颜色，和其它绘画属性，但是要调用基类来进行比例变换。

滚动条可以显示在与一个视相关的三个位置，如下所示：

可以使用 WS_HSCROLL 和 WS_VSCROLL 风格为视设置标准的窗

口风格滚动条。
也可以将滚动条加在包含视的框架上，在这种情况下

，框架将来自框架窗口的 WM_HSCROLL 和 WM_VSCROLL 消息向前传递给当前的活动视。
框架也可以将来自 CSplitterWnd 分隔器控件的滚动信息

转发给当前活动的分隔格（一个视）。当在一个 CSplitterWnd 中放置了一个可共享的滚动条时， CScrollView 对象将使用这个可共享的滚动条而不再去创建它自己的滚动条。

#include <afxwin.h>

请参阅 CView, CSplitterWnd

CScrollView 类成员

Operation s FillOutsideRect 填充视滚动区域之外的其它区域

GetDeviceScrollPositio n

获取以设备单位表示的当前滚动位置

GetDeviceScrollSizes 获取可滚动视的用设备单位表示的当前映射模

式，总尺寸，以及行和页的大小GetScrollPosition 获取用逻辑单位表示的当前滚动位置GetTotalSize 获取用逻辑单位表示的滚动视的总尺寸ResizeParentToFit 使视的大小可以支配它的框架的大小ScrollToPosition 将视滚动到用逻辑单位指定的给定点SetScaleToFitSize 将视设置为 “ scale-to-fit” 模式

SetScrollSizes 设置滚动视的映射模式，总尺寸，以及水平和垂

直滚动量

Construction

CscrollView 构造一个 CScrollView 对象

成员函数

CScrollView::CScrollView

CScrollView( );

说明

此成员函数用来构造一个对象。在此滚动视可用之前你必须调用 SetScrollSize

或 SetScaleToFitSize 。

请参阅 CScrollView::SetScrollSizes, CScrollView::SetScaleToFitSize

CScrollView::FillOutsideRect

void FillOutsideRect( CDC* pDC , CBrush* pBrush );

参数

pDC

将在其中完成填充操作的设备环境。

pBrush

将被填充的区域的画刷。

说明

调用 FillOutsideRect 来填充视的滚动区域之外的区域。在滚动视的 OnEraseBkgnd

处理函数中使用 FillOutsideRect 可以避免连续的背景重画。

示例

BOOL CScaleView::OnEraseBkgnd( CDC* pDC )

{

CBrush br( GetSysColor( COLOR_WINDOW ) );

FillOutsideRect( pDC, &br );

return TRUE; // 擦除

}

请参阅 CWnd::OnEraseBkgnd

CScrollView::GetDeviceScrollPosition CPoint GetDeviceScrollPosition( ) const; 返回值

返回一个 CPoint 对象，包含了滚动框的水平和垂直位置（以设备单位表示）。

说明

当你需要滚动条中的滚动框的当前水平和垂直位置时，可以调用

GetDeviceScrollPosition 。此函数返回的坐标对应于已滚动的视的左上角在文档

中的位置。在将鼠标设备的位置偏移到滚动视的设备位置时，这一点是很有用的。

GetDeviceScrollPosition 的返回值是以设备单位表示的。如果你需要的是逻辑单位值，你可以使用 GetScrollPosition 来代替。

请参阅 CScrollView::GetScrollPosition

CScrollView::GetDeviceScrollSizes

void GetDeviceScrollSizes( int& nMapMode , SIZE& sizeTotal , SIZE& sizePage , SIZE& sizeLine ) const;

参数

nMapMode

返回这个视的当前映射模式。参见 SetScrollSize s 可以获得可能取值的列

表。

sizeTotal

返回这个滚动视的当前以设备单位表示的总尺寸。

sizePage

返回在响应滚动条的条体中发生的鼠标单击时，水平和垂直方向上的当前滚动量。 cx 成员中存放水平量； cy 成员中存放垂直量。

sizeLine

返回当响应鼠标在某个滚动箭头上单击时水平和垂直方向上的当前滚动量。 cx 成员中存放水平量； cy 成员中存放垂直量。

说明

GetDeviceScrollSizes 用来获取当前的映射模式，总尺寸，以及这个可滚动视的行和页的大小。各个尺寸都是以设备单位表示的。这个成员函数很少被调用。

CScrollView::GetScrollPosition CPoint GetScrollPosition( ) const; 返回值

返回一个 CPoint 对象，包含滚动框的水平和垂直位置（以逻辑单位表示）。

说明

当你需要滚动条中的滚动框的当前水平和垂直位置时可以调用

GetScrollPosition 。这个坐标对是对应于已滚动的视的左上角在文档中的位置。

GetScrollPosition 的返回值是以逻辑单位表示的。如果你需要的是以设备单位表示的值，你可以调用 GetDeviceScrollPosition 来代替。

CScrollView::GetTotalSize CSize GetTotalSize( ) const; 返回值

返回以逻辑单位表示的滚动视的总尺寸。水平尺寸被保存在 CSize 返回值的 cx

成员中。垂直尺寸被保存在 cy 成员中。

说明

调用 GetTotalSize 来获取滚动视的当前水平和垂直尺寸。

请参阅 CScrollView::GetDeviceScrollSizes, CScrollView::SetScrollSizes

CScrollView::ResizeParentToFit

void ResizeParentToFit( BOOL bShrinkOnly = TRUE );

参数

bShrinkOnly

要实现的尺寸调整操作。缺省值是 TRUE ，表示要根据需要缩小框架窗口。对大的视或小的框架窗口，滚动条仍然是可见的。该值为 FALSE ，表示视总是要精确地调整框架窗口。这样做可能会有危险，这是因为框架窗口可能会变得太大以致于不能被放在多文档界面（ M D I ）的框架窗口中或屏幕内。

说明

调用 ResizeParentToFit 将使视的大小支配它的框架窗口的大小。仅对 M D I 子窗

口才推荐使用此函数。你应该在 CScrollView 派生类的 OnInitialUpdate 处理函数中使用 ResizeParentToFit 函数。关于这个成员函数的例子，参见CScrollView::SetScrollSize 。

ResizeParentToFit 假设视图窗口的尺寸已被设置好。如果 ResizeParentToFit 函数被调用时视图窗口的尺寸还没有被设置好，则屏幕上显示一条断言。为了保证不发生此类事件，应确保在调用 ResizeParentToFit 函数之前进行如下调用：

GetParentFrame()->RecalcLayout();

请参阅 CView::OnInitialUpdate, CScrollView::SetScrollSizes

CScrollView::ScrollToPosition

void ScrollToPosition( POINT pt );

参数

用逻辑单位表示的要滚动到的点。 x 成员必须是正值（大于或等于 0 ，小于视的总大小值）。当映射模式时 MM_TEXT 时，对 y 成员有同样的要求。当映射模式不是 MM_TEXT 时， y 成员是一个负值。

说明

调用 ScrollToPosition 来滚动到视中的一个给定点。视也将被滚动以使此点位于窗口的左上角。当视是 “ scale-to-fit ” 的视时，不能调用此函数。

请参阅 CScrollView::GetDeviceScrollPosition, CScrollView::SetScaleToFitSize, CScrollView::SetScrollSizes

CScrollView::SetScaleToFitSize

void SetScaleToFitSize( SIZE sizeTotal );

参数

sizeTotal

指出这个视将被比例变换至的水平和垂直尺寸。可滚动视的尺寸是以逻辑单位测量的。 cx 成员中存放水平尺寸， cy 成员中存放垂直尺寸。 cx 和cy 都必须大于或等于 0 。

说明

当你希望将视口的尺寸自动按比例变换为当前窗口的尺寸时，可以调用SetScaleToFitSize 函数。使用滚动条时，在任一时刻可能只能看到逻辑视的一部分。但是如果具有 “ scale-to-fit” 的功能，则视没有滚动条，并且逻辑视被扩

大或缩小以精确吻合窗口的客户区。当窗口被重新调整大小时，该视将根据窗口的尺寸以新的比例绘制其数据。

通常你可以在视的重载的 OnInitialUpdate 成员函数中调用 SetScaleToFitSize 。如果你不需要自动按比例变换，调用 SetScrollSizes 成员函数来代替。

SetScaleToFitSize 可以用来实现一个 “ Zoom to fit ” 操作。使用 SetScrollSizes

来重新初始化滚动。

SetScaleToFitSize 假设视图窗口已经被设置好了。如果在调用 SetScaleToFitSize 时视图窗口的尺寸还没有被设置，你将会得到一个断言。为了保证不出现这种情况，在调用 SetScaleToFitSize 之前要进行以下调用：

GetParentFrame()->RecalcLayout();

请参阅 CScrollView::SetScrollSizes, CView::OnInitialUpdate

CScrollView::SetScrollSizes

void SetScrollSizes( int nMapMode , SIZE sizeTota l, const SIZE& sizePage = sizeDefault,

const SIZE& sizeLine = sizeDefault );

参数

nMapMode

要为这个视设置的映射模式。可能的取值包括：

Mapping Mode	Logical Unit	Positive Extends...	y-axis
MM_TEXT	1 个像素	向下
Mapping Mode	Logical Unit	Positive	y-axis
		Extends...
M M _ H IMETRIC MM_TWIPS	0.01 毫米 1/1440 英寸	向上向上
M M _ H IENGLISH	0.001 英寸	向上
MM_LOMETRIC	0.1 毫米	向上
MM_LOENGLISH	0.01 英寸	向上

所有的这些模式都是 Windows 定义的。两个标准的映射模式， M M _ ISOTROPIC 和 MM_ANISOTROPIC ，在 CScrollView 中没有使用。类库提供了SetScaleToFitSize 成员函数来将视图的尺寸按比例变换为窗口的尺寸。

sizeTotal

滚动视的总尺寸。 cx 成员包含了水平分量。 cy 成员包含了垂直分量。这些尺寸是以逻辑单位表示的。 cx 和 cy 都必须大于或等于 0 。

sizePage

当鼠标在滚动条的条体上单击时，要在水平和垂直方向上滚动的量。 cx

中存放水平滚动量， cy 成员中存放垂直滚动量。

sizeLine

当响应鼠标单击滚动条的滚动箭头时要在水平或垂直方向上滚动的量。cx

中存放水平滚动量， cy 成员中存放垂直滚动量。

当视要被更新时，调用 SetScrollSize s。在你的重载的 OnUpdate 成员函数中调用这个函数来调整滚动特性，例如，当文档第一次被显示或是被改变大小时。

通常，通过调用你的派生文档类的一个文档成员函数，可能是 GetMyDocSize ，你可以获得视的相关文档的尺寸信息。下面的代码给出了这种方法：

SetScrollSizes( nMapMode, GetDocument( )->GetMyDocSize( ) );

另外，你有时候也许需要设置一个固定的尺寸，就像下面的代码：

SetScrollSizes( nMapMode, CSize(100, 100) );

你必须将映射模式设置为除 MM_ISOTROPIC 或 M M _ A N ISOTROPIC 之外的任何 W indows 映射方式。如果你希望使用一种非限定的映射方式，可以调用SetScaleToFitSize 成员函数来代替 SetScrollSizes 。

void CScaleView::OnUpdate( )

{

// ...

// Implement a GetDocSize( ) member function in

// your document class; it returns a CSize.

SetScrollSizes( MM_LOENGLISH, GetDocument( )->GetDocSize( ) ); ResizeParentToFit( ); // Default bShrinkOnly argument

// ...

}

请参阅 CScrollView::SetScaleToFitSize, CScrollView::GetDeviceScrollSizes, CScrollView::GetTotalSize

CScrollView

CScrollView

CScrollView 类 成 员

成 员 函 数

CScrollView 类成员

成员函数