SolidWorksMakroprogrammierung

Objekt · SldWorks

SurfaceRadiateFeatureData-Objekt

Die Definition einer Ausstrahlungsfläche: die ausgestrahlten Kanten, die Richtungsreferenz, die Breite und die Richtung.

Deklaration Dim x As SldWorks.SurfaceRadiateFeatureData · in der englischen .NET-Hilfe: ISurfaceRadiateFeatureData

Beschreibung

SurfaceRadiateFeatureData gibt Zugriff auf eine Ausstrahlungsfläche (radiate surface). Sie strahlt von Kanten aus eine Fläche in einer bestimmten Breite ab, parallel zu einer Fläche, Ebene oder Oberfläche, die die Richtung vorgibt. Auf Wunsch setzt sie sich über tangentiale Flächen fort. Die Befehle gibt es seit SOLIDWORKS 2001Plus SP02.

Zugriff

Beispiel

' Gibt die Daten der ausgewählten Ausstrahlungsfläche aus und macht sie 5 mm breiter.
' Vorbedingung: Ein Teil mit einer Ausstrahlungsfläche ist offen, das Feature ist
'               im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, die Fläche ist breiter.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.SurfaceRadiateFeatureData
    Dim swEnt As SldWorks.Entity
    Dim vKanten As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    If swFeat.GetTypeName2 <> "RadiateRefSurface" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    Debug.Print swFeat.Name & ": Breite " & swDaten.Distance * 1000 & " mm, umgekehrt " & swDaten.Flip & _
                ", tangential fortsetzen " & swDaten.PropagateToTangentFaces

    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    vKanten = swDaten.RadiatedEntities
    For i = 0 To swDaten.GetRadiatedEntitiesCount - 1
        Set swEnt = vKanten(i)
        Debug.Print "  Element " & i & ": Art " & swEnt.GetType   ' swSelectType_e
    Next i
    swDaten.Distance = swDaten.Distance + 0.005
    If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Anlegen: Die Fläche legst du mit ModelDoc2.InsertRadiateSurface an. Vorher wählst du die Richtungsreferenz mit der Markierung 1 und die Kanten mit der Markierung 2 aus. So macht es das Hilfebeispiel „Create Planar Surface Feature“, das die Ausstrahlungsfläche auch ausliest.

Ändern: Nach SurfaceRadiateFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du SurfaceRadiateFeatureData.ReleaseSelectionAccess auf.

Einheiten: Für die Breite nennt die Hilfe keine Einheit. Das Hilfebeispiel rechnet sie mit * 1000 in Millimeter um, die Eigenschaft liefert also Meter.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
DirectionReferenceLiest oder setzt die Fläche, Ebene oder Oberfläche, die die Richtung der Ausstrahlungsfläche vorgibt.
DistanceLiest oder setzt die Breite der Ausstrahlungsfläche.
FlipLiest oder setzt, ob die Ausstrahlungsfläche in die Gegenrichtung zeigt.
PropagateToTangentFacesLiest oder setzt, ob sich die Ausstrahlungsfläche über tangentiale Flächen fortsetzt.
RadiatedEntitiesLiest oder setzt die Kanten, von denen die Ausstrahlungsfläche ausgeht.

Methoden 3, davon 3 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die Ausstrahlungsfläche zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetRadiatedEntitiesCountLiefert die Zahl der Kanten, von denen die Ausstrahlungsfläche ausgeht.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Ausstrahlungsfläche nicht geändert hast.

Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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