HardwareKeys, énumération

Mise à jour : novembre 2007

Spécifie les boutons matériels sur un Pocket PC auxquels il est possible d'accéder via la classe HardwareButton.

Espace de noms :  Microsoft.WindowsCE.Forms
Assembly :  Microsoft.WindowsCE.Forms (dans Microsoft.WindowsCE.Forms.dll)

Syntaxe

'Déclaration
Public Enumeration HardwareKeys
'Utilisation
Dim instance As HardwareKeys

public enum HardwareKeys

public enum class HardwareKeys

public enum HardwareKeys

Membres

	Nom de membre	Description
	None	Spécifie qu'aucun véritable bouton matériel n'est associé à cette instance de HardwareButton.
	ApplicationKey1	Spécifie le bouton matériel qui correspond à l'application 1.
	ApplicationKey2	Spécifie le bouton matériel qui correspond à l'application 2.
	ApplicationKey3	Spécifie le bouton matériel qui correspond à l'application 3.
	ApplicationKey4	Spécifie le bouton matériel qui correspond à l'application 4.
	ApplicationKey5	Spécifie le bouton matériel qui correspond à l'application 5.
	ApplicationKey6	Spécifie le bouton matériel qui correspond à l'application 6.

Exceptions

Exception	Condition
NotSupportedException

Notes

Le formulaire ou le contrôle associé à un membre de cette énumération peut recevoir les événements KeyDown et KeyUp lorsque le bouton matériel correspondant est enfoncé.

Cette énumération n'est pas prise en charge et lève une exception NotSupportedException sur Smartphone et autres périphériques Windows CE qui ne sont pas des Pocket PC.

Exemples

L'exemple de code suivant utilise les propriétés AssociatedControl et HardwareKey pour afficher un formulaire chaque fois que le premier bouton et le quatrième bouton sur Pocket PC sont enfoncés. Cet exemple de code fait partie d'un plus grand exemple fourni pour 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;
    }
}

Plateformes

Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Informations de version

.NET Compact Framework

Pris en charge dans : 3.5, 2.0

Voir aussi

Référence

Microsoft.WindowsCE.Forms, espace de noms

Autres ressources

Comment : utiliser le composant HardwareButton