InkPicture.MarginY property
Gets or sets the y-axis margin around the window rectangle, in screen coordinates.
This margin provides a buffer around the edge of the ink window.
This property is read/write.
Syntax
HRESULT put_MarginY( [in] long MarginY ); HRESULT get_MarginY( [out, retval] long *MarginY );
Property value
The y-axis margin around the window rectangle, in screen coordinates.
Error codes
| Name | Meaning |
|---|---|
|
Success. |
|
The MarginY parameter is an invalid pointer. |
|
Cannot change modes while the collector is enabled. |
|
An exception occurred while processing. |
Remarks
This property is most commonly used with nonintegrated tablet devices-the buffer gives users a margin of error when writing on a device that may not map 1 to 1 with the screen.
The margin is specified in screen coordinates. A positive margin extends outside the context, a negative margin extends inside the context, and a value of zero produces no margin. Ink is collected if the stroke starts within the margin. This behavior does not clip the ink. The context of the object or control is either the window input rectangle from the GetWindowInputRectangle method or the client rectangle for the window.
The margin is effective only within the application's window. If the pen is applied outside the application's window, then the application loses focus and cannot collect ink.
Requirements
|
Minimum supported client |
Windows XP Tablet PC Edition [desktop apps only] |
|---|---|
|
Minimum supported server |
None supported |
|
Header |
|
|
Library |
|
See also