IInkTablets::get_DefaultTablet method (msinkaut.h)

Article
05/12/2021

Gets the default tablet within the set of available tablets.

This property is read-only.

Syntax

HRESULT get_DefaultTablet(
  IInkTablet **DefaultTablet
);

Parameters

DefaultTablet

Return value

None

Remarks

The platform determines the default IInkTablet object in the following order:

If the system has a digitizer integrated with the display device, this integrated digitizer is considered the default tablet, even if other digitizing tablets are installed.
If more than one digitizing tablet is installed in the system, the first one encountered during initialization is considered the default tablet.
If only one digitizing tablet is installed in the system, it is considered the default tablet.
If no digitizing tablets are installed in the system but there are other pointing devices (such as a mouse or a touch pad) installed that generate mouse messages, those devices in aggregate are considered to be the default tablet.
If no digitizing tablets and no pointing devices are installed in the system, no default tablet can be returned.

Note Accessing this property within certain message handlers can result in the underlying function being re-entered, 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.

Requirements

Requirement	Value
Minimum supported client	Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	msinkaut.h
Library	InkObj.dll