Procedura: modificare l'input da tastiera in un controllo standard

Windows Form consente di utilizzare e modificare gli input da tastiera. L'utilizzo di un tasto in questo contesto indica la gestione di un tasto all'interno di un metodo o di un gestore eventi in modo che il valore del tasto non venga ricevuto da altri metodi ed eventi situati più in basso nella coda dei messaggi. La modifica di un tasto indica invece la modifica del valore di un tasto in modo che altri metodi ed eventi situati più in basso nella coda dei messaggi ricevano un valore diverso. In questo argomento verrà descritto come eseguire queste attività.

Per utilizzare un tasto

• In un gestore eventi KeyPress, impostare la proprietà Handled della classe KeyPressEventArgs su true.

  -oppure-

  In un gestore eventi KeyDown, impostare la proprietà Handled della classe KeyEventArgs su true.

  Nota

  L'impostazione della proprietà Handled nel gestore eventi KeyDown non impedisce la generazione degli eventi KeyPress e KeyUp per la sequenza di tasti. Utilizzare la proprietà SuppressKeyPress per questo scopo.

  L'esempio riportato di seguito è tratto da un'istruzione switch per l'esame della proprietà KeyChar della classe KeyPressEventArgs ricevuta da un gestore eventi KeyPress. In questo codice vengono utilizzati i tasti corrispondenti ai caratteri A e a.

  ' Consume 'A' and 'a'.
  Case ChrW(65), ChrW(97)
      MessageBox.Show(("Control.KeyPress: '" + _
          e.KeyChar.ToString() + "' consumed."))
      e.Handled = True
  

  // Consume 'A' and 'a'.
  case (char)65:
  case (char)97:
      MessageBox.Show("Control.KeyPress: '" +
          e.KeyChar.ToString() + "' consumed.");
      e.Handled = true;
      break;
  

Per modificare un tasto carattere standard

• In un gestore eventi KeyPress, impostare la proprietà KeyChar della classe KeyPressEventArgs sul valore del nuovo tasto carattere.

  L'esempio riportato di seguito è tratto da un'istruzione switch per la modifica del tasto B in A e di b in a. La proprietà Handled del parametro KeyPressEventArgs è impostata su false, in modo che il nuovo valore del tasto venga propagato ad altri metodi ed eventi nella coda dei messaggi.

      ' Modify 'B' to 'A' and forward the key.
  Case ChrW(66)
      MessageBox.Show(("Control.KeyPress: '" + _
          e.KeyChar.ToString() + "' replaced by 'A'."))
      e.KeyChar = ChrW(65)
      e.Handled = False
  
      ' Modify 'b' to 'a' and forward the key.
  Case ChrW(98)
      MessageBox.Show(("Control.KeyPress: '" + _
          e.KeyChar.ToString() + "' replaced by 'a'."))
      e.KeyChar = ChrW(97)
      e.Handled = False
  

  // Detect 'B', modify it to 'A', and forward the key.
  case (char)66:
      MessageBox.Show("Control.KeyPress: '" +
          e.KeyChar.ToString() + "' replaced by 'A'.");
      e.KeyChar = (char)65;
      e.Handled = false;
      break;
  
  // Detect 'b', modify it to 'a', and forward the key.
  case (char)98:
      MessageBox.Show("Control.KeyPress: '" +
          e.KeyChar.ToString() + "' replaced by 'a'.");
      e.KeyChar = (char)97;
      e.Handled = false;
      break;
  

Per modificare un tasto non corrispondente a un carattere

