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 BooleanswRef.Edit "Welle", swFlaeche, swMateReferenceType_Concentric, swMateReferenceAlignment_Any, _
Nothing, swMateReferenceType_default, swMateReferenceAlignment_Any, _
Nothing, swMateReferenceType_default, swMateReferenceAlignment_AnyParameter
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.