SolidWorksMakroprogrammierung

Methode · MateReference

Edit-Methode (MateReference)

Ändert die Verknüpfungsreferenz: den Namen und für bis zu drei Elemente das Element, die Art der Verknüpfung und die Ausrichtung.

Syntax

Function Edit( _
   ByVal BstrMateReferenceName As String, _
   ByVal PrimaryReferenceEntity As Entity, _
   ByVal PrimaryReferenceType As Long, _
   ByVal PrimaryReferenceAlignment As Long, _
   ByVal SecondaryReferenceEntity As Entity, _
   ByVal SecondaryReferenceType As Long, _
   ByVal SecondaryReferenceAlignment As Long, _
   ByVal TertiaryReferenceEntity As Entity, _
   ByVal TertiaryReferenceType As Long, _
   ByVal TertiaryReferenceAlignment As Long _
) As Boolean
swRef.Edit "Welle", swFlaeche, swMateReferenceType_Concentric, swMateReferenceAlignment_Any, _
    Nothing, swMateReferenceType_default, swMateReferenceAlignment_Any, _
    Nothing, swMateReferenceType_default, swMateReferenceAlignment_Any

Parameter

BstrMateReferenceNameStringByVal
Der Name der geänderten Verknüpfungsreferenz. Sie ersetzt die bisherige.
PrimaryReferenceEntityEntityByVal
Das primäre Element, oder Nothing, um die bisherige Angabe zu löschen.
PrimaryReferenceTypeLongByVal
Art der Verknüpfung für das primäre Element, ein Wert aus swMateReferenceType_e.
PrimaryReferenceAlignmentLongByVal
Ausrichtung für das primäre Element, ein Wert aus swMateReferenceAlignment_e.
SecondaryReferenceEntityEntityByVal
Das sekundäre Element oder Nothing.
SecondaryReferenceTypeLongByVal
Art der Verknüpfung für das sekundäre Element.
SecondaryReferenceAlignmentLongByVal
Ausrichtung für das sekundäre Element.
TertiaryReferenceEntityEntityByVal
Das tertiäre Element oder Nothing.
TertiaryReferenceTypeLongByVal
Art der Verknüpfung für das tertiäre Element.
TertiaryReferenceAlignmentLongByVal
Ausrichtung für das tertiäre Element.

Rückgabewert

Immer True.

Beispiel

' swModel ist das Teil (ModelDoc2), swRef eine Verknüpfungsreferenz (MateReference),
' swFlaeche eine zylindrische Fläche des Teils (Face2), etwa aus SelectionMgr.GetSelectedObject6.
swRef.Edit "Welle", swFlaeche, swMateReferenceType_Concentric, swMateReferenceAlignment_Any, _
    Nothing, swMateReferenceType_default, swMateReferenceAlignment_Any, _
    Nothing, swMateReferenceType_default, swMateReferenceAlignment_Any
swModel.EditRebuild3
If swModel.Extension.NeedsRebuild2 <> swModelRebuildStatus_FullyRebuilt Then Debug.Print "Neuaufbau unvollständig"

Bemerkungen

Edit übernimmt die Werte direkt in das Feature. Danach baust du das Modell mit ModelDoc2.EditRebuild3 neu auf und prüfst, ob das geklappt hat. Die Hilfe nennt dafür die veraltete NeedsRebuild, heute gibt es ModelDocExtension.NeedsRebuild2. Der Rückgabewert ist immer True und sagt deshalb nichts über den Erfolg.

Mit Nothing statt eines Elements löschst du die bisherige Angabe für dieses Element. Die Elemente sind als Entity deklariert. Das Hilfebeispiel „Edit Mate Reference“ übergibt eine Variable vom Typ Face2 und eine Ebene, die es vorher ausgewählt hat. Es benennt die Referenz dabei von „Default“ in „MyDefault“ um.

Die Hilfe spricht von der „ausgewählten“ Verknüpfungsreferenz. Das Hilfebeispiel holt das Objekt aber mit Feature.GetSpecificFeature2 und hebt die Auswahl vor dem Aufruf auf. Anders als bei FeatureManager.InsertMateReference2 gibt es hier keine Parameter für das Ausrichten an den Achsen.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2005

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

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