Offset Method
Collapse the table of content
Expand the table of content

Point3D.Offset Method (Double, Double, Double)

 

Translates the Point3D structure by the specified amounts.

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

public void Offset(
	double offsetX,
	double offsetY,
	double offsetZ
)

Parameters

offsetX
Type: System.Double

The amount to change the X coordinate of this Point3D structure.

offsetY
Type: System.Double

The amount to change the Y coordinate of this Point3D structure.

offsetZ
Type: System.Double

The amount to change the Z coordinate of this Point3D structure.

This operation is equivalent to adding a Vector3D structure to a Point3D structure with the corresponding X, Y, and Z values.

Note that calling the Offset method will only have an effect if you can change the X, Y, and Z properties directly. Because Point3D is a value type, if you reference a Point3D object by using a property or indexer, you get a copy of the object, not a reference to the object. If you attempt to change X, Y, or Z on a property or indexer reference, a compiler error occurs. Similarly, calling Offset on the property or indexer will not change the underlying object.  If you want to change the value of a Point3D that is referenced as a property or indexer, create a new Point3D, modify its fields, and then assign the Point3D back to the property or indexer. 

The following example shows how to offset a Point3D structure.

                  // Offsets the X, Y and Z values of a Point3D.

                  Point3D point1 = new Point3D(10, 5, 1);

                  point1.Offset(20, 30, 40);
                  // point1 is equal to (30, 35, 41)

                  // Note: This operation is equivalent to adding a point 
                  // to vector with the corresponding X,Y, Z values.

                  // Displaying Results
                  syntaxString = "point1.Offset(20, 30, 40);";
                  resultType = "Point3D";
operationString = "Offsetting a Point3D";
ShowResults(point1.ToString(), syntaxString, resultType, operationString);

.NET Framework
Available since 3.0
Return to top
Show:
© 2016 Microsoft