Export (0) Print
Expand All
Expand Minimize

InkOverlay.SetSingleTabletIntegratedMode method

Applies to: desktop apps only

Allows the ink collector (InkCollector, InkOverlay, or InkPicture) to collect ink from only one tablet. Ink from other tablets is ignored by the ink collector.

Syntax

HRESULT SetSingleTabletIntegratedMode(
  [in]  IInkTablet *tablet
);

Parameters

tablet [in]

The tablet on which ink is collected, or drawn.

Return value

This method can return one of these values.

Return codeDescription
S_OK

Success.

E_POINTER

A parameter contained an invalid pointer.

E_INK_COLLECTOR_ENABLED

Cannot change modes while the collector is enabled.

E_INK_EXCEPTION

An exception occurred while processing.

E_INK_INCOMPATIBLE_OBJECT

tablet does not point to a compatible Ink object.

 

Remarks

To allow the ink collector to collect ink from all tablets, call the SetAllTabletsMode method.

Note  The ink collector object or control that collects ink must be disabled before calling this method. To disable the InkCollector object or the InkOverlay object, set the Enabled property to FALSE. To disable the InkPicture control, set the InkEnabled property to FALSE. After calling the SetSingleTabletIntegratedMode method, re-enable the object or control by setting the Enabled (or InkEnabled) property to TRUE.

When this method is called, the Cursors property of the ink collector is set to the empty collection.

Requirements

Minimum supported client

Windows XP Tablet PC Edition

Minimum supported server

None supported

Header

Msinkaut.h (also requires Msinkaut_i.c)

Library

InkObj.dll

See also

InkOverlay Class
Enabled Property
SetAllTabletsMode Method
IInkTablet Interface
InkTablets Collection

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

ADD
Show:
© 2014 Microsoft