SolidWorksMakroprogrammierung

Methode · Entity

GetDistance-Methode (Entity)

Ermittelt den kleinsten oder größten Abstand zwischen diesem Element und einer anderen Fläche oder Kante.

Syntax

Function GetDistance( _
   ByVal BaseEntity As Object, _
   ByVal MinDistance As Boolean, _
   ByVal Parameter As Variant, _
   ByRef Position1 As Variant, _
   ByRef Position2 As Variant, _
   ByRef Distance As Double _
) As Long
nFehler = swEnt.GetDistance(swEnt2, True, vParam, vPunkt1, vPunkt2, dAbstand)

Parameter

BaseEntityObjectByVal
Die andere Fläche oder Kante, als Entity.
MinDistanceBooleanByVal
True für den kleinsten, False für den größten Abstand.
ParameterVariantByVal
Der Parameterbereich des anderen Elements: bei einer Kante ein Array mit zwei Werten (Min, Max) für U, bei einer Fläche ein Array mit vier Werten (UMin, VMin, UMax, VMax). Beim größten Abstand ist er nötig, beim kleinsten kannst du ihn weglassen (Empty).
Position1VariantByRef · Rückgabe
Rückgabe: Array mit den Koordinaten des Punkts auf diesem Element, an dem gemessen wurde.
Position2VariantByRef · Rückgabe
Rückgabe: Array mit den Koordinaten des Punkts auf dem anderen Element.
DistanceDoubleByRef · Rückgabe
Rückgabe: der Abstand in Metern.

Rückgabewert

0 bei Erfolg, -1 bei einem Fehler.

Beispiel

' swSelMgr ist der Auswahl-Manager (SelectionMgr), zwei Flächen oder Kanten sind ausgewählt.
Dim swEnt As SldWorks.Entity, swEnt2 As SldWorks.Entity
Dim vParam As Variant, vPunkt1 As Variant, vPunkt2 As Variant
Dim dAbstand As Double
Set swEnt = swSelMgr.GetSelectedObject6(1, -1)
Set swEnt2 = swSelMgr.GetSelectedObject6(2, -1)
vParam = Empty
If swEnt.GetDistance(swEnt2, True, vParam, vPunkt1, vPunkt2, dAbstand) = 0 Then
    Debug.Print "Kleinster Abstand: " & dAbstand * 1000 & " mm"
End If

Bemerkungen

Es gehen nur Flächen und Kanten. Ohne Parameter liefert der Befehl den kleinsten Abstand. Den Parameterbereich holst du bei Kanten mit GetCurveParams2, inzwischen Edge.GetCurveParams3, und bei Flächen mit Face2.GetUVBounds.

Das Hilfebeispiel „Get Distance Between Entities“ misst den kleinsten Abstand zweier Flächen und den größten zwischen Fläche und Kante in multi_inter.sldprt und zeichnet die Strecke als Skizzenlinie. Es schreibt im Text „1 = failure“, die Beschreibung des Rückgabewerts sagt -1.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2009 SP05

Englisches Original: IEntity::GetDistance in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.