SolidWorksMakroprogrammierung

Objekt · SldWorks

SMNormalCutFeatureData2-Objekt

Die Definition eines Normal-Schnitts im Blech: die Flächengruppen eines schrägen Schnitts, Schnittrichtung, Versatzebene und Optionen.

Deklaration Dim x As SldWorks.SMNormalCutFeatureData2 · in der englischen .NET-Hilfe: ISMNormalCutFeatureData2

Beschreibung

SMNormalCutFeatureData2 gibt Zugriff auf einen Normal-Schnitt im Blech. Ein Schnitt, der ein Blechteil schräg durchstößt, hat Seitenwände, die nicht senkrecht zum Blech stehen. Ein Normal-Schnitt macht diese Seitenwände senkrecht. Die schrägen Flächen fasst er in Flächengruppen (SMNormalCutGroupData) zusammen. Das Objekt ersetzt SMNormalCutFeatureData. Die Befehle gibt es seit SOLIDWORKS 2019.

Zugriff

Beispiel

' Legt aus den ausgewählten schrägen Seitenflächen eines Schnitts einen Normal-Schnitt an.
' Tangentiale Flächen kommen von selbst dazu, geschnitten wird so weit wie möglich.
' Vorbedingung: Ein Blechteil mit einem schrägen Schnitt ist offen. Eine oder mehrere
'               schräge Seitenflächen des Schnitts sind mit der Markierung 1 ausgewählt,
'               etwa mit SelectByRay oder SelectByID2 und Mark = 1.
' Ergebnis:     Ein neuer Normal-Schnitt im FeatureManager.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeatMgr As SldWorks.FeatureManager
    Dim swDaten As SldWorks.SMNormalCutFeatureData2
    Dim swGruppe As SldWorks.SMNormalCutGroupData
    Dim swFeat As SldWorks.Feature
    Dim nFehler As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swFeatMgr = swModel.FeatureManager

    Set swDaten = swFeatMgr.CreateDefinition(swFmNormalCut)
    swDaten.AutoPropagation = True
    swDaten.OptimizeGeometry = True
    swDaten.NormalCutParameters = swNormalCutExtent

    Set swGruppe = swDaten.CreateGroup(nFehler)          ' aus den ausgewählten Flächen
    If nFehler <> swAddNormalCutGroup_Success Then
        Debug.Print "Flächengruppe nicht angelegt"
        Exit Sub
    End If
    Set swFeat = swFeatMgr.CreateFeature(swDaten)
    If swFeat Is Nothing Then
        Debug.Print "Normal-Schnitt nicht angelegt"
    Else
        Debug.Print swFeat.Name & " mit Gruppe " & swGruppe.GetGroupName
    End If
End Sub

Bemerkungen

Anlegen: So gehst du vor:

  1. FeatureManager.CreateDefinition mit swFmNormalCut aufrufen und die Werte setzen, die keine Elemente sind.
  2. Bei swNormalCutOffsetPlane die Versatzebene mit der Markierung 4 auswählen, bei swNormalCutExtent die Schnittrichtung mit der Markierung 8 (ModelDocExtension.SelectByRay oder ModelDocExtension.SelectByID2).
  3. Die schrägen Flächen einer Gruppe mit der Markierung 1 auswählen und SMNormalCutFeatureData2.CreateGroup aufrufen. Für jede weitere Gruppe wiederholst du Schritt 2 und 3 und rufst nach jeder Gruppe ModelDoc2.ClearSelection2 auf.
  4. FeatureManager.CreateFeature aufrufen.

Ändern: Nach SMNormalCutFeatureData2.AccessSelections liest du die Gruppen mit SMNormalCutFeatureData2.GetGroupNames und SMNormalCutFeatureData2.GetGroupByName, legst bei Bedarf mit SMNormalCutFeatureData2.CreateGroup weitere an und änderst die übrigen Werte. Dann rufst du Feature.ModifyDefinition auf, oder SMNormalCutFeatureData2.ReleaseSelectionAccess, wenn du nichts geändert hast. Auswahlen von vor AccessSelections gelten nicht mehr. Elemente wie die Schnittrichtung wählst du deshalb danach aus, etwa mit ModelDocExtension.SelectByRay und SelectionMgr.GetSelectedObject6.

Vorgänger: Das ältere SMNormalCutFeatureData stammt aus SOLIDWORKS 2018 und ist veraltet. Dort gab es statt der benannten Gruppen die Methode AddAGroupOfFaces und eine Lage zwischen 0 und 1 (Offset).

Eigenschaften und Methoden

Eigenschaften 7, davon 7 beschrieben

NameBeschreibung
AutoPropagationLiest oder setzt, ob tangentiale Flächen von selbst in die Flächengruppe des Normal-Schnitts kommen.
CutDirectionLiest oder setzt die Kante, gerade Kurve oder ebene Fläche, die die Richtung des Normal-Schnitts festlegt.
LayerAdjustmentValueLiest oder setzt die Lage der Versatzebene im Blech als Wert zwischen 0 und 1.
LinkToKFactorLiest oder setzt, ob die Versatzebene des Normal-Schnitts an den K-Faktor gekoppelt wird.
NormalCutParametersLiest oder setzt, wie der Normal-Schnitt schneidet: so weit wie möglich oder an einer Versatzebene.
OffsetPlaneReferenceLiest oder setzt die Referenz für die Versatzebene des Normal-Schnitts: eine Ebene oder die Ober- oder Unterseite des Blechs.
OptimizeGeometryLiest oder setzt, ob die Geometrie des Normal-Schnitts optimiert wird.

Methoden 6, davon 6 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor den Normal-Schnitt zurück, damit du die Auswahlen lesen und ändern kannst, die ihn festlegen.
CreateGroupLegt aus den ausgewählten Flächen eine neue Flächengruppe des Normal-Schnitts an.
DeleteGroupByNameLöscht eine Flächengruppe des Normal-Schnitts anhand ihres Namens.
GetGroupByNameLiefert eine Flächengruppe des Normal-Schnitts anhand ihres Namens.
GetGroupNamesLiefert die Namen aller Flächengruppen des Normal-Schnitts.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du den Normal-Schnitt nicht geändert hast.

Siehe auch

Englisches Original: ISMNormalCutFeatureData2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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