SolidWorksMakroprogrammierung

Objekt · SldWorks

BrokenOutSectionFeatureData-Objekt

Die Feature-Daten eines Ausbruchs in einer Zeichenansicht: Tiefe, Referenz für die Tiefe und die Skizze der Kontur.

Deklaration Dim x As SldWorks.BrokenOutSectionFeatureData · in der englischen .NET-Hilfe: IBrokenOutSectionFeatureData

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

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 Sub

Bemerkungen

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

NameBeschreibung
DepthLiest oder setzt, wie tief der Ausbruch in das Modell hineinschneidet, in Metern.
DepthReferenceLiest oder setzt das Element, das die Tiefe des Ausbruchs festlegt.
EditSketchLiest oder setzt, ob der Ausbruch im Bearbeitungsmodus seiner Skizze ist. Davon hängt ab, ob du die Kontur oder die Tiefe bearbeitest.
SketchSegmentLiefert die Skizzenelemente, die die Kontur des Ausbruchs bilden.

Methoden 3, davon 3 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor den Ausbruch zurück, damit du die Auswahlen lesen und ändern kannst, die ihn festlegen.
GetSketchSegmentCountLiefert die Zahl der Skizzenelemente, die die Kontur des Ausbruchs bilden.
ReleaseSelectionAccessHebt 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.