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.
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
Feature.GetDefinition: bei einem Feature mit dem TypnamenScale- Neu anlegen kannst du das Feature mit
FeatureManager.InsertScale.
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Bodies | Liest oder setzt die Körper, die das Skalieren-Feature in einem Mehrkörperteil skaliert. |
| CoordinateSystem | Liest oder setzt das Koordinatensystem, um das das Skalieren-Feature skaliert. |
| IsUniform | Liest oder setzt, ob das Skalieren-Feature gleichmäßig in allen Richtungen skaliert. |
| ScaleUniform | Liest oder setzt den Faktor, mit dem das Skalieren-Feature gleichmäßig skaliert. |
| ScaleX | Liest oder setzt den Faktor in X-Richtung, wenn das Skalieren-Feature nicht gleichmäßig skaliert. |
| ScaleY | Liest oder setzt den Faktor in Y-Richtung, wenn das Skalieren-Feature nicht gleichmäßig skaliert. |
| ScaleZ | Liest oder setzt den Faktor in Z-Richtung, wenn das Skalieren-Feature nicht gleichmäßig skaliert. |
| Type | Liest oder setzt, worum das Skalieren-Feature skaliert: Schwerpunkt, Ursprung oder Koordinatensystem. |
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Skalieren-Feature zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetBodiesCount | Liefert die Zahl der Körper, die das Skalieren-Feature skaliert. |
| GetScale | Liefert die Faktoren des Skalieren-Features in X, Y und Z und ob es gleichmäßig skaliert. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Skalieren-Feature nicht geändert hast. |
| SetScale | Setzt 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.