Point3D.Offset(Double, Double, Double) Methode

Definition

Verschiebt die Point3D-Struktur um den angegebenen Betrag.

public:
 void Offset(double offsetX, double offsetY, double offsetZ);
public void Offset (double offsetX, double offsetY, double offsetZ);
member this.Offset : double * double * double -> unit
Public Sub Offset (offsetX As Double, offsetY As Double, offsetZ As Double)

Parameter

offsetX
Double

Der Änderungsbetrag für die X-Koordinate der Point3D-Struktur.

offsetY
Double

Der Änderungsbetrag für die Y-Koordinate der Point3D-Struktur.

offsetZ
Double

Der Änderungsbetrag für die Z-Koordinate der Point3D-Struktur.

Beispiele

Das folgende Beispiel zeigt, wie eine Point3D -Struktur versetzt wird.

// 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);
' Offsets the X, Y and Z values of a Point3D.

Dim point1 As 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)

Hinweise

Dieser Vorgang entspricht dem Hinzufügen einer Vector3D -Struktur zu einer Point3D -Struktur mit den entsprechenden XWerten , Yund Z .

Beachten Sie, dass das Aufrufen der Offset -Methode nur dann Auswirkungen hat, wenn Sie die XEigenschaften , Yund Z direkt ändern können. Da Point3D ein Werttyp ist. Wenn Sie mithilfe einer Eigenschaft oder eines Indexers auf ein Point3D Objekt verweisen, erhalten Sie eine Kopie des Objekts und keinen Verweis auf das Objekt. Wenn Sie versuchen, , Yoder Z für einen Eigenschafts- oder Indexerverweis zu ändernX, tritt ein Compilerfehler auf. Ebenso ändert das Aufrufen Offset der Eigenschaft oder des Indexers das zugrunde liegende Objekt nicht. Wenn Sie den Wert einer Point3D ändern möchten, auf die als Eigenschaft oder Indexer verwiesen wird, erstellen Sie einen neuen Point3D, ändern Sie dessen Felder, und weisen Sie dann der Eigenschaft oder dem Indexer zurück Point3D zu.

Gilt für: