2 // ToolStripDropDownButton.cs
4 // Permission is hereby granted, free of charge, to any person obtaining
5 // a copy of this software and associated documentation files (the
6 // "Software"), to deal in the Software without restriction, including
7 // without limitation the rights to use, copy, modify, merge, publish,
8 // distribute, sublicense, and/or sell copies of the Software, and to
9 // permit persons to whom the Software is furnished to do so, subject to
10 // the following conditions:
12 // The above copyright notice and this permission notice shall be
13 // included in all copies or substantial portions of the Software.
15 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
19 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
20 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
21 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
23 // Copyright (c) 2006 Jonathan Pobst
26 // Jonathan Pobst (monkey@jpobst.com)
31 using System.Runtime.InteropServices;
32 using System.Windows.Forms.Design;
33 using System.ComponentModel;
35 namespace System.Windows.Forms
37 [ToolStripItemDesignerAvailability (ToolStripItemDesignerAvailability.ToolStrip | ToolStripItemDesignerAvailability.StatusStrip)]
38 public class ToolStripDropDownButton : ToolStripDropDownItem
40 private bool show_drop_down_arrow = true;
42 #region Public Constructors
43 public ToolStripDropDownButton()
44 : this (string.Empty, null, null, string.Empty)
48 public ToolStripDropDownButton (Image image)
49 : this (string.Empty, image, null, string.Empty)
53 public ToolStripDropDownButton (string text)
54 : this (text, null, null, string.Empty)
58 public ToolStripDropDownButton (string text, Image image)
59 : this (text, image, null, string.Empty)
63 public ToolStripDropDownButton (string text, Image image, EventHandler onClick)
64 : this (text, image, onClick, string.Empty)
68 public ToolStripDropDownButton (string text, Image image, params ToolStripItem[] dropDownItems)
69 : base (text, image, dropDownItems)
73 public ToolStripDropDownButton (string text, Image image, EventHandler onClick, string name)
74 : base (text, image, onClick, name)
79 #region Public Properties
81 public new bool AutoToolTip {
82 get { return base.AutoToolTip; }
83 set { base.AutoToolTip = value; }
87 public bool ShowDropDownArrow {
88 get { return this.show_drop_down_arrow; }
89 set { this.show_drop_down_arrow = value; }
93 #region Protected Properties
94 protected override bool DefaultAutoToolTip {
99 #region Protected Methods
100 protected override ToolStripDropDown CreateDefaultDropDown ()
102 return base.CreateDefaultDropDown ();
105 protected override void OnMouseDown (MouseEventArgs e)
107 if (this.DropDown.Visible)
108 this.HideDropDown (ToolStripDropDownCloseReason.ItemClicked);
110 this.ShowDropDown ();
112 base.OnMouseDown (e);
114 protected override void OnPaint (PaintEventArgs e)
118 if (this.Owner != null) {
119 Color font_color = this.Enabled ? this.ForeColor : SystemColors.GrayText;
120 Image draw_image = this.Enabled ? this.Image : ToolStripRenderer.CreateDisabledImage (this.Image);
122 this.Owner.Renderer.DrawDropDownButtonBackground (new System.Windows.Forms.ToolStripItemRenderEventArgs (e.Graphics, this));
124 Rectangle text_layout_rect;
125 Rectangle image_layout_rect;
127 this.CalculateTextAndImageRectangles (out text_layout_rect, out image_layout_rect);
129 if (text_layout_rect != Rectangle.Empty)
130 this.Owner.Renderer.DrawItemText (new System.Windows.Forms.ToolStripItemTextRenderEventArgs (e.Graphics, this, this.Text, text_layout_rect, font_color, this.Font, this.TextAlign));
131 if (image_layout_rect != Rectangle.Empty)
132 this.Owner.Renderer.DrawItemImage (new System.Windows.Forms.ToolStripItemImageRenderEventArgs (e.Graphics, this, draw_image, image_layout_rect));
133 if (this.ShowDropDownArrow)
134 this.Owner.Renderer.DrawArrow (new ToolStripArrowRenderEventArgs (e.Graphics, this, new Rectangle (this.Width - 10, 0, 6, this.Height), Color.Black, ArrowDirection.Down));
139 protected internal override bool ProcessMnemonic (char charCode)
142 this.Parent.ChangeSelection (this);
144 if (this.HasDropDownItems)
145 this.ShowDropDown ();
147 this.PerformClick ();