DrawingAttributes.Height Property

Definition

Namespace:

System.Windows.Ink

Assembly:

PresentationCore.dll

Gets or sets the height of the stylus used to draw the Stroke.

public:
 property double Height { double get(); void set(double value); };

public double Height { get; set; }

member this.Height : double with get, set

Public Property Height As Double

Property Value

Double

The value that indicates the height of the stylus used to draw the Stroke.

Exceptions

ArgumentOutOfRangeException

The Height property is less than Epsilon or NaN.

Examples

The following example demonstrates how to set the Height property. The example assumes that your application has an InkCanvas called inkCanvas1, and two DrawingAttributes objects called inkDA and highlighterDA. For the complete example, see the DrawingAttributes class overview.

// Set up the DrawingAttributes for the pen.
inkDA = new DrawingAttributes();
inkDA.Color = Colors.SpringGreen;
inkDA.Height = 5;
inkDA.Width = 5;
inkDA.FitToCurve = false;
inkDA.StylusTipTransform = new Matrix(1, 0, 0, 5, 0, 0);

// Set up the DrawingAttributes for the highlighter.
highlighterDA = new DrawingAttributes();
highlighterDA.Color = Colors.Orchid;
highlighterDA.IsHighlighter = true;
highlighterDA.IgnorePressure = true;
highlighterDA.StylusTip = StylusTip.Rectangle;
highlighterDA.Height = 30;
highlighterDA.Width = 10;

inkCanvas1.DefaultDrawingAttributes = inkDA;

' Set up the DrawingAttributes for the pen.
inkDA = New Ink.DrawingAttributes()
With inkDA
    .Color = Colors.SpringGreen
    .Height = 5
    .Width = 5
    .FitToCurve = True
    .StylusTipTransform = New Matrix(1, 0, 0, 1, 20, 0)
End With

' Set up the DrawingAttributes for the highlighter.
highlighterDA = New Ink.DrawingAttributes()
With highlighterDA
    .Color = Colors.Orchid
    .IsHighlighter = True
    .IgnorePressure = True
    .StylusTip = StylusTip.Rectangle
    .Height = 30
    .Width = 10
End With

inkCanvas1.DefaultDrawingAttributes = inkDA

Remarks

The following factors affect the height and width of a Stroke when it is rendered, but not the value of the Height property.

• The amount of pressure applied to the stylus when the Stroke is drawn.

• The value of the StylusTipTransform property.

If you set the Height property to 0 device independent pixels (DIP), it is changed to 2 DIP.

XAML Text Usage

This property is not typically used in XAML.