SolidWorksMakroprogrammierung

Objekt · SldWorks

BoundingBoxFeatureData-Objekt

Die Feature-Daten eines Begrenzungsrahmens: Ausrichtung nach bester Passung, Fläche, Ebene oder Koordinatensystem und welche Körper er einschließt.

Deklaration Dim x As SldWorks.BoundingBoxFeatureData · in der englischen .NET-Hilfe: IBoundingBoxFeatureData

Beschreibung

BoundingBoxFeatureData gibt Zugriff auf einen Begrenzungsrahmen (Typname BoundingBoxProfileFeat). Das ist ein Quader oder Zylinder, der ein Teil oder eine Baugruppe umschließt. Du liest die Daten mit Feature.GetDefinition und übernimmst Änderungen mit Feature.ModifyDefinition. Mit FeatureManager.CreateDefinition legst du einen neuen Begrenzungsrahmen an.

Zugriff

Beispiel

' Legt einen Begrenzungsrahmen an, der sich nach der ausgewählten ebenen Fläche richtet,
' und gibt den Durchmesser der Kugel aus, die ihn umschließt.
' Vorbedingung: Ein Teil ohne Begrenzungsrahmen ist offen, eine ebene Fläche ist ausgewählt.
' Ergebnis:     Der Begrenzungsrahmen steht im FeatureManager, der Durchmesser im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeatMgr As SldWorks.FeatureManager
    Dim swFlaeche As Object
    Dim swRahmen As SldWorks.BoundingBoxFeatureData
    Dim swFeat As SldWorks.Feature

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.SelectionManager.GetSelectedObjectType3(1, -1) <> swSelFACES Then Exit Sub
    Set swFlaeche = swModel.SelectionManager.GetSelectedObject6(1, -1)

    Set swFeatMgr = swModel.FeatureManager
    Set swRahmen = swFeatMgr.CreateDefinition(swFmBoundingBox)
    swRahmen.ReferenceFaceOrPlane = swBoundingBoxType_CustomPlane
    swRahmen.PlanarEntity = swFlaeche                              ' wie im Hilfebeispiel ohne Set
    swRahmen.IncludeSurfaces = True
    Set swFeat = swFeatMgr.CreateFeature(swRahmen)
    swModel.ClearSelection2 True
    If swFeat Is Nothing Then
        Debug.Print "Begrenzungsrahmen wurde nicht angelegt."
    Else
        Debug.Print swFeat.Name & ": umschließende Kugel " & _
                    swModel.Extension.GetSphericalBoxDiameter * 1000 & " mm"
    End If
End Sub

Bemerkungen

Anlegen und ändern: So legt auch das Hilfebeispiel „Create Bounding Box“ einen Begrenzungsrahmen an. Zum Ändern rufst du BoundingBoxFeatureData.AccessSelections auf, änderst die Werte und übernimmst sie mit Feature.ModifyDefinition. Bei FeatureManager.CreateDefinition ist die neue Definition schon mit Vorgaben gefüllt. In SOLIDWORKS 2024 stand BoundingBoxFeatureData.ReferenceFaceOrPlane dabei auf 0 und IncludeSurfaces auf False, und FeatureManager.CreateFeature lieferte damit Nothing. Erst mit swBoundingBoxType_BestFit und IncludeSurfaces = True entstand der Rahmen.

Ausrichtung: Welche Eigenschaften gelten, hängt von BoundingBoxFeatureData.ReferenceFaceOrPlane ab. BoundingBoxFeatureData.PlanarEntity gilt nur bei swBoundingBoxType_CustomPlane, BoundingBoxFeatureData.CoordinateSystem und BoundingBoxFeatureData.lwtaDirectionType nur bei swBoundingBoxType_CustomCoordSys.

Anzeigen und Auswahl: Du blendest die Skizze des Begrenzungsrahmens mit der Dokumenteigenschaft swViewDispGlobalBBox (swUserPreferenceToggle_e) ein oder aus. Die Auswahl, die beim Anlegen entsteht, hebst du mit ModelDoc2.ClearSelection2 auf.

Ohne Feature-Daten: Einen Begrenzungsrahmen fügst du auch direkt mit FeatureManager.InsertGlobalBoundingBox2 ein. Die Ausmaße eines Teils ohne Feature liefert PartDoc.GetPartBox.

Eigenschaften und Methoden

Eigenschaften 8, davon 8 beschrieben

NameBeschreibung
CoordinateSystemLiest oder setzt das Koordinatensystem, nach dem sich der Begrenzungsrahmen richtet.
IncludeEnvelopeComponentsLiest oder setzt, ob der Begrenzungsrahmen Hüllkomponenten einschließt.
IncludeHiddenBodiesLiest oder setzt, ob der Begrenzungsrahmen ausgeblendete Körper einschließt.
IncludeHiddenComponentsLiest oder setzt, ob der Begrenzungsrahmen ausgeblendete Komponenten einschließt.
IncludeSurfacesLiest oder setzt, ob der Begrenzungsrahmen Flächenkörper einschließt.
lwtaDirectionTypeLiest oder setzt, welche Achsen des Koordinatensystems Länge, Breite und Dicke oder bei einem zylindrischen Begrenzungsrahmen die Achse festlegen.
PlanarEntityLiest oder setzt die ebene Fläche oder Ebene, nach der sich der Begrenzungsrahmen richtet.
ReferenceFaceOrPlaneLiest oder setzt, wie der Begrenzungsrahmen ausgerichtet wird: beste Passung, nach einer Fläche oder Ebene oder nach einem Koordinatensystem.

Methoden 2, davon 2 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor den Begrenzungsrahmen zurück, damit du die Auswahlen lesen und ändern kannst, die ihn festlegen.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du den Begrenzungsrahmen nicht geändert hast.

Siehe auch

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

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