Objekt · SldWorks
FaultEntity-Objekt
Das Ergebnis der Prüfung eines Körpers, einer Fläche oder einer Kante: die fehlerhaften Elemente und ihre Fehlercodes.
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
Body2.Check3: die Fehler eines KörpersFace2.Check: die Fehler einer FlächeEdge.Check: die Fehler einer Kante
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Count | Liefert die Anzahl der Fehler, die die Prüfung eines Körpers, einer Fläche oder einer Kante gefunden hat. |
| Entity | veraltet ersetzt durch FaultEntity.Entity2 |
| Entity2 | Liefert das fehlerhafte Element zu einem Fehler, etwa eine Fläche oder Kante. |
| ErrorCode | Liefert 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.