1 // Permission is hereby granted, free of charge, to any person obtaining
2 // a copy of this software and associated documentation files (the
3 // "Software"), to deal in the Software without restriction, including
4 // without limitation the rights to use, copy, modify, merge, publish,
5 // distribute, sublicense, and/or sell copies of the Software, and to
6 // permit persons to whom the Software is furnished to do so, subject to
7 // the following conditions:
9 // The above copyright notice and this permission notice shall be
10 // included in all copies or substantial portions of the Software.
12 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
13 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
14 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
15 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
16 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
17 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
18 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
20 // Copyright (c) 2005 Novell, Inc. (http://www.novell.com)
23 // Peter Bartok pbartok@novell.com
30 using System.ComponentModel;
31 using System.ComponentModel.Design;
34 namespace System.Windows.Forms {
35 [DefaultProperty("Text")]
36 [DefaultEvent("MouseDown")]
37 [Designer ("System.Windows.Forms.Design.NotifyIconDesigner, " + Consts.AssemblySystem_Design, (string)null)]
38 [ToolboxItemFilter("System.Windows.Forms", ToolboxItemFilterType.Allow)]
39 public sealed class NotifyIcon : System.ComponentModel.Component {
40 #region Local Variables
41 private ContextMenu context_menu;
43 private Bitmap icon_bitmap;
46 private NotifyIconWindow window;
47 private bool systray_active;
48 private ToolTip tooltip;
49 #endregion // Local Variables
51 #region NotifyIconWindow Class
52 internal class NotifyIconWindow : Control {
56 public NotifyIconWindow(NotifyIcon owner) {
59 rect = new Rectangle(0, 0, 1, 1);
63 Paint += new PaintEventHandler(HandlePaint);
64 SizeChanged += new EventHandler(HandleSizeChanged);
66 // Events that need to be sent to our parent
67 Click += new EventHandler(HandleClick);
68 DoubleClick += new EventHandler(HandleDoubleClick);
69 MouseDown +=new MouseEventHandler(HandleMouseDown);
70 MouseUp +=new MouseEventHandler(HandleMouseUp);
71 MouseMove +=new MouseEventHandler(HandleMouseMove);
72 ContextMenu = owner.context_menu;
75 protected override CreateParams CreateParams {
\r
79 cp = base.CreateParams;
\r
81 cp.Parent = IntPtr.Zero;
\r
82 cp.Style = (int)WindowStyles.WS_POPUP;
\r
83 cp.Style |= (int)WindowStyles.WS_CLIPSIBLINGS;
\r
85 cp.ExStyle = (int)(WindowStyles.WS_EX_TOOLWINDOW);
91 protected override void WndProc(ref Message m) {
\r
92 switch((Msg)m.Msg) {
\r
94 switch ((Msg)m.LParam.ToInt32()) {
\r
95 case Msg.WM_LBUTTONDOWN: {
\r
96 HandleMouseDown(this, new MouseEventArgs(MouseButtons.Left, 1, Control.MousePosition.X, Control.MousePosition.Y, 0));
\r
100 case Msg.WM_LBUTTONUP: {
\r
101 HandleMouseUp(this, new MouseEventArgs(MouseButtons.Left, 1, Control.MousePosition.X, Control.MousePosition.Y, 0));
\r
102 HandleClick(this, EventArgs.Empty);
\r
106 case Msg.WM_LBUTTONDBLCLK: {
\r
107 HandleDoubleClick(this, EventArgs.Empty);
\r
111 case Msg.WM_MOUSEMOVE: {
\r
112 HandleMouseMove(this, new MouseEventArgs(MouseButtons.None, 1, Control.MousePosition.X, Control.MousePosition.Y, 0));
\r
116 case Msg.WM_RBUTTONDOWN: {
\r
117 HandleMouseDown(this, new MouseEventArgs(MouseButtons.Right, 1, Control.MousePosition.X, Control.MousePosition.Y, 0));
\r
121 case Msg.WM_RBUTTONUP: {
\r
122 HandleMouseUp(this, new MouseEventArgs(MouseButtons.Right, 1, Control.MousePosition.X, Control.MousePosition.Y, 0));
\r
123 HandleClick(this, EventArgs.Empty);
\r
127 case Msg.WM_RBUTTONDBLCLK: {
\r
128 HandleDoubleClick(this, EventArgs.Empty);
\r
135 base.WndProc (ref m);
\r
138 internal void CalculateIconRect() {
\r
139 if (owner != null && owner.icon != null) {
\r
144 // Icons are always square. Try to center them in the window
\r
145 if (ClientRectangle.Width < ClientRectangle.Height) {
\r
146 size = ClientRectangle.Width;
\r
148 size = ClientRectangle.Height;
\r
150 x = this.ClientRectangle.Width / 2 - size / 2;
\r
151 y = this.ClientRectangle.Height / 2 - size / 2;
\r
152 rect = new Rectangle(x, y, size, size);
\r
154 // Force our window to be square
\r
155 if (Width != size) {
\r
159 if (Height != size) {
\r
160 this.Height = size;
\r
165 private void HandlePaint(object sender, PaintEventArgs e) {
\r
166 if (owner.icon != null) {
\r
167 e.Graphics.DrawImage(owner.icon_bitmap, rect);
\r
172 private void HandleSizeChanged(object sender, EventArgs e) {
\r
173 CalculateIconRect();
\r
176 private void HandleClick(object sender, EventArgs e) {
\r
177 if (owner.Click != null) {
\r
178 owner.Click(owner, e);
\r
182 private void HandleDoubleClick(object sender, EventArgs e) {
\r
183 if (owner.DoubleClick != null) {
\r
184 owner.DoubleClick(owner, e);
\r
188 private void HandleMouseDown(object sender, MouseEventArgs e) {
\r
189 if (owner.MouseDown != null) {
\r
190 owner.MouseDown(owner, e);
\r
194 private void HandleMouseUp(object sender, MouseEventArgs e) {
\r
195 if (owner.context_menu != null) {
\r
196 owner.context_menu.Show(this, new Point(e.X, e.Y));
\r
199 if (owner.MouseUp != null) {
\r
200 owner.MouseUp(owner, e);
\r
204 private void HandleMouseMove(object sender, MouseEventArgs e) {
\r
205 if (owner.MouseMove != null) {
\r
206 owner.MouseMove(owner, e);
\r
210 #endregion // NotifyIconWindow Class
212 #region Public Constructors
213 public NotifyIcon() {
214 window = new NotifyIconWindow(this);
215 systray_active = false;
218 public NotifyIcon(System.ComponentModel.IContainer container) : this() {
220 #endregion // Public Constructors
222 #region Private Methods
223 private void ShowSystray(bool property_changed) {
224 if (property_changed) {
225 window.CalculateIconRect();
228 if (systray_active) {
229 if (property_changed) {
236 icon_bitmap = icon.ToBitmap();
239 systray_active = true;
240 XplatUI.SystrayAdd(window.Handle, text, icon, out tooltip);
243 private void HideSystray() {
244 if (!systray_active) {
248 systray_active = false;
249 XplatUI.SystrayRemove(window.Handle, ref tooltip);
252 private void UpdateSystray() {
253 if (icon_bitmap != null) {
254 icon_bitmap.Dispose();
258 icon_bitmap = icon.ToBitmap();
261 XplatUI.SystrayChange(window.Handle, text, icon, ref tooltip);
264 #endregion // Private Methods
266 #region Public Instance Properties
268 public ContextMenu ContextMenu {
274 if (context_menu != value) {
275 context_menu = value;
276 window.ContextMenu = value;
307 if (value.Length >= 64) {
308 throw new ArgumentException("ToolTip length must be less than 64 characters long", "Text");
311 if (text == string.Empty && icon == null) {
321 [DefaultValue(false)]
322 public bool Visible {
328 if (visible != value) {
331 // Let our control know, too
332 window.is_visible = value;
342 #endregion // Public Instance Properties
344 #region Protected Instance Methods
345 protected override void Dispose(bool disposing) {
\r
346 if (icon != null) {
\r
350 if (icon_bitmap != null) {
\r
351 icon_bitmap.Dispose();
\r
353 base.Dispose (disposing);
\r
356 #endregion // Protected Instance Methods
360 public event EventHandler Click;
363 public event EventHandler DoubleClick;
365 public event MouseEventHandler MouseDown;
366 public event MouseEventHandler MouseMove;
367 public event MouseEventHandler MouseUp;