This documentation is archived and is not being maintained.

Visual3D::TransformToAncestor Method (Visual)

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

Namespace:  System.Windows.Media.Media3D
Assembly:  PresentationCore (in PresentationCore.dll)

public:
GeneralTransform3DTo2D^ TransformToAncestor(
	Visual^ ancestor
)

Parameters

ancestor
Type: System.Windows.Media::Visual
The Visual to which the coordinates are transformed.

Return Value

Type: System.Windows.Media.Media3D::GeneralTransform3DTo2D
A GeneralTransform3DTo2D object; or nullptr, if the transform cannot be created.

ExceptionCondition
ArgumentNullException

ancestor is nullptr.

ArgumentException

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

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 .NET Framework Versions and Dependencies.

.NET Framework

Supported in: 4, 3.5 SP1, 3.0 SP1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: