DevExpress：可左右滑動的圖片框ImageSlider

本文爲個人.NET控件庫DevExpress使用筆記，個人DevExpress版本爲13.1

一、控件類型全稱：DevExpress.XtraEditors.Controls.ImageSlider

二、控件所在程序集：DevExpress.XtraEditors.v13.1.dll

三、工具箱內分類：DX.13.1: Common Controls

四、控件樣式截圖

五、ImageSlider是一個能夠左右拖動的圖片框。相似與電子相冊的功能，當鼠標停在這個控件上時，控件左右兩側會出現兩個按鈕：向左和向右，這兩個按鈕的功能即展現上一張或下一張圖片。該控件下的SlidePrev和SlideNext函數，也能夠用於實現這一功能

六、將控件的AllowLooping屬性設置爲True後，能夠將圖片框設置爲循環展現，即最後一張圖片的下一張圖片是第一張圖片，第一張圖片的上一張圖片是最後一張

七、控件的LayoutMode屬性用於設定圖片在圖片框中的停靠方式。該方式取自枚舉DevExpress.Utils.Drawing.ImageLayoutMode，取值範圍以下：

• TopLeft、TopCenter、TopRight、MiddleLeft、MiddleCenter、MiddleRight、BottomLeft、BottomCenter、BottomRight，功能爲將圖片停靠在八個方向上

• Stretch，拉伸到撐滿全圖片

• ZoomInside，圖片等比例放大，當有兩邊剛好撐滿容器時，中止放大

• ZoomOutside，圖片等比例放大，當有兩邊剛好撐滿容器時繼續放大，另外兩邊剛好撐滿容器時中止放大

• StretchHorizontal、StretchVertical，橫向拉伸、縱向拉伸

• Default，默認配置，即顯示在左上角

八、AnimationTime屬性指定了連續完成屢次圖片時單張圖片停留的最短間隔時間，單位爲毫秒。ScrollButtonFadeAnimationTime屬性指定了圖片切換花費的時間，單位也爲毫秒

九、在屬性中的Images中，能夠進入界面「ImageInfo集合編輯器」添加和修改圖片框中的圖片信息

在「添加」按鈕中，有三個選項：

• Load From Disk：從磁盤中讀取圖片

• Load From Project Resources：從項目資源中讀取圖片

• Load From DevExpress Gallery：從「DevExpress Gallery」中讀取DevExpress默認圖片
  

從磁盤中讀取的圖片，讀取到的圖片會被放置在Form本身的Resource中，參考窗體Designer.cs中的代碼，從磁盤中讀取的文件是這樣添加的：

this.imageSlider1.Images.Add(
    ((System.Drawing.Image)(resources.GetObject("imageSlider1.Images"))));
this.imageSlider1.Images.Add(
    ((System.Drawing.Image)(resources.GetObject("imageSlider1.Images1"))));
this.imageSlider1.Images.Add(
    ((System.Drawing.Image)(resources.GetObject("imageSlider1.Images2"))));

三張圖片被存放到Form的resx資源文件下，被DevExpress自動命名成了imageSlider1.Images、imageSlider1.Images一、imageSlider1.Images2

（這三張圖片分別是Pokemon中的三個神獸：帝牙盧卡、帕路奇犽、騎拉帝納）

END