HScrollBar浅析

HScrollBar是水平滚动轴,与VscrollBar类似,在不内置支持翻页滚动的窗口中,经常有使用的需求。然而,要合理的控制使用 HScrollBar并不是一件很容易的事情。HScroollBar有两个事件hScrollBar1_Scroll和 hScrollBar1_ValueChanged,有一句笼统的概括这两个事件的使用时机:在移动过程中的处理放在_Scroll事件,在移动后处理放在_ValueChanged事件。这句话太笼统了,而且不是很准确,往往不能满足实际的使用需要。

1.      hScrollBar1_ValueChanged(objectsender, EventArgs e)事件

当hScrollBar1.Value值改变时触发此事件,有两种途径:a>点击、拖动滚动条触发hScrollBar1_Scroll事件,从而引起hScrollBar1.Value值改变;b>直接设置hScrollBar1.Value值,如 hScrollBar1.Value = 27。

2.      hScrollBar1_Scroll(objectsender, ScrollEventArgs e)事件

当点击左右箭头、左右翻页、拖动滚动条时,会触发hScrollBar1_Scroll事件。这里的形参e有几个属性需要注意。

a> e.ScrollOrientation     获取Scroll滚动方向;

b> e.OldValue                 获取旧的hScrollBar1.Value值;

c> e.NewValue               获取或设置新的hScrollBar1.Value值;

d> e.Type                      获取发生的滚动事件类型。

    public enum ScrollEventType           //e.Type类型

    {

       SmallDecrement = 0,                //上换行,Value变化了SmallChange量

        SmallIncrement = 1,                 //下换行,Value变化了SmallChange量

        LargeDecrement = 2,                //上翻页,Value变化了LargeChange量

        LargeIncrement = 3,                 //下翻页,Value变化了LargeChange量

        ThumbPosition = 4,                 //滚动框停止拖动

        ThumbTrack = 5,                     //滚动框当前正移动

        First = 6,                                  //滚动框被移动至Minimum位置—本人未发现

        Last = 7,                                   //滚动框被移动至Maximum位置—本人未发现

        EndScroll = 8,                           //滚动停止

}

3.      基本属性

Value                             //获取或设置当前位置

LargeChange                  //获取或设置最大移动量--一页

SmallChange                  //获取或设置最小移动量--一行

Maximum                      //获取或设置最大值

Minimum                       //获取或设置最小值

a>    假设移动范围是100,如果Minimum=0,那么Maximum应该是99,而不是100;

b>    颜色值选择实例

      this.hScrollBar1.SmallChange = 1;

            this.hScrollBar1.LargeChange = 16;

            this.hScrollBar1.Minimum = 0;

            this.hScrollBar1.Maximum = 255 +this.hScrollBar1.LargeChange - 1;

                   假设换行跨度为1,翻页跨度为16,最小值为0,那么颜色值范围(0~255)的最大值怎么设置?注意,是255加上一页的范围再减1。因为Value的位置是页的左边,而最大值在页的右边。

4.      综合实例

a>    点击某按钮,改变Value值,触发的事件及顺序

    private void btnChange_Click(object sender, EventArgse)

        {

            this.hScrollBar1.Value = 27;

        }

                   只触发一个事件:

                   ValueChanged Event--Value = 27

b>    点击右键右换行,触发的事件及顺序

触发了三个事件,先SmallIncrement Event,此时Value值未改变;接着ValueChanged Event,Value发生了改变;最后EndScroll Even。

SmallIncrement Event--Value = 0

ValueChanged Event--Value = 1

EndScroll Event--Value = 1

c>    拖动滚动框,触发的事件及顺序

如下所示,拖动过程中,不断触发ThumbTrack Event事件,每当Value值改变时,触发ValueChanged Event事件,如快速拖动每次值可能会大于SmallChange(这里是1),拖动停止时触发ThumbPosition Event事件,最后触发EndScroll Event事件。

ThumbTrack Event--Value = 1

ThumbTrack Event--Value = 1

ValueChanged Event--Value = 4

ThumbTrack Event--Value = 4

ValueChanged Event--Value = 7

ThumbTrack Event--Value = 7

ValueChanged Event--Value = 11

ThumbTrack Event--Value = 11

ValueChanged Event--Value = 15

ThumbTrack Event--Value = 15

ValueChanged Event--Value = 20

ThumbTrack Event--Value = 20

ValueChanged Event--Value = 23

ThumbTrack Event--Value = 23

ValueChanged Event--Value = 26

ThumbTrack Event--Value = 26

ValueChanged Event--Value = 29

ThumbTrack Event--Value = 29

ValueChanged Event--Value = 30

ThumbTrack Event--Value = 30

ValueChanged Event--Value = 31

ThumbPosition Event--Value = 31

EndScroll Event--Value = 31

d>    右翻页,触发事件及顺序

如下所示,与下换行一样,触发了三个事件,先LargeIncrementEvent,此时Value值未改变,OldValue也未变,NewValue已经改变了;接着ValueChanged Event,Value发生了改变;最后EndScroll Even时,进入Scoll函数Value和OldValue已经边改了。

Enter Scroll--Value = 3, OldValue = 3,NewValue = 13

LargeIncrement Event--Value = 3,OldValue = 3, NewValue = 13

Leave Scroll--Value = 3, OldValue = 3,NewValue = 13

ValueChanged Event--Value = 13

Enter Scroll--Value = 13, OldValue = 13,NewValue = 13

EndScroll Event--Value = 13, OldValue =13, NewValue = 13

Leave Scroll--Value = 13, OldValue = 13,NewValue = 13

5.      总结

a>    如果响应代码放在hScrollBar1_ValueChanged中,有时就不能随意设置Value值,否则会触发多余的hScrollBar1_ValueChanged事件;如果不需要动态直接修改Value值,下面是一个好的选择。

   private int _OldValue = 0;

       private void btnChange_Click(object sender, EventArgs e)

       {

           MyFunScrollLines(this.hScrollBar1.Value - _OldValue);

            _OldValue = this.hScrollBar1.Value;

       }

b>    响应代码最好不要笼统的放在hScrollBar1_Scroll中,应该区分ScrollEventType类型,否则会触发两次hScrollBar1_Scroll事件。下面也是一种很好的换行翻页。

private void hScrollBar_Scroll(object sender, ScrollEventArgs e)

{

     if (e.NewValue != e.OldValue)

     {

          this.curveChart1.ScrollLine(e.NewValue- e.OldValue);

      }

    //switch (e.Type)

//{

//   case ScrollEventType.LargeIncrement:

//       Console.WriteLine("LargeIncrement Event--Value = {0}",hScrollBar1.Value);

//       break;

//   case ScrollEventType.LargeDecrement:

//       Console.WriteLine("LargeDecrement Event--Value = {0}", hScrollBar1.Value);

//       break;

//   case ScrollEventType.SmallIncrement:

//       Console.WriteLine("SmallIncrement Event--Value = {0}",hScrollBar1.Value);

//       break;

//   ......        

//}

}

c>    Value最大值 = Maximum – LargeChange + 1。

posted on 2011-08-06 09:00  fyhui  阅读(6018)  评论(0编辑  收藏  举报