InkPresenter.AttachVisuals(Visual, DrawingAttributes) Method

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Attaches the visual of a DynamicRenderer to an InkPresenter.

public:
 void AttachVisuals(System::Windows::Media::Visual ^ visual, System::Windows::Ink::DrawingAttributes ^ drawingAttributes);

public void AttachVisuals (System.Windows.Media.Visual visual, System.Windows.Ink.DrawingAttributes drawingAttributes);

member this.AttachVisuals : System.Windows.Media.Visual * System.Windows.Ink.DrawingAttributes -> unit

Public Sub AttachVisuals (visual As Visual, drawingAttributes As DrawingAttributes)

Parameters

visual

Visual

The visual of a DynamicRenderer.

drawingAttributes

DrawingAttributes

The DrawingAttributes that specifies the appearance of the dynamically rendered ink.

Exceptions

InvalidOperationException

visual is already attached to a visual tree.

Examples

The following example demonstrates how to attach the visual and DrawingAttributes of a DynamicRenderer to an InkPresenter.

// Create a DrawingAttributes to use for the 
// DynamicRenderer.
DrawingAttributes inkDA = new DrawingAttributes();
inkDA.Width = 5;
inkDA.Height = 5;
inkDA.Color = Colors.Purple;

// Add a dynamic renderer plugin that 
// draws ink as it "flows" from the stylus
DynamicRenderer dynamicRenderer1 = new DynamicRenderer();
dynamicRenderer1.DrawingAttributes = inkDA;

this.StylusPlugIns.Add(dynamicRenderer1);
inkPresenter1.AttachVisuals(dynamicRenderer1.RootVisual,
    dynamicRenderer1.DrawingAttributes);

' Create a DrawingAttributes to use for the 
' DynamicRenderer.
Dim inkDA As New DrawingAttributes()
inkDA.Width = 5
inkDA.Height = 5
inkDA.Color = Colors.Purple

' Add a dynamic renderer plugin that 
' draws ink as it "flows" from the stylus
Dim dynamicRenderer1 As New DynamicRenderer()
dynamicRenderer1.DrawingAttributes = inkDA

Me.StylusPlugIns.Add(dynamicRenderer1)
inkPresenter1.AttachVisuals(dynamicRenderer1.RootVisual, dynamicRenderer1.DrawingAttributes)

Remarks

Attach the visual of a DynamicRenderer to the InkPresenter to dynamically render ink on your control.