Objekt · SldWorks
InstanceToVaryOptions-Objekt
Die Optionen „Instanzen variieren“ eines linearen Musters oder Kreismusters: Abstandsinkremente, geänderte Abstände und Bemaßungen einzelner Instanzen.
Beschreibung
InstanceToVaryOptions gibt Zugriff auf die Optionen, mit denen du Bemaßungen und Lage einzelner Instanzen eines Musters in einem Teil variierst. Das Objekt gilt nur, wenn beim Muster die Eigenschaft InstancesToVary True ist. Die Befehle gibt es seit SOLIDWORKS 2021.
Zugriff
CircularPatternFeatureData.GetInstanceToVaryOptions: aus einem KreismusterLinearPatternFeatureData.GetInstanceToVaryOptions: aus einem linearen Muster
Die geänderten Optionen gibst du mit CircularPatternFeatureData.SetInstanceToVaryOptions bzw. LinearPatternFeatureData.SetInstanceToVaryOptions an das Muster zurück und rufst dann Feature.ModifyDefinition auf.
Beispiel
' Gibt für das ausgewählte lineare Muster oder Kreismuster die Abstandsinkremente
' und die Instanzen mit geändertem Abstand in Richtung 1 aus.
' Vorbedingung: Ein Teil ist offen, ein lineares Muster oder Kreismuster mit
' „Instanzen variieren“ ist im FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, das Muster 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 swDaten As Object
Dim swOptionen As SldWorks.InstanceToVaryOptions
Dim vInstanzen As Variant
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
If swFeat.GetTypeName2 <> "LPattern" And swFeat.GetTypeName2 <> "CirPattern" Then Exit Sub
Set swDaten = swFeat.GetDefinition ' LinearPatternFeatureData oder CircularPatternFeatureData
If False = swDaten.InstancesToVary Then
Debug.Print "„Instanzen variieren“ ist aus."
Exit Sub
End If
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Set swOptionen = swDaten.GetInstanceToVaryOptions
Debug.Print "Abstandsinkrement Richtung 1: " & swOptionen.D1SpacingIncrement
Debug.Print "Abstandsinkrement Richtung 2: " & swOptionen.D2SpacingIncrement
vInstanzen = swOptionen.GetModifiedInstances(swInstanceToVaryModificationType_D1Spacing)
If IsArray(vInstanzen) Then
For i = 0 To UBound(vInstanzen)
Debug.Print "Instanz " & vInstanzen(i) & ": Abstand Richtung 1 = " & _
swOptionen.GetD1ModifiedSpacingValue(vInstanzen(i))
Next i
End If
swDaten.ReleaseSelectionAccess
End SubBemerkungen
Schrittfolge: InstancesToVary gilt nur beim Ändern eines vorhandenen Musters, nicht beim Anlegen. Du rufst Feature.GetDefinition und AccessSelections auf, setzt InstancesToVary auf True und rufst Feature.ModifyDefinition auf. Danach rufst du erneut AccessSelections auf, holst die Optionen mit GetInstanceToVaryOptions, änderst sie, gibst sie mit SetInstanceToVaryOptions zurück und rufst wieder ModifyDefinition auf. Einzelheiten stehen bei CircularPatternFeatureData.InstancesToVary.
Nummer der Instanz: Mehrere Befehle erwarten die Nummer einer Instanz Instance. Dafür muss D2PatternSeedOnly in den Feature-Daten des Musters False sein. Die Nummer berechnest du so:
- Muster in zwei Richtungen:
I = n2 * (i - 1) + (j - 1) - Muster in einer Richtung:
I = i - 1
Dabei ist n2 die Zahl der Instanzen in Richtung 2, i der Index in Richtung 1 und j der Index in Richtung 2. n2 steht im PropertyManager des Musters unter Richtung 2 bei der Zahl der Instanzen, [i,j] im Abschnitt der geänderten Instanzen. Welche Instanzen schon geändert sind, liefert InstanceToVaryOptions.GetModifiedInstances. Im Hilfebeispiel ist bei einem Muster mit 2 × 2 Instanzen die Instanz (2,2) die Nummer 3. D2PatternSeedOnly gibt es nur bei LinearPatternFeatureData. Was beim Kreismuster gilt, sagt die Hilfe nicht.
Einheiten: Die Einheiten der Abstände und Bemaßungswerte nennt die Hilfe nicht. Beim linearen Muster sind es Meter (ein Abstandsinkrement von 0.05 schob Instanzen über die Platte hinaus, ein Bemaßungsinkrement von 0.002 machte die Zapfen je Instanz 2 mm höher), beim Kreismuster für die Abstände vermutlich Bogenmaß. Das Hilfebeispiel setzt bei einem linearen Muster Werte wie 0.05 und 0.005.
Bemaßungen: Das Hilfebeispiel übergibt die Bemaßungen als Array von Namen wie Near C'Sink Dia.@Sketch2 und die Werte als Array von Double.
Hilfebeispiel: Das Beispiel zu IInstanceToVaryOptions („Vary Linear Pattern Instances“) legt in box.sldprt ein lineares Muster in zwei Richtungen an, schaltet „Instanzen variieren“ ein, setzt die Abstandsinkremente, ändert den Abstand und eine Bemaßung der Instanz 3 und erhöht eine Bemaßung in Richtung 1 für alle Instanzen.
Veraltet: FeatureManager.InsertVaryInstanceIncrement und FeatureManager.InsertVaryInstanceOverride sind durch dieses Objekt ersetzt.
Hilfethema: Die Hilfe verweist auf das Thema „Varying Dimension Patterns“ in der SOLIDWORKS-Hilfe.
Für eine nicht geänderte Instanz liefern InstanceToVaryOptions.GetD1ModifiedSpacingValue und InstanceToVaryOptions.GetD2ModifiedSpacingValue 0, nicht den Abstand des Musters.
Eigenschaften und Methoden
Eigenschaften 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| D1SpacingIncrement | Liest oder setzt das Abstandsinkrement aller Instanzen des Musters in Richtung 1. |
| D2SpacingIncrement | Liest oder setzt das Abstandsinkrement aller Instanzen des Musters in Richtung 2. |
Methoden 11, davon 11 beschrieben
| Name | Beschreibung |
|---|---|
| GetD1IncrementDimensions | Liefert die Bemaßungen, die in Richtung 1 von Instanz zu Instanz um einen Wert wachsen, samt ihren Inkrementen. |
| GetD1ModifiedSpacingValue | Liefert den Abstand einer geänderten Instanz des Musters in Richtung 1. |
| GetD2IncrementDimensions | Liefert die Bemaßungen, die in Richtung 2 von Instanz zu Instanz um einen Wert wachsen, samt ihren Inkrementen. |
| GetD2ModifiedSpacingValue | Liefert den Abstand einer geänderten Instanz des Musters in Richtung 2. |
| GetModifiedDimensions | Liefert die geänderten Bemaßungen einer Instanz des Musters und ihre Werte. |
| GetModifiedInstances | Liefert die Nummern der Instanzen des Musters, die auf eine bestimmte Art geändert sind. |
| ModifyD1SpacingValue | Ändert den Abstand einer Instanz des Musters in Richtung 1. |
| ModifyD2SpacingValue | Ändert den Abstand einer Instanz des Musters in Richtung 2. |
| ModifyDimensions | Ändert Bemaßungen einer einzelnen Instanz des Musters. |
| SetD1IncrementDimensions | Legt Bemaßungen fest, die in Richtung 1 von Instanz zu Instanz um einen Wert wachsen. |
| SetD2IncrementDimensions | Legt Bemaßungen fest, die in Richtung 2 von Instanz zu Instanz um einen Wert wachsen. |
Siehe auch
Englisches Original: IInstanceToVaryOptions in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.