SolidWorksMakroprogrammierung

Objekt · SldWorks

IntersectFeatureData-Objekt

Die Definition eines Features „Überschneiden“: die Körper, Oberflächen und Ebenen, die sich überschneiden, die entstandenen Bereiche und welche davon weggelassen werden.

Deklaration Dim x As SldWorks.IntersectFeatureData · in der englischen .NET-Hilfe: IIntersectFeatureData

Beschreibung

IntersectFeatureData gibt Zugriff auf ein Feature „Überschneiden“ (intersect). Es bildet aus Volumenkörpern, Oberflächen und Ebenen, die sich überschneiden, Bereiche (intersect regions). Einzelne Bereiche kannst du weglassen, die übrigen werden zu Körpern. Die Befehle gibt es seit SOLIDWORKS 2015.

Zugriff

Angelegt wird das Feature mit FeatureManager.PreIntersect2 und FeatureManager.PostIntersect.

Beispiel

' Gibt für das ausgewählte Feature „Überschneiden“ die Einstellungen, die Zahl der
' Werkzeuge und für jeden Bereich aus, ob er weggelassen wird.
' Vorbedingung: Ein Teil mit einem Feature „Überschneiden“ ist offen, das Feature
'               ist im FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, das Teil bleibt unverändert.
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.IntersectFeatureData
    Dim vBereiche As Variant, vWeg As Variant
    Dim i As Long

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

    Set swDaten = swFeat.GetDefinition
    Debug.Print swFeat.Name & ": verschmelzen " & swDaten.Merge & ", Oberflächen entfernen " & _
                swDaten.Consume & ", ebene Öffnungen schließen " & swDaten.CapPlanar
    Debug.Print swDaten.GetIntersectionsToolsCount & " Werkzeug(e), " & _
                swDaten.GetIntersectionsCount & " Bereich(e)"

    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    vBereiche = swDaten.GetIntersections(vWeg)
    If IsArray(vBereiche) Then
        For i = 0 To UBound(vBereiche)
            Debug.Print "  Bereich " & i + 1 & IIf(vWeg(i), ": weggelassen", ": behalten")
        Next i
    End If
    swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Typname: Die Tabelle zu Feature.GetTypeName2 ordnet IntersectFeatureData dem Typnamen Sculpt zu. Ein eigenes Hilfebeispiel, das den Typnamen prüft, gibt es nicht. Liefert dein Feature einen anderen Namen, prüf stattdessen mit TypeOf swFeat.GetDefinition Is SldWorks.IntersectFeatureData.

Hilfebeispiele: „Get Intersect Feature Data“ legt das Feature mit dem veralteten PreIntersect und FeatureManager.PostIntersect an, färbt die Bereiche dazwischen mit Body2.Display3 ein und lässt den zweiten Bereich weg. Danach liest es Merge, Consume, CapPlanar und die beiden Zahlen, ohne AccessSelections aufzurufen. „Create Intersect Feature“ legt das Feature mit FeatureManager.PreIntersect2 aus einem Körper und einer Ebene an.

Ändern: Nach IntersectFeatureData.AccessSelections liest du die Bereiche mit IntersectFeatureData.GetIntersections, legst mit IntersectFeatureData.SetIntersections fest, welche weggelassen werden, und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du IntersectFeatureData.ReleaseSelectionAccess auf. Ob GetIntersections, GetIntersectionsTools und die Set-Befehle AccessSelections brauchen, sagt die Hilfe nicht ausdrücklich; die Beispiele holen den Zugriff vorher.

Eigenschaften und Methoden

Eigenschaften 3, davon 3 beschrieben

NameBeschreibung
CapPlanarLiest oder setzt, ob das Feature „Überschneiden“ ebene Öffnungen von Oberflächen schließt.
ConsumeLiest oder setzt, ob das Feature „Überschneiden“ die verwendeten Oberflächen aus dem FeatureManager entfernt.
MergeLiest oder setzt, ob das Feature „Überschneiden“ die behaltenen Bereiche zu einem Körper verschmilzt.

Methoden 8, davon 8 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Feature „Überschneiden“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetIntersectionsLiefert die Bereiche des Features „Überschneiden“ und welche davon weggelassen werden.
GetIntersectionsCountLiefert die Zahl der Bereiche des Features „Überschneiden“.
GetIntersectionsToolsLiefert die Volumenkörper, Oberflächen und Ebenen, die sich im Feature „Überschneiden“ überschneiden.
GetIntersectionsToolsCountLiefert die Zahl der Volumenkörper, Oberflächen und Ebenen, aus denen das Feature „Überschneiden“ entsteht.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Überschneiden“ nicht geändert hast.
SetIntersectionsLegt fest, welche Bereiche aus dem Feature „Überschneiden“ weggelassen werden.
SetIntersectionsToolsLegt die Volumenkörper, Oberflächen und Ebenen fest, die sich im Feature „Überschneiden“ überschneiden.

Siehe auch

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

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