Visual3D.TransformToAncestor Method

Definition

Namespace:

System.Windows.Media.Media3D

Assembly:

PresentationCore.dll

Returns a transform that can be used to transform coordinates from this object to the specified ancestor of the object.

Overloads

TransformToAncestor(Visual3D)	Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual3D ancestor of the object.
TransformToAncestor(Visual)	Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual ancestor of the object.

Remarks

TransformToAncestor is introduced in .NET Framework version 3.5. For more information, see Versions and Dependencies.

TransformToAncestor(Visual3D)

Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual3D ancestor of the object.

public:
 System::Windows::Media::Media3D::GeneralTransform3D ^ TransformToAncestor(System::Windows::Media::Media3D::Visual3D ^ ancestor);

public System.Windows.Media.Media3D.GeneralTransform3D TransformToAncestor (System.Windows.Media.Media3D.Visual3D ancestor);

member this.TransformToAncestor : System.Windows.Media.Media3D.Visual3D -> System.Windows.Media.Media3D.GeneralTransform3D

Public Function TransformToAncestor (ancestor As Visual3D) As GeneralTransform3D

Parameters

ancestor

Visual3D

The Visual3D to which the coordinates are transformed.

Returns

GeneralTransform3D

A GeneralTransform3D object; or null, if the transform cannot be created.

Exceptions

ArgumentNullException

ancestor is null.

ArgumentException

The specified ancestor object is not an ancestor of this object.

InvalidOperationException

The Visual3D objects are not related.

Remarks

The TransformToAncestor method is introduced in .NET Framework version 3.5. For more information, see Versions and Dependencies.

TransformToAncestor(Visual)

Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual ancestor of the object.

public:
 System::Windows::Media::Media3D::GeneralTransform3DTo2D ^ TransformToAncestor(System::Windows::Media::Visual ^ ancestor);

public System.Windows.Media.Media3D.GeneralTransform3DTo2D TransformToAncestor (System.Windows.Media.Visual ancestor);

member this.TransformToAncestor : System.Windows.Media.Visual -> System.Windows.Media.Media3D.GeneralTransform3DTo2D

Public Function TransformToAncestor (ancestor As Visual) As GeneralTransform3DTo2D

Parameters

ancestor

Visual

The Visual to which the coordinates are transformed.

Returns

GeneralTransform3DTo2D

A GeneralTransform3DTo2D object; or null, if the transform cannot be created.

Exceptions

ArgumentNullException

ancestor is null.

ArgumentException

The specified ancestor object is not an ancestor of this object.

Remarks

This transform projects a 3-D point to a 2-D space. The resulting point is the transformed 3-D point in the coordinate space of the specified ancestor.

The TransformToAncestor method is introduced in .NET Framework version 3.5. For more information, see Versions and Dependencies.