SolidWorksMakroprogrammierung

Objekt · SldWorks

FaultEntity-Objekt

Das Ergebnis der Prüfung eines Körpers, einer Fläche oder einer Kante: die fehlerhaften Elemente und ihre Fehlercodes.

Deklaration Dim x As SldWorks.FaultEntity · in der englischen .NET-Hilfe: IFaultEntity

Beschreibung

FaultEntity nennt die Elemente mit Fehlern und die Art der Fehler. Du bekommst es, wenn du einen Körper, eine Fläche oder eine Kante prüfst. Jeder Fehler hat eine Nummer ab 0, zu der du das fehlerhafte Element und den Fehlercode liest. Count und ErrorCode gibt es seit SOLIDWORKS 2004 SP04, Entity2 seit SOLIDWORKS 2007 SP02.

Zugriff

Beispiel

' Prüft alle Körper des aktiven Teils und ihre Flächen, gibt die Fehlercodes aus
' und wählt die fehlerhaften Elemente aus.
' Vorbedingung: Ein Teil ist offen.
' Ergebnis:     Die Fehler stehen im Direktfenster (Strg+G), die fehlerhaften Elemente
'               sind ausgewählt. Ein fehlerfreies Teil meldet 0 Fehler.
Option Explicit

Sub FehlerAusgeben(swFehler As SldWorks.FaultEntity, sWas As String)
    Dim swEnt As SldWorks.Entity
    Dim i As Long

    If swFehler Is Nothing Then Exit Sub
    If swFehler.Count = 0 Then Exit Sub
    Debug.Print sWas & ": " & swFehler.Count & " Fehler"
    For i = 0 To swFehler.Count - 1
        Debug.Print "  Fehler " & i & ": Code " & swFehler.ErrorCode(i)
        Set swEnt = swFehler.Entity2(i)
        If Not swEnt Is Nothing Then swEnt.Select4 True, Nothing
    Next i
End Sub

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPart As SldWorks.PartDoc
    Dim swKoerper As SldWorks.Body2
    Dim swFlaeche As SldWorks.Face2
    Dim vKoerper As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocPART Then Exit Sub
    Set swPart = swModel
    swModel.ClearSelection2 True

    vKoerper = swPart.GetBodies2(swAllBodies, True)
    If Not IsArray(vKoerper) Then Exit Sub
    For i = 0 To UBound(vKoerper)
        Set swKoerper = vKoerper(i)
        FehlerAusgeben swKoerper.Check3, "Körper " & swKoerper.Name
        Set swFlaeche = swKoerper.GetFirstFace
        Do While Not swFlaeche Is Nothing
            FehlerAusgeben swFlaeche.Check, "Fläche in " & swKoerper.Name
            Set swFlaeche = swFlaeche.GetNextFace
        Loop
    Next i
    Debug.Print UBound(vKoerper) + 1 & " Körper geprüft"
End Sub

Bemerkungen

Hilfebeispiele: Die Beispiele „Check Bodies for Faults“, „Check Faces for Faults“ und „Check Edges for Faults“ gehen so vor: Sie prüfen jeden Körper, jede Fläche oder jede Kante, laufen über die Fehler von 0 bis Count - 1, wählen das fehlerhafte Element aus und geben den Fehlercode aus. Sie nehmen dafür noch das veraltete FaultEntity.Entity, das durch FaultEntity.Entity2 ersetzt ist.

Kein FaultEntity: Body2.Check3 liefert ein FaultEntity, wenn es Fehler gibt. Ob du bei einem fehlerfreien Körper Nothing oder ein FaultEntity mit Count 0 bekommst, sagt die Hilfe nicht. Das Beispiel prüft deshalb beides.

Kein Element: FaultEntity.Entity2 kann Nothing liefern, wenn das Element vom Fehler „verschluckt“ ist oder kein Element (Entity) ist. Prüf das vor dem Auswählen.

Lücken: Die Lücken eines Körpers, etwa ein Loch in einem Flächenkörper, liefert Body2.Diagnose als DiagnoseResult. Das Hilfebeispiel „Get and Fill Gaps in Body“ prüft den Körper zusätzlich mit Body2.Check3.

Veraltet: Die veralteten Befehle Body2.Check und Body2.Check2 sind durch Body2.Check3 ersetzt. Die Hilfebeispiele rufen sie zum Vergleich noch auf.

Konstanten: swAllBodies stammt aus swBodyType_e, swDocPART aus swDocumentTypes_e.

Eigenschaften und Methoden

Eigenschaften 4, davon 3 beschrieben, 1 veraltet

NameBeschreibung
CountLiefert die Anzahl der Fehler, die die Prüfung eines Körpers, einer Fläche oder einer Kante gefunden hat.
Entityveraltet ersetzt durch FaultEntity.Entity2
Entity2Liefert das fehlerhafte Element zu einem Fehler, etwa eine Fläche oder Kante.
ErrorCodeLiefert den Fehlercode zu einem Fehler.

Siehe auch

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

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