InkDrawingAttributes.Width property

Gets or sets the y-axis dimension, or width, of the pen tip when drawing ink.

This property is read/write.

Syntax


HRESULT put_Width(
  [in]          float NewWidth
);

HRESULT get_Width(
  [out, retval] float *CurrentWidth
);

Property value

The y-axis dimension, or width, of the pen tip when drawing ink.

Error codes

NameMeaning
S_OK

Success.

E_POINTER

Parameter pointer is NULL or invalid.

E_INK_EXCEPTION

An exception occurred inside the method.

E_INVALIDARG

The width of the pen is less than 0.

E_UNEXPECTED

Unexpected parameter or property type.

Remarks

If the tablet reports pen pressure (if the IgnorePressure property is false), the actual width of the ink varies depending on the amount of pressure applied to the drawing surface. When maximum pressure is applied, the width is 150% of the value of the Width property. When minimum pressure is applied, the width is 50% of the value of the Width property. By default, this property is set to true, so that pressure from the pen is reported. To specify that pressure should not be reported (that the width of ink does not change), set the IgnorePressure property to true.

Precision is limited to one one-thousandth of a HIMETRIC unit (three digits to the right of the decimal point). For example, if you specify a value of 2.0006, the most precise measurement is 2.001.

Requirements

Minimum supported client

Windows XP Tablet PC Edition [desktop apps only]

Minimum supported server

None supported

Header

Msinkaut.h (also requires Msinkaut_i.c)

Library

InkObj.dll

See also

InkDrawingAttributes Class
Height Property [InkDrawingAttributes Class]
IgnorePressure Property
PenTip Property

 

 

Show: