界面控件 - 滚动条ScrollBar

界面是人机交互的门户，对产品至关重要。在界面开发中只有想不到没有做不到的，有好的想法，当然要尝试着做出来。对滚动条的扩展，现在有很多类是的例子。

VS2015的代码编辑是非常强大的，其中有一个功能可以把滚动态变成MinMap，可以通过Options->Text Editor->C/C++->Scroll Bars中的Behavior选项分类进行打开。

sublime也有这个功能，但没有VS的好用。变成MinMap后整个代码文档变成一个完整的缩微图，在你对代码比较熟悉的情况下，可以非常容易判断并定位到大致的函数位置。同时对特殊状态，如：错误信息，更新信息等进行标识。只要看一眼滚动条就能知道当前文档的情况，可以快速定位到相关文档位置。

优点多多： 当一个文件内容比较长时，在上面标注相关重要内容是非常方便的。用于只要一看滚动条上的相关标示，就能知道相关信息。不用再开辟窗口告诉用户，他想得到的有关信息。

有VS可作参考，做这个就比较容易。不知道微软有没有注册版权-_-!!。因此想到扩展Scroll Bar是个不错的主意，但windows系统并没有给这个机会，一般的窗口类都自带系统滚动条。系统自带的完全无法做出这种效果，只能自己做一个覆盖系统默认滚动条。

一、滚动条结构SCROLLINFO

typedef struct tagSCROLLINFO {
  UINT cbSize;    // 结构尺寸
  UINT fMask;     // 需要处理或返回的相关选项参数
  int  nMin;      // 滚动条的最小值
  int  nMax;      // 最大滚动范围
  UINT nPage;     // 一页有效行数
  int  nPos;      // 当前滚动条
  int  nTrackPos; // 拖拽滚筒条时的位置
} SCROLLINFO, *LPCSCROLLINFO;

正常我们用到的的滚动条有下面一些元素，画了张图更容易理解点。

可以看到如果我们默认最小值=0时，实际需要的只有三个滚动条参数，最大可以滚动的范围nMax，一页可显示的行数nPage 和 当前行的显示位置nPos 这三个参数。

1、滚动数量计算

如滚动条能正常滚动到最后一行的位置。有100行记录，滚动最下面界面显示最后一行。为方便计算没条记录的行高固定。

  • nPage = ClientHeight / rowHeight
  • nMax = rowCount - 1 + nPage - 1

正常情况计算是总行数-1， 就是 nMax的值，应为要允许滚动到记录最后一条，因此需要多加一页的滚动数量。就产生了上面的nMax的公式。

// 只要超过1行就能滚动，因此需要多加一页的行数。
si.nMax   = rowCount - 1 + yClient / rowHeight - 1;
si.nPage  = yClient / rowHeight;

2、滑块尺寸计算

滑块的尺寸的尺寸按照上图的定义，滚动条的高度除以滚动范围再乘上每页数量可以得到。

滑块尺寸 = 滚动条高度 / 有效范围 * 每页数量

上述计算公式存在另外一个问题，如果记录量很大时就杯具，滑块会非常小，用户很难用鼠标抓到滑块。眼神犀利和伸手敏捷的才能完成这种艰巨任务。因此为滑容易定位的最小值。

 s = max((float)((r.bottom - r.top) / (si.nMax - si.nMin) * si.nPage), 20.0f);

3、滑块位置计算

在图上看滑块有效的滑动位置是需要扣除滑块的大小的。

实际滑动位置 = （滚动条高度 - 滑块尺寸） / （有效范围 - 每页数量 + 1） * 当前行位置

有除法，就会存一些精度问题，所以算出位置后要检查一下位置是否超出客户区。

v = 0;
if (si.nPos > 0)
    v = (int)((r.bottom - r.top - s) / (float)(si.nMax - si.nMin + 1 - si.nPage)  * si.nPos);
// 由于精度问题，可能滑块位置会超界。超界就取最大值
if (v && v + (int)s > r.bottom)
    v = r.bottom - (int)s;

二、滚动条信息

做滚动条肯定需要记录上述说的相关信息。为简易期间直接使用这个结构体记录static SCROLLINFO si;。在设置和获取时直接使用。

自定义滚动条不能使用SetScrollInfo 或 GetScrollInfo ，这两个是给系统提供的。需要另外增加2个消息，系统已经提供了两个消息，可以直接使用。SBM_SETSCROLLINFO 和 SBM_GETSCROLLINFO 处理滚动信息。

参数：

  • wParam --- SBM_SETSCROLLINFO 是否需要刷新， SBM_GETSCROLLINFO 无效。
  • lParam --- *SCROLLINFO 结构体指针。

前面在SCROLLINFO 结构中有提到fMask，在设置和获取中需要使用。

Mask 值：

  • SIF_RANGE --- 设置行数范围参数 nMin ～ nMax 这两个参数值有效。
  • SIF_PAGE --- 每页行数 nPage 参数值有效
  • SIF_POS --- 位置值 nPos 参数值有效
  • SIF_ALL --- 所有参数值都有效。

其他对应值可以参考MSDN文档。

case SBM_SETSCROLLINFO:
    if (!lParam) return 0;

    // 设置滚动条信息
    psrcsi = (SCROLLINFO *)lParam;
    if (psrcsi->fMask & SIF_RANGE) {    // 设置内容行数
        si.nMax = psrcsi->nMax;
        si.nMin = psrcsi->nMin;
    }
    if (psrcsi->fMask & SIF_PAGE)       // 每页能显示多少行
        si.nPage = psrcsi->nPage;
    if (psrcsi->fMask & SIF_POS)        // 行显示位置
        si.nPos = psrcsi->nPos;

    // wParam = true　刷新滚动区域
    if (wParam) InvalidateRect(hwnd, NULL, false);
    return 0;

case SBM_GETSCROLLINFO:
    //这里简单处理，应该和SBM_SETSCROLLINFO一样判断获取的信息。
    if (lParam) *(SCROLLINFO *)lParam = si;
    return 0;

三、滚动条绘制

有基本的滚动条结构信息后，要绘制出自己的滚动条就很简单了。需要主意的一点，当滚动条尺寸小到比滑块尺寸还小时，就不要再绘制滑块了。

技巧： 在填充色块时可以使用ExtTextOut函数进行填充，在不使用双缓存的情况下，能减少闪烁，而且不需要申请画刷。

static void mlCGFillColor(HDC hdc, RECT *r, unsigned int color)
{
    // 实际使用ExtTextOut要比FillRect填充颜色效果好，能减少绘制中闪烁问题。而且不要申请画刷。
    SetBkColor(hdc, color);
    ExtTextOut(hdc, 0, 0, ETO_OPAQUE, r, 0, 0, 0);
}

// WM_PAINT Code
// 绘制背景色
GetClientRect(hwnd, &r);
mlCGFillColor(hdc, &r, 0xcccccc);

// 计算滑块大小，过小时不绘制
if (r.bottom - r.top > 30 && si.nMax && (si.nMax - si.nMin) >= (int)si.nPage) {

    // 滑块计算
    //   大小 = 滚动条高度 / 有效范围 * 每页数量
    //   最小20, 内容比较多，降低用于鼠标定位到滚动条拖动的难度。
    s = max((float)((r.bottom - r.top) / (si.nMax - si.nMin) * si.nPage), 20.0f);

    // 实际滑动位置
    //  = （滚动条高度 - 滑块尺寸） / （有效范围 - 每页数量 + 1） * 当前行位置
    // 实际滚动的位置会比实际少一页的数量。
    //
    v = 0;
    if (si.nPos > 0)
        v = (int)((r.bottom - r.top - s) / (float)(si.nMax - si.nMin + 1 - si.nPage)  * si.nPos);
    // 由于精度问题，可能滑块位置会超界。超界就取最大值
    if (v && v + (int)s > r.bottom)
        v = r.bottom - (int)s;

    // 绘制滑块
    r.left++;
    r.right--;
    r.top = v ;
    r.bottom = r.top + (int)s;

    // 拖拽时滑块颜色反一下
    mlCGFillColor(hdc, &r, dragState ? 0x999999 : 0x666666e);
    InflateRect(&r, -1, -1);
    mlCGFillColor(hdc, &r, dragState ? 0x666666e : 0x999999);
}

四、响应鼠标消息

鼠标消息，主要是左键点击定位、拖拽和滚轮滚动翻页。

1、点击定位响应

鼠标左击滚动条位置，可以直接定位到对应行。这个功能就是第一个需求，根据标识快速定位到记录行。实际的核心就是，鼠标所在滚动条的实际位置，计算出对应的行数。

计算方法：
nPos = （鼠标位置 - 半滑块尺寸） / 每象素滑动量

  • 每象素滑动量 = 有效高度 / 可滑动数量
  • 有效高度 = 总高度 - 滑块尺寸
  • 可滑动数量 = 总量 - 每页数量

根据上述公式提取出一个通用方法，计算像素位置位置对应行数的关系函数。

// 计算滚动条位置
static int calcVertThumPos(int postion, SCROLLINFO *si, int s)
{
    float thumsize;     // 滑块的大小
    float pxSize;       // 每象素可滑动量
    int   scrollCnt;    // 可滑动数量

    // 滑块尺寸 =  滚动条高度 / 有效范围 * 每页数量
    //            最小 20
    thumsize = max((float)((s) / (si->nMax - si->nMin) * si->nPage), 20.0f);
    if (postion <= (int)(thumsize / 2))
        return 0;
    if (postion >= s - (thumsize / 2))
        return (si->nMax - si->nMin + 1) - si->nPage;

    // 计算方法：
    //  每象素滑动量 = 有效高度 / 可滑动数量
    //  有效高度     = 总高度 - 滑块尺寸
    //  可滑动数量   = 总量 - 每页数量
    scrollCnt = (si->nMax - si->nMin + 1) - si->nPage;
    pxSize = (float)(s - thumsize) / (float)scrollCnt;

    //
    // 计算方法：
    //   位置 = （鼠标位置 - 半滑块尺寸） / 每象素滑动量
    return (int)((postion - thumsize / 2.0) / pxSize);
}

鼠标左击事件响应WM_LBUTTONDOWN消息。

si.nTrackPos = calcVertThumPos(GET_Y_LPARAM(lParam), &si, height);
if (si.nPos != si.nTrackPos)
    PostMessage(GetParent(hwnd), WM_VSCROLL, SB_THUMBTRACK, (LPARAM)hwnd);

使用calcVertThumPos 函数计算出滚动位置，并通过WM_VSCROLL消息请求滚动。

注意：MSDN中 WM_VSCROLL的lParam参数约定，当自定义控件是通常传自定义控件的hWnd。用于区分系统默认的还是自定义控件的。

点击定位就搞定了。

2、拖拽滑块滚响应

拖拽滚动需要同时用到3消息WM_LBUTTONDOWN、WM_MOUSEMOVE 和WM_LBUTTONUP。当鼠标按下时准备拖拽，拖拽中滚动记录，鼠标释放结束拖拽。

正常情况鼠标按下就需要锁定鼠标SetCapture，但有时只是点击一下，并没有需要拖拽。或内部处理更多的控制时，直接锁定不太好。因此在拖拽时加了个dragState的状态，只有准备拖拽了才进行锁定鼠标操作。

另外一种情况，某些异常情况，锁定的鼠标会丢失。如断点调试一定会打断，这时候会出现不想要的情况。没在拖拽状态，鼠标已经松开了，滑块还是会跟着鼠标移动。

case WM_LBUTTONDOWN:
    ...
    dragState = 1;        // 准备拖动滚动条
    InvalidateRect(hwnd, NULL, false);
    return 0;

case WM_MOUSEMOVE:
    if (dragState == 1) {
        SetCapture(hwnd);  // 有拖拽准备，锁定鼠标鼠标
        dragState = 2;
    }
    else if (dragState == 2) {
        if (!(wParam & MK_LBUTTON)) {
            dragState = 0;              // 防止中间中断，导致出现无效拖拽
            if (GetCapture() == hwnd)
                ReleaseCapture();
        }
        else {
            // 在锁定状态下拖动滚动条定位。
            si.nTrackPos = calcVertThumPos(GET_Y_LPARAM(lParam), &si, height);
            if (si.nTrackPos != si.nPos)
                PostMessage(GetParent(hwnd), WM_VSCROLL, SB_THUMBTRACK, (LPARAM)hwnd);
        }
    }
    return 0;

case WM_LBUTTONUP:
    if (dragState == 2)
        ReleaseCapture();   // 释放鼠标锁定

    if (dragState) {
        dragState = 0;          // 清除状态
        InvalidateRect(hwnd, NULL, false);
    }
    return 0;

鼠标滚轮响应

滚动事件WM_MOUSEWHEEL，鼠标滚动翻页时会有一个精度。慢慢滚动滚轮会上移或下移3行左右，当快速滚动时，会很容易到文档末尾。这个就是一般说的精度。

这里默认处理，滚动一次滚轮移动三行。获得滚动行数量后就可以直接在当前数量nPos上累加。注意一下，不要超界。

// 鼠标滚动支持
accumDelta = GET_WHEEL_DELTA_WPARAM(wParam) / WHEEL_DELTA;  // 滚动精度120一个单位
si.nTrackPos = si.nPos - accumDelta * 3;   // 每滚一次3行
if (si.nTrackPos < 0)
    si.nTrackPos = 0;
else if (si.nTrackPos > (int)((si.nMax - si.nMin + 1) - si.nPage))
    si.nTrackPos = (si.nMax - si.nMin + 1) - si.nPage;

if (si.nPos != si.nTrackPos)
    PostMessage(GetParent(hwnd), WM_VSCROLL, SB_THUMBTRACK, (LPARAM)hwnd);

～OK 啦

简单的滚动条就完成，然后后面的标识之类的就可以在这个基础上尽情发挥。随你完全由你掌控滚动条。

最终的效果：

完整代码：

蘑菇房 moguf.com

相关消息和API：

时间： 2024-10-13 22:25:47

界面控件 - 滚动条ScrollBar的相关文章

界面控件 - 滚动条ScrollBar（对滚动条消息和鼠标消息结合讲的不错）

