Control.ProcessMnemonic(Char) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Verarbeitet ein mnemonisches Zeichen.

protected public:
 virtual bool ProcessMnemonic(char charCode);

protected internal virtual bool ProcessMnemonic (char charCode);

abstract member ProcessMnemonic : char -> bool
override this.ProcessMnemonic : char -> bool

Protected Friend Overridable Function ProcessMnemonic (charCode As Char) As Boolean

Parameter

charCode

Char

Das zu verarbeitende Zeichen.

Gibt zurück

Boolean

true, wenn das Zeichen als mnemonisches Zeichen vom Steuerelement verarbeitet wurde, andernfalls false.

Beispiele

Im folgenden Codebeispiel wird eine Erweiterung der Schaltflächenklasse veranschaulicht, die die ProcessMnemonic -Methode außer Kraft setzt, um benutzerdefiniertes Verhalten anzuzeigen. Das Beispiel veranschaulicht auch die Verwendung der CanSelect Eigenschaften und IsMnemonic . Fügen Sie zum Ausführen dieses Beispiels den folgenden Code nach einer Formularklasse in die gleiche Datei ein. Fügen Sie dem Formular eine Schaltfläche vom Typ MnemonicButton hinzu.

// 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.  
// This method makes sure the control is selectable and the 
// mnemonic is correct before displaying the message box
// and triggering the click event.
public ref class MyMnemonicButton: public Button
{
protected:
   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;
   }

};

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

' 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
    Inherits Button

    ' This method makes sure the control is selectable and the 
    ' mneumonic is correct before displaying the message box
    ' and triggering the click event.
    <System.Security.Permissions.UIPermission( _
    System.Security.Permissions.SecurityAction.Demand, Window:=UIPermissionWindow.AllWindows)> _
    Protected Overrides Function ProcessMnemonic( _
        ByVal inputChar As Char) As Boolean

        If (CanSelect And IsMnemonic(inputChar, Me.Text)) Then
            MessageBox.Show("You've raised the click event " _
                & "using the mnemonic.")
            Me.PerformClick()
            Return True
        End If
        Return False
    End Function

End Class

Hinweise

Diese Methode wird aufgerufen, um einem Steuerelement die Möglichkeit zu geben, ein mnemonisches Zeichen zu verarbeiten. Die -Methode sollte bestimmen, ob sich das Steuerelement in einem Zustand für die Verarbeitung von Mnemonika befindet und ob das angegebene Zeichen ein mnemonisches Darstellt. Wenn ja, sollte die -Methode die aktion ausführen, die dem mnemonischen zugeordnet ist, und zurückgeben true. Andernfalls sollte die -Methode zurückgeben false. Implementierungen dieser Methode verwenden häufig die IsMnemonic -Methode, um zu bestimmen, ob das angegebene Zeichen einem mnemonischen Zeichen im Text des Steuerelements entspricht.

Beispiel:

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

Diese Standardimplementierung der ProcessMnemonic Methode gibt einfach zurück false , um anzugeben, dass das Steuerelement kein mnemonisches Element aufweist.

Weitere Informationen

• IsMnemonic(Char, String)
• ProcessDialogChar(Char)