• Eseguire l'override di un metodo Control per l'elaborazione dei messaggi di Windows, individuare il messaggio WM_KEYDOWN o il messaggio WM_SYSKEYDOWN e impostare la proprietà WParam del parametro Message sul valore Keys che rappresenta il nuovo tasto non corrispondente a un carattere.

  Nell'esempio di codice riportato di seguito viene illustrato come eseguire l'override del metodo PreProcessMessage di un controllo per individuare i tasti da F1 a F9 e modificare la funzione del tasto F3 in quella del tasto F1. Per ulteriori informazioni sui metodi Control di cui è possibile eseguire l'override per intercettare i messaggi da tastiera, vedere Input dell'utente in un'applicazione Windows Form e Funzionamento dell'input da tastiera.

  ' Detect F1 through F9 during preprocessing and modify F3.
  Public Overrides Function PreProcessMessage(ByRef m As Message) _
      As Boolean
  
      If m.Msg = WM_KEYDOWN Then
          Dim keyCode As Keys = CType(m.WParam, Keys) And Keys.KeyCode
  
          ' Detect F1 through F9.
          Select Case keyCode
              Case Keys.F1, Keys.F2, Keys.F3, Keys.F4, Keys.F5, _
                   Keys.F6, Keys.F7, Keys.F8, Keys.F9
  
                  MessageBox.Show(("Control.PreProcessMessage: '" + _
                      keyCode.ToString() + "' pressed."))
  
                  ' Replace F3 with F1, so that ProcessKeyMessage will  
                  ' receive F1 instead of F3.
                  If keyCode = Keys.F3 Then
                      m.WParam = CType(Keys.F1, IntPtr)
                      MessageBox.Show(("Control.PreProcessMessage: '" + _
                          keyCode.ToString() + "' replaced by F1."))
                  End If
          End Select
      End If
  
      ' Send all other messages to the base method.
      Return MyBase.PreProcessMessage(m)
  End Function
  

  // Detect F1 through F9 during preprocessing and modify F3.
  public override bool PreProcessMessage(ref Message m)
  {
      if (m.Msg == WM_KEYDOWN)
      {
          Keys keyCode = (Keys)m.WParam & Keys.KeyCode;
  
          // Detect F1 through F9.
          switch (keyCode)
          {
              case Keys.F1:
              case Keys.F2:
              case Keys.F3:
              case Keys.F4:
              case Keys.F5:
              case Keys.F6:
              case Keys.F7:
              case Keys.F8:
              case Keys.F9:
  
                  MessageBox.Show("Control.PreProcessMessage: '" +
                    keyCode.ToString() + "' pressed.");
  
                  // Replace F3 with F1, so that ProcessKeyMessage will  
                  // receive F1 instead of F3.
                  if (keyCode == Keys.F3)
                  {
                      m.WParam = (IntPtr)Keys.F1;
                      MessageBox.Show("Control.PreProcessMessage: '" +
                          keyCode.ToString() + "' replaced by F1.");
                  }
                  break;
          }
      }
  
      // Send all other messages to the base method.
      return base.PreProcessMessage(ref m);
  }
  

Esempio

L'esempio di codice riportato di seguito è l'applicazione completa degli esempi di codice delle sezioni precedenti. Nell'applicazione viene utilizzato un controllo personalizzato derivato dalla classe TextBox per utilizzare e modificare gli input da tastiera.

Imports System
Imports System.Drawing
Imports System.Security
Imports System.Security.Permissions
Imports System.Windows.Forms


Namespace KeyboardInput
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _ 
    Class Form1
        Inherits Form

        ' The following Windows message value is defined in Winuser.h.
        Private WM_KEYDOWN As Integer = &H100
        Private WithEvents CustomTextBox1 As New CustomTextBox()

        <STAThread()> _
        Public Shared Sub Main()
            Application.EnableVisualStyles()
            Application.Run(New Form1())
        End Sub

        Public Sub New()
            Me.AutoSize = True
            Me.Controls.Add(CustomTextBox1)
        End Sub

        ' Consume and modify several character keys.
        Sub CustomTextBox1_KeyPress(ByVal sender As Object, _
            ByVal e As KeyPressEventArgs) Handles CustomTextBox1.KeyPress

            Select Case e.KeyChar

                ' Consume 'A' and 'a'.
                Case ChrW(65), ChrW(97)
                    MessageBox.Show(("Control.KeyPress: '" + _
                        e.KeyChar.ToString() + "' consumed."))
                    e.Handled = True

                    ' Modify 'B' to 'A' and forward the key.
                Case ChrW(66)
                    MessageBox.Show(("Control.KeyPress: '" + _
                        e.KeyChar.ToString() + "' replaced by 'A'."))
                    e.KeyChar = ChrW(65)
                    e.Handled = False

                    ' Modify 'b' to 'a' and forward the key.
                Case ChrW(98)
                    MessageBox.Show(("Control.KeyPress: '" + _
                        e.KeyChar.ToString() + "' replaced by 'a'."))
                    e.KeyChar = ChrW(97)
                    e.Handled = False
            End Select
        End Sub
    End Class

