Objekt · SldWorks
MateReference-Objekt
Steht für eine Verknüpfungsreferenz: bis zu drei Elemente einer Komponente, die beim automatischen Verknüpfen benutzt werden.
Beschreibung
Eine Verknüpfungsreferenz legt ein oder mehrere Elemente einer Komponente fest, die beim automatischen Verknüpfen benutzt werden, etwa die Fläche einer Bohrung für eine Schraube. Es gibt bis zu drei Elemente: primär, sekundär und tertiär. Für jedes gibt die Referenz eine Art der Verknüpfung und eine Ausrichtung vor. MateReference liest diese Angaben und ändert sie. Die meisten Befehle gibt es seit SOLIDWORKS 2005, ReferenceEntity2 und ReferenceEntityType seit SOLIDWORKS 2011.
MateReference.ReferenceEntity ist veraltet.
Zugriff
Feature.GetSpecificFeature2: aus dem Feature der Verknüpfungsreferenz, etwa nach der Auswahl mit dem TypPOSGROUPFeatureManager.InsertMateReference2: legt eine neue Verknüpfungsreferenz an und liefert ihrFeature
Beispiel
' Gibt Name, Art der Verknüpfung, Ausrichtung und Elementart für jedes Element
' der ausgewählten Verknüpfungsreferenz aus.
' Vorbedingung: Ein Teil mit einer Verknüpfungsreferenz ist offen, die Verknüpfungsreferenz
' ist im FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swFeat As SldWorks.Feature
Dim swSpez As Object
Dim swRef As SldWorks.MateReference
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
Set swFeat = swSel
Set swSpez = swFeat.GetSpecificFeature2
If Not TypeOf swSpez Is SldWorks.MateReference Then
Debug.Print swFeat.Name & " ist keine Verknüpfungsreferenz."
Exit Sub
End If
Set swRef = swSpez
Debug.Print "Verknüpfungsreferenz " & swRef.Name
For i = 0 To swRef.ReferenceEntityCount - 1 ' 0 primär, 1 sekundär, 2 tertiär
If swRef.ReferenceType(i) = -1 Then
Debug.Print " " & i & ": kein Element"
Else
Debug.Print " " & i & ": Art " & swRef.ReferenceType(i) & " (swMateReferenceType_e), " & _
"Ausrichtung " & swRef.ReferenceAlignment(i) & " (swMateReferenceAlignment_e), " & _
"Element " & swRef.ReferenceEntityType(i) & " (swSelectType_e)"
End If
Next i
End SubBemerkungen
Auswählen: Die Hilfebeispiele legen eine Verknüpfungsreferenz mit dem Namen „Default“ an, wählen danach „Default-<1>“ mit ModelDocExtension.SelectByID2 und dem Typ POSGROUP aus und holen das Objekt mit Feature.GetSpecificFeature2. Die Tabelle bei Feature.GetTypeName2 nennt für das Feature den Typnamen PosGroupFolder, für den Ordner der Verknüpfungsreferenzen im FeatureManager den Typnamen MateReferenceGroupFolder.
Drei Elemente: Den Index nimmst du aus swMateReferenceIndex_e. MateReference.ReferenceEntityCount liefert die Zahl der belegten Elemente; die Elemente stehen ab Index 0. Die Hilfe nennt bei MateReference.ReferenceType und MateReference.ReferenceAlignment den Wert -1 für einen Index ohne Element; es kommt dafür 0.
Element lesen: MateReference.ReferenceEntity2 liefert ein Entity oder einen SketchPoint. Welches von beiden, sagt MateReference.ReferenceEntityType mit einem Wert aus swSelectType_e. Die veraltete MateReference.ReferenceEntity lieferte nur ein Entity.
Ändern: MateReference.Edit setzt den Namen und alle drei Elemente mit Art und Ausrichtung neu. Danach baust du das Modell mit ModelDoc2.EditRebuild3 neu auf. Anlegen geht mit FeatureManager.InsertMateReference2.
Eigenschaften und Methoden
Eigenschaften 7, davon 6 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| Name | Liefert den Namen der Verknüpfungsreferenz. |
| ReferenceAlignment | Liefert die Ausrichtung, die die Verknüpfungsreferenz für eines ihrer Elemente vorgibt. |
| ReferenceEntity | veraltet ersetzt durch MateReference.ReferenceEntity2 |
| ReferenceEntity2 | Liefert ein Element der Verknüpfungsreferenz, als Entity oder als Skizzenpunkt. |
| ReferenceEntityCount | Liefert die Zahl der belegten Elemente der Verknüpfungsreferenz, 1 bis 3. |
| ReferenceEntityType | Liefert die Art des Elements, das ReferenceEntity2 für einen Index liefert, etwa Fläche oder Skizzenpunkt. |
| ReferenceType | Liefert die Art der Verknüpfung, die die Verknüpfungsreferenz für eines ihrer Elemente vorgibt, etwa konzentrisch. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| Edit | Ändert die Verknüpfungsreferenz: den Namen und für bis zu drei Elemente das Element, die Art der Verknüpfung und die Ausrichtung. |
Siehe auch
Englisches Original: IMateReference in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.