SolidWorksMakroprogrammierung

Objekt · SldWorks

ScaleFeatureData-Objekt

Die Definition eines Skalieren-Features: Bezugspunkt, gleichmäßige oder getrennte Faktoren für X, Y und Z und die skalierten Körper.

Deklaration Dim x As SldWorks.ScaleFeatureData · in der englischen .NET-Hilfe: IScaleFeatureData

Beschreibung

ScaleFeatureData gibt Zugriff auf ein Skalieren-Feature. Es vergrößert oder verkleinert das Modell um den Schwerpunkt, den Ursprung oder ein Koordinatensystem, entweder gleichmäßig mit einem Faktor oder mit getrennten Faktoren für X, Y und Z. In Mehrkörperteilen legst du fest, welche Körper skaliert werden. Die meisten Befehle gibt es seit SOLIDWORKS 2001Plus.

Zugriff

Beispiel

' Gibt die Werte des ausgewählten Skalieren-Features aus und stellt es auf
' gleichmäßiges Skalieren mit dem Faktor 2 um.
' Vorbedingung: Ein Teil mit einem Skalieren-Feature ist offen, das Feature ist im
'               FeatureManager ausgewählt.
' Ergebnis:     Das Modell ist doppelt so groß, die alten Werte stehen im Direktfenster.
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.ScaleFeatureData
    Dim swKoord As SldWorks.Feature
    Dim dX As Double, dY As Double, dZ As Double
    Dim bGleich As Boolean

    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 <> "Scale" Then Exit Sub

    Set swDaten = swFeat.GetDefinition
    swDaten.GetScale dX, dY, dZ, bGleich
    Debug.Print swFeat.Name & ": X " & dX & ", Y " & dY & ", Z " & dZ & IIf(bGleich, " (gleichmäßig)", "")
    Select Case swDaten.Type
        Case swScaleAboutCentroid: Debug.Print "um den Schwerpunkt"
        Case swScaleAboutOrigin: Debug.Print "um den Ursprung"
        Case swScaleAboutCoordinateSystem
            Set swKoord = swDaten.CoordinateSystem
            If Not swKoord Is Nothing Then Debug.Print "um " & swKoord.Name
    End Select

    If swDaten.AccessSelections(swModel, Nothing) Then
        swDaten.SetScale 2#, 2#, 2#, True
        If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
    End If
End Sub

Bemerkungen

Faktoren: Bei gleichmäßigem Skalieren (ScaleFeatureData.IsUniform True) gilt ScaleFeatureData.ScaleUniform, sonst gelten ScaleFeatureData.ScaleX, ScaleFeatureData.ScaleY und ScaleFeatureData.ScaleZ. Alles auf einmal liest oder setzt du mit ScaleFeatureData.GetScale und ScaleFeatureData.SetScale. Die Faktoren sind reine Zahlen, das Hilfebeispiel zu FeatureManager.InsertScale skaliert mit 3.

Ändern: Nach ScaleFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du ScaleFeatureData.ReleaseSelectionAccess auf. Das Hilfebeispiel „Get Data for Scale Feature“ liest die Werte auch ohne AccessSelections.

Betroffene Flächen: Im Hilfebeispiel „Get Faces Affected by Scale Feature“ steht, dass Feature.GetFaces bei einem Skalieren-Feature keine Flächen liefert, weil es keine neuen Flächen erzeugt. Das Beispiel holt deshalb nach AccessSelections die Körper aus ScaleFeatureData.Bodies und merkt sich deren Flächen als Elemente, die den Neuaufbau überstehen (Entity.GetSafeEntity).

Eigenschaften und Methoden

Eigenschaften 8, davon 8 beschrieben

NameBeschreibung
BodiesLiest oder setzt die Körper, die das Skalieren-Feature in einem Mehrkörperteil skaliert.
CoordinateSystemLiest oder setzt das Koordinatensystem, um das das Skalieren-Feature skaliert.
IsUniformLiest oder setzt, ob das Skalieren-Feature gleichmäßig in allen Richtungen skaliert.
ScaleUniformLiest oder setzt den Faktor, mit dem das Skalieren-Feature gleichmäßig skaliert.
ScaleXLiest oder setzt den Faktor in X-Richtung, wenn das Skalieren-Feature nicht gleichmäßig skaliert.
ScaleYLiest oder setzt den Faktor in Y-Richtung, wenn das Skalieren-Feature nicht gleichmäßig skaliert.
ScaleZLiest oder setzt den Faktor in Z-Richtung, wenn das Skalieren-Feature nicht gleichmäßig skaliert.
TypeLiest oder setzt, worum das Skalieren-Feature skaliert: Schwerpunkt, Ursprung oder Koordinatensystem.

Methoden 5, davon 5 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Skalieren-Feature zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetBodiesCountLiefert die Zahl der Körper, die das Skalieren-Feature skaliert.
GetScaleLiefert die Faktoren des Skalieren-Features in X, Y und Z und ob es gleichmäßig skaliert.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Skalieren-Feature nicht geändert hast.
SetScaleSetzt die Faktoren des Skalieren-Features in X, Y und Z und ob es gleichmäßig skaliert.

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: IScaleFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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