<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _ 
    Public Class CustomTextBox
        Inherits TextBox

        ' The following Windows message value is defined in Winuser.h.
        Private WM_KEYDOWN As Integer = &H100

        Public Sub New()
            Me.Size = New Size(100, 100)
            Me.AutoSize = False
        End Sub

        ' Detect F1 through F9 during preprocessing and modify F3.
        Public Overrides Function PreProcessMessage(ByRef m As Message) _
            As Boolean

            If m.Msg = WM_KEYDOWN Then
                Dim keyCode As Keys = CType(m.WParam, Keys) And Keys.KeyCode

                ' Detect F1 through F9.
                Select Case keyCode
                    Case Keys.F1, Keys.F2, Keys.F3, Keys.F4, Keys.F5, _
                         Keys.F6, Keys.F7, Keys.F8, Keys.F9

                        MessageBox.Show(("Control.PreProcessMessage: '" + _
                            keyCode.ToString() + "' pressed."))

                        ' Replace F3 with F1, so that ProcessKeyMessage will  
                        ' receive F1 instead of F3.
                        If keyCode = Keys.F3 Then
                            m.WParam = CType(Keys.F1, IntPtr)
                            MessageBox.Show(("Control.PreProcessMessage: '" + _
                                keyCode.ToString() + "' replaced by F1."))
                        End If
                End Select
            End If

            ' Send all other messages to the base method.
            Return MyBase.PreProcessMessage(m)
        End Function

        ' Detect F1 through F9 during processing.
        Protected Overrides Function ProcessKeyMessage(ByRef m As Message) _
            As Boolean

            If m.Msg = WM_KEYDOWN Then
                Dim keyCode As Keys = CType(m.WParam, Keys) And Keys.KeyCode

                ' Detect F1 through F9.
                Select Case keyCode
                    Case Keys.F1, Keys.F2, Keys.F3, Keys.F4, Keys.F5, _
                         Keys.F6, Keys.F7, Keys.F8, Keys.F9

                        MessageBox.Show(("Control.ProcessKeyMessage: '" + _
                            keyCode.ToString() + "' pressed."))
                End Select
            End If

            ' Send all messages to the base method.
            Return MyBase.ProcessKeyMessage(m)
        End Function

    End Class
End Namespace

using System;
using System.Drawing;
using System.Windows.Forms;

namespace KeyboardInput
{
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
    class Form1 : Form
    {
        // The following Windows message value is defined in Winuser.h.
        private int WM_KEYDOWN = 0x100;
        CustomTextBox CustomTextBox1 = new CustomTextBox();

        [STAThread]
        public static void Main()
        {
            Application.EnableVisualStyles();
            Application.Run(new Form1());
        }

        public Form1()
        {
            this.AutoSize = true;
            this.Controls.Add(CustomTextBox1);
            CustomTextBox1.KeyPress +=
                new KeyPressEventHandler(CustomTextBox1_KeyPress);
        }

