[C#] (原創)一步一步教你自定義控件——02,ScrollBar(滾動條)


一、前言

技術沒有先進與落后,只有合適與不合適。

本篇的自定義控件是:滾動條(ScollBar)。

我們可以在網上看到很多自定義的滾動條控件,它們大都是使用UserControl去做,即至少使用一個Panel或其它控件作滑塊,使用UserControl本身或另一個控件作為背景條,而有的復雜的還會加上頂端和底端的按鈕。這樣作的好處有很多,最主要的是支持承載更加復雜的視覺和動作效果,比如使用一系列圖片來實現非常炫麗的動畫效果等。

不過本次所實現的滾動條並不需要太多復雜的效果,扁平化樣式即可,所以就不需要使用UserControl,所以直接參照上一篇的LTrackBar,實現一個類似樣式的滾動條,這也是在上一篇之后緊接本篇的原因之一。

就像實現上篇的LTrackBar時的圓角的坐標計算是個難點,然后着重結合示意圖去講解一樣,在本篇,關於滾動條中比較反直覺的、不太好直觀想像的,我仍會結合示意圖去詳細講解。

相信看完的你,一定會有所收獲。

本文地址:https://www.cnblogs.com/lesliexin/p/13440927.html

 


 

二、前期分析

(一)為什么需要自定義滾動條?

滾動條(ScrollBar)控件是一個常常被忽略,但是應用卻極其頻繁的控件。由於很多控件都自帶滾動條,所以往往令人忽略滾動條的存在。

但是這些控件自帶的滾動條有個非常大的缺點,那就是幾乎不可以單獨對滾動條進行重繪,甚至連調整控件自帶滾動條的寬度這種”看起來很簡單“的操作,真正實現起來的工作量簡直令人”懷疑人生“。

而且,系統的滾動條控件:VScrollBar和HScrollBar,其樣式仍是最基本的那樣,其可重繪性非常小。

 

系統控件自帶的滾動條,在一般的WinForm程序中,看着還挺不錯的,但是一旦你的WinForm程序中使用了大比例的自定義控件后,系統的滾動條就有點”刺眼“了。所以,便需要自己的滾動條控件。

(二)實現目標

1,外觀

參考上一篇的 LTrackBar控件,我想實現的滾動條的外觀樣式如下:

2,功能

(1)支持鼠標拖動。

(2)支持點擊非”滑塊“區,改變滑塊位置。

(3)支持鼠標進入時改變滑塊顏色。

(4)支持修改各部分顏色。

3,特點

(1)支持改變滾動條方向:垂直或橫向。

(2)支持改變顏色。

(3)支持圓角、直角顯示。

 

(三)技術分析

滾動條控件LScrollBar與LTrackBar類似,同樣是分為背景條(Bar)和滑塊(Slider)。所使用的核心技術仍是GDI+。

(四)滾動條講解

在這里,我會對滾動條進行詳細的講解,包括滾動條的效果、比例的計算等。

在本節的講解中,我將以”直角“、”垂直“樣式的滾動條進行講解說明。

1,滾動條的工作方式。

如下圖所示,我們將”滾動條“和”顯示內容“拆分成兩部分。


其中,半透明的黑色部分是”屏幕“,也就是我們實際可以看到的范圍。而“文檔”的實際長度要遠遠超過屏幕可顯示部分,所以就需要通過“滾動條”來上下“滾動”來看文檔的其他部分。

那么,在直觀的想像中,”滾動“應該如下面的動圖演示那樣:

但是實現情況卻不是如此,因為現在中”屏幕“是不會動的,那么”滾動“的只能是”文檔“,所以真實的”滾動“應該像下面這樣:

 

也就是說,我們在將滾動條的滑塊”向下“拖動時,”文檔“實際是”向上“拖動的。

在具體使用程序實現時,也就是改變”文檔“的”Y“坐標值。

2,比值計算。

在知道了滾動條的內部原理后,就需要一些比值的計算了,比如滾動條“滑塊”的長度、“滑塊”的拖動距離與“文檔”位置改變的距離的比值等。

首先,如下圖所未,我加上了一些標識,以方便描述。

 

其中:

(1)

文檔的長度=A。

屏幕的長度=可見文檔部分的長度=B。

那么,不可見的文檔長度=A-B=C。

(2)

滾動條的長度=D。

滑塊的長度=E。

滑塊可拖動的范圍=D-E=F。

(3)

在實現的時候,我們已經的量有:A(文檔長度)、B(屏幕長度)、D(滾動條長度),而E(滑塊長度)是不知道的,是計算出來的。

在日常使用過程中我們也會發現,如果要顯示的內容越多,滑塊的長度越短。

其中的比例關系如下:

B/A=E/D

可得:E=D*B/A。

此時我們已經得到了滑塊的長度,這是一個非常重要的基本量。

得到E(滑塊長度)后,F(滑塊可移動范圍)也可以得到:

F=D-E。

(4)

因為“屏幕”已經顯示了一部分的“文檔”,所以真正需要通過滾動條去查看的“文檔”部分是C(不可見文檔長度):

C=A-B。

由此,我們可以得到一個重要的比值關系:

n*F(滑塊拖動范圍)=m*C(不可見文檔長度)

(注:加上n、m是因為F與C並不是1:1的關系)

n/m=C/F

這個比值我們使用X代替,即:

X=C/F=(A-B)/(D-E)。

(5)

為什么要計算這個比值,因為我們在使用滾動條時,並不是去考慮鼠標是向下拖動還是向上拖動,以及拖動了多少距離。而是只需要知道滾動條的“滑塊”的位置,更准確的說是“滑塊”頂端距滾動條頂端的距離,如下圖所示,我們所需要知道的只是下圖中F(注意:此F不是上面中的F)的值而已。

通過F的值,我們計算出B的值,然后再使“文檔”向上移動B的距離,這就是滾動條的使用方法。

那么,怎么通過F來得到B就非常重要了,這就需要一個比值,通過這個比值將F轉換為B,這個比值就是上面的X。

通過X,我們可以得到以下信息:

a,拖動滾動條時,文檔應該“上移”的距離B:

B=F*X。

b,文檔位置改變后,滾動條所處的位置F:

F=B/X。


三、開始實現

(一)前期准備。

由於本篇實現的滾動條控件(LScrollBar)是參考前篇的LTrackBar來實現的,所以此處僅作提綱用,具體操作見前篇。

新建類:LScrollBar.cs

添加繼承:Control(需要添加引用:System.Windows.Forms.dll)

修改可訪問性為:public

(二)添加控件屬性

由於本控件和前篇的LTrackBar有極大的相似性,所以一些屬性也可以直接拿來使用。這也是“復用”的一種。

1,滾動條背景顏色

 

2,滑塊顏色

 

3,鼠標進入滾動條后滑塊顏色

這是一種提示顏色,像一些軟件、網頁的滾動條在平時是一種顏色,在鼠標處於滾動條上方時又是一種顏色,本屬性就是實現的這種效果。

 

4,滾動條是圓角還是直角

 

5,滾動條方向

此處和LTrackBar不一樣,對於滾動條(LScrollBar)而言,只有兩種方向:水平、垂直。所以我們需要新建一個方向枚舉,為了避免與LTrackBar方向枚舉沖突,我們將枚舉命名為:OrientationScrollBar

在改變滾動條的方向時,下面的代碼會自動交換滾動條的寬和高。

6,滾動條尺寸

這里的尺寸是指滾動條(LScrollBar)的寬度(在垂直方向時)或高度(在水平方向時)。

為了支持此屬性,還需要設置控件使之只能修改高度(在垂直方向時)或寬度(在水平方向時),就需要重寫SetBoundsCore。

在重寫了SetBoundsCore后,在設計器界面我們便只能調整控件的寬或高。

7,“文檔”長度

這里使用“文檔”這個說法是源自MFC,本處仍沿用其說法。其指的是所要顯示的總長度。

這里用“長度”是方便說明,不然就要在垂直狀態時說“高度”,水平狀態時說“寬度”,太過繁瑣。

 

在設置了“文檔”長度時,我們調用了兩個方法:pInit()和pChangeSliderLocation()。

其中pInit()的作用是初始化各個比例、計算滑塊長等。pChangeSliderLocation()的作用是改變滑塊的位置。其代碼如下:

8,“頁面”長度

指示窗口可顯示的長度。

 

9,滑塊位置

這里滑塊的位置指的時滑塊的頂端相對於滾動條頂端的距離。

這里我將其設置為公共只讀,是因為這個屬性更多的是用來查看,如果直接修改還需要計算比例什么的,而為了計算比例,就需要額外提供一些額外的值以支持其計算,很麻煩,所以就不讓用戶去直接修改。如果想修改滑塊的位置,則使用下面的“顯示位置”屬性去設置。

 

10,顯示位置(正數)

這里的顯示位置就是“文檔”頂端與顯示窗口的距離。

以垂直狀態為例,就是其Y坐標,因為默認情況下,系統的坐標方向是向右為正、向下為正。而其原點就是顯示窗口的左上角,所以“文檔”的Y坐標值便是個負數,為了方便計算和處理,我們將以正數的方式進行處理。

在用戶設置了此屬性時,我們會自動進行相應的計算,並改變滑塊的位置(即上面的“滑塊位置”屬性的值),這樣對用戶而言,只需要知道“文檔”的位置就行了,這樣當其設置了文檔的位置后,滑塊的位置會自動改變。

11,滑塊可移動距離

本屬性是公共只讀,以備某些情況下使用。

 

12,滑塊長度

本屬性是公共只讀,以備某些情況下使用。

 

13,滑塊最小長度

平常狀態下,滾動條是支持鼠標按在滑塊上拖動的,所以滑塊的長度就不能太短。當然如果使用滾動條時僅是作為顯示用,而不需要操作,則可以將滑塊的最小長度設置為0。

 

14,滾動間隔距離

本屬性是為了在使用鼠標滾輪上下滾動時,和按上下左右鍵時,滑塊每次移動的距離。

這個距離是“文檔”角度下的距離,不是滑塊真實移動的距離,這樣設置的原因是方便使用者按需要設置,比如其想實現一個ListBox,每次按鍵都是一行的高度,此時就可以將本屬性設置為那一行的高度值。

 

(三)添加事件

對於本滾動條(LScrollBar)而言,只需要一個事件,那就是滑塊發生了滾動時的事件。

當然,估計很多人在初次實現時,會想到有很多事件,像點擊了滑塊事件、點擊了滑塊上面空白部分事件、拖動事件等等。但是我們要記得之前所說的滾動條的工作方式:只需要知道滑塊的位置即可。前面事件的結果都是滑塊的位置發生了改變,所以可以歸到一個事件里面。

 

(四)重寫方法

1,OnPaint

OnPaint是實現效果的根本,不過本次的實現內容比LtrackBar要簡單很多,總的來說就是先畫一個背景條,再畫一個滑塊。

 

2,OnMouseEnter

因為我們要實現鼠標處於滾動條上方時滑塊變色,所以我們要將滑塊的顏色設置為屬性:“鼠標進入滾動條后滑塊顏色”的值,並使控件發生重繪。

 

3,OnMouseLeave

同上,我們在鼠標離開滾動條后,將滑塊的顏色設置為屬性:“滑塊顏色”的值。

 

4,OnMouseUp

 

5,OnMouseDown

在這里,我們需要確定下鼠標點擊處的位置:點在了滑塊上、點在了滑塊上方、點在了滑塊下方。

根據日常使用經驗,在點擊非滑塊上時,是有相應的效果的,一般而方點擊滑塊上方空白處則代表“上一頁”,就是減去屬性“頁面長度”的值。同理,點擊滑塊下方的空白處則代表“下一頁”,就是加上屬性“頁面長度”的值。

 

6,OnMouseMove

這里實現的是當鼠標點在了滑塊上時,按住鼠標拖動。

在上面的OnMouseDown中,我們額外計算了兩個值:fAbove、fBelow,其作用便是為了在此時計算滑塊的位置。

具體如下圖演示:

7,OnMouseWheel

我們想實現滾動鼠標滾輪鍵(中鍵)時滑塊跟着上下滾動,便需要重寫本方法。

其中需要用到事件的一個屬性:Delta,其MSDN的說明如下:

 

在滾輪向下滾動時,Delta的值為負數;滾輪向上滾動時,Delta的值為正數。

根據上面MSDN的解釋,我們只需要知道滾輪是向上滾動還是向下滾動就行了。根據滾輪是向上滾動還是向下滾動,將顯示位置的值加上或減去屬性:“滾動間隔距離”的值。

 

8,ProcessDialogKey

本方法中,主要是為了實現按鼠標箭頭鍵時執行相當的操作。

在滾動條是垂直狀態時,按上箭頭鍵,滑塊向上滾動;按下箭頭鍵,滑塊向下滾動。

在滾動條是水平狀態時,按左箭頭鍵,滑塊向左滾動;按右箭頭鍵,滑塊向右滾動。

在按鍵時,是將顯示位置的值加上或減去屬性“滾動間隔距離”的值。

 

(五)添加雙緩沖

為了避免拖動滑塊時、改變滾動條尺寸時滾動條閃爍,故在其構造函數中加上對雙緩沖的支持。

 

(六)添加默認事件

為了達到雙擊控件就自動實現僅有的一個事件:L_Scrolled,所以在類的最上方加上默認事件支持。

(七)其它說明

1,在”屬性“窗口中隱藏某屬性

在前面的屬性中,有不少屬性我除了加了Category和Description——這兩個的含意我在LTrackBar那篇講過,分別是分類和描述,還有一個“Browsable(false)”,如下圖所示,其作用是不在設計界面的“屬性”窗口中顯示。

在一些不可設置的屬性或者不想讓用戶直接通過屬性窗口設置的屬性,可以添加Browsable(false)以達到此目的。

當然,在代碼界面,還是可以看到該屬性提示的。

 2,寫代碼時方法、屬性顯示提示

如下圖那樣當鼠標放上去時彈出相應的中文提示,寫代碼時的智能提示中顯示中文提示。

要想實現該效果,首先要在屬性或方法上輸入”///“,此時VS會自動補全,之后便可以添加想要的提示了。像上面的屬性都是這樣寫的。

不過只這樣寫的話在同一個解決方案中是可以顯示中文提示的,如果單獨引用生成的dll就沒有提示了,這時需要生成對應的xml幫助文檔,這樣在引用該dll時,VS會自動加載對應的xml文件,也就會有對應的提示了。

生成xml方法:選擇控件類庫屬性,在”生成“標簽頁中,勾選“XML文件文件”,VS會自動填入生成路徑,如果想生成到其他地方可以自行修改。

不過在單獨引用dll時要保證dll和xml文件在同一目錄下。


 

四、效果演示

 在本節中,我們不止要演示滾動條LScrollBar的各種效果、特點,最主要的是演示一下怎么如何使用LScrollBar。

我們會在一個panel中添加50個按鈕,然后通過操作滾動條還使這些按鈕上下移動。

首先,我們新建一WinForm程序,在上面添加如下幾個控件,其控件名如下:

接着,我們雙擊“加載列表”按鈕,在其方法中寫入以下代碼。代碼功能是往panel1中添加50個按鈕。

最后,我們雙擊滾動條lScrollBar1,在其方法中寫入以下代碼。代碼功能一是顯示當前滑塊的位置,以及當前所有按鈕距初始位置的距離;二是改變所有按鈕的位置,以實現滾動效果。

之后編譯並運行程序,其運行效果如下:


 

五、調整優化

 LScrollBar實現到當前這種程度,對我目前而言,以及對大多數需要使用自定義滾動條的地方而言都是足夠了的。但是,並不是沒有缺點或可優化的地方。

其中最主要的一點,就是無法直接代替系統控件自帶的滾動條,比如替換ListBox自帶的滾動條,替換TextBox自帶的滾動條等等。

之所以無法替換,是因為對ListBox、TextBox等自帶滾動條的控件而言,其控制滾動條的滾動和處理滾動條的滾動是通過Windows消息去處理的,而LScrollBar並沒有攔截和處理這些滾動條消息。

如果想使用LScrollBar替換ListBox、TextBox等控件自帶的滾動條,可以參考下面的思路:

首先要在LScrollBar中增加對滾動條消息的處理,包括攔截和發送。

然后,可以直接將LScrollBar的寬度調成和ListBox、TextBox自帶滾動條同樣的寬度,然后覆蓋上;

或者將ListBox、TextBox自帶滾動條隱藏掉,在旁邊放上LScrollBar。

通過上面的方法,應該就可以達到”自定義ListBox、TextBox控件的滾動條“的效果了。

注:鑒於篇幅及個人需要和使用場景,我並沒去實現上面的替換ListBox、TextBox滾動條的效果,只是從邏輯層面上驗證可以達到預期效果。

后續如果有需要,我會考慮寫一篇文章去實現一下這種效果。

 


 

六、結束語

通篇下來,會發現技術層面上算不上太難,難點在於突破常規的思維束縛。

可以看到,WinForm並非不能實現炫麗、更加現代化的效果,不過需要一些想像力支撐、並多付出一些的努力罷了。同樣的,像WPF、像Electron等WebUI,雖然本身就更加現代化,但是想到達到一定的炫麗效果、比較人性化界面,也是需要花費不小的精力的。並不是說使用了新的語言、框架就可以很輕松的、或者自動的實現想要的效果。

技術並沒有先進和落后,只有合適與不合適,因為各有優點與缺點、各有擅長與不擅長。

所以,對自己掌握的知識多抱有一些信心,釋放自己的想像力,在實踐中提升自己。


 

七、源代碼及工程下載

 https://files.cnblogs.com/files/lesliexin/02,LScrollBar.7z

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM