Objekt · SldWorks
BrokenOutSectionFeatureData-Objekt
Die Feature-Daten eines Ausbruchs in einer Zeichenansicht: Tiefe, Referenz für die Tiefe und die Skizze der Kontur.
Beschreibung
BrokenOutSectionFeatureData gibt Zugriff auf die Daten eines Ausbruchs in einer Zeichenansicht. Ein Ausbruch schneidet einen Teil der Ansicht innerhalb einer geschlossenen Kontur bis zu einer Tiefe weg und zeigt so innere Details. Du liest die Daten mit Feature.GetDefinition und übernimmst Änderungen mit Feature.ModifyDefinition.
Zugriff
Feature.GetDefinition: aus dem Feature eines Ausbruchs, etwa ausView.GetBreakOutSections(TypnameDrBreakoutSectionLine)
Neu anlegen kannst du einen Ausbruch mit DrawingDoc.CreateBreakOutSection.
Beispiel
' Gibt für jeden Ausbruch in jeder Zeichenansicht der aktiven Zeichnung
' die Tiefe und die Zahl der Skizzenelemente der Kontur aus.
' Vorbedingung: Eine Zeichnung mit mindestens einem Ausbruch ist offen.
' Ergebnis: Die Werte stehen im Direktfenster, die Zeichnung bleibt unverändert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swView As SldWorks.View
Dim swFeat As SldWorks.Feature
Dim swAusbruch As SldWorks.BrokenOutSectionFeatureData
Dim vBlaetter As Variant, vAnsichten As Variant, vAusbrueche As Variant
Dim i As Long, j As Long, k As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocDRAWING Then Exit Sub
Set swDraw = swModel
swModel.ClearSelection2 True
vBlaetter = swDraw.GetViews
For i = 0 To UBound(vBlaetter)
vAnsichten = vBlaetter(i)
For j = 1 To UBound(vAnsichten) ' 0 ist das Blatt selbst
Set swView = vAnsichten(j)
vAusbrueche = swView.GetBreakOutSections
If IsArray(vAusbrueche) Then
For k = 0 To UBound(vAusbrueche)
Set swFeat = vAusbrueche(k)
Set swAusbruch = swFeat.GetDefinition
If swAusbruch.AccessSelections(swModel, Nothing) Then
Debug.Print swView.GetName2 & ", " & swFeat.Name
If swAusbruch.DepthReference Is Nothing Then
Debug.Print " Tiefe: " & swAusbruch.Depth * 1000 & " mm"
Else
Debug.Print " Tiefe über ein Element festgelegt"
End If
swAusbruch.EditSketch = True
Debug.Print " Kontur: " & swAusbruch.GetSketchSegmentCount & " Skizzenelemente"
swAusbruch.ReleaseSelectionAccess
End If
Next k
End If
Next j
Next i
End SubBemerkungen
Kontur oder Tiefe: Du schaltest mit BrokenOutSectionFeatureData.EditSketch um. Mit True liest du die Skizzenelemente der Kontur, mit False setzt du die Tiefe.
Tiefe: Die Tiefe gibst du entweder als Zahl in BrokenOutSectionFeatureData.Depth an oder über ein Element in BrokenOutSectionFeatureData.DepthReference. Die Zahl gilt nur, wenn keine Referenz gesetzt und die Auswahlliste leer ist. Das Beispiel hebt die Auswahl deshalb vorher auf, wie das Hilfebeispiel „Get Broken-Out Section Feature Data“.
Ändern: Du rufst erst BrokenOutSectionFeatureData.AccessSelections auf und übernimmst Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit BrokenOutSectionFeatureData.ReleaseSelectionAccess auf. Das Hilfebeispiel ändert so die Radien der Kontur.
Zwei Objekte zum Feature: Nach Feature.GetTypeName2 steht hinter dem Feature DrBreakoutSectionLine entweder ein DrSection oder ein BrokenOutSectionFeatureData. Die Feature-Daten liefert Feature.GetDefinition.
Eigenschaften und Methoden
Eigenschaften 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| Depth | Liest oder setzt, wie tief der Ausbruch in das Modell hineinschneidet, in Metern. |
| DepthReference | Liest oder setzt das Element, das die Tiefe des Ausbruchs festlegt. |
| EditSketch | Liest oder setzt, ob der Ausbruch im Bearbeitungsmodus seiner Skizze ist. Davon hängt ab, ob du die Kontur oder die Tiefe bearbeitest. |
| SketchSegment | Liefert die Skizzenelemente, die die Kontur des Ausbruchs bilden. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor den Ausbruch zurück, damit du die Auswahlen lesen und ändern kannst, die ihn festlegen. |
| GetSketchSegmentCount | Liefert die Zahl der Skizzenelemente, die die Kontur des Ausbruchs bilden. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du den Ausbruch nicht geändert hast. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IBrokenOutSectionFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.