SolidWorksMakroprogrammierung

Methode · Modeler

CreateBodyFromFaces2-Methode (Modeler)

Erzeugt aus Flächen eines Körpers einen neuen temporären Körper und schließt die Lücken auf eine gewählte Art.

Syntax

Function CreateBodyFromFaces2( _
   ByVal NumOfFaces As Long, _
   ByVal Faces As Variant, _
   ByVal ActionType As Long, _
   ByVal DoLocalCheck As Boolean, _
   ByRef LocalCheckResult As Boolean _
) As Object
Set swNeu = swModeler.CreateBodyFromFaces2(nAnzahl, vFlaechen, swCreateFacesBodyActionGrow, True, bOk)

Parameter

NumOfFacesLongByVal
Anzahl der Flächen in Faces.
FacesVariantByVal
Array mit den Flächen (Face2). Alle vom selben Körper.
ActionTypeLongByVal
Wie fehlende Flächen ergänzt werden, ein Wert aus swCreateFacesBodyAction_e: swCreateFacesBodyActionCap (1) mit einer Deckfläche schließen, swCreateFacesBodyActionGrow (2) die Nachbarflächen verlängern, swCreateFacesBodyActionGrowFromParent (3) aus dem ursprünglichen Körper verlängern, swCreateFacesBodyActionLeaveRubber (4) nur eine Fläche ohne Geometrie anlegen.
DoLocalCheckBooleanByVal
True prüft den neuen Körper, False nicht.
LocalCheckResultBooleanByRef · Rückgabe
Gibt bei DoLocalCheck = True zurück, ob der Körper in Ordnung ist (True) oder nicht (False).

Rückgabewert

Der neue temporäre Körper (Body2) oder Nothing, wenn es nicht geklappt hat.

Beispiel

' swModeler ist der Modeler (SldWorks.GetModeler), swBody ein Volumenkörper (Body2),
' etwa ein Quader mit Bohrung. Ohne die Zylinderfläche verschwindet die Bohrung.
Dim vAlle As Variant, swRest() As SldWorks.Face2, swFlaeche As SldWorks.Face2
Dim swNeu As SldWorks.Body2, bOk As Boolean
Dim i As Long, n As Long
vAlle = swBody.GetFaces
ReDim swRest(UBound(vAlle))
For i = 0 To UBound(vAlle)
    Set swFlaeche = vAlle(i)
    If False = swFlaeche.GetSurface.IsCylinder Then
        Set swRest(n) = swFlaeche
        n = n + 1
    End If
Next i
If n > 0 And n <= UBound(vAlle) Then
    ReDim Preserve swRest(n - 1)
    Set swNeu = swModeler.CreateBodyFromFaces2(n, swRest, swCreateFacesBodyActionGrow, True, bOk)
    If Not swNeu Is Nothing Then Debug.Print "Neuer Körper, Prüfung: " & bOk
End If

Bemerkungen

Der Befehl ist nützlich, wenn du einen Körper mit Änderungen kopieren willst: Du übergibst die Flächen, die bleiben sollen. Alle Flächen müssen vom selben Körper stammen. Lässt du Flächen weg, etwa die einer Bohrung, sagt ActionType dem Geometriekern, wie er die Lücke füllt. Das Ergebnis muss ein Volumenkörper sein.

Der Befehl ist das Gegenstück zum Löschen von Flächen, bei dem du die Flächen angibst, die wegfallen. Die Hilfe nennt dafür das ältere Body2.DeleteFaces3, aktuell ist Body2.DeleteFaces5. Welche Art sich für welche Lücke eignet, sagt die Hilfe nicht, und sie hat kein Beispiel.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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