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.
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
FeatureManager.FeatureStatistics: die Feature-Statistik eines Teils, den FeatureManager holst du mitModelDoc2.FeatureManager
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| FeatureCount | Liefert die Anzahl der Features im Teil. |
| FeatureNames | Liefert die Namen der Features im Teil. |
| Features | Liefert die Features im Teil. |
| FeatureTypes | Liefert die Typen der Features im Teil. |
| FeatureUpdatePercentageTimes | Liefert für jedes Feature im Teil seinen Anteil an der Gesamtzeit des Neuaufbaus. |
| FeatureUpdateTimes | Liefert für jedes Feature im Teil, wie viele Sekunden sein Neuaufbau dauert. |
| PartName | Liefert den Namen des Teils, zu dem die Feature-Statistik gehört. |
| SolidBodiesCount | Liefert die Anzahl der Volumenkörper im Teil. |
| SurfaceBodiesCount | Liefert die Anzahl der Flächenkörper im Teil. |
| TotalRebuildTime | Liefert, wie viele Sekunden der Neuaufbau aller Features im Teil dauert. |
Methoden 1, davon 1 beschrieben
| Name | Beschreibung |
|---|---|
| Refresh | Ermittelt 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.