Export (0) Print
Expand All

IRealTimeStylus::WindowInputRectangle property

Applies to: desktop apps only

Gets or sets the window input rectangle for the RealTimeStylus Class object.

This property is read/write.

Syntax

HRESULT put_WindowInputRectangle(
  [in]           const RECT *prcWndInputRect
);

HRESULT get_WindowInputRectangle(
  [out, retval]  RECT *prcWndInputRect
);

Property value

The pointer that specifies the handle value, in pixels, for the window input rectangle associated with this RealTimeStylus Class object.

The default value is an empty rectangle ({0, 0, 0, 0}).

Error codes

For a description of the return values, see RealTimeStylus Classes and Interfaces.

Remarks

Each RealTimeStylus Class object receives tablet pen data for specific section of a window based on the defined window input rectangle for that RealTimeStylus Class object.

The default value is an empty window input rectangle, IRealTimeStylus::WindowInputRectangle Property, value. When the IRealTimeStylus::WindowInputRectangle Property value is empty, {0, 0, 0, 0}, the RealTimeStylus Class object collects pen input over the entire window, even after the window is resized.

After the RealTimeStylus Class object starts collecting pen data, it continues to collect the data until the pen is raised, even if the pen is moved outside of the input region.

Use either an attached IStylusSyncPlugin object or the attached IStylusAsyncPlugin object to uniquely handle pen data that is collected outside of the input region.

The E_INVALIDOPERATION HRESULT is returned when you attempt to set this property on a child RealTimeStylus Class object.

Requirements

Minimum supported client

Windows XP Tablet PC Edition

Minimum supported server

None supported

Header

RTSCom.h (also requires RTSCom_i.c)

DLL

RTSCom.dll

See also

IRealTimeStylus
RealTimeStylus Reference
RealTimeStylus Class

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

ADD
Show:
© 2014 Microsoft