SolidWorksMakroprogrammierung

Objekt · SldWorks

CavityFeatureData-Objekt

Die Feature-Daten eines Hohlraums (Cavity) für Formen: die Komponenten, die den Hohlraum bilden, und das Schwindmaß.

Deklaration Dim x As SldWorks.CavityFeatureData · in der englischen .NET-Hilfe: ICavityFeatureData

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

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 Sub

Bemerkungen

Ä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

NameBeschreibung
ComponentsLiest oder setzt die Komponenten, deren Form den Hohlraum bildet.
ScaleTypeLiest oder setzt, um welchen Punkt der Hohlraum skaliert wird, etwa um den Schwerpunkt oder den Ursprung.
UniformScaleLiest oder setzt das Schwindmaß, mit dem der Hohlraum in allen Richtungen gleich skaliert wird.
UseUniformScaleLiest oder setzt, ob der Hohlraum in allen Richtungen gleich skaliert wird.

Methoden 5, davon 5 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor den Hohlraum zurück, damit du die Auswahlen lesen und ändern kannst, die ihn festlegen.
GetComponentsCountLiefert die Zahl der Komponenten, deren Form den Hohlraum bildet.
GetScaleLiefert die Schwindmaße des Hohlraums in X, Y und Z.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du den Hohlraum nicht geändert hast.
SetScaleSetzt 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.