SolidWorksMakroprogrammierung

Objekt · SldWorks

GroundPlaneFeatureData-Objekt

Die Definition einer Bodenebene in einer Baugruppe: die ebene Fläche oder Ebene, auf der sie liegt, und ihre Richtung.

Deklaration Dim x As SldWorks.GroundPlaneFeatureData · in der englischen .NET-Hilfe: IGroundPlaneFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
PlanarEntityLiest oder setzt die ebene Fläche oder Ebene, auf der die Bodenebene liegt.
ReverseDirectionLiest oder setzt, ob die Ausrichtung der Bodenebene umgekehrt ist.

Methoden 2, davon 2 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Bodenebene zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
ReleaseSelectionAccessHebt 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.