InkCollector.SetAllTabletsMode Method (Boolean)

Article
12/12/2007

Sets the InkCollector object to collect ink from any tablet attached to the Tablet PC, and optionally the mouse.

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

Syntax

'Declaration
Public Sub SetAllTabletsMode ( _
    useMouseForInput As Boolean _
)
'Usage
Dim instance As InkCollector
Dim useMouseForInput As Boolean

instance.SetAllTabletsMode(useMouseForInput)

public void SetAllTabletsMode (
    bool useMouseForInput
)

public:
void SetAllTabletsMode (
    bool useMouseForInput
)

public void SetAllTabletsMode (
    boolean useMouseForInput
)

public function SetAllTabletsMode (
    useMouseForInput : boolean
)

Not applicable.

Parameters

useMouseForInput
The Boolean value that indicates whether to use the mouse as an input device.

true if in addition to the pen, the mouse is used for input.

false if the mouse cannot be used for input.

Remarks

This is the default mode for an InkCollector object. To allow the InkCollector object to collect ink from only one tablet, call the SetSingleTabletIntegratedMode method.

Note

The InkCollector object must be disabled before calling this method. To disable the InkCollector, set the Enabled property to false. After calling the SetAllTabletsMode method, enable the InkCollector by setting the Enabled property to true.

When an InkCollector object switches from collecting ink by using a single tablet to collecting ink by using all tablets, the Cursors property is set to the empty collection.

Note

If the SetAllTabletsMode method is called with the useMouseForInput parameter set to true (or no parameters), then the mouse is used as an input device. If the SetAllTabletsMode method is then called with the useMouseForInput parameter set to false, the mouse is not removed from the Cursors property.

Example

This C# example calls SetAllTabletsMode on a new InkCollector object, theInkCollector, with the useMouseForInput parameter set to false if more than one tablet is available.

using Microsoft.Ink;
// . . .
Tablets theTablets = new Tablets();
InkCollector theInkCollector = new InkCollector();
if (theTablets.Count > 1)
theInkCollector.SetAllTabletsMode(false);
else
theInkCollector.SetAllTabletsMode();

This Microsoft Visual Basic .NET example calls SetAllTabletsMode on a new InkCollector object, theInkCollector, with the useMouseForInput parameter set to false if more than one tablet is available.

Imports Microsoft.Ink
' . . .
Dim theTablets As New Tablets()
Dim theInkCollector As New InkCollector()
If theTablets.Count > 1 Then
theInkCollector.SetAllTabletsMode(False)
Else
theInkCollector.SetAllTabletsMode()
End If

Platforms

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0

Share via