SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.Face · in der englischen .NET-Hilfe: IFace

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:

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 Sub

Bemerkungen

Ersatz: 46 Befehle heißen an Face2 genauso, etwa Face2.GetArea, Face2.GetEdges oder Face2.MaterialPropertyValues. Bei den übrigen nimmst du diese Befehle:

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

NameBeschreibung
MaterialIdNameveraltet ersetzt durch Face2.MaterialIdName
MaterialPropertyValuesveraltet ersetzt durch Face2.MaterialPropertyValues
MaterialUserNameveraltet ersetzt durch Face2.MaterialUserName
Normalveraltet ersetzt durch Face2.Normal

Methoden 45, davon 0 beschrieben, 45 veraltet

NameBeschreibung
AddPropertyExtensionveraltet ersetzt durch Face2.AddPropertyExtension
CreateSheetBodyveraltet ersetzt durch Face2.CreateSheetBody
CreateSheetBodyByFaceExtensionveraltet ersetzt durch Face2.CreateSheetBodyByFaceExtension
EnumEdgesveraltet ersetzt durch Face2.EnumEdges
EnumLoopsveraltet ersetzt durch Face2.EnumLoops
FaceInSurfaceSenseveraltet ersetzt durch Face2.FaceInSurfaceSense
GetAreaveraltet ersetzt durch Face2.GetArea
GetBodyveraltet ersetzt durch Face2.GetBody
GetBoxveraltet ersetzt durch Face2.GetBox
GetClosestPointOnveraltet ersetzt durch Face2.GetClosestPointOn
GetEdgeCountveraltet ersetzt durch Face2.GetEdgeCount
GetEdgesveraltet ersetzt durch Face2.GetEdges
GetFaceIdveraltet ersetzt durch Face2.GetFaceId
GetFeatureveraltet ersetzt durch Face2.GetFeature
GetFeatureIdveraltet ersetzt durch Face2.GetFeatureId
GetFirstLoopveraltet ersetzt durch Face2.GetFirstLoop
GetLoopCountveraltet ersetzt durch Face2.GetLoopCount
GetNextFaceveraltet ersetzt durch Face2.GetNextFace
GetPatternSeedFeatureveraltet ersetzt durch Face2.GetPatternSeedFeature
GetPropertyExtensionveraltet ersetzt durch Face2.GetPropertyExtension
GetShellTypeveraltet ersetzt durch Face2.GetShellType
GetSilhoutteEdgesveraltet ersetzt durch Face2.GetSilhoutteEdgesVB
GetSilhoutteEdgesVBveraltet ersetzt durch Face2.GetSilhoutteEdgesVB
GetSurfaceveraltet ersetzt durch Face2.GetSurface
GetTessNormsveraltet ersetzt durch Face2.GetTessNorms
GetTessTriangleCountveraltet ersetzt durch Face2.GetTessTriangleCount
GetTessTrianglesveraltet ersetzt durch Face2.GetTessTriangles
GetTessTriStripEdgesveraltet ersetzt durch Face2.GetTessTriStripEdges
GetTessTriStripNormsveraltet ersetzt durch Face2.GetTessTriStripNorms
GetTessTriStripsveraltet ersetzt durch Face2.GetTessTriStrips
GetTessTriStripSizeveraltet ersetzt durch Face2.GetTessTriStripSize
GetTrimCurvesveraltet ersetzt durch Face2.GetTrimCurves2
GetTrimCurves2veraltet ersetzt durch Face2.GetTrimCurves2
GetTrimCurveTopologyveraltet ersetzt durch Face2.GetTrimCurveTopology
GetTrimCurveTopologyCountveraltet ersetzt durch Face2.GetTrimCurveTopologyCount
GetTrimCurveTopologyTypesveraltet ersetzt durch Face2.GetTrimCurveTopologyTypes
GetUVBoundsveraltet ersetzt durch Face2.GetUVBounds
Highlightveraltet ersetzt durch Face2.Highlight
IsSameveraltet ersetzt durch Face2.IsSame
RemoveFaceIdveraltet ersetzt durch Face2.RemoveFaceId
RemoveInnerLoopsveraltet ersetzt durch Face2.RemoveInnerLoops
RemoveMaterialPropertyveraltet ersetzt durch Face2.RemoveMaterialProperty2
RemoveRedundantTopologyveraltet ersetzt durch Face2.RemoveRedundantTopology
ResetPropertyExtensionveraltet ersetzt durch Face2.ResetPropertyExtension
SetFaceIdveraltet ersetzt durch Face2.SetFaceId

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.