        // Consume and modify several character keys.
        void CustomTextBox1_KeyPress(object sender, KeyPressEventArgs e)
        {
            switch (e.KeyChar)
            {
                // Consume 'A' and 'a'.
                case (char)65:
                case (char)97:
                    MessageBox.Show("Control.KeyPress: '" +
                        e.KeyChar.ToString() + "' consumed.");
                    e.Handled = true;
                    break;

                // Detect 'B', modify it to 'A', and forward the key.
                case (char)66:
                    MessageBox.Show("Control.KeyPress: '" +
                        e.KeyChar.ToString() + "' replaced by 'A'.");
                    e.KeyChar = (char)65;
                    e.Handled = false;
                    break;

                // Detect 'b', modify it to 'a', and forward the key.
                case (char)98:
                    MessageBox.Show("Control.KeyPress: '" +
                        e.KeyChar.ToString() + "' replaced by 'a'.");
                    e.KeyChar = (char)97;
                    e.Handled = false;
                    break;
            }
        }
    }
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
    public class CustomTextBox : TextBox
    {
        // The following Windows message value is defined in Winuser.h.
        private int WM_KEYDOWN = 0x100;

        public CustomTextBox()
        {
            this.Size = new Size(100, 100);
            this.AutoSize = false;
        }

        // Detect F1 through F9 during preprocessing and modify F3.
        public override bool PreProcessMessage(ref Message m)
        {
            if (m.Msg == WM_KEYDOWN)
            {
                Keys keyCode = (Keys)m.WParam & Keys.KeyCode;

                // Detect F1 through F9.
                switch (keyCode)
                {
                    case Keys.F1:
                    case Keys.F2:
                    case Keys.F3:
                    case Keys.F4:
                    case Keys.F5:
                    case Keys.F6:
                    case Keys.F7:
                    case Keys.F8:
                    case Keys.F9:

                        MessageBox.Show("Control.PreProcessMessage: '" +
                          keyCode.ToString() + "' pressed.");

                        // Replace F3 with F1, so that ProcessKeyMessage will  
                        // receive F1 instead of F3.
                        if (keyCode == Keys.F3)
                        {
                            m.WParam = (IntPtr)Keys.F1;
                            MessageBox.Show("Control.PreProcessMessage: '" +
                                keyCode.ToString() + "' replaced by F1.");
                        }
                        break;
                }
            }

            // Send all other messages to the base method.
            return base.PreProcessMessage(ref m);
        }

        // Detect F1 through F9 during processing.
        protected override bool ProcessKeyMessage(ref Message m)
        {
            if (m.Msg == WM_KEYDOWN)
            {
                Keys keyCode = (Keys)m.WParam & Keys.KeyCode;

                // Detect F1 through F9.
                switch (keyCode)
                {
                    case Keys.F1:
                    case Keys.F2:
                    case Keys.F3:
                    case Keys.F4:
                    case Keys.F5:
                    case Keys.F6:
                    case Keys.F7:
                    case Keys.F8:
                    case Keys.F9:

                        MessageBox.Show("Control.ProcessKeyMessage: '" +
                          keyCode.ToString() + "' pressed.");
                        break;
                }
            }

            // Send all messages to the base method.
            return base.ProcessKeyMessage(ref m);
        }
    }
}

Compilazione del codice

Per questo esempio sono necessari i seguenti requisiti:

• Riferimenti agli assembly System, System.Drawing e System.Windows.Forms.

Per informazioni sulla compilazione di questo esempio dalla riga di comando per Visual Basic o Visual C#, vedere Building from the Command Line (Visual Basic) o Compilazione dalla riga di comando con csc.exe. È anche possibile compilare questo esempio in Visual Studio incollando il codice in un nuovo progetto. Per ulteriori informazioni, vedere Procedura: compilare ed eseguire un esempio di codice Windows Form completo tramite Visual Studio e Procedura: compilare ed eseguire un esempio di codice Windows Form completo tramite Visual Studio e Procedura: compilare ed eseguire un esempio di codice Windows Form completo tramite Visual Studio e Procedura: compilare ed eseguire un esempio di codice Windows Form completo tramite Visual Studio e Procedura: compilare ed eseguire un esempio di codice Windows Form completo tramite Visual Studio.

Vedere anche

Concetti

Input dell'utente in un'applicazione Windows Form

Funzionamento dell'input da tastiera

Altre risorse

Input da tastiera in un'applicazione Windows Form