界面是人机交互的门户,对产品至关重要.在界面开发中只有想不到没有做不到的,有好的想法,当然要尝试着做出来.对滚动条的扩展,现在有很多类是的例子. VS2015的代码编辑是非常强大的,其中有一个功能可以把滚动态变成MinMap,可以通过Options->Text Editor->C/C++->Scroll Bars中的Behavior选项分类进行打开. sublime也有这个功能,但没有VS的好用.变成MinMap后整个代码文档变成一个完整的缩微图,在你对代码比较熟悉的情况下,可以非常容易

界面控件Essential Studio for ASP.NET正式发布2015 v3[附下载]

Essential Studio for ASP.NET界面控件包含了商业Web应用程序开发中所需的所有控件,如grids.charts.gauges.menus.calendars.editors等等.同时,Essential Studio for ASP.NET中高性能的界面控件库还允许您的应用程序浏览和创建Excel.Word和PDF格式的文件. 免费下载:Essential Studio for ASP.NET 2015 v3 此次Essential Studio v3更新为Syncfu

基于MVC4+EasyUI的Web开发框架形成之旅--界面控件的使用

在前面介绍了两篇关于我的基于MVC4+EasyUI技术的Web开发框架的随笔,本篇继续介绍其中界面部分的一些使用知识,包括控件的赋值.取值.清空,以及相关的使用. 我们知道,一般Web界面包括的界面控件有:单行文本框.多行文本框.密码文本框.下拉列表Combobox.日期输入控件.数值输入控件.单项选择.复选框.表格控件DataGrid.树形控件.布局控件.弹出式对话框.提示信息.列表控件等,这些界面控件的操作都有哪些不同,下面我们来逐一进行介绍. <input class="easyui

WinForms界面控件初探：布局灵活、让你灵感一现的Tile Control

超乎你想象!WinForms Grid Control处理100万行数据到底有多快? WinForms界面控件初探:处理速度飞快的WinForms Data Grid(1) WinForms界面控件初探:处理速度飞快的WinForms Data Grid(2) WinForms界面控件初探:支持读写XLSx, XLS, CSV 和 TXT文件的Spreadsheet Control WinForms界面控件初探:强大的嵌入式多功能Data Editors WinForms界面控件初探:功能强大且

Android 遍历界面控件

//遍历界面上的控件 fubin.pan LinearLayout sLinerLayout = (LinearLayout)findViewById(R.id.layout_scr); for (int i = 0; i < sLinerLayout.getChildCount(); i++) { View v=sLinerLayout.getChildAt(i); if ( v instanceof RadioGroup){ RadioGroup mRadioGroup = (RadioGr

日积（Running）月累（ZSSURE）：WCF学习之“通过事件绑定控制WinForm宿主程序主界面控件”

背景: WCF服务需要寄宿到相应的可运行进程中执行,常见的有四种寄宿,分别是控制台程序.WinForm程序.IIS和Windows服务.之前学习老A博客和<WCF全面解析>时最常用到的是控制台寄宿,近期由于项目需求,需要在WinForm程序中调用WCF服务,本博文通过一个简单的实例来演示WCF在WinForm中的寄宿.并着重介绍如何利用事件绑定控制宿主主UI界面控件. 题记: 之前一直坚守在C++阵地,对于新语言.新技术(诸如Python.J2EE.Bigdata.AI)不甚感冒.自以为&qu

[Android]界面控件

1. 引用系统自带样式 字体大小 对于能够显示文字的控件(如TextView EditText RadioButton Button CheckBox Chronometer等等),你有时需要控制字体的大小.Android平台定义了三种字体大小. "?android:attr/textAppearanceLarge" "?android:attr/textAppearanceMedium" "?android:attr/textAppearanceSmal

Winform中子线程访问界面控件时被阻塞解决方案

public partial class WebData_Import : Form { //声明用于访问主界面的委托类型 public delegate void deleGetOrderdata(string info); //声明访问主界面委托类型的变量 public deleGetOrderdata OptGetOrderData; int CompanyID = 0; public WebData_Import() { InitializeComponent(); cmbCompany

WinForms界面控件初探：互动、精准、强大的Map Control

今天给大家介绍WINFORMS界面控件中的Map Control ,其强大的搜索,精准的定位,和诸多实用性功能,都十分值得一试.下面就带大家看看它有哪些特性吧. 多个地图供应商 可选择任何现有的地图数据提供商,并嵌入到你的地图控件中,从网上或者内部服务器获取映射图像. 搜索和获取方向 简单易用的搜索面板,也可使用Bing Maps的地理编码.海拔和路由服务. 通知与导航 为用户提供所需的地图:提供你位置的简短概述:可平移和缩放地图 POI集群 数据可视化变得简介清晰,整合的数据将在附近以一个聚合