Enumerazione HardwareKeys

Aggiornamento: novembre 2007

Specifica i pulsanti hardware di un Pocket PC a cui è possibile accedere mediante la classe HardwareButton.

Spazio dei nomi:  Microsoft.WindowsCE.Forms
Assembly:  Microsoft.WindowsCE.Forms (in Microsoft.WindowsCE.Forms.dll)

Sintassi

'Dichiarazione
Public Enumeration HardwareKeys
'Utilizzo
Dim instance As HardwareKeys

public enum HardwareKeys

public enum class HardwareKeys

public enum HardwareKeys

Membri

	Nome membro	Descrizione
	None	Specifica che nessun pulsante hardware effettivo è associato a questa istanza HardwareButton.
	ApplicationKey1	Specifica il pulsante hardware corrispondente all'applicazione 1.
	ApplicationKey2	Specifica il pulsante hardware corrispondente all'applicazione 2.
	ApplicationKey3	Specifica il pulsante hardware corrispondente all'applicazione 3.
	ApplicationKey4	Specifica il pulsante hardware corrispondente all'applicazione 4.
	ApplicationKey5	Specifica il pulsante hardware corrispondente all'applicazione 5.
	ApplicationKey6	Specifica il pulsante hardware corrispondente all'applicazione 6.

Eccezioni

Eccezione	Condizione
NotSupportedException

Note

Il form o il controllo associato a un membro di questa enumerazione può ricevere gli eventi KeyDowne KeyUp quando viene premuto il corrispondente pulsante hardware.

Questa enumerazione non è supportata e genera un'eccezione NotSupportedException nei dispositivi Smartphone e negli altri dispositivi Windows CE diversi dai Pocket PC.

Esempi

Nell'esempio di codice riportato di seguito vengono utilizzate le proprietà AssociatedControl e HardwareKey per visualizzare un form ogni volta che vengono premuti il primo e il quarto pulsante del Pocket PC. Questo esempio di codice fa parte di un esempio più esaustivo fornito per la classe HardwareButton.

Private Sub ConfigHWButton()
   'Set KeyPreview to true so that the form 
   'will receive key events before they 
   'are passed to the control that has focus. 

    Me.KeyPreview = True

      hwb1 = New HardwareButton()
      hwb4 = New HardwareButton()

   'Set the AssociatedControl property
   'to the current form and configure the
   'first and fourth buttons to activate the form.
   Try
      hwb1.AssociatedControl = Me
      hwb4.AssociatedControl = Me
      hwb1.HardwareKey = HardwareKeys.ApplicationKey1
      hwb4.HardwareKey = HardwareKeys.ApplicationKey4
   Catch exc As Exception
      MessageBox.Show(exc.Message + " Check if the hardware button is physically available on this device.")
   End Try
 End Sub

Private Overloads Sub OnKeyUp(sender As Object, e As KeyEventArgs) Handles MyBase.KeyUp
    ' When a hardware button is pressed and released,
    ' this form receives the KeyUp event. The OnKeyUp
    ' method is used to determine which hardware
    ' button was pressed, because the event data
    ' specifies a member of the HardwareKeys enumeration.
    Select Case CType(e.KeyCode, HardwareKeys)
      Case HardwareKeys.ApplicationKey1
         statusBar1.Text = "Button 1 pressed."

      Case HardwareKeys.ApplicationKey4
         statusBar1.Text = "Button 4 pressed."

      Case Else
   End Select
End Sub

// Configure hardware buttons
// 1 and 4 to activate the current form.
private void HBConfig()
    {
        try 
        {
            hwb1 = new HardwareButton();
            hwb4 = new HardwareButton();
            hwb1.AssociatedControl = this;
            hwb4.AssociatedControl = this;
            hwb1.HardwareKey = HardwareKeys.ApplicationKey1;
            hwb4.HardwareKey = HardwareKeys.ApplicationKey4;
        }
        catch (Exception exc)
        {
            MessageBox.Show(exc.Message + " Check if the hardware button is physically available on this device.");
        }
}

// When a hardware button is pressed and released,
// this form receives the KeyUp event. The OnKeyUp
// method is used to determine which hardware
// button was pressed, because the event data
// specifies a member of the HardwareKeys enumeration.
private void OnKeyUp(object sender, KeyEventArgs e)
{
    switch ((HardwareKeys)e.KeyCode)
    {
        case HardwareKeys.ApplicationKey1:
            statusBar1.Text = "Button 1 pressed.";
            break;

        case HardwareKeys.ApplicationKey4:
            statusBar1.Text = "Button 4 pressed.";
            break;

        default:
            break;
    }
}

Piattaforme

Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Informazioni sulla versione

.NET Compact Framework

Supportato in: 3.5, 2.0

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.WindowsCE.Forms

Altre risorse

Procedura: utilizzare il componente HardwareButton