Objekt · SldWorks
LibraryFormToolFeatureData-Objekt
Die Feature-Daten eines Umformwerkzeugs aus der Konstruktionsbibliothek in einem Blechteil: Werkzeugdatei, Konfiguration, Lage, Drehwinkel, Stempel-ID und Anzeige in der Abwicklung.
Beschreibung
LibraryFormToolFeatureData gibt Zugriff auf ein Umformwerkzeug aus der Konstruktionsbibliothek (Design Library), das in ein Blechteil eingefügt ist. Umformwerkzeuge sind Stempel, die Blech eindrücken, biegen, strecken oder anders umformen. Die Befehle gibt es seit SOLIDWORKS 2025 SP02.
Zugriff
FeatureManager.CreateDefinitionmitswFmFormToolInstance: Daten für ein neues Umformwerkzeug, das du mitFeatureManager.CreateFeatureeinfügstFeature.GetDefinition: aus einem eingefügten Umformwerkzeug (TypnameFormToolInstance)
Beispiel
' Fügt auf der ausgewählten ebenen Fläche ein Umformwerkzeug aus der
' Konstruktionsbibliothek ein und gibt seine Stempel-ID aus.
' Vorbedingung: Ein Blechteil ist offen, eine ebene Fläche ist ausgewählt, die
' Registerkarte Blech im CommandManager ist sichtbar. DATEI zeigt auf
' ein vorhandenes Umformwerkzeug (*.sldftp).
' Ergebnis: Ein neues Umformwerkzeug-Feature im FeatureManager.
Option Explicit
Private Const DATEI As String = _
"C:\ProgramData\SOLIDWORKS\SOLIDWORKS 2025\design library\forming tools\embosses\dimple.sldftp" ' Version anpassen
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swFeatMgr As SldWorks.FeatureManager
Dim swDaten As SldWorks.LibraryFormToolFeatureData
Dim swFeat As SldWorks.Feature
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocPART Then Exit Sub
If swModel.SelectionManager.GetSelectedObjectCount2(-1) <> 1 Then
Debug.Print "Bitte eine ebene Fläche auswählen."
Exit Sub
End If
Set swFeatMgr = swModel.FeatureManager
Set swDaten = swFeatMgr.CreateDefinition(swFmFormToolInstance)
swDaten.LinkToFormTool = True
swDaten.FormToolPath = DATEI
swDaten.OverrideDocumentSettings True, True, True, True
swDaten.RotationAngle = 0 ' vermutlich Bogenmaß
Set swFeat = swFeatMgr.CreateFeature(swDaten)
If swFeat Is Nothing Then
Debug.Print "Kein Umformwerkzeug eingefügt."
Exit Sub
End If
Set swDaten = swFeat.GetDefinition
Debug.Print swFeat.Name & ": Stempel-ID " & swDaten.GetPunchID & _
", Konfiguration " & swDaten.FormToolConfiguration
End SubBemerkungen
Anlegen: Die Registerkarte Blech muss im CommandManager sichtbar sein. Du wählst mit ModelDocExtension.SelectByRay und der Markierung 0 eine ebene Fläche aus, holst mit FeatureManager.CreateDefinition und swFmFormToolInstance die Daten, stellst mit LibraryFormToolFeatureData.OverrideDocumentSettings die Anzeige in der Abwicklung ein und gibst Werkzeug, Konfiguration, Verknüpfung und Drehwinkel an. Dann rufst du FeatureManager.CreateFeature auf.
Ändern: Zum Verschieben wählst du eine neue ebene Fläche aus, holst die Daten mit Feature.GetDefinition und rufst LibraryFormToolFeatureData.AccessSelections auf. Mit LibraryFormToolFeatureData.SetPlacementFace verschiebst du das Werkzeug, außerdem kannst du Anzeige, Werkzeug, Konfiguration, Verknüpfung und Drehwinkel ändern. Dann rufst du Feature.ModifyDefinition auf, ohne Änderung LibraryFormToolFeatureData.ReleaseSelectionAccess. Änderst du LibraryFormToolFeatureData.FormToolPath, ändert sich auch der Name des Features.
Hilfebeispiel: Das Beispiel „Create Forming Tool Feature“ öffnet cover.sldprt aus den Lernbeispielen zu Blech und fügt dort „drafted rectangular emboss.sldftp“ mit RotationAngle = 0.5 ein. Nach einer Pause wählt der Benutzer eine ebene Fläche, das Beispiel macht aus dem Auswahlpunkt mit MathUtility.CreatePoint einen MathPoint, ersetzt das Werkzeug durch „dimple.SLDFTP“ mit RotationAngle = 0.7833 und der Konfiguration „Default“ und verschiebt es mit SetPlacementFace.
Typname: Die Hilfe zu Feature.GetTypeName2 nennt für FormToolInstance kein Datenobjekt. Auf der Seite zu LibraryFormToolFeatureData liefert Feature.GetDefinition aber dieses Objekt, und so macht es auch das Hilfebeispiel.
Umformwerkzeug anlegen: Ein eigenes Umformwerkzeug machst du mit FeatureManager.CreateFormTool2 aus einem Teil. Die Stempel-ID aus LibraryFormToolFeatureData.GetPunchID steht in der Stanztabelle (View.InsertPunchTable, PunchTable).
Mehr dazu: Die Hilfe verweist auf die Themen „Using Forming Tools with Sheet Metal“ unter „Sheet Metal“ in der Hilfe zur Oberfläche.
In SOLIDWORKS 2024 nicht prüfbar: LibraryFormToolFeatureData gibt es erst ab SOLIDWORKS 2025 SP02. Schon Dim swDaten As SldWorks.LibraryFormToolFeatureData ergibt in 2024 den Kompilierfehler „Benutzerdefinierter Typ nicht definiert“. Den Pfad aus dem Beispiel (C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\data\Design Library\…) gab es in der 2024-Installation nicht; die Konstruktionsbibliothek lag unter C:\ProgramData\SOLIDWORKS\SOLIDWORKS 2024\design library, dort auch forming tools\embosses\dimple.sldftp. Das Beispiel nennt deshalb diesen Ordner, mit der passenden Versionsnummer.
Eigenschaften und Methoden
Eigenschaften 10, davon 10 beschrieben
| Name | Beschreibung |
|---|---|
| FormToolConfiguration | Liest oder setzt die Konfiguration des Teils, das als Umformwerkzeug eingefügt wird. |
| FormToolPath | Liest oder setzt den Pfad des Teils in der Konstruktionsbibliothek, das als Umformwerkzeug eingefügt wird. |
| LinkToFormTool | Liest oder setzt, ob das Umformwerkzeug mit seinem Teil in der Konstruktionsbibliothek verknüpft ist. |
| OverrideSettings | Liefert, ob für das Umformwerkzeug in der Abwicklung eigene Einstellungen statt der Dokumenteigenschaften gelten. |
| PickPoint | Liefert den Punkt, an dem das Umformwerkzeug eingefügt ist. |
| PlacementFace | Liefert die Fläche, auf der das Umformwerkzeug eingefügt ist. |
| RotationAngle | Liest oder setzt den Drehwinkel des Umformwerkzeugs. |
| ShowCenter | Liefert, ob die Abwicklung an der Stelle des Umformwerkzeugs eine Mittelpunktmarke zeigt. |
| ShowProfile | Liefert, ob die Abwicklung die Platzierungsskizze des Umformwerkzeugs zeigt. |
| ShowPunch | Liefert, ob die Abwicklung den Schnitt des Umformwerkzeugs zeigt. |
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Umformwerkzeug zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetPunchID | Liefert die Stempel-ID, die dem Umformwerkzeug aus der Konstruktionsbibliothek zugeordnet ist. |
| OverrideDocumentSettings | Legt fest, was die Abwicklung vom Umformwerkzeug zeigt, abweichend von den Dokumenteigenschaften. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Umformwerkzeug nicht geändert hast. |
| SetPlacementFace | Legt Fläche und Punkt fest, an denen das Umformwerkzeug sitzt. |
Siehe auch
Englisches Original: ILibraryFormToolFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.