Hide Table of Contents

Check Faces for Faults Example (VBA)

This example shows how to check faces for faults.

' Preconditions:
' 1. Open a part document.
' 2. Open the Immediate window.
' Postconditions:
' 1. Checks the faces in the part for faults.
' 2. Examine the Immediate window.
Option Explicit
Function GetStringFromID(swApp As SldWorks.SldWorks, swModel As SldWorks.ModelDoc2, vPIDarr As Variant) As String
    Dim vPID As Variant    
    For Each vPID In vPIDarr
        Debug.Assert vbByte = VarType(vPID)
        GetStringFromID = GetStringFromID & Format(vPID, "###000")
    Next vPID
End Function
Sub ProcessFaultEntity(swApp As SldWorks.SldWorks, swModel As SldWorks.ModelDoc2, swFace As SldWorks.Face2, swFaultEnt As SldWorks.FaultEntity)    Dim swModExt As SldWorks.ModelDocExtension
    Dim vPIDarr As Variant
    Dim nCount As Long
    Dim swEnt As SldWorks.Entity
    Dim bRet As Boolean
    Dim i As Long
    nCount = swFaultEnt.Count
    ' For each face, print:
    ' * no fault found, if not fault found
    ' * face ID and error code, if fault found
    If 0 = nCount Then
        Debug.Print "      No fault found."
        Exit Sub
    End If
    Set swModExt = swModel.Extension
    vPIDarr = swModExt.GetPersistReference3(swFace): Debug.Assert Not IsEmpty(vPIDarr)
    Debug.Print "    Face ID = " & GetStringFromID(swApp, swModel, vPIDarr)
    For i = 0 To nCount - 1
        Set swEnt = swFaultEnt.Entity(i)
        If Not swEnt Is Nothing Then
            bRet = swEnt.Select4(True, Nothing): Debug.Assert bRet
        End If
        Debug.Print "      Fault[" & i & "] = " & swFaultEnt.ErrorCode(i)
    Next i
End Sub
Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPart As SldWorks.PartDoc
    Dim vBodyArr As Variant
    Dim vBody As Variant
    Dim swBody As SldWorks.Body2
    Dim nRetval1 As Long
    Dim nRetval2 As Long
    Dim swFace As SldWorks.Face2
    Dim swFaultEnt As SldWorks.FaultEntity    
    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    Set swPart = swModel
    Debug.Print "File = " & swModel.GetPathName
    vBodyArr = swPart.GetBodies2(swAllBodies, True): Debug.Assert Not IsEmpty(vBodyArr)
    For Each vBody In vBodyArr
        Set swBody = vBody
        Debug.Print "  Body[" & swBody.GetType & "] --> " & swBody.GetSelectionId
        nRetval1 = swBody.Check ' Obsolete method
        nRetval2 = swBody.Check2 ' Obsolete method
        Debug.Print "    IBody2::Check (1 if valid; 0 if not)= " & nRetval1
        Debug.Print "    IBody2::Check2 (Number of faults)   = " & nRetval2
        Set swFace = swBody.GetFirstFace
        Do While Not swFace Is Nothing
            Set swFaultEnt = swFace.Check
            ProcessFaultEntity swApp, swModel, swFace, swFaultEnt
            Set swFace = swFace.GetNextFace
    Next vBody
End Sub

Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

Subject:   Feedback on Help Topics
Page:   Check Faces for Faults Example (VBA)
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:


We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again

Web Help Content Version: API Help (English only) 2018 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.