SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.LibraryFormToolFeatureData · in der englischen .NET-Hilfe: ILibraryFormToolFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
FormToolConfigurationLiest oder setzt die Konfiguration des Teils, das als Umformwerkzeug eingefügt wird.
FormToolPathLiest oder setzt den Pfad des Teils in der Konstruktionsbibliothek, das als Umformwerkzeug eingefügt wird.
LinkToFormToolLiest oder setzt, ob das Umformwerkzeug mit seinem Teil in der Konstruktionsbibliothek verknüpft ist.
OverrideSettingsLiefert, ob für das Umformwerkzeug in der Abwicklung eigene Einstellungen statt der Dokumenteigenschaften gelten.
PickPointLiefert den Punkt, an dem das Umformwerkzeug eingefügt ist.
PlacementFaceLiefert die Fläche, auf der das Umformwerkzeug eingefügt ist.
RotationAngleLiest oder setzt den Drehwinkel des Umformwerkzeugs.
ShowCenterLiefert, ob die Abwicklung an der Stelle des Umformwerkzeugs eine Mittelpunktmarke zeigt.
ShowProfileLiefert, ob die Abwicklung die Platzierungsskizze des Umformwerkzeugs zeigt.
ShowPunchLiefert, ob die Abwicklung den Schnitt des Umformwerkzeugs zeigt.

Methoden 5, davon 5 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Umformwerkzeug zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetPunchIDLiefert die Stempel-ID, die dem Umformwerkzeug aus der Konstruktionsbibliothek zugeordnet ist.
OverrideDocumentSettingsLegt fest, was die Abwicklung vom Umformwerkzeug zeigt, abweichend von den Dokumenteigenschaften.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Umformwerkzeug nicht geändert hast.
SetPlacementFaceLegt 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.