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.
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
Feature.GetImportedFeatureParameters: bei einem 3D-Interconnect-Feature (TypnameMBimport)
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 SubBemerkungen
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:
- in ein vorhandenes Teil mit
PartDoc.InsertImportedFeature - in eine vorhandene Baugruppe mit
AssemblyDoc.InsertImportedComponent - in ein neues Teil oder eine neue Baugruppe mit
SldWorks.LoadFile4
Verknüpfung: Für importierte Teile und Baugruppen gilt:
- Ob eine Aktualisierung nötig ist, liefert
Feature.Is3DInterconnectUpdateAvailable. Aktualisiert wird mitFeature.Update3DInterconnectModel. - Die importierten Daten änderst du mit diesem Objekt und
Feature.SetImportedFeatureParameters. - Mit
Feature.BreakLinktrennst 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
| Name | Beschreibung |
|---|---|
| Axes | Liest oder setzt, ob 3D Interconnect Referenzachsen aus der Originaldatei übernimmt. |
| CustomProperties | Liest oder setzt, ob 3D Interconnect benutzerdefinierte Eigenschaften aus der Originaldatei übernimmt. |
| IgnoreHiddenEntities | Liest oder setzt, ob 3D Interconnect ausgeblendete Elemente der Originaldatei auslässt. |
| Material | Liest oder setzt, ob 3D Interconnect das Material aus der Originaldatei übernimmt. |
| Planes | Liest oder setzt, ob 3D Interconnect Referenzebenen aus der Originaldatei übernimmt. |
| SketchesAndCurves | Liest oder setzt, ob 3D Interconnect nicht verbrauchte Skizzen und Kurven als 2D- oder 3D-Skizzen übernimmt. |
| SolidBodies | Liest oder setzt, ob 3D Interconnect Volumenkörper aus der Originaldatei übernimmt. |
| SurfaceBodies | Liest oder setzt, ob 3D Interconnect die Daten als Flächen übernimmt. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| GetAuthoringInfo | Liefert den Namen des Programms, mit dem die Originaldatei erstellt wurde. |
| GetReferencedFileName | Liefert Pfad und Namen der verknüpften Originaldatei des 3D-Interconnect-Features. |
| SetReferencedFileName | Setzt 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.