Adorner.GetDesiredTransform Method (GeneralTransform)


Returns a Transform for the adorner, based on the transform that is currently applied to the adorned element.

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

public virtual GeneralTransform GetDesiredTransform(
	GeneralTransform transform


Type: System.Windows.Media.GeneralTransform

The transform that is currently applied to the adorned element.

Return Value

Type: System.Windows.Media.GeneralTransform

A transform to apply to the adorner.

An adorner may need to be transformed differently than the element it decorates. For instance, adorners which act like points, such as resize handles, should be translated and rotated along with the adorned element, but not scaled. By contrast, an adorner that displays a marquee on an element might require the same transform as the adorned element.

This method is called by the associated AdornerLayer to provide an opportunity to filter unwanted or unneeded transforms. Implementations of this method should examine the incoming transform (which is the transform for the adorned element) and remove aspects that are not useful or should not be applied to the adorner itself. This method can also be used to add additional transform details at this time, for instance adding a translation that enables the adorner to control its position relative to the adorned element.

.NET Framework
Available since 3.0
Return to top