Objekt · SldWorks
SurfaceRadiateFeatureData-Objekt
Die Definition einer Ausstrahlungsfläche: die ausgestrahlten Kanten, die Richtungsreferenz, die Breite und die Richtung.
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
Feature.GetDefinition: bei einem Feature mit dem TypnamenRadiateRefSurface
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| DirectionReference | Liest oder setzt die Fläche, Ebene oder Oberfläche, die die Richtung der Ausstrahlungsfläche vorgibt. |
| Distance | Liest oder setzt die Breite der Ausstrahlungsfläche. |
| Flip | Liest oder setzt, ob die Ausstrahlungsfläche in die Gegenrichtung zeigt. |
| PropagateToTangentFaces | Liest oder setzt, ob sich die Ausstrahlungsfläche über tangentiale Flächen fortsetzt. |
| RadiatedEntities | Liest oder setzt die Kanten, von denen die Ausstrahlungsfläche ausgeht. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Ausstrahlungsfläche zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetRadiatedEntitiesCount | Liefert die Zahl der Kanten, von denen die Ausstrahlungsfläche ausgeht. |
| ReleaseSelectionAccess | Hebt 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.