Control.ProcessMnemonic-Methode

Artikel
08/20/2007

Verarbeitet ein mnemonisches Zeichen.

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

Syntax

'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 internal virtual bool ProcessMnemonic (
    char charCode
)

protected public:
virtual bool ProcessMnemonic (
    wchar_t charCode
)

protected boolean ProcessMnemonic (
    char charCode
)

protected internal function ProcessMnemonic (
    charCode : char
) : boolean

Parameter

charCode
Das zu verarbeitende Zeichen.

Rückgabewert

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

Hinweise

Diese Methode wird aufgerufen, damit ein Steuerelement ein mnemonisches Zeichen verarbeiten kann. Die Methode ermittelt, ob das Steuerelement mnemonische Zeichen verarbeiten kann und ob das angegebene Zeichen ein mnemonisches Zeichen darstellt. In diesem Fall führt die Methode die dem mnemonischen Zeichen zugeordnete Aktion aus und gibt true zurück. Andernfalls gibt die Methode false zurück. Implementierungen dieser Methode ermitteln häufig mit der IsMnemonic-Methode, ob das angegebene Zeichen mit einem mnemonischen Zeichen im Text des Steuerelements übereinstimmt.

Beispiel:

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

Diese Standardimplementierung der ProcessMnemonic-Methode gibt lediglich false zurück und zeigt damit an, dass das Steuerelement nicht über mnemonische Zeichen verfügt.

Beispiel

Im folgenden Codebeispiel wird eine Erweiterung der Schaltflächenklasse veranschaulicht, die die ProcessMnemonic-Methode überschreibt, um benutzerdefiniertes Verhalten bereitzustellen. Außerdem wird im Beispiel die Verwendung der CanSelect-Eigenschaft und der IsMnemonic-Eigenschaft veranschaulicht. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in derselben Datei hinter einer Formularklasse ein. Fügen Sie im 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;
   }

};

.NET Framework-Sicherheit

UIPermission für alle Fenster für erbende Klassen zum Aufrufen dieser Methode. Zugeordnete Enumeration: AllWindows-Wert von UIPermissionWindow.

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
IsMnemonic
ProcessDialogChar

Freigeben über