Adorner.GetDesiredTransform(GeneralTransform) Method

Definition

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

public:
 virtual System::Windows::Media::GeneralTransform ^ GetDesiredTransform(System::Windows::Media::GeneralTransform ^ transform);
public virtual System.Windows.Media.GeneralTransform GetDesiredTransform (System.Windows.Media.GeneralTransform transform);
abstract member GetDesiredTransform : System.Windows.Media.GeneralTransform -> System.Windows.Media.GeneralTransform
override this.GetDesiredTransform : System.Windows.Media.GeneralTransform -> System.Windows.Media.GeneralTransform
Public Overridable Function GetDesiredTransform (transform As GeneralTransform) As GeneralTransform

Parameters

transform
GeneralTransform

The transform that is currently applied to the adorned element.

Returns

A transform to apply to the adorner.

Remarks

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.

Applies to