GeneralTransform Class

Definition

Provides generalized transformation support for objects. GeneralTransform is a base class that's in the hierarchy of practical transform classes such as TranslateTransform.

public ref class GeneralTransform : DependencyObject
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class GeneralTransform : DependencyObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class GeneralTransform : DependencyObject
Public Class GeneralTransform
Inherits DependencyObject
Inheritance
Object Platform::Object IInspectable DependencyObject GeneralTransform
Derived
Attributes

Remarks

Transformation types include rotation (RotateTransform), scale (ScaleTransform), skew/shear (SkewTransform), and translation (TranslateTransform).

MatrixTransform is for transforms that don't use these conventions and instead use Matrix values for transform definition.

CompositeTransform and TransformGroup both support specifying multiple transforms for a combined transformation logic.

There's also an intermediate base class, Transform. Properties sometimes are typed as GeneralTransform or Transform so that you can use any of the practical transforms to provide values.

You can animate properties of a transform. For XAML syntaxes that take a Transform, you need to specify a nonabstract derived type of Transform as an object element. Typically, this is one of: MatrixTransform, RotateTransform, ScaleTransform, SkewTransform, or TranslateTransform. See the syntax sections on the appropriate class.

Use the MatrixTransform class to create custom transformations that are not provided by the other Transform derived classes. A two-dimensional x-y plane uses a 3x3 matrix for transformations.

GeneralTransform derived classes

GeneralTransform is the parent class for Transform. Transform is the parent class for the practical transforms.

Constructors

GeneralTransform()

Provides base class initialization behavior for GeneralTransform-derived classes.

Properties

Dispatcher

Always returns null in a Windows App SDK app. Use DispatcherQueue instead.

(Inherited from DependencyObject)
DispatcherQueue

Gets the DispatcherQueue that this object is associated with. The DispatcherQueue represents a facility that can access the DependencyObject on the UI thread even if the code is initiated by a non-UI thread.

(Inherited from DependencyObject)
Inverse

Gets the inverse transformation of this GeneralTransform, if possible.

InverseCore

Implements the behavior for return value of Inverse in a derived or custom GeneralTransform.

Methods

ClearValue(DependencyProperty)

Clears the local value of a dependency property.

(Inherited from DependencyObject)
GetAnimationBaseValue(DependencyProperty)

Returns any base value established for a dependency property, which would apply in cases where an animation is not active.

(Inherited from DependencyObject)
GetValue(DependencyProperty)

Returns the current effective value of a dependency property from a DependencyObject.

(Inherited from DependencyObject)
ReadLocalValue(DependencyProperty)

Returns the local value of a dependency property, if a local value is set.

(Inherited from DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registers a notification function for listening to changes to a specific DependencyProperty on this DependencyObject instance.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object)

Sets the local value of a dependency property on a DependencyObject.

(Inherited from DependencyObject)
TransformBounds(Rect)

Transforms the specified bounding box and returns an axis-aligned bounding box that is exactly large enough to contain it.

TransformBoundsCore(Rect)

Provides the means to override the TransformBounds behavior in a derived transform class.

TransformPoint(Point)

Uses this transformation object's logic to transform the specified point, and returns the result.

TryTransform(Point, Point)

Attempts to transform the specified point and returns a value that indicates whether the transformation was successful.

TryTransformCore(Point, Point)

Provides the means to override the TryTransform behavior in a derived transform class.

UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Cancels a change notification that was previously registered by calling RegisterPropertyChangedCallback.

(Inherited from DependencyObject)

Applies to

See also