SolidWorksMakroprogrammierung

Objekt · SldWorks

InstanceToVaryOptions-Objekt

Die Optionen „Instanzen variieren“ eines linearen Musters oder Kreismusters: Abstandsinkremente, geänderte Abstände und Bemaßungen einzelner Instanzen.

Deklaration Dim x As SldWorks.InstanceToVaryOptions · in der englischen .NET-Hilfe: IInstanceToVaryOptions

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

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 Sub

Bemerkungen

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

NameBeschreibung
D1SpacingIncrementLiest oder setzt das Abstandsinkrement aller Instanzen des Musters in Richtung 1.
D2SpacingIncrementLiest oder setzt das Abstandsinkrement aller Instanzen des Musters in Richtung 2.

Methoden 11, davon 11 beschrieben

NameBeschreibung
GetD1IncrementDimensionsLiefert die Bemaßungen, die in Richtung 1 von Instanz zu Instanz um einen Wert wachsen, samt ihren Inkrementen.
GetD1ModifiedSpacingValueLiefert den Abstand einer geänderten Instanz des Musters in Richtung 1.
GetD2IncrementDimensionsLiefert die Bemaßungen, die in Richtung 2 von Instanz zu Instanz um einen Wert wachsen, samt ihren Inkrementen.
GetD2ModifiedSpacingValueLiefert den Abstand einer geänderten Instanz des Musters in Richtung 2.
GetModifiedDimensionsLiefert die geänderten Bemaßungen einer Instanz des Musters und ihre Werte.
GetModifiedInstancesLiefert 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.
SetD1IncrementDimensionsLegt Bemaßungen fest, die in Richtung 1 von Instanz zu Instanz um einen Wert wachsen.
SetD2IncrementDimensionsLegt 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.