SolidWorksMakroprogrammierung

Methode · AssemblyDoc

AddDistanceMate-Methode (AssemblyDoc)

Legt eine Abstandsverknüpfung an, wahlweise mit Grenzen.

Syntax

Function AddDistanceMate( _
   ByVal AlignFromEnum As Long, _
   ByVal Flip As Boolean, _
   ByVal Distance As Double, _
   ByVal DistanceAbsUpperLimit As Double, _
   ByVal DistanceAbsLowerLimit As Double, _
   ByVal FirstArcCondition As Long, _
   ByVal SecondArcCondition As Long, _
   ByRef ErrorStatus As Long _
) As Mate2
Set swMate = swAssy.AddDistanceMate(swMateAlignCLOSEST, False, 0.01, 0.01, 0.01, swArcCondition_NotSet, swArcCondition_NotSet, nFehler)

Parameter

AlignFromEnumLongByVal
Ausrichtung, ein Wert aus swMateAlign_e: swMateAlignALIGNED (0) gleich, swMateAlignANTI_ALIGNED (1) entgegen, swMateAlignCLOSEST (2) die nächstliegende.
FlipBooleanByVal
True: Komponenten auf die andere mögliche Lage umklappen.
DistanceDoubleByVal
Der Abstand in Metern.
DistanceAbsUpperLimitDoubleByVal
Größter Abstand. Ohne Grenzen gleich Distance.
DistanceAbsLowerLimitDoubleByVal
Kleinster Abstand. Ohne Grenzen gleich Distance.
FirstArcConditionLongByVal
Nur bei Zylindern: wo am ersten gemessen wird, ein Wert aus swDistanceMateArcConditions_e: swArcCondition_Center (1) Mitte, swArcCondition_Minimum (2), swArcCondition_Maximum (3).
SecondArcConditionLongByVal
Dasselbe für das zweite Element.
ErrorStatusLongByRef · Rückgabe
Gibt einen Wert aus swAddMateError_e zurück, swAddMateError_NoError (1) bei Erfolg.

Rückgabewert

Die neue Mate2.

Beispiel

' swAssy ist das AssemblyDoc, etwa per Set swAssy = swModel.
' Zwei ebene Flächen verschiedener Komponenten sind ausgewählt.
Dim swMate As SldWorks.Mate2
Dim nFehler As Long
Set swMate = swAssy.AddDistanceMate(swMateAlignCLOSEST, False, 0.01, 0.01, 0.01, swArcCondition_NotSet, swArcCondition_NotSet, nFehler)
If nFehler <> swAddMateError_NoError Then Debug.Print "Fehler " & nFehler

Bemerkungen

Für einen Abstand ohne Grenzen gibst du bei beiden Grenzen denselben Wert wie bei Distance an. Bei zylindrischen Abstandsverknüpfungen wählst du zwei Zylinderflächen oder eine Zylinderfläche und eine Achse aus. Die Arc-Bedingungen gelten nur dort. Ob swArcCondition_NotSet bei ebenen Flächen der richtige Wert ist, sagt die Hilfe nicht ausdrücklich.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2018

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

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