WindowInputRectangle Property

IRealTimeStylus::WindowInputRectangle property

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

This property is read/write.


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.


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.


Minimum supported client

Windows XP Tablet PC Edition [desktop apps only]

Minimum supported server

None supported


RTSCom.h (also requires RTSCom_i.c)



See also

RealTimeStylus Reference
RealTimeStylus Class



Community Additions

© 2015 Microsoft