Objekt · SldWorks
CavityFeatureData-Objekt
Die Feature-Daten eines Hohlraums (Cavity) für Formen: die Komponenten, die den Hohlraum bilden, und das Schwindmaß.
Beschreibung
CavityFeatureData gibt Zugriff auf ein Hohlraum-Feature. Ein Hohlraum entsteht in einer Formbasis aus der Form von Komponenten, etwa für ein Spritzgusswerkzeug. Damit das Werkstück nach dem Schwinden passt, lässt sich der Hohlraum skalieren. Du liest die Daten mit Feature.GetDefinition und übernimmst Änderungen mit Feature.ModifyDefinition.
Zugriff
Feature.GetDefinition: aus einem Hohlraum-Feature (TypnameCavity)
Neu anlegen kannst du einen Hohlraum mit AssemblyDoc.InsertCavity4.
Beispiel
' Gibt die Skalierung des ausgewählten Hohlraums aus und setzt ein gleichmäßiges Schwindmaß von 2.
' Vorbedingung: Eine Baugruppe ist offen. Im FeatureManager ist in der Formbasis
' ein Hohlraum-Feature ausgewählt.
' Ergebnis: Die alten Werte stehen im Direktfenster, der Hohlraum ist gleichmäßig skaliert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swFeat As SldWorks.Feature
Dim swComp As SldWorks.Component2
Dim swDaten As SldWorks.CavityFeatureData
Dim dX As Double, dY As Double, dZ As Double
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocASSEMBLY Then Exit Sub
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelBODYFEATURES Then Exit Sub
Set swFeat = swSelMgr.GetSelectedObject6(1, -1)
If swFeat.GetTypeName2 <> "Cavity" Then Exit Sub
Set swComp = swSelMgr.GetSelectedObjectsComponent4(1, -1) ' die Formbasis
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, swComp) Then Exit Sub
swDaten.GetScale dX, dY, dZ
Debug.Print "Skaliert um: " & swDaten.ScaleType & ", gleichmäßig: " & swDaten.UseUniformScale
Debug.Print "X: " & dX & ", Y: " & dY & ", Z: " & dZ & ", alle Richtungen: " & swDaten.UniformScale
swDaten.UseUniformScale = True
swDaten.UniformScale = 2
If False = swFeat.ModifyDefinition(swDaten, swModel, swComp) Then Debug.Print "Nicht geändert"
End SubBemerkungen
Ändern: Du rufst erst CavityFeatureData.AccessSelections auf und übernimmst Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit CavityFeatureData.ReleaseSelectionAccess auf.
Komponente übergeben: Die Tabelle bei AccessSelections sagt: In einer Baugruppe übergibst du die Komponente, in der das Feature liegt. Das Hilfebeispiel „Create and Modify Cavity Feature“ ändert einen Hohlraum in einer Komponente, übergibt aber Nothing. Das Beispiel hier übergibt die Komponente, die SelectionMgr.GetSelectedObjectsComponent4 zum ausgewählten Feature liefert.
Einheit des Schwindmaßes: Die Seiten zu CavityFeatureData nennen keine Einheit. In SOLIDWORKS 2024 war es ein Prozentwert wie bei InsertCavity4. Bei AssemblyDoc.InsertCavity4 ist das Schwindmaß ein Prozentwert zwischen -20 und 20. Das Hilfebeispiel setzt hier den Wert 2 und vergleicht ihn danach mit dem PropertyManager.
Zum Anlegen eines Hohlraums muss die Baugruppe gespeichert sein. Sonst liefert AssemblyDoc.EditPart2 -1, und es entsteht kein Hohlraum.
Eigenschaften und Methoden
Eigenschaften 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| Components | Liest oder setzt die Komponenten, deren Form den Hohlraum bildet. |
| ScaleType | Liest oder setzt, um welchen Punkt der Hohlraum skaliert wird, etwa um den Schwerpunkt oder den Ursprung. |
| UniformScale | Liest oder setzt das Schwindmaß, mit dem der Hohlraum in allen Richtungen gleich skaliert wird. |
| UseUniformScale | Liest oder setzt, ob der Hohlraum in allen Richtungen gleich skaliert wird. |
Methoden 5, davon 5 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor den Hohlraum zurück, damit du die Auswahlen lesen und ändern kannst, die ihn festlegen. |
| GetComponentsCount | Liefert die Zahl der Komponenten, deren Form den Hohlraum bildet. |
| GetScale | Liefert die Schwindmaße des Hohlraums in X, Y und Z. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du den Hohlraum nicht geändert hast. |
| SetScale | Setzt die Schwindmaße des Hohlraums in X, Y und Z. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetComponents). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ICavityFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.