制作类似VS2008起始页中的列表框

一.引子

    在VS2008的起始页中，有一种控件类似我们常用的列表框，可以显示图片，有超链接功能，有的还有按钮，可以创建或打开项目。它的效果比较好看，在一些场合还是有比较多的使用机会。我利用这2天的闲暇时间也仿照它做了个类似的控件。

    该控件可以设计时添加子项，可以提供类似超链接的点击效果，显示不下时支持滚动条的滚动（支持鼠标滑轮滚动），在选中子项后，支持突出显示选中项边框。提供ItemClick,ItemDoubleClick,ItemChanged事件。

二.结构图

 

 

三.设计时效果

 

 

 

四.运行时效果

 

 

五.部分源代码

 

1.  public partial class JcsTextList : UserControl
2.     {
3.         public delegate void ItemChangedEventHandler(Object sender, EventArgs e);
4.         public event ItemChangedEventHandler ItemChanged;
5.         public event EventHandler ItemClick;
6.         public event EventHandler ItemDoubleClick;
8.         private VScrollBar vScrollBar1; //滚动条
9.         
10.         private Int32 _itemSpace = 6;//item间隔
11.         private const Int32 _itemleft = 6;//文字左侧间隔
13.         private TextListItem _mouseHoverItem = null; //鼠标移动到上面的ITEM
14.         private TextListItem _selectedItem = null;//选择的ITEM
15.         private TextListItemCollection _categories = new TextListItemCollection();//元素集合
16.         private Color _borderColor = Color.Gray;//边框的颜色
17.      
18.         private Color _itemBackColor = Color.White;//item的背景色
19.         private Color _itemForeColor = Color.Black;//item的前景色
20.         private Color _itemSelectedColor = Color.LightSkyBlue ;//选定项的颜色
21.         private Color _itemMoveOverColor = Color.LightBlue;//移动到item其上的颜色
23.         private ImageList _imagelist;
25.         private bool _isLink = true;
27.         private ControlBorderStyle _borderstyle = ControlBorderStyle.None;
28.     
29.         /// <summary>
30.         /// 控件边框类型
31.         /// </summary>
32.         public enum ControlBorderStyle
33.         {
34.             SingleLine,
35.             Border3D,
36.             None
37.         }
38.         
39.         public JcsTextList()
40.         {
41.             InitializeComponent();
42.             
43.             this.BorderStyle = BorderStyle.None;
44.             this.MinimumSize = new Size(40, 30);
45.             vScrollBar1 = new VScrollBar();
46.             vScrollBar1.Dock = DockStyle.Right;
47.             this.Controls.Add(vScrollBar1);
48.             this.vScrollBar1.Scroll +=new ScrollEventHandler(vScrollBar1_Scroll);
49.             this.vScrollBar1.MouseEnter += new EventHandler(vScrollBar1_MouseEnter);
50.             SetStyle(ControlStyles.AllPaintingInWmPaint, true);
51.             SetStyle(ControlStyles.DoubleBuffer, true);
52.             SetStyle(ControlStyles.UserPaint, true);
53.             SetStyle(ControlStyles.ResizeRedraw, true);
55.             RefreshScrollBar();
57.             this._categories.ItemChanged += new CollectionChangeEventHandler(OnCategoryCollectionChanged);
58.             this.ItemChanged += new ItemChangedEventHandler(OnItemChanged);
59.         }
61.         void vScrollBar1_MouseEnter(object sender, EventArgs e)
62.         {
63.             if (_isLink)
64.             {
65.                 this.Cursor = Cursors.Default;
66.             }
67.         }
70.         #region"属性"
72.         [Category("Jcs属性"), Description("分组项的图标集合对象")]
73.         public ImageList ImageList
74.         {
75.             get { return this._imagelist; }
76.             set { this._imagelist = value; }
77.         }
79.         [DesignerSerializationVisibility(DesignerSerializationVisibility.Content),
80.         Category("Jcs属性"),Description("分组项的集合")]
81.         public TextListItemCollection Categories
82.         {
83.             get
84.             {
85.                 return _categories;
86.             }
87.             set
88.             {
89.                 _categories = value;
90.             }
91.         }
92.         //代码生成器不生成对象的代码
93.         [Browsable(false)]
94.         [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
95.         public TextListItem SelectedItem
96.         {
97.             get
98.             {
99.                 return _selectedItem;
100.             }
101.         }
102.         
103.         [Browsable(true),Category("Jcs属性"),Description("边框颜色")]
104.         public Color BorderColor
105.         {
106.             get
107.             {
108.                 return _borderColor;
109.             }
110.             set
111.             {
112.                 if (_borderColor == value) return;
113.                 _borderColor = value;
114.                 Invalidate();
115.             }
116.         }
118.         [Browsable(true), Category("Jcs属性"), Description("移动到Item上时显示的颜色")]
119.         public Color ItemMoveOverColor
120.         {
121.             get { return _itemMoveOverColor; }
122.             set
123.             {
124.                 _itemMoveOverColor = value;
125.                 this.Invalidate();
126.             }
127.         }
129.         [Browsable(true), Category("Jcs属性"), Description("Item的前景色")]
130.         public Color ItemForeColor
131.         {
132.             get { return _itemForeColor; }
133.             set 
134.             {
135.                 _itemForeColor = value;
136.                 Invalidate();
137.             }
138.         }
140.         [Browsable(true), Category("Jcs属性"), Description("Item的背景色")]
141.         public Color ItemBackColor
142.         {
143.             get { return _itemBackColor; }
144.             set
145.             {
146.                 _itemBackColor = value;
147.                 Invalidate();
148.             }
149.         }
152.         [Browsable(false )]
153.         public VScrollBar scrollbar
154.         {
155.             get { return this.vScrollBar1; }
156.         }
158.         [Browsable(true), Category("Jcs属性"), Description("边框显示类型")]
159.         public ControlBorderStyle ToolBoxBorderStyle
160.         {
161.             get { return this._borderstyle; }
162.             set 
163.             { 
164.                 this._borderstyle = value ;
165.                 this.Invalidate();
166.             }
167.         }
169.         [Browsable(true), Category("Jcs属性"), Description("是否子项使用连接模式。")]
170.         public bool IsUseLink
171.         {
172.             get { return this._isLink; }
173.             set
174.             {
175.                 this._isLink = value;
176.                 this.Invalidate();
177.             }
178.         }
179.         #endregion
181.         #region"重写"
183.         protected override void OnPaint(PaintEventArgs e)
184.         {
185.             base.OnPaint(e);
186.             Graphics g = e.Graphics;
187.             Rectangle visibleRectangle = GetVisibleRect();
188.             
189.             //绘制边框
190.             switch (this._borderstyle )
191.             {
192.                 case ControlBorderStyle.SingleLine :
193.                     using (Pen p = new Pen(this._borderColor))
194.                     {
195.                         g.DrawRectangle(p, new Rectangle(0, 0, this.Width - 1, this.Height - 1));
196.                     }
197.                     break;
198.                 case ControlBorderStyle.Border3D :
199.                     ControlPaint.DrawBorder3D(g,new Rectangle(0,0,this.Width - 1 ,this.Height -1), Border3DStyle.RaisedOuter);
200.                     break;
201.                 case ControlBorderStyle.None :
202.                     break;
203.             }
204.             
205.             //起始位置
206.             Int32 top = _itemSpace;
208.             if (vScrollBar1.Visible)
209.             {
210.                 top -= vScrollBar1.Value;
211.             }
213.             Int32 left = 0;
215.             foreach (TextListItem item in _categories)
216.             {
217.                 string s = item.Caption;
218.                 Font f = item.StringFont;
219.                 int imageindex = item.ImageIndex;
220.                 int maxwidth = visibleRectangle.Width - 2 - left;
221.                 
222.                 //绘制图标
223.                 if (this._imagelist != null && imageindex >= 0 && this._imagelist.Images.Count > imageindex)
224.                 {
225.                     g.DrawImage(this._imagelist.Images[imageindex], new Rectangle(left, top, 16, 16));
226.                     maxwidth -= 16;
227.                     left += 16;
228.                 }
229.                 SizeF sizef = g.MeasureString(s, f, maxwidth);
230.                 
231.                 //绘制文字
232.                 using (SolidBrush itemTextBrush = new SolidBrush(this._itemForeColor))
233.                 {
234.                     //如果是移动到其上的元素
235.                     if (item == _mouseHoverItem)
236.                     {
237.                         itemTextBrush.Color = Color.Red;
238.                     }
239.                     g.DrawString(s, f, itemTextBrush, new Rectangle(left + 2 , top,(int) Math.Ceiling(sizef.Width ) , (int)Math.Floor(sizef.Height)));
240.                 }
241.                 //如果是选中的元素
242.                 if (item == _selectedItem)
243.                 {
244.                     using(Pen p = new Pen(SystemColors.Desktop))
245.                     {
246.                         p.DashStyle = DashStyle.Dash;
247.                         g.DrawRectangle(p,new Rectangle(left + 2,top -2,maxwidth - 4 ,(int)Math.Floor(sizef.Height) + 4));
248.                     }
249.                 }
250.               
251.                 top += (int)Math.Floor(sizef.Height) + _itemSpace;
252.                 left = 0;
253.             }
254.         }