Add New Menu To System Menu

				
//**************************************
// Name: Add New Menu To System Menu
// Description:Demonstrates how to add a new menu to the system menu found in the icon in the top left corner of your form, or by right clicking on the app in the task bar.<br><br>
Original idea was submitted by Nicholas Afxentiou for VB6, which can be found at: http://www.planet-source-code.com/vb/scripts/ShowCode.asp?txtCodeId=1519&lngWId=10
<br><br>
Please note that the code must be used in a form class, it can not be used in a non-gui class.<br><br>
// By: Philip Pierce
//
//This code is copyrighted and has// limited warranties.Please see http://www.Planet-Source-Code.com/vb/scripts/ShowCode.asp?txtCodeId=1822&lngWId=10//for details.//**************************************

using System;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using System.Windows.Forms;
using System.Data;
using System.Runtime.InteropServices;
.........
		/* API References:
		 * RemoveMenu: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/winui/windowsuserinterface/resources/menus/menureference/menufunctions/removemenu.asp
		 * InsertMenuItem: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/winui/windowsuserinterface/resources/menus/menureference/menufunctions/insertmenuitem.asp
		 * AppendMenu: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/winui/windowsuserinterface/resources/menus/menureference/menufunctions/appendmenu.asp
		*/
		
		#region API Declarations
		// return the handle for the system menu
		[DllImport ("user32.dll")]
		public static extern int GetSystemMenu(int hwnd, bool bRevert);
		// append a menu item to the menu
		[DllImport ("user32.dll", EntryPoint="AppendMenuA")]
		public static extern long AppendMenu(int hMenu, int wFlags, int wIDNewItem, string lpNewItem);
		// remove a menu item from the menu
		[DllImport ("user32.dll")]
		public static extern long RemoveMenu(int hMenu, int nPosition, int wFlags);
		#endregion // API Declarations
		// constants
		private const int MF_BYPOSITION = 1024;
		private const int MF_SEPERATOR = 2048;
		private const int MF_REMOVE = 4096;
		private const int WM_SYSCOMMAND = 274;
		#region System Menu API
		/// <summary>
		/// Returns the handle for the System Menu with the associate form
		/// </summary>
		/// <param name="frmHandle">The handle to the form to retrieve the menu handle</param>
		public int GetSysMenuHandle(int frmHandle)
		{
			return GetSystemMenu(frmHandle, false);
		}
		/// <summary>
		/// Removes a system menu
		/// </summary>
		/// <param name="mnuHandle">Then handle to the system menu. Use GetSysMenuHandle</param>
		/// <param name="mnuPosition">Zero based position of the menu item to delete</param>
		/// <returns>returns nonzero on success, returns 0 on fail</returns>
		public long RemoveSysMenu(int mnuHandle, int mnuPosition)
		{
			return RemoveMenu(mnuHandle, mnuPosition, MF_REMOVE);
		}
		/// <summary>
		/// Appends a menu item to the end of the system menu list
		/// </summary>
		/// <param name="mnuHandle">Handle to the system menu to append to</param>
		/// <param name="MenuID">A unique ID sent by the calling function to track events for the menu</param>
		/// <param name="mnuText">The display text of the menu</param>
		/// <returns>Returns nonzero on success, 0 on fail.</returns>
		public long AppendSysMenu(int mnuHandle, int MenuID, string mnuText)
		{
			return AppendMenu(mnuHandle, 0, MenuID, mnuText);
		}
		/// <summary>
		/// Appends a seperator bar at the end of the system menu
		/// </summary>
		/// <param name="mnuHandle">Handle to the system menu</param>
		/// <returns>Returns nonzero on success, 0 on fail</returns>
		public long AppendSeperator(int mnuHandle)
		{
			return AppendMenu(mnuHandle, MF_SEPERATOR, 0, null);
		}
		// THIS IS IMPORTANT. The WndProc function has to be overridden so
		// we can capture the events from a menu item being selected.
		// In the future, we could add OwnerDraw features here, and process
		// that here, too (see: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/winui/windowsuserinterface/resources/menus/menureference/menufunctions/appendmenu.asp
		/// <summary>
		/// Overrides the orignal WndPrc function to process menu events
		/// </summary>
		/// <param name="messg">The messages sent to WndProc</param>
		protected override void WndProc(ref Message messg)
		{
			int i = 1; // for EXAMPLE purposes only
			// see if this is a menu message to monitor
			if (messg.Msg == WM_SYSCOMMAND)
			{
				// decide how to handle the command
				switch (messg.WParam.ToInt32())
				{
					case x:
						// TODO: this is for example only, replace x with
						// whatever values you gave for the MenuID
						// then process the menu event here by calling
						// whatever function necessary
				}
			}
			// return the message so other wndprocs can process them
			base.WndProc(ref messg);
		}
		#endregion // System Menu API