DrawingAttributes.StylusTipTransform Property

Definition

Namespace:

System.Windows.Ink

Assembly:

PresentationCore.dll

Gets or sets the Matrix that specifies the transformation to perform on the stylus' tip.

public:
 property System::Windows::Media::Matrix StylusTipTransform { System::Windows::Media::Matrix get(); void set(System::Windows::Media::Matrix value); };

public System.Windows.Media.Matrix StylusTipTransform { get; set; }

member this.StylusTipTransform : System.Windows.Media.Matrix with get, set

Public Property StylusTipTransform As Matrix

Property Value

Matrix

A Matrix that specifies the transformation to perform on the stylus' tip.

Exceptions

ArgumentException

The matrix set to StylusTipTransform is not an invertible matrix.

-or-

The OffsetX or OffsetY property of the matrix is not zero.

Examples

The following example demonstrates how to set the StylusTipTransform 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

Use the StylusTipTransform property to rotate, skew, or scale the stylus tip.

XAML Text Usage

This property is not typically used in XAML.