CScrollBar

CScrollBar 类支持一个 W indows 滚动条控件的功能。

创建一个滚动条控件分为两步。首先，调用构造函数 CScrollBar 来构造一个CScrollBar 对象，然后调用 C reate 成员函数来创建 W indows 滚动条控件并将它与 CScrollBar 对象相联系。

如果你是在一个对话框（通过一个对话框资源）中创建一个 CScrollBar 对象的，

则当用户关闭这个对话框时， CScrollBar 自动销毁。

如果你是在一个窗口中创建一个 CScrollBar 对象，则你必须负责销毁该对象。

如果你是堆栈中创建 CScrollBar 对象，则该对象将会自动销毁。如果你是通过使用 New 函数在数据堆中创建 CScrollBar 对象，则当用户终止使用该 W indows 滚动条时，你必须调用 delete 来销毁该对象。

如果你在此 CScrollBar 对象中分配了任何内存，则应重载 CScrollBar 析构函数来释放这些内存。

#include <afxwin.h>

请参阅 C Wnd, CButton, CComboBox, CEdit, CListBox, CStatic, CDialog

CScrollBar 类成员

Construction

CscrollBar 构造一个 CScrollBar 对象

Initialization

Create 创建 W indows 滚动条，并将它连接到 CScrollBar

对象上

Operation s GetScrollPos 获取一个滚动框的当前位置

SetScrollPos 设置一个滚动框的当前位置

GetScrollRange 获取给定滚动条的当前最大和最小滚动条位置SetScrollRange 设置给定滚动条的最小和最大位置ShowScrollBar 显示或隐藏一个滚动条

EnableScrollBar 使一个滚动条的一个或两个箭头有效或无效

SetScrollInfo 设置有关滚动条的信息

GetScrollInfo 获取有关滚动条的信息

GetScrollLimit 获取滚动条的极限

成员函数

CScrollBar::Create

BOOL Create( DWORD dwStyle , const RECT& rect , CWnd* pParentWnd , UINT

nID );

返回值

如果成功则返回非零值；否则返回 0 。

参数

dwStyle

指定滚动条的风格。任何滚动条风格的组合都适用于滚动条。

rect

指定滚动条的大小和位置。可以是一个 RECT 结构或是一个 CRect 对象。

pParentWnd

指定滚动条的父窗口，通常是一个 CDialog 对象。它不能是 NULL 。

NID

该滚动条的控件 ID 。

说明

可以分两步构造一个 CScrollBar 对象。首先调用构造函数来构造一个 CScrollBar 对象；然后调用 Create 来创建并初始化关联的 W indows 滚动条，并将它连接到该 CScrollBar 对象上。

可以将下列窗口风格使用到一个滚动条：

WS_CHILD 总要使用。
WS_VISIBLE 常用。
WS_DISABLED 少用。
WS_GROUP 将控件分组。

请参阅 CScrollBar::CScrollBar

CScrollBar::CScrollBar

CScrollBar( );

说明

此成员函数用来构造一个 CScrollBar 对象。在构造对象之后，调用 Create 成员函数来创建并初始化 Windows 滚动条。

请参阅 CScrollBar::Create

CScrollBar::EnableScrollBar

BOOL EnableScrollBar( UINT nArrowFlags = ESB_ENABLE_BOTH );

返回值

如果按指定的要求使箭头有效或无效，则返回非零值；否则返回 0 ，这表明箭头已经处于需要的状态，或者是发生了一个错误。

参数

nArrowFlags

指定是要使给定箭头有效还是无效，及是使哪一个箭头有效或无效。这个参数可以是下列值之一：

ESB_ENABLE_BOTH 使滚动条的两个箭头都有效。
ESB_DISABLE_LTUP 使水平滚动条的左箭头或垂直滚动条

的上箭头无效。
ESB_DISABLE_RTDN 使水平滚动条的右箭头或垂直滚动条

的下箭

头无效。

ESB_DISABLE_BOTH 使滚动条的两个箭头都无效。

说明

此成员函数用来使滚动条的一个或两个箭头有效或无效。

请参阅 CWnd::EnableScrollBar, ::EnableScrollBar

CScrollBar::GetScrollInfo

BOOL GetScrollInfo( LPSCROLLINFO lpScrollInfo , UINT nMask );

返回值

如果消息获取了任何值，则返回 TRUE ；否则返回 FALSE 。

参数

lpScrollInfo

指向一个 SCROLLINFO 结构的指针。参见 “ W in32 程序员参考 ” 可以获得更多有关这个结构的信息。

nMask

指定要获取的滚动条参数。通常使用的是：SIF_ALL ，表示是 SIF_PAGE ， SIF_POS ， SIF_TRACKPOS 和 SIF_RANGE 的组合。参见 SCROLLINFO

可以获得有关 n M ask 值的更多信息。

说明

此成员函数用来获取由 SCROLLINFO 结构保存的关于一个滚动条的信息。

GetScrollInfo 允许应用程序使用 32 位的滚动位置信息。

SCROLLINFO 结构包含了有关一个滚动条的信息，包括滚动位置的最小和最大值，页面的大小和滚动框（拇指）的位置。参见 “ W in32 SDK 程序员参考 ” 中的 SCROLLINFO 结构主题，可以获得有关改变结构的缺省值的更多信息。

MFC Windows 消息句柄表示了滚动条的位置， CWnd::OnHScroll 和CWnd::OnVScroll 只提供 16 位的位置数据。 GetScrollInfo 和 SetScrollInfo 提供32 位的滚动条位置数据。因此，一个应用程序在处理 GetScrollInfo 或 SetScrollInfo 时，可以调用 GetScrollInfo 来获取 32 位的滚动条位置数据。

请参阅 CScrollBar::SetScrollInfo, CWnd::SetScrollInfo, CWnd::SetScrollPos, CWnd::OnVScroll, CWnd::OnHScroll, SCROLLINFO

CScrollBar::GetScrollLimit

int GetScrollLimit( );

返回值

如果成功则返回值指定滚动条最大位置；否则返回值为 0 。

说明

此成员函数用来获取滚动条的最大滚动位置。

请参阅 CWnd::GetScrollLimit

CScrollBar::GetScrollPos

int GetScrollPos( ) const;

返回值

如果成功则返回指定滚动框当前位置的值；否则返回 0 。

说明

此成员函数用来获取一个滚动框的当前位置。这个当前位置是一个相对值，它依赖于当前的滚动范围。例如，如果滚动范围是 100 到 200 ，而滚动框是在滚动条的中间，则这个当前位置是 150 。

请参阅 CScrollBar::SetScrollPos, CScrollBar::GetScrollRange, CScrollBar::SetScrollRange, ::GetScrollPos

CScrollBar::GetScrollRange

void GetScrollRange( LPINT lpMinPos , LPINT lpMaxPos ) const;

参数

lpMinPos

指向一个用来接收最小位置的整型变量。

lpMaxPos

指向一个用来接收最大位置的整型变量。

说明

此成员函数将滚动条的当前滚动条位置的最小和最大值拷贝为 lpMinPos 和

lpMaxPos 指定的值。

个滚动条控件的缺省范围是空（两个值都为零）。

请参阅 ::GetScrollRange, CScrollBar::SetScrollRange, CScrollBar::GetScrollPos, CScrollBar::SetScrollPos

CScrollBar::SetScrollInfo

BOOL SetScrollInfo( LPSCROLLINFO lpScrollInfo , BOOL bRedraw = TRUE );

返回值

如果成功则返回 TRUE ；否则返回 FALSE 。

参数

lpScrollInfo

指向一个 SCROLLINFO 结构的指针。

bRedraw

指示这个滚动条是否应重画以反映新的信息。如果 bRedraw 是 TRUE ，则滚动条被重画。如果它是 FALSE ，则不重画滚动条。缺省的，滚动条将被重画。

说明

此成员函数用来设置 SCROLLINFO 结构保持的有关一个滚动条的信息。你必

须提供 SCROLLINFO 结构参数需要的值，包括标志值。

SCROLLINFO 结构包含了有关一个滚动条的信息，包括滚动位置的最小和最大值，页面的大小和滚动框（拇指）的位置。参见 “ W in32 SDK 程序员参考 ” 中的 SCROLLINFO 结构主题，可以获得有关改变此结构的缺省值的更多信息。

请参阅 CScrollBar::GetScrollInfo, CWnd::SetScrollInfo, CWnd::SetScrollPos, CWnd::OnVScroll, CWnd::OnHScroll, CWnd::GetScrollInfo, SCROLLINFO

CScrollBar::SetScrollPos

int SetScrollPos( int nPo s , BOOL bRedraw = TRUE );

返回值

如果成功则返回滚动框的先前位置；否则返回 0 。

参数

nPos

指定滚动框的新位置。它必须是在滚动范围之内。

bRedraw

指示滚动条是否应该被重画来反映新的位置。如果 bRedraw 是 TRUE ，则滚动条被重画。如果它是 FALSE ，则不重画滚动条。缺省的，滚动条将被重画。

说明

此成员函数用来将一个滚动框的当前位置设置为 nPos 指定的位置，并且，如果指定了重画，则重画滚动条来反映新的位置。

请参阅 CScrollBar::GetScrollPos, CScrollBar::GetScrollRange, CScrollBar::SetScrollRange, ::SetScrollPos

CScrollBar::SetScrollRange

void SetScrollRange( int nMinPo s , int nMaxPo s , BOOL bRedraw = TRUE );

参数

nMinPos

指定滚动位置的最小值。

nMaxPos

指定滚动位置的最大值。

bRedraw

指示是否要重画滚动条来反映改变。如果 bRedraw 是 TRUE ，则滚动条被重画。如果它是 FALSE ，则不重画滚动条。缺省的，滚动条将被重画。

说明

此成员函数用来为给定的滚动条设置滚动位置的最小和最大值。如果将 nMinPos

和 nMaxPos 都设置为零，则隐藏此标准滚动条。

当处理一个滚动条通知消息时，不要调用这个函数来隐藏一个滚动条。

如果在调用 SetScrollRange 之后，立即调用 SetScrollPos 成员函数，则在

SetScrollPos 中将 bRedraw 设置为 0 ，以禁止滚动条被重画两次。

由 nMinPos 和 nMaxPos 指定的间隔值必须不大于 32,767 。一个滚动条控件的缺省范围是空（ nMinPos 和 nMaxPos 都为 0 ）。

请参阅 CScrollBar::GetScrollPos, CScrollBar::SetScrollPos, CScrollBar::GetScrollRange, ::SetScrollRange

CScrollBar::ShowScrollBar

void ShowScrollBar( BOOL bShow = TRUE );

参数

bShow

指示是显示还是隐藏滚动条。如果这个参数是 TRUE ，则显示滚动条；否则隐藏滚动条。

说明

此成员函数用来显示或隐藏一个滚动条。

当应用程序在处理一个滚动条通知消息时，不要调用这个函数来隐藏滚动条。

请参阅 CScrollBar::GetScrollPos, CScrollBar::GetScrollRange, CWnd::ScrollWindow,

CScrollBar::SetScrollPos, CScrollBar::SetScrollRange

CScrollBar

CScrollBar

CScrollBar 类 成 员

成 员 函 数

CScrollBar 类成员

成员函数