Tablet.PlugAndPlayId Property

Article
10/19/2012

Gets a string representation of the Plug and Play identifier of the Tablet object.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public ReadOnly Property PlugAndPlayId As String
'Usage
Dim instance As Tablet 
Dim value As String 

value = instance.PlugAndPlayId

public string PlugAndPlayId { get; }

public:
property String^ PlugAndPlayId {
    String^ get ();
}

public function get PlugAndPlayId () : String

Property Value

Type: System.String
The Plug and Play identifier of the Tablet object.

Remarks

The return value is based upon the HIDD_ATTRIBUTES.ProductID element. The manufacturer of the tablet device is responsible for adding this string. The return value is empty if the tablet device does not have an identifier.

Note

This function can be re-entered if called within certain message handlers, causing unexpected results. Take care to avoid a reentrant call when handling any of the following messages: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND if wParam is set to SC_HOTKEY or SC_TASKLIST; and WM_SYSKEYDOWN (when processing Alt-Tab or Alt-Esc key combinations). This is an issue with single-threaded apartment model applications.

Examples

This example reports on the Plug and Play ID, the hardware capabilities and the maximum input rectangle of the default Tablet object in the Tablets collection.

Public Function Report_Hardware_DefaultTablet() As String 
    Dim SB As StringBuilder = New StringBuilder(1024)
    Dim defTablet As Tablet = New Tablets().DefaultTablet

    ' report on the hardware capabilities of the default tablet
    SB.AppendLine("Hardware capabilities of the default tablet: " + defTablet.Name)
    SB.AppendLine("PlugAndPlayId: " + defTablet.PlugAndPlayId)

    If (defTablet.HardwareCapabilities And TabletHardwareCapabilities.CursorMustTouch) <> 0 Then
        SB.AppendLine("CursorMustTouch: YES")
    Else
        SB.AppendLine("CursorMustTouch: NO")
    End If 

    If (defTablet.HardwareCapabilities And TabletHardwareCapabilities.CursorsHavePhysicalIds) <> 0 Then
        SB.AppendLine("CursorsHavePhysicalIds: YES")
    Else
        SB.AppendLine("CursorsHavePhysicalIds: NO")
    End If 

    If (defTablet.HardwareCapabilities And TabletHardwareCapabilities.HardProximity) <> 0 Then
        SB.AppendLine("HardProximity:: YES")
    Else
        SB.AppendLine("HardProximity:: NO")
    End If 

    If (defTablet.HardwareCapabilities And TabletHardwareCapabilities.Integrated) <> 0 Then
        SB.AppendLine("Integrated: YES")
    Else
        SB.AppendLine("Integrated: NO")
    End If

    SB.AppendLine("MaximumInputRectangle " + defTablet.MaximumInputRectangle.ToString())

    Return SB.ToString()
End Function

public string Report_Hardware_DefaultTablet()
{
    StringBuilder SB = new StringBuilder(1024);
    Tablet defTablet = new Tablets().DefaultTablet;

    // report on the hardware capabilities of the default tablet
    SB.AppendLine("Hardware capabilities of the default tablet: " + defTablet.Name);
    SB.AppendLine("PlugAndPlayId: " + defTablet.PlugAndPlayId);

    SB.AppendLine("CursorMustTouch: " +
        (((defTablet.HardwareCapabilities & TabletHardwareCapabilities.CursorMustTouch) != 0) ? "YES" : "NO"));

    SB.AppendLine("CursorsHavePhysicalIds: " +
        (((defTablet.HardwareCapabilities & TabletHardwareCapabilities.CursorsHavePhysicalIds) != 0) ? "YES" : "NO"));

    SB.AppendLine("HardProximity: " +
        (((defTablet.HardwareCapabilities & TabletHardwareCapabilities.HardProximity) != 0) ? "YES" : "NO"));

    SB.AppendLine("Integrated: " +
        (((defTablet.HardwareCapabilities & TabletHardwareCapabilities.Integrated) != 0) ? "YES" : "NO"));

    SB.AppendLine("MaximumInputRectangle " + defTablet.MaximumInputRectangle.ToString());

    return SB.ToString();
}

Platforms

Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008

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

Version Information

.NET Framework

Supported in: 3.0

Share via