PointerDevice class (Windows)

This topic has not yet been rated - Rate this topic

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

Syntax


var pointerDevice = Windows.Devices.Input.PointerDevice;

Attributes

MarshalingBehaviorAttribute(None)
StaticAttribute(Windows.Devices.Input.IPointerDeviceStatics, NTDDI_WIN8)
VersionAttribute(NTDDI_WIN8)

Members

The PointerDevice class has these types of members:

Methods
Properties

Methods

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

Method	Description
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.

Property	Access type	Description
IsIntegrated	Read-only	Gets 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-only	Gets a value indicating the maximum number of contacts supported by the input device.
PhysicalDeviceRect	Read-only	Gets the coordinates of the bounding rectangle supported by the input device.
PointerDeviceType	Read-only	Gets the pointer device type.
ScreenRect	Read-only	Gets the screen coordinates that are mapped to the bounding rectangle supported by the input device.
SupportedUsages	Read-only	Gets 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).

Windows Phone 8

This API is not implemented and will throw an exception if called.

Examples

The following code shows how to use PointerDevice.

JavaScript


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
Namespace	Windows.Devices.Input Windows::Devices::Input [C++]
Metadata	Windows.winmd

PointerDevice class