Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

PointerDevice class

Applies to Windows and Windows Phone

Supports the ability to identify the connected pointer devices and determine their capabilities.

Syntax

Public NotInheritable Class PointerDevice

Attributes

[MarshalingBehavior(None)]
[Version(0x06020000)]

Members

The PointerDevice class has these types of members:

Methods

The PointerDevice class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

MethodDescription
GetPointerDevice Gets information about the pointer device associated with the specified input pointer ID.
GetPointerDevices Gets information about the pointer devices attached to the system.

 

Properties

The PointerDevice class has these properties.

PropertyAccess typeDescription

IsIntegrated

Read-onlyGets a value indicating whether the pointer device is an integrated device. For example, a video display with an integrated touch digitizer compared to an external pen/stylus digitizer.

MaxContacts

Read-onlyGets a value indicating the maximum number of contacts supported by the input device.

PhysicalDeviceRect

Read-onlyGets the coordinates of the bounding rectangle supported by the input device.

PointerDeviceType

Read-onlyGets the pointer device type.

ScreenRect

Read-onlyGets the screen coordinates that are mapped to the bounding rectangle supported by the input device.

SupportedUsages

Read-onlyGets a collection containing the supported pointer device usages.

 

Remarks

The values returned by the properties discussed here are based on the total number of pointer devices connected: Boolean properties return true if one device supports a specific capability and numeric properties return the maximum value exposed by all devices.

The Device Capabilities Sample demonstrates how to detect the presence of input devices and retrieve the capabilities and attributes of each device.

Note  : This class is not agile, which means that you need to consider its threading model and marshaling behavior. For more info, see Threading and Marshaling (C++/CX) and Using Windows Runtime objects in a multithreaded environment (.NET).

Examples

The following code shows how to use PointerDevice.


function getPointerDevicesAndAttributes() {
    var pointerDevices = Windows.Devices.Input.PointerDevice.GetPointerDevices();
    var htmlWrite = "";
    for (i = 0; i < pointerDevices.Size; i++)  {
         htmlWrite += "<tr><td>(" + i + ") Pointer Device Type</td><td>";
         htmlWrite += getPointerDeviceType(pointerDevices[i].PointerDeviceType) + "</td></tr>";
         htmlWrite += "<tr><td>(" + i + ") Is External</td><td>" + pointerDevices[i].IsExternal + "</td></tr>";
         htmlWrite += "<tr><td>(" + i + ") Max Contacts</td><td>" + pointerDevices[i].MaxContacts + "</td></tr>";
         htmlWrite += "<tr><td>(" + i + ") Physical Device Rect</td><td>" +
             pointerDevices[i].PhysicalDeviceRect.X + "," +
             pointerDevices[i].PhysicalDeviceRect.Y + "," +
             pointerDevices[i].PhysicalDeviceRect.Width + "," +
             pointerDevices[i].PhysicalDeviceRect.Height + "</td></tr>";
         htmlWrite += "<tr><td>(" + i + ") Screen Rect</td><td>" +
             pointerDevices[i].ScreenRect.X + "," +
             pointerDevices[i].ScreenRect.Y + "," +
             pointerDevices[i].ScreenRect.Width + "," +
             pointerDevices[i].ScreenRect.Height + "</td></tr>";
    }
    id("pointerDevices").innerHTML = htmlWrite;
}

Requirements

Minimum supported client

Windows 8 [Windows Store apps only]

Minimum supported server

Windows Server 2012 [Windows Store apps only]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.Devices.Input
Windows::Devices::Input [C++]

Metadata

Windows.winmd

See also

Windows.Devices.Input
Quickstarts
Quickstart: Identifying input devices

 

 

Show:
© 2014 Microsoft