Export (0) Print
Expand All

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 System.Windows.Forms.dll)

public static bool IsMnemonic(
	char charCode,
	string text
)

Parameters

charCode
Type: System.Char

The character to test.

text
Type: System.String

The string to search.

Return Value

Type: System.Boolean
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.
{
	[UIPermission(
        SecurityAction.Demand, 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.");
			this.PerformClick();
			return true;
		}
		return false;
	}

}
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.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft