This topic has not yet been rated - Rate this topic

HardwareKeys Enumeration

.NET Framework 2.0

Other Versions

Specifies the hardware buttons on a Pocket PC that can be accessed by the HardwareButton class.

Namespace: Microsoft.WindowsCE.Forms
Assembly: Microsoft.WindowsCE.Forms (in microsoft.windowsce.forms.dll)

Syntax

C++

Copy

public enum HardwareKeys

Copy

public enum HardwareKeys

JScript

Copy

public enum HardwareKeys

Members

	Member name	Description
	ApplicationKey1	Specifies the hardware button that corresponds to application 1.
	ApplicationKey2	Specifies the hardware button that corresponds to application 2.
	ApplicationKey3	Specifies the hardware button that corresponds to application 3.
	ApplicationKey4	Specifies the hardware button that corresponds to application 4.
	ApplicationKey5	Specifies the hardware button that corresponds to application 5.
	ApplicationKey6	Specifies the hardware button that corresponds to application 6.
	None	Specifies that no actual hardware buttons are associated with this HardwareButton instance.

Remarks

The form or control associated with a member of this enumeration can receive the KeyDownand KeyUp events when the corresponding hardware button is pressed.

This enumeration is not supported and throws a NotSupportedException on the Smartphone and other Windows CE devices that are not Pocket PCs.

Example

The following code example uses the AssociatedControl and HardwareKey properties to display a form whenever the first and fourth buttons on Pocket PC are pressed. This code example is part of a larger example provided for the HardwareButton class.

Copy

// 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;
    }
}

Platforms

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Version Information

.NET Compact Framework

Supported in: 2.0

Reference

Microsoft.WindowsCE.Forms Namespace

Other Resources

How to: Use the HardwareButton Component

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