SolidWorksMakroprogrammierung

Objekt · SldWorks

FeatureStatistics-Objekt

Die Feature-Statistik eines Teils: Features mit Namen, Typ und Neuaufbauzeit, die Gesamtzeit und die Zahl der Volumen- und Flächenkörper.

Deklaration Dim x As SldWorks.FeatureStatistics · in der englischen .NET-Hilfe: IFeatureStatistics

Beschreibung

FeatureStatistics gibt Zugriff auf die Feature-Statistik eines Teils. Sie zeigt, wie lange der Neuaufbau (rebuild, update) jedes Features dauert, absolut in Sekunden und als Anteil an der Gesamtzeit. So findest du die Features, die ein Teil langsam machen. Die Befehle gibt es seit SOLIDWORKS 2010.

Zugriff

Beispiel

' Ermittelt die Feature-Statistik des aktiven Teils, gibt die Übersicht aus und
' listet die fünf Features mit der längsten Neuaufbauzeit.
' Vorbedingung: Ein Teil mit mehreren Features ist offen.
' Ergebnis:     Die Werte stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swStat As SldWorks.FeatureStatistics
    Dim vNamen As Variant, vTypen As Variant
    Dim vZeiten As Variant, vProzent As Variant
    Dim bGezeigt() As Boolean
    Dim i As Long, j As Long, nMax 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 swStat = swModel.FeatureManager.FeatureStatistics
    swStat.Refresh
    Debug.Print "Teil:          " & swStat.PartName
    Debug.Print "Features:      " & swStat.FeatureCount
    Debug.Print "Volumenkörper: " & swStat.SolidBodiesCount
    Debug.Print "Flächenkörper: " & swStat.SurfaceBodiesCount
    Debug.Print "Neuaufbau:     " & Format(swStat.TotalRebuildTime, "0.000") & " s"

    vNamen = swStat.FeatureNames
    vTypen = swStat.FeatureTypes
    vZeiten = swStat.FeatureUpdateTimes
    vProzent = swStat.FeatureUpdatePercentageTimes
    If Not IsArray(vNamen) Then Exit Sub
    ReDim bGezeigt(UBound(vNamen))

    For j = 1 To 5
        nMax = -1
        For i = 0 To UBound(vZeiten)
            If False = bGezeigt(i) Then
                If nMax < 0 Then
                    nMax = i
                ElseIf vZeiten(i) > vZeiten(nMax) Then
                    nMax = i
                End If
            End If
        Next i
        If nMax < 0 Then Exit For
        bGezeigt(nMax) = True
        Debug.Print j & ". " & vNamen(nMax) & " [" & vTypen(nMax) & "]: " & _
                    Format(vZeiten(nMax), "0.000") & " s, " & Format(vProzent(nMax), "0.0") & " %"
    Next j
End Sub

Bemerkungen

Hilfebeispiel: Das Beispiel „Get Part's Feature Statistics“ ruft erst FeatureStatistics.Refresh auf und gibt dann alle Werte aus. Die Arrays FeatureStatistics.FeatureNames, FeatureStatistics.FeatureTypes, FeatureStatistics.FeatureUpdateTimes und FeatureStatistics.FeatureUpdatePercentageTimes liest es mit demselben Index, sie gehören also Eintrag für Eintrag zusammen. Vorher prüft es, ob FeatureNames leer ist.

Nur Teile: Die Statistik gilt für Teile. Was du in einer Baugruppe bekommst, sagt die Hilfe nicht.

Zeiten: FeatureStatistics.FeatureUpdateTimes und FeatureStatistics.TotalRebuildTime sind in Sekunden. In welcher Form der Anteil aus FeatureStatistics.FeatureUpdatePercentageTimes kommt, als Prozentzahl oder Bruchteil, sagt die Hilfe nicht. Der Name spricht für Prozent.

Typen: Die Typen aus FeatureStatistics.FeatureTypes sind nach swSelectType_e angegeben. Die Hilfe zu Feature.GetNameForSelection, das Typ und Namen als Text für ModelDocExtension.SelectByID2 liefert, verweist auf FeatureTypes und FeatureNames. Ob FeatureTypes Zahlen oder solche Texte liefert, sagt die Hilfe nicht. Das Beispiel gibt den Wert unverändert aus.

Konstante: swDocPART stammt aus swDocumentTypes_e.

Eigenschaften und Methoden

Eigenschaften 10, davon 10 beschrieben

NameBeschreibung
FeatureCountLiefert die Anzahl der Features im Teil.
FeatureNamesLiefert die Namen der Features im Teil.
FeaturesLiefert die Features im Teil.
FeatureTypesLiefert die Typen der Features im Teil.
FeatureUpdatePercentageTimesLiefert für jedes Feature im Teil seinen Anteil an der Gesamtzeit des Neuaufbaus.
FeatureUpdateTimesLiefert für jedes Feature im Teil, wie viele Sekunden sein Neuaufbau dauert.
PartNameLiefert den Namen des Teils, zu dem die Feature-Statistik gehört.
SolidBodiesCountLiefert die Anzahl der Volumenkörper im Teil.
SurfaceBodiesCountLiefert die Anzahl der Flächenkörper im Teil.
TotalRebuildTimeLiefert, wie viele Sekunden der Neuaufbau aller Features im Teil dauert.

Methoden 1, davon 1 beschrieben

NameBeschreibung
RefreshErmittelt die Feature-Statistik des Teils neu.

Siehe auch

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

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