Objekt · SldWorks
ChainPatternFeatureData-Objekt
Die Feature-Daten eines Kettenmusters von Komponenten in einer Baugruppe: Pfad, Kettengruppen, Art, Abstand und Zahl der Instanzen.
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
FeatureManager.CreateDefinitionmitswFmLocalChainPattern: Daten für ein neues Kettenmuster, das du mitFeatureManager.CreateFeatureanlegstFeature.GetDefinition: aus einem vorhandenen Kettenmuster (TypnameLocalChainPattern)
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 SubBemerkungen
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 1256, Pfadglied 2512, Ausrichtungsebene16384 - Kettengruppe 2: Komponente
2048, Pfadglied 14096, Pfadglied 28192, Ausrichtungsebene32768 - 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
| Name | Beschreibung |
|---|---|
| AlignMethod | Liest oder setzt, wie die Instanzen eines Kettenmusters mit Abstand ausgerichtet sind: wie das Ausgangselement oder tangential zum Pfad. |
| FillPath | Liest oder setzt, ob SOLIDWORKS die größte Zahl Instanzen berechnet, die auf den Pfad passt. |
| ForceUseSeedConfiguration | Liest oder setzt, ob die gemusterten Komponenten immer dieselbe Konfiguration haben wie die Ausgangskomponente. |
| Group1FlipPlane | Liest oder setzt, ob die Ausrichtungsebene der Kettengruppe 1 umgedreht wird. |
| Group1PathLink1 | Liest oder setzt das erste Pfadglied der Kettengruppe 1, etwa eine Zylinderfläche oder eine Achse. |
| Group1PathLink2 | Liest oder setzt das zweite Pfadglied der Kettengruppe 1, bei Kettenmustern mit Verbindung. |
| Group1PathPlane | Liest oder setzt die Ebene, die die Lage der gemusterten Komponente zum Pfad in Kettengruppe 1 festlegt. |
| Group1PatternComponent | Liest oder setzt die Komponente, die Kettengruppe 1 entlang des Pfads mustert. |
| Group2FlipPlane | Liest oder setzt, ob die Ausrichtungsebene der Kettengruppe 2 umgedreht wird. |
| Group2PathLink1 | Liest oder setzt das erste Pfadglied der Kettengruppe 2, bei verbundener Verbindung. |
| Group2PathLink2 | Liest oder setzt das zweite Pfadglied der Kettengruppe 2, bei verbundener Verbindung. |
| Group2PathPlane | Liest oder setzt die Ebene, die die Lage der gemusterten Komponente zum Pfad in Kettengruppe 2 festlegt. |
| Group2PatternComponent | Liest oder setzt die Komponente, die Kettengruppe 2 mustert, bei verbundener Verbindung. |
| InstanceCount | Liest oder setzt die Zahl der Instanzen des Kettenmusters. |
| Options | Liest oder setzt, ob das Kettenmuster die Verknüpfungen zwischen den Instanzen berechnet oder die Instanzen nur kopiert. |
| Path | Liest oder setzt den Pfad des Kettenmusters: eine Skizze, eine Skizzenlinie oder eine Modellkante. |
| PathPlaneReference | Liest oder setzt die Referenzebene zum Pfad, wenn der Pfad eine Skizzenlinie ist. |
| PitchMethod | Liest oder setzt die Art des Kettenmusters: Abstand, Abstandsverbindung oder verbundene Verbindung. |
| ReverseDirection | Liest oder setzt, ob die Richtung des Pfads umgekehrt wird. |
| Spacing | Liest oder setzt den Abstand zwischen den Instanzen auf dem Pfad, bei Kettenmustern mit Abstand. |
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Kettenmuster zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| ClearGroup2Selections | Entfernt die Auswahlen der Kettengruppe 2, sodass ein Kettenmuster mit verbundener Verbindung nur noch Kettengruppe 1 hat. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Kettenmuster nicht geändert hast. |
| SetEqualSpacing | Verteilt 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.