This documentation is archived and is not being maintained.

Control.ProcessMnemonic Method

Processes a mnemonic character.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

'Declaration
Protected Friend Overridable Function ProcessMnemonic ( _
	charCode As Char _
) As Boolean
'Usage
Dim charCode As Char
Dim returnValue As Boolean

returnValue = Me.ProcessMnemonic(charCode)
protected boolean ProcessMnemonic (
	char charCode
)
protected internal function ProcessMnemonic (
	charCode : char
) : boolean
Not applicable.

Parameters

charCode

The character to process.

Return Value

true if the character was processed as a mnemonic by the control; otherwise, false.

This method is called to give a control the opportunity to process a mnemonic character. The method should determine whether the control is in a state to process mnemonics and if whether the given character represents a mnemonic. If so, the method should perform the action associated with the mnemonic and return true. If not, the method should return false. Implementations of this method often use the IsMnemonic method to determine whether the given character matches a mnemonic in the control's text.

For example:

if (CanSelect && IsMnemonic(charCode, MyControl.Text) {
      // Perform action associated with mnemonic.
       }

This default implementation of the ProcessMnemonic method simply returns false to indicate that the control has no mnemonic.

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.

No code example is currently available or this language may not be supported.

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
Show: