SolidWorksMakroprogrammierung

Objekt · SldWorks

Import3DInterconnectData-Objekt

Die Importeinstellungen eines 3D-Interconnect-Features: welche Daten aus der fremden CAD-Datei übernommen werden, die verknüpfte Datei und das Ursprungsprogramm.

Deklaration Dim x As SldWorks.Import3DInterconnectData · in der englischen .NET-Hilfe: IImport3DInterconnectData

Beschreibung

Import3DInterconnectData gibt Zugriff auf die Importeinstellungen eines Features, das 3D Interconnect aus einer CAD-Datei eines anderen Programms angelegt hat (etwa Inventor, CATIA V5, Creo, NX oder Solid Edge). Anders als ImportStepData, ImportIgesData und ImportDxfDwgData holst du das Objekt nicht vor dem Import, sondern danach vom importierten Feature. Die Befehle gibt es seit SOLIDWORKS 2020.

Zugriff

Ob ein Feature ein 3D-Interconnect-Feature ist, prüfst du mit Feature.Is3DInterconnectFeature. Geänderte Einstellungen gibst du mit Feature.SetImportedFeatureParameters zurück.

Beispiel

' Gibt für das ausgewählte 3D-Interconnect-Feature die Originaldatei, das
' Ursprungsprogramm und die Einstellungen aus und schaltet die Übernahme der
' Referenzebenen ein.
' Vorbedingung: 3D Interconnect ist eingeschaltet. Ein Teil mit einem
'               3D-Interconnect-Feature ist offen, das Feature ist ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, das Feature übernimmt die Ebenen.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swObj As Object
    Dim swDaten As SldWorks.Import3DInterconnectData
    Dim nFehler 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 False = swFeat.Is3DInterconnectFeature Then
        Debug.Print swFeat.Name & " ist kein 3D-Interconnect-Feature."
        Exit Sub
    End If

    nFehler = swFeat.GetImportedFeatureParameters(swObj)
    If nFehler <> sw3DInterconnectImportErrors_None Or swObj Is Nothing Then
        Debug.Print "Nicht gelesen, Fehler " & nFehler
        Exit Sub
    End If
    Set swDaten = swObj
    Debug.Print "Datei:      " & swDaten.GetReferencedFileName
    Debug.Print "Programm:   " & swDaten.GetAuthoringInfo
    Debug.Print "Volumen:    " & swDaten.SolidBodies & ", Flächen: " & swDaten.SurfaceBodies
    Debug.Print "Ebenen:     " & swDaten.Planes & ", Achsen: " & swDaten.Axes
    Debug.Print "Skizzen:    " & swDaten.SketchesAndCurves
    Debug.Print "Eigensch.:  " & swDaten.CustomProperties & ", Material: " & swDaten.Material
    Debug.Print "Ausgeblendete auslassen: " & swDaten.IgnoreHiddenEntities

    swDaten.Planes = True
    nFehler = swFeat.SetImportedFeatureParameters(swDaten)
    If nFehler <> sw3DInterconnectImportErrors_None Then Debug.Print "Nicht gesetzt, Fehler " & nFehler
End Sub

Bemerkungen

3D Interconnect: Das Objekt setzt 3D Interconnect voraus. Du schaltest es unter Extras > Optionen > Systemoptionen > Importieren ein oder mit SldWorks.SetUserPreferenceToggle und swMultiCAD_Enable3DInterconnect aus swUserPreferenceToggle_e.

Wann verfügbar: Nach dem Import einer fremden CAD-Datei auf einem dieser Wege:

Verknüpfung: Für importierte Teile und Baugruppen gilt:

  • Ob eine Aktualisierung nötig ist, liefert Feature.Is3DInterconnectUpdateAvailable. Aktualisiert wird mit Feature.Update3DInterconnectModel.
  • Die importierten Daten änderst du mit diesem Objekt und Feature.SetImportedFeatureParameters.
  • Mit Feature.BreakLink trennst du die Verknüpfung zur Originaldatei. Danach gehen alle Bezüge darauf verloren, und du kannst nicht mehr ändern, was aus der Datei übernommen wird.
  • Bei Teilen ist die SOLIDWORKS-Datei eine Kopie mit externem Bezug auf die Originaldatei. Änderungen am Original lassen sich übernehmen, Änderungen an der Kopie gehen nicht zurück ins Original.
  • Bei Baugruppen musst du die neue Baugruppe erst speichern. Erst dann kannst du die oberste importierte Baugruppe bearbeiten oder ihre Verknüpfung trennen. Untergeordnete Komponenten lassen sich nicht einzeln bearbeiten oder trennen.

Formate: 3D Interconnect liest ACIS, Autodesk Inventor, CATIA V5, IGES, JT, PTC (Pro/ENGINEER, Creo), Solid Edge, STEP und NX. Die Übernahme-Einstellungen dieses Objekts gelten aber nur für einen Teil davon, etwa Inventor, CATIA V5, Creo, NX und Solid Edge. Welche Daten übernommen werden können, hängt vom Format ab. Die Hilfe verweist dazu auf die Themen zu SOLIDWORKS 3D Interconnect in der SOLIDWORKS-Hilfe.

Hilfebeispiel: Das einzige Beispiel „Use 3D Interconnect to Import Third-Party Native CAD Files“ gibt es nur in C#. Es lädt Dateien mit LoadFile4, fügt sie mit InsertImportedFeature oder InsertImportedComponent ein und liest und setzt die Einstellungen über ein Formular.

Eigenschaften und Methoden

Eigenschaften 8, davon 8 beschrieben

NameBeschreibung
AxesLiest oder setzt, ob 3D Interconnect Referenzachsen aus der Originaldatei übernimmt.
CustomPropertiesLiest oder setzt, ob 3D Interconnect benutzerdefinierte Eigenschaften aus der Originaldatei übernimmt.
IgnoreHiddenEntitiesLiest oder setzt, ob 3D Interconnect ausgeblendete Elemente der Originaldatei auslässt.
MaterialLiest oder setzt, ob 3D Interconnect das Material aus der Originaldatei übernimmt.
PlanesLiest oder setzt, ob 3D Interconnect Referenzebenen aus der Originaldatei übernimmt.
SketchesAndCurvesLiest oder setzt, ob 3D Interconnect nicht verbrauchte Skizzen und Kurven als 2D- oder 3D-Skizzen übernimmt.
SolidBodiesLiest oder setzt, ob 3D Interconnect Volumenkörper aus der Originaldatei übernimmt.
SurfaceBodiesLiest oder setzt, ob 3D Interconnect die Daten als Flächen übernimmt.

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetAuthoringInfoLiefert den Namen des Programms, mit dem die Originaldatei erstellt wurde.
GetReferencedFileNameLiefert Pfad und Namen der verknüpften Originaldatei des 3D-Interconnect-Features.
SetReferencedFileNameSetzt Pfad und Namen der verknüpften Originaldatei des 3D-Interconnect-Features.

Siehe auch

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

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