Objekt · SldWorks
GroundPlaneFeatureData-Objekt
Die Definition einer Bodenebene in einer Baugruppe: die ebene Fläche oder Ebene, auf der sie liegt, und ihre Richtung.
Beschreibung
GroundPlaneFeatureData gibt Zugriff auf eine Bodenebene (ground plane). Bodenebenen fügst du in jeder Ebene einer Anlagen-Baugruppe ein (Large Assemblies > Facility Layout). Sie dienen als Referenzgeometrie, wenn du dort veröffentlichte Assets einfügst: Die Bodenfläche des Assets rastet auf der aktiven Bodenebene der Baugruppe ein. Die Befehle gibt es seit SOLIDWORKS 2019.
Zugriff
FeatureManager.CreateDefinitionmitswFmGroundPlane(swFeatureNameID_e): eine neue Definition, die du mitFeatureManager.CreateFeatureals Bodenebene einfügstFeature.GetDefinition: bei einem Feature mit dem TypnamenGroundPlane
Beispiel
' Legt auf der ausgewählten ebenen Fläche eine Bodenebene an und aktiviert sie
' in der aktiven Konfiguration.
' Vorbedingung: Eine Baugruppe ist offen, eine ebene Fläche oder eine Ebene ist
' ausgewählt.
' Ergebnis: Die Bodenebene steht im Ordner Ground Planes des FeatureManagers
' und ist aktiv.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swAssy As SldWorks.AssemblyDoc
Dim swEbene As Object
Dim swDaten As SldWorks.GroundPlaneFeatureData
Dim swFeat 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 swAssy = swModel
Set swEbene = swModel.SelectionManager.GetSelectedObject6(1, -1)
If swEbene Is Nothing Then Exit Sub
Set swDaten = swModel.FeatureManager.CreateDefinition(swFmGroundPlane)
swDaten.PlanarEntity = swEbene
swDaten.ReverseDirection = False
Set swFeat = swModel.FeatureManager.CreateFeature(swDaten)
swModel.ClearSelection2 True
If swFeat Is Nothing Then
Debug.Print "Bodenebene wurde nicht angelegt."
Exit Sub
End If
swFeat.Select2 False, 0
If swAssy.ActivateGroundPlane(swThisConfiguration, Empty) Then
Debug.Print swFeat.Name & " ist aktiv."
End If
End SubBemerkungen
Anlegen: Das Hilfebeispiel wählt eine Fläche mit ModelDocExtension.SelectByRay aus, holt sie aus der Auswahl, setzt sie mit GroundPlaneFeatureData.PlanarEntity in die Definition aus FeatureManager.CreateDefinition und legt die Bodenebene mit FeatureManager.CreateFeature an. Der frühere Befehl FeatureManager.InsertGroundPlane ist veraltet.
Ändern: Nach GroundPlaneFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du GroundPlaneFeatureData.ReleaseSelectionAccess auf.
Aktivieren: Eine Bodenebene aktivierst du mit AssemblyDoc.ActivateGroundPlane, nachdem du sie ausgewählt hast. Je Konfiguration ist nur eine Bodenebene aktiv. Komponenten mit magnetischen Verknüpfungen rasten nur an Komponenten ein, die auch auf der aktiven Bodenebene liegen. Welche Bodenebene aktiv ist, liefert AssemblyDoc.GetActiveGroundPlane. Das Hilfebeispiel zu InsertGroundPlane wählt die Bodenebene dafür mit dem Typ MAGNETICGROUNDPLANE aus. Ob Feature.Select2 dasselbe leistet, sagt die Hilfe nicht, vermutlich ja.
Typname: In der Liste bei Feature.GetTypeName2 hat eine Bodenebene den Typnamen GroundPlane und liefert eine GroundPlaneFeatureData. Dieselbe Liste nennt unter Baugruppe auch den Typnamen MagneticGroundPlane mit Feature als Objekt. Was davon eine Bodenebene im Ordner Ground Planes liefert, sagt die Hilfe nicht.
Eine Bodenebene hat bei Feature.GetTypeName2 den Typnamen MagneticGroundPlane und steht im Ordner mit dem Typnamen GroundPlaneFolder.
Eigenschaften und Methoden
Eigenschaften 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| PlanarEntity | Liest oder setzt die ebene Fläche oder Ebene, auf der die Bodenebene liegt. |
| ReverseDirection | Liest oder setzt, ob die Ausrichtung der Bodenebene umgekehrt ist. |
Methoden 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Bodenebene zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Bodenebene nicht geändert hast. |
Siehe auch
Englisches Original: IGroundPlaneFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.