This documentation is archived and is not being maintained.

Control.IsMnemonic Method

Determines if the specified character is the mnemonic character assigned to the control in the specified string.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in

public static bool IsMnemonic (
	char charCode,
	string text
public static boolean IsMnemonic (
	char charCode, 
	String text
public static function IsMnemonic (
	charCode : char, 
	text : String
) : boolean
Not applicable.



The character to test.


The string to search.

Return Value

true if the charCode character is the mnemonic character assigned to the control; otherwise, false.

The mnemonic character is the character immediately following the first instance of "&" in a String.

The following code example demonstrates an extension of the button class that overrides the ProcessMnemonic method to exhibit custom behavior. The example also demonstrates the use of the CanSelect and IsMnemonic properties. To run this example paste the following code after a form class, in the same file. Add a button of type MnemonicButton to the form.

// This button is a simple extension of the button class that overrides
// the ProcessMnemonic method.  If the mnemonic is correctly entered,  
// the message box will appear and the click event will be raised.  
public class MyMnemonicButton:Button

	// This method makes sure the control is selectable and the 
	// mneumonic is correct before displaying the message box
	// and triggering the click event.
        SecurityAction.LinkDemand, Window = UIPermissionWindow.AllWindows)]
        protected override bool ProcessMnemonic(char inputChar)

		if (CanSelect&&IsMnemonic(inputChar, this.Text))
			MessageBox.Show("You've raised the click event " +
				"using the mnemonic.");
			return true;
		return false;


Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0