Export (0) Print
Expand All

Point3D Structure

Represents an x-, y-, and z-coordinate point in 3-D space.

Namespace:  System.Windows.Media.Media3D
Assembly:  PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[SerializableAttribute]
[TypeConverterAttribute(typeof(Point3DConverter))]
public value class Point3D : IFormattable
<object property="x,y,z"/>
-or
<object property="x y z"/>

XAML Values

x

The x-coordinate of this Point3D.

y

The y-coordinate of this Point3D.

z

The z-coordinate of this Point3D.

The Point3D type exposes the following members.

  NameDescription
Public methodPoint3DInitializes a new instance of the Point3D structure.
Top

  NameDescription
Public propertyXGets or sets the x-coordinate of this Point3D structure.
Public propertyYGets or sets the y-coordinate of this Point3D structure.
Public propertyZGets or sets the z-coordinate of this Point3D structure.
Top

  NameDescription
Public methodStatic memberAddAdds a Point3D structure to a Vector3D and returns the result as a Point3D structure.
Public methodEquals(Object)Determines whether the specified object is a Point3D structure and if so, whether the X, Y, and Z properties of the specified Object are equal to the X, Y, and Z properties of this Point3D structure. (Overrides ValueType::Equals(Object).)
Public methodEquals(Point3D)Compares two Point3D structures for equality.
Public methodStatic memberEquals(Point3D, Point3D)Compares two Point3D structures for equality.
Public methodGetHashCodeReturns a hash code for this Point3D structure. (Overrides ValueType::GetHashCode().)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodStatic memberMultiplyTransforms the specified Point3D structure by the specified Matrix3D structure.
Public methodOffsetTranslates the Point3D structure by the specified amounts.
Public methodStatic memberParseConverts a String representation of a 3-D point into the equivalent Point3D structure.
Public methodStatic memberSubtract(Point3D, Point3D)Subtracts a Point3D structure from a Point3D structure and returns the result as a Vector3D structure.
Public methodStatic memberSubtract(Point3D, Vector3D)Subtracts a Vector3D structure from a Point3D structure and returns the result as a Point3D structure.
Public methodToString()Creates a String representation of this Point3D structure. (Overrides ValueType::ToString().)
Public methodToString(IFormatProvider)Creates a String representation of this Point3D structure.
Top

  NameDescription
Public operatorStatic memberAdditionAdds a Point3D structure to a Vector3D and returns the result as a Point3D structure.
Public operatorStatic memberEqualityCompares two Point3D structures for equality.
Public operatorStatic memberExplicit(Point3D to Point4D)Converts a Point3D structure into a Point4D structure.
Public operatorStatic memberExplicit(Point3D to Vector3D)Converts a Point3D structure into a Vector3D structure.
Public operatorStatic memberInequalityCompares two Point3D structures for inequality.
Public operatorStatic memberMultiplyTransforms the specified Point3D structure by the specified Matrix3D structure.
Public operatorStatic memberSubtraction(Point3D, Point3D)Subtracts a Point3D structure from a Point3D structure and returns the result as a Vector3D structure.
Public operatorStatic memberSubtraction(Point3D, Vector3D)Subtracts a Vector3D structure from a Point3D structure and returns the result as a Point3D structure.
Top

  NameDescription
Explicit interface implemetationPrivate methodIFormattable::ToStringThis member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code. For a description of this member, see ToString.
Top

In XAML, the delimiter between the values of a Point3D can be either a comma or a space.

Some cultures might use the comma character as the decimal delimiter instead of the period character. XAML processing for invariant culture defaults to en-US in most XAML processor implementations, and expects the period to be the decimal delimiter. You should avoid using the comma character as the decimal delimiter if specifying a Point3D in XAML, because that will clash with the string type conversion of a Point3D attribute value into its components.

This example shows how to subtract Point3D structures and Vector3D structures using the overloaded subtraction (-) operator and the Point3D static Subtract method.

The following code illustrates how to use the Point3D subtraction methods. First, the Point3D structures and the Vector3D structures are instantiated. The Point3D structures are subtracted using the overloaded subtraction (-) operator and then they are subtracted using the static Subtract method. Next, the Vector3D structure is subtracted from the first Point3D structure using the static Subtract method, and finally the Point3D structure is subtract from the Vector3D using the overloaded subtraction (-) operator.

// instantiate variables
Point3D point1 = new Point3D();
Point3D point2 = new Point3D(15, 40, 60);
Vector3D vector1 = new Vector3D(20, 30, 40);
Point3D pointResult1 = new Point3D();
Point3D pointResult2 = new Point3D();
Vector3D vectorResult1 = new Vector3D();
Vector3D vectorResult2 = new Vector3D();

// defining x,y,z of point1
point1.X = 10;
point1.Y = 5;
point1.Z = 1;

vectorResult1 = Point3D.Subtract(point1, point2);
// vectorResult1 is equal to (-5, -35, -59)

vectorResult2 = point2 - point1;
// vectorResult2 is equal to (5, 35, 59)

pointResult1 = Point3D.Subtract(point1, vector1);
//  pointResult1 is equal to (-10, -25, -39)

pointResult2 = vector1 - point1;
//  pointResult2 is equal to (10, 25, 39)

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft