Export (0) Print
Expand All

InkPresenter.DetachVisuals Method

Detaches the visual of the DynamicRenderer from the InkPresenter.

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

public void DetachVisuals(
	Visual visual
)

Parameters

visual
Type: System.Windows.Media.Visual

The visual of the DynamicRenderer to detach.

ExceptionCondition
InvalidOperationException

visual is not attached to the InkPresenter.

When the DrawingAttributes on a custom control changes, the visual of the DynamicRenderer must be re-attached to the InkPresenter. Call the DetachVisuals and AttachVisuals methods to re-attach the visual to the InkPresenter.

The following example re-attaches the visual of a DynamicRenderer to the InkPresenter whenever the DrawingAttributes on the changes. This example assumes that the AttributeChanged event is attached to the event handler.

void DrawingAttributesChanged(object sender, PropertyDataChangedEventArgs e)
{
    // Reattach the visual of the DynamicRenderer to the InkPresenter  
    // whenever the DrawingAttributes change.
    presenter.DetachVisuals(renderer.RootVisual);
    presenter.AttachVisuals(renderer.RootVisual, renderer.DrawingAttributes);

}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft