Objekt · SldWorks
SurfaceOffsetFeatureData-Objekt
Die Definition des Features „Oberfläche versetzen“: die versetzten Flächen und Oberflächen, der Abstand und die Richtung.
Beschreibung
SurfaceOffsetFeatureData gibt Zugriff auf ein Feature „Oberfläche versetzen“. Es legt zu Flächen oder Oberflächen eine neue Oberfläche in einem Abstand an. Die Befehle gibt es seit SOLIDWORKS 2001Plus SP01.
Veraltet sind SurfaceOffsetFeatureData.Faces und SurfaceOffsetFeatureData.GetFacesCount. An ihre Stelle treten SurfaceOffsetFeatureData.Entities und SurfaceOffsetFeatureData.GetEntitiesCount.
Zugriff
Feature.GetDefinition: bei einem Feature „Oberfläche versetzen“. Den Typnamen schreibt die HilfeOffsetRefSuface; GetTypeName2 liefertOffsetRefSurface.
Beispiel
' Gibt Abstand, Richtung und Zahl der Flächen des ausgewählten Features
' „Oberfläche versetzen“ aus und verdoppelt den Abstand.
' Vorbedingung: Ein Teil mit einem Feature „Oberfläche versetzen“ ist offen, das
' Feature ist im FeatureManager ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, der Abstand ist doppelt so groß.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swFeat As SldWorks.Feature
Dim swDef As Object
Dim swDaten As SldWorks.SurfaceOffsetFeatureData
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
Set swDef = swFeat.GetDefinition
If Not TypeOf swDef Is SldWorks.SurfaceOffsetFeatureData Then Exit Sub
Set swDaten = swDef
Debug.Print swFeat.Name & ": Abstand " & swDaten.Distance * 1000 & " mm, umgekehrt " & swDaten.Flip & _
", " & swDaten.GetEntitiesCount & " Fläche(n)/Oberfläche(n)"
If swDaten.AccessSelections(swModel, Nothing) Then
swDaten.Distance = swDaten.Distance * 2
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End If
End SubBemerkungen
Anlegen: Das Feature legst du mit ModelDoc2.InsertOffsetSurface an, nachdem du die Flächen oder Oberflächen ausgewählt hast.
Ändern: Nach SurfaceOffsetFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du SurfaceOffsetFeatureData.ReleaseSelectionAccess auf. Das Hilfebeispiel „Get Offset Surface Data“ liest so auch Features in einer Komponente einer Baugruppe aus.
Einheiten: Für den Abstand nennt die Hilfe keine Einheit. Das Hilfebeispiel rechnet ihn mit * 1000 in Millimeter um, die Eigenschaft liefert also Meter.
Eigenschaften und Methoden
Eigenschaften 4, davon 3 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| Distance | Liest oder setzt den Abstand, um den das Feature „Oberfläche versetzen“ die Flächen versetzt. |
| Entities | Liest oder setzt die Flächen und Oberflächen, die das Feature „Oberfläche versetzen“ versetzt. |
| Faces | veraltet ersetzt durch SurfaceOffsetFeatureData.Entities |
| Flip | Liest oder setzt, ob das Feature „Oberfläche versetzen“ in die Gegenrichtung versetzt. |
Methoden 4, davon 3 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Feature „Oberfläche versetzen“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetEntitiesCount | Liefert die Zahl der Flächen und Oberflächen, die das Feature „Oberfläche versetzen“ versetzt. |
| GetFacesCount | veraltet ersetzt durch SurfaceOffsetFeatureData.GetEntitiesCount |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Oberfläche versetzen“ nicht geändert hast. |
Nicht aufgeführt sind 5 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ISurfaceOffsetFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.