Objekt · SldWorks
Face-Objekt
Veraltetes Objekt für eine Fläche eines Körpers. An seine Stelle tritt Face2, das fast alle Befehle unter demselben Namen hat.
Beschreibung
Face ist mit allen Befehlen veraltet und durch Face2 ersetzt. Das Objekt stand wie Face2 für eine Fläche eines Körpers und gab Zugriff auf ihre Kanten, Schleifen und die zugrunde liegende Oberfläche, auf den Körper und das Feature, zu dem sie gehört, und auf Tessellierung und Begrenzungskurven (trim curves). Seit wann es veraltet ist, sagt die Hilfe nicht. Face2 mit den gleichnamigen Befehlen gibt es seit SOLIDWORKS 2001Plus.
Zugriff
An das alte Objekt kam man über ebenfalls veraltete Befehle, etwa Body.GetFirstFace (veraltet) und dann Face.GetNextFace. Heute liefern diese Befehle ein Face2:
Body2.GetFaces, oderBody2.GetFirstFacemitFace2.GetNextFace: alle Flächen eines KörpersFeature.GetFaces: die Flächen eines FeaturesSelectionMgr.GetSelectedObject6: eine ausgewählte Fläche (TypswSelFACES)
Beispiel
' Gibt Fläche, Zahl der Kanten und Schleifen, Körper und Feature der ausgewählten Fläche aus.
' Vorbedingung: In einem Teil ist eine Fläche ausgewählt.
' Ergebnis: Die Werte stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swFace As SldWorks.Face2 ' statt SldWorks.Face
Dim vNormale As Variant
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelFACES Then Exit Sub
Set swFace = swSelMgr.GetSelectedObject6(1, -1)
Debug.Print "Fläche: " & Format(swFace.GetArea * 1000000#, "0.00") & " mm²" ' früher Face.GetArea
Debug.Print "Kanten: " & swFace.GetEdgeCount & ", Schleifen: " & swFace.GetLoopCount
Debug.Print "Körper: " & swFace.GetBody.Name & ", Feature: " & swFace.GetFeature.Name
If swFace.GetSurface.IsPlane Then
vNormale = swFace.Normal
Debug.Print "Eben, Normale: " & vNormale(0) & ", " & vNormale(1) & ", " & vNormale(2)
End If
End SubBemerkungen
Ersatz: 46 Befehle heißen an Face2 genauso, etwa Face2.GetArea, Face2.GetEdges oder Face2.MaterialPropertyValues. Bei den übrigen nimmst du diese Befehle:
Face.GetSilhoutteEdges:Face2.GetSilhoutteEdgesVB, wie beiFace.GetSilhoutteEdgesVBFace.GetTrimCurves:Face2.GetTrimCurves2, wie beiFace.GetTrimCurves2Face.RemoveMaterialProperty:Face2.RemoveMaterialProperty2
Nachfolger der Nachfolger: Bei RemoveMaterialProperty nennt die alte Hilfe Face2.RemoveMaterialProperty, das inzwischen selbst veraltet ist. Die Liste oben nennt den heute gültigen Befehl. Seine Parameter können sich vom alten Befehl unterscheiden, prüf sie auf der Seite des Befehls.
Neu in Face2: Face2 hat dazu Befehle, die es bei Face nicht gab, etwa Face2.GetLoops, Face2.GetTexture, Face2.GetDecalsCount, Face2.GetTrackingIDs und Face2.IsCoincident.
Umstellen: Meist reicht es, Variablen von SldWorks.Face auf SldWorks.Face2 umzustellen und die drei Befehle aus der Liste zu ersetzen.
Eigenschaften und Methoden
Eigenschaften 4, davon 0 beschrieben, 4 veraltet
| Name | Beschreibung |
|---|---|
| MaterialIdName | veraltet ersetzt durch Face2.MaterialIdName |
| MaterialPropertyValues | veraltet ersetzt durch Face2.MaterialPropertyValues |
| MaterialUserName | veraltet ersetzt durch Face2.MaterialUserName |
| Normal | veraltet ersetzt durch Face2.Normal |
Methoden 45, davon 0 beschrieben, 45 veraltet
Nicht aufgeführt sind 31 C++-Varianten (Namen mit I davor, zum Beispiel ICreateSheetBody). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IFace in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.