GeneralTransform GeneralTransform GeneralTransform Class

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

Syntax

Declaration

public class GeneralTransformpublic class GeneralTransformPublic Class GeneralTransform

Inheritance Hierarchy

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 summary

Provides base class initialization behavior for GeneralTransform -derived classes.

Properties summary

Gets the inverse transformation of this GeneralTransform, if possible.

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

Methods summary

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

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

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

Provides the means to override the TransformBounds(Windows.Foundation.Rect) behavior in a derived transform class.

Provides the means to override the TryTransform(Windows.Foundation.Point,Windows.Foundation.Point) behavior in a derived transform class.

Constructors

  • GeneralTransform()
    GeneralTransform()
    GeneralTransform()
    GeneralTransform()

    Provides base class initialization behavior for GeneralTransform -derived classes.

    protected GeneralTransform()protected GeneralTransform()Protected Function GeneralTransform() As

Properties

  • Inverse
    Inverse
    Inverse
    Inverse

    Gets the inverse transformation of this GeneralTransform, if possible.

    public GeneralTransform Inverse { get; }public GeneralTransform Inverse { get; }Public ReadOnly Property Inverse As GeneralTransform

    Property Value

  • InverseCore
    InverseCore
    InverseCore
    InverseCore

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

    protected virtual GeneralTransform InverseCore { get; }protected virtual GeneralTransform InverseCore { get; }Protected Overridable ReadOnly Property InverseCore As GeneralTransform

    Property Value

Methods

  • TransformBounds(Windows.Foundation.Rect)
    TransformBounds(Windows.Foundation.Rect)
    TransformBounds(Windows.Foundation.Rect)
    TransformBounds(Windows.Foundation.Rect)

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

    public Rect TransformBounds(Windows.Foundation.Rect rect)public Rect TransformBounds(Windows.Foundation.Rect rect)Public Function TransformBounds(rect As Windows.Foundation.Rect) As Rect

    Parameters

    Returns

    • The smallest axis-aligned bounding box possible that contains the transformed rect.

  • TransformPoint(Windows.Foundation.Point)
    TransformPoint(Windows.Foundation.Point)
    TransformPoint(Windows.Foundation.Point)
    TransformPoint(Windows.Foundation.Point)

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

    public Point TransformPoint(Windows.Foundation.Point point)public Point TransformPoint(Windows.Foundation.Point point)Public Function TransformPoint(point As Windows.Foundation.Point) As Point

    Parameters

    • point

      The point to transform using the transformation logic.

    Returns

    Remarks

    The purpose of transformations is to convert data in coordinate systems to new frames of reference for a different coordinate system. Call this method to use the logic of this specific Transform derived class in order to convert a Point of the initial coordinate system into a Point in the coordinate system as it's interpreted by the transformation.

  • TryTransform(Windows.Foundation.Point,Windows.Foundation.Point)
    TryTransform(Windows.Foundation.Point,Windows.Foundation.Point)
    TryTransform(Windows.Foundation.Point,Windows.Foundation.Point)
    TryTransform(Windows.Foundation.Point,Windows.Foundation.Point)

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

    public bool TryTransform(Windows.Foundation.Point inPoint,Windows.Foundation.Point outPoint)public bool TryTransform(Windows.Foundation.Point inPoint,Windows.Foundation.Point outPoint)Public Function TryTransform(inPoint As Windows.Foundation.Point,outPoint As Windows.Foundation.Point) As bool

    Parameters

    Returns

    • bool
      bool
      bool

      true if inPoint was transformed; otherwise, false.

  • TransformBoundsCore(Windows.Foundation.Rect)
    TransformBoundsCore(Windows.Foundation.Rect)
    TransformBoundsCore(Windows.Foundation.Rect)
    TransformBoundsCore(Windows.Foundation.Rect)

    Provides the means to override the TransformBounds(Windows.Foundation.Rect) behavior in a derived transform class.

    protected virtual Rect TransformBoundsCore(Windows.Foundation.Rect rect)protected virtual Rect TransformBoundsCore(Windows.Foundation.Rect rect)Protected Overridable Function TransformBoundsCore(rect As Windows.Foundation.Rect) As Rect

    Parameters

    Returns

    • The smallest axis-aligned bounding box possible that contains the transformed rect.

  • TryTransformCore(Windows.Foundation.Point,Windows.Foundation.Point)
    TryTransformCore(Windows.Foundation.Point,Windows.Foundation.Point)
    TryTransformCore(Windows.Foundation.Point,Windows.Foundation.Point)
    TryTransformCore(Windows.Foundation.Point,Windows.Foundation.Point)

    Provides the means to override the TryTransform(Windows.Foundation.Point,Windows.Foundation.Point) behavior in a derived transform class.

    protected virtual bool TryTransformCore(Windows.Foundation.Point inPoint,Windows.Foundation.Point outPoint)protected virtual bool TryTransformCore(Windows.Foundation.Point inPoint,Windows.Foundation.Point outPoint)Protected Overridable Function TryTransformCore(inPoint As Windows.Foundation.Point,outPoint As Windows.Foundation.Point) As bool

    Parameters

    Returns

    • bool
      bool
      bool

      true if inPoint was transformed; otherwise, false.

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.MarshalingBehaviorAttribute
Windows.Foundation.Metadata.ThreadingAttribute
Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.ComposableAttribute
Windows.Foundation.Metadata.WebHostHiddenAttribute

Details

Assembly

Windows.UI.Xaml.Media.dll