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.
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
Feature.GetDefinition: aus einem Feature mit dem TypnamenBoundingBoxProfileFeatFeatureManager.CreateDefinitionmitswFmBoundingBox: eine neue Definition fürFeatureManager.CreateFeature
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| CoordinateSystem | Liest oder setzt das Koordinatensystem, nach dem sich der Begrenzungsrahmen richtet. |
| IncludeEnvelopeComponents | Liest oder setzt, ob der Begrenzungsrahmen Hüllkomponenten einschließt. |
| IncludeHiddenBodies | Liest oder setzt, ob der Begrenzungsrahmen ausgeblendete Körper einschließt. |
| IncludeHiddenComponents | Liest oder setzt, ob der Begrenzungsrahmen ausgeblendete Komponenten einschließt. |
| IncludeSurfaces | Liest oder setzt, ob der Begrenzungsrahmen Flächenkörper einschließt. |
| lwtaDirectionType | Liest oder setzt, welche Achsen des Koordinatensystems Länge, Breite und Dicke oder bei einem zylindrischen Begrenzungsrahmen die Achse festlegen. |
| PlanarEntity | Liest oder setzt die ebene Fläche oder Ebene, nach der sich der Begrenzungsrahmen richtet. |
| ReferenceFaceOrPlane | Liest oder setzt, wie der Begrenzungsrahmen ausgerichtet wird: beste Passung, nach einer Fläche oder Ebene oder nach einem Koordinatensystem. |
Methoden 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor den Begrenzungsrahmen zurück, damit du die Auswahlen lesen und ändern kannst, die ihn festlegen. |
| ReleaseSelectionAccess | Hebt 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.