SolidWorksMakroprogrammierung

Objekt · SldWorks

ChainPatternFeatureData-Objekt

Die Feature-Daten eines Kettenmusters von Komponenten in einer Baugruppe: Pfad, Kettengruppen, Art, Abstand und Zahl der Instanzen.

Deklaration Dim x As SldWorks.ChainPatternFeatureData · in der englischen .NET-Hilfe: IChainPatternFeatureData

Beschreibung

ChainPatternFeatureData gibt Zugriff auf ein Kettenmuster von Komponenten. Ein Kettenmuster verteilt Komponenten entlang eines Pfads, etwa die Glieder einer Kette. Es gibt drei Arten (ChainPatternFeatureData.PitchMethod): Abstand, Abstandsverbindung und verbundene Verbindung. Viele Eigenschaften gelten nur für einzelne Arten, das steht jeweils auf ihrer Seite.

Zugriff

Beispiel

' Gibt Art, gemusterte Komponente und Zahl der Instanzen des ausgewählten Kettenmusters aus.
' Bei Mustern mit Abstand setzt es den Abstand auf 78 mm und lässt SOLIDWORKS den Pfad füllen,
' wie das Hilfebeispiel.
' Vorbedingung: Eine Baugruppe ist offen, ein Kettenmuster ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, ein Muster mit Abstand ist geändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.ChainPatternFeatureData
    Dim swKompFeat As SldWorks.Feature

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocASSEMBLY Then Exit Sub
    Set swSelMgr = swModel.SelectionManager
    Set swSel = swSelMgr.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "LocalChainPattern" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Set swKompFeat = swDaten.Group1PatternComponent       ' das Feature der Komponente, nicht Component2
    If Not swKompFeat Is Nothing Then Debug.Print "Gemustert wird " & swKompFeat.Name
    Debug.Print "Art: " & swDaten.PitchMethod & ", Instanzen: " & swDaten.InstanceCount

    If swDaten.PitchMethod = swChainPatternDistance Or swDaten.PitchMethod = swChainPatternDistanceLinkage Then
        swDaten.Spacing = 0.078                               ' Meter, also 78 mm
        swDaten.FillPath = True
        Debug.Print "Neue Zahl der Instanzen: " & swDaten.InstanceCount
        If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then Debug.Print "Nicht geändert"
    Else
        swDaten.ReleaseSelectionAccess
    End If
End Sub

Bemerkungen

Anlegen: Vor FeatureManager.CreateDefinition wählst du die Elemente mit diesen Markierungen aus und rufst danach FeatureManager.CreateFeature auf:

  • Pfad (Skizze, Skizzenlinie oder Modellkante): 2
  • Kettengruppe 1: Komponente 1, Pfadglied 1 256, Pfadglied 2 512, Ausrichtungsebene 16384
  • Kettengruppe 2: Komponente 2048, Pfadglied 1 4096, Pfadglied 2 8192, Ausrichtungsebene 32768
  • Ebene der Baugruppe für die Ausrichtung zur Flächennormale: 1024, nur wenn der Pfad eine Skizzenlinie ist

Pfadglied 2 der Kettengruppe 1 brauchst du nur bei Abstandsverbindung und verbundener Verbindung, die Kettengruppe 2 nur bei verbundener Verbindung. Das Hilfebeispiel „Create and Modify Distance Chain Pattern Feature“ legt so ein Kettenmuster mit Abstand an.

Ändern: Du rufst erst ChainPatternFeatureData.AccessSelections auf und übernimmst Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit ChainPatternFeatureData.ReleaseSelectionAccess auf.

Elemente zuweisen: Pfad, Pfadglieder, Ebenen und Komponenten sind Objekt-Eigenschaften. Wie du ihnen ein Element zuweist, mit oder ohne Set, zeigt die Hilfe nicht. Die Beispiele hier lesen sie nur.

Hilfethema: Die Hilfe verweist auf das Thema „Pattern Features and their Feature Data Objects“.

Ohne ChainPatternFeatureData.AccessSelections liefern PitchMethod, Spacing und InstanceCount 0. ChainPatternFeatureData.Group1PatternComponent liefert das Feature der Komponente statt eines Component2, der Abstand ist in Metern.

Eigenschaften und Methoden

Eigenschaften 20, davon 20 beschrieben

NameBeschreibung
AlignMethodLiest oder setzt, wie die Instanzen eines Kettenmusters mit Abstand ausgerichtet sind: wie das Ausgangselement oder tangential zum Pfad.
FillPathLiest oder setzt, ob SOLIDWORKS die größte Zahl Instanzen berechnet, die auf den Pfad passt.
ForceUseSeedConfigurationLiest oder setzt, ob die gemusterten Komponenten immer dieselbe Konfiguration haben wie die Ausgangskomponente.
Group1FlipPlaneLiest oder setzt, ob die Ausrichtungsebene der Kettengruppe 1 umgedreht wird.
Group1PathLink1Liest oder setzt das erste Pfadglied der Kettengruppe 1, etwa eine Zylinderfläche oder eine Achse.
Group1PathLink2Liest oder setzt das zweite Pfadglied der Kettengruppe 1, bei Kettenmustern mit Verbindung.
Group1PathPlaneLiest oder setzt die Ebene, die die Lage der gemusterten Komponente zum Pfad in Kettengruppe 1 festlegt.
Group1PatternComponentLiest oder setzt die Komponente, die Kettengruppe 1 entlang des Pfads mustert.
Group2FlipPlaneLiest oder setzt, ob die Ausrichtungsebene der Kettengruppe 2 umgedreht wird.
Group2PathLink1Liest oder setzt das erste Pfadglied der Kettengruppe 2, bei verbundener Verbindung.
Group2PathLink2Liest oder setzt das zweite Pfadglied der Kettengruppe 2, bei verbundener Verbindung.
Group2PathPlaneLiest oder setzt die Ebene, die die Lage der gemusterten Komponente zum Pfad in Kettengruppe 2 festlegt.
Group2PatternComponentLiest oder setzt die Komponente, die Kettengruppe 2 mustert, bei verbundener Verbindung.
InstanceCountLiest oder setzt die Zahl der Instanzen des Kettenmusters.
OptionsLiest oder setzt, ob das Kettenmuster die Verknüpfungen zwischen den Instanzen berechnet oder die Instanzen nur kopiert.
PathLiest oder setzt den Pfad des Kettenmusters: eine Skizze, eine Skizzenlinie oder eine Modellkante.
PathPlaneReferenceLiest oder setzt die Referenzebene zum Pfad, wenn der Pfad eine Skizzenlinie ist.
PitchMethodLiest oder setzt die Art des Kettenmusters: Abstand, Abstandsverbindung oder verbundene Verbindung.
ReverseDirectionLiest oder setzt, ob die Richtung des Pfads umgekehrt wird.
SpacingLiest oder setzt den Abstand zwischen den Instanzen auf dem Pfad, bei Kettenmustern mit Abstand.

Methoden 4, davon 4 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Kettenmuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
ClearGroup2SelectionsEntfernt die Auswahlen der Kettengruppe 2, sodass ein Kettenmuster mit verbundener Verbindung nur noch Kettengruppe 1 hat.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Kettenmuster nicht geändert hast.
SetEqualSpacingVerteilt die Instanzen des Kettenmusters mit gleichem Abstand.

Siehe auch

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

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