SolidWorksMakroprogrammierung

Objekt · SldWorks

SurfaceOffsetFeatureData-Objekt

Die Definition des Features „Oberfläche versetzen“: die versetzten Flächen und Oberflächen, der Abstand und die Richtung.

Deklaration Dim x As SldWorks.SurfaceOffsetFeatureData · in der englischen .NET-Hilfe: ISurfaceOffsetFeatureData

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 Hilfe OffsetRefSuface; GetTypeName2 liefert OffsetRefSurface.

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 Sub

Bemerkungen

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

NameBeschreibung
DistanceLiest oder setzt den Abstand, um den das Feature „Oberfläche versetzen“ die Flächen versetzt.
EntitiesLiest oder setzt die Flächen und Oberflächen, die das Feature „Oberfläche versetzen“ versetzt.
Facesveraltet ersetzt durch SurfaceOffsetFeatureData.Entities
FlipLiest oder setzt, ob das Feature „Oberfläche versetzen“ in die Gegenrichtung versetzt.

Methoden 4, davon 3 beschrieben, 1 veraltet

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Oberfläche versetzen“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetEntitiesCountLiefert die Zahl der Flächen und Oberflächen, die das Feature „Oberfläche versetzen“ versetzt.
GetFacesCountveraltet ersetzt durch SurfaceOffsetFeatureData.GetEntitiesCount
ReleaseSelectionAccessHebt 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.