Control.ProcessMnemonic(Char) Méthode

Définition

Traite un caractère mnémonique.Processes a mnemonic character.

protected:
 virtual bool ProcessMnemonic(char charCode);
protected virtual bool ProcessMnemonic (char charCode);
abstract member ProcessMnemonic : char -> bool
override this.ProcessMnemonic : char -> bool
Protected Overridable Function ProcessMnemonic (charCode As Char) As Boolean

Paramètres

charCode
Char

Caractère à traiter.The character to process.

Retours

true si le caractère a été traité comme un mnémonique par le contrôle ; sinon, false.true if the character was processed as a mnemonic by the control; otherwise, false.

Exemples

L’exemple de code suivant illustre une extension de la classe Button qui remplace la méthode ProcessMnemonic pour présenter un comportement personnalisé.The following code example demonstrates an extension of the button class that overrides the ProcessMnemonic method to exhibit custom behavior. L’exemple illustre également l’utilisation des propriétés CanSelect et IsMnemonic.The example also demonstrates the use of the CanSelect and IsMnemonic properties. Pour exécuter cet exemple, collez le code suivant après une classe Form, dans le même fichier.To run this example paste the following code after a form class, in the same file. Ajoutez un bouton de type MnemonicButton au formulaire.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.  
// 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.
{
    [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;
    }

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

Remarques

Cette méthode est appelée pour permettre à un contrôle de traiter un caractère mnémonique.This method is called to give a control the opportunity to process a mnemonic character. La méthode doit déterminer si le contrôle est dans un État pour traiter les mnémoniques et si le caractère donné représente un mnémonique.The method should determine whether the control is in a state to process mnemonics and if whether the given character represents a mnemonic. Si c’est le cas, la méthode doit exécuter l’action associée au mnémonique et retourner true.If so, the method should perform the action associated with the mnemonic and return true. Si ce n’est pas le cas, la méthode doit retourner false.If not, the method should return false. Les implémentations de cette méthode utilisent souvent la méthode IsMnemonic pour déterminer si le caractère donné correspond à un mnémonique dans le texte du contrôle.Implementations of this method often use the IsMnemonic method to determine whether the given character matches a mnemonic in the control's text.

Par exemple :For example:

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

Cette implémentation par défaut de la méthode ProcessMnemonic retourne simplement false pour indiquer que le contrôle n’a pas de mnémonique.This default implementation of the ProcessMnemonic method simply returns false to indicate that the control has no mnemonic.

Sécurité

UIPermission
pour toutes les fenêtres permettant d’hériter des classes pour appeler cette méthode.for all windows for inheriting classes to call this method. Énumération associée : valeur AllWindows de UIPermissionWindow.Associated enumeration: AllWindows value of UIPermissionWindow.

S’applique à

Voir aussi