IRealTimeStylus::WindowInputRectangle property

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 [desktop apps only]

Minimum supported server

None supported

Header

RTSCom.h (also requires RTSCom_i.c)

DLL

RTSCom.dll

See also

IRealTimeStylus
RealTimeStylus Reference
RealTimeStylus Class

 

 

Show: