SolidWorksMakroprogrammierung

Objekt · SldWorks

Face2-Objekt

Steht für eine Fläche eines Körpers: Größe, Form, Kanten, Schleifen, Farbe und das Feature, aus dem sie stammt.

Deklaration Dim x As SldWorks.Face2 · in der englischen .NET-Hilfe: IFace2

Beschreibung

Eine Fläche ist ein Stück Oberfläche eines Körpers mit Rand. Ihre Form (eben, zylindrisch, Freiform) beschreibt die zugrunde liegende Surface, die du mit Face2.GetSurface holst. Den Rand bilden Kanten, geordnet in Schleifen (Loop2).

Zugriff

Beispiel

' swBody ist ein Körper (Body2).
Dim vFlaechen As Variant
Dim swFace As SldWorks.Face2, swGroesste As SldWorks.Face2
Dim i As Long
vFlaechen = swBody.GetFaces
For i = 0 To UBound(vFlaechen)
    Set swFace = vFlaechen(i)
    If swFace.GetSurface.IsPlane Then
        If swGroesste Is Nothing Then
            Set swGroesste = swFace
        ElseIf swFace.GetArea > swGroesste.GetArea Then
            Set swGroesste = swFace
        End If
    End If
Next i
If Not swGroesste Is Nothing Then Debug.Print "Größte ebene Fläche: " & swGroesste.GetArea * 1000000 & " mm²"

Bemerkungen

Zum Auswählen weist du die Fläche einer Variable vom Typ SldWorks.Entity zu und rufst Entity.Select4 auf. Flächen sind in m² und Koordinaten in Metern.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
CheckPrüft eine Fläche auf Fehler und liefert die fehlerhaften Elemente.
MaterialIdNameLiefert oder setzt den Materialnamen einer Fläche.
MaterialPropertyValuesLiefert oder setzt Farbe und Lichteigenschaften einer Fläche in der aktiven Konfiguration.
MaterialUserNameLiefert oder setzt den sichtbaren Materialnamen einer Fläche.
NormalLiefert die Normale einer ebenen Fläche als Einheitsvektor.

Methoden 74, davon 70 beschrieben, 4 veraltet

NameBeschreibung
AddPropertyExtensionHängt einen eigenen Wert (Zahl oder Text) an eine Fläche.
AttachSurfaceHängt eine andere Fläche (Surface) als Geometrie an eine Fläche.
CreateSheetBodyLegt aus einer Fläche einen Flächenkörper an.
CreateSheetBodyByFaceExtensionLegt einen Flächenkörper an, der die Fläche bis zu einem Quader verlängert.
DetachSurfaceLöst die Geometrie (Surface) von einer Fläche.
EnumEdgesLiefert die Kanten einer Fläche als Aufzählung.
EnumLoopsLiefert die Schleifen einer Fläche als Aufzählung.
FaceInSurfaceSenseLiefert, ob die Normale der Fläche entgegen der Normalen ihrer Surface zeigt.
GetAllAssemblyDecalPropertiesLiefert die Eigenschaften der Abziehbilder einer Fläche in einer Baugruppen-Komponente.
GetAllDecalPropertiesLiefert die Eigenschaften der Abziehbilder einer Fläche in einem Teil.
GetAreaLiefert den Flächeninhalt einer Fläche in Quadratmetern.
GetBodyLiefert den Körper, zu dem eine Fläche gehört.
GetBoxLiefert einen Quader, der die Fläche umschließt.
GetClosestPointOnLiefert den Punkt einer Fläche, der einem gegebenen Punkt am nächsten liegt.
GetDecalsCountLiefert die Anzahl der Abziehbilder einer Fläche.
GetEdgeCountLiefert die Anzahl der Kanten, die eine Fläche begrenzen.
GetEdgesLiefert die Kanten, die eine Fläche begrenzen.
GetFaceIdLiefert die Flächen-ID einer Fläche eines importierten Körpers.
GetFeatureLiefert das Feature, zu dem eine Fläche gehört.
GetFeatureIdLiefert die Nummer des Features, zu dem eine Fläche gehört.
GetFirstLoopLiefert die erste Schleife einer Fläche, als Start für eine Schleife mit Loop2.GetNext.
GetLoopCountLiefert die Anzahl der Schleifen einer Fläche.
GetLoopsLiefert alle Schleifen einer Fläche: den Rand und je eine für jedes Loch.
GetMaterialPropertyValues2Liefert Farbe und Lichteigenschaften einer Fläche in bestimmten Konfigurationen.
GetNextFaceLiefert die nächste Fläche eines Körpers.
GetPatternSeedFeatureLiefert das Ausgangs-Feature eines Musters, aus dem eine Fläche stammt.
GetProjectedPointOnProjiziert einen Punkt in einer Richtung auf eine Fläche.
GetPropertyExtensionLiefert den mit AddPropertyExtension angehängten Wert einer Fläche.
GetSeedFeatureLiefert das Ausgangs-Feature eines gemusterten, gespiegelten oder kopierten Körpers, zu dem eine Fläche gehört.
GetShellTypeLiefert, ob eine Fläche zu einer offenen, inneren oder äußeren Hülle gehört.
GetSilhoutteEdgesveraltet ersetzt durch Face2.GetSilhoutteEdgesVB
GetSilhoutteEdgesVBLiefert die Silhouettenkanten einer Fläche für eine Blickrichtung.
GetSurfaceLiefert die Geometrie (Surface) einer Fläche, etwa um zu prüfen, ob sie eben oder zylindrisch ist.
GetTessNormsLiefert die Normalen der Dreiecke, aus denen die schattierte Darstellung einer Fläche besteht.
GetTessTexturesLiefert die Texturkoordinaten der Dreiecke einer Fläche.
GetTessTriangleCountLiefert die Anzahl der Dreiecke, aus denen die schattierte Darstellung einer Fläche besteht.
GetTessTrianglesLiefert die Dreiecke, aus denen die schattierte Darstellung einer Fläche besteht.
GetTessTriStripEdgesLiefert, welche Kanten der Dreiecksstreifen einer Fläche auf dem Rand der Fläche liegen.
GetTessTriStripNormsLiefert die Normalen an den Punkten der Dreiecksstreifen einer Fläche.
GetTessTriStripsLiefert die Punkte der Dreiecksstreifen, aus denen die schattierte Darstellung einer Fläche besteht.
GetTessTriStripSizeLiefert die Anzahl der Werte, die GetTessTriStrips liefert.
GetTessTriStripTexturesLiefert die Texturkoordinaten an den Punkten der Dreiecksstreifen einer Fläche.
GetTextureLiefert die Textur einer Fläche in einer Konfiguration.
GetTrackingIDsLiefert die Tracking-IDs einer Fläche zu einer Tracking-Definition.
GetTrackingIDsCountLiefert die Anzahl der Tracking-IDs einer Fläche zu einer Tracking-Definition.
GetTrimCurvesveraltet ersetzt durch Face2.GetTrimCurves2
GetTrimCurves2Liefert die Begrenzungskurven einer Fläche als B-Splines im UV-Raum ihrer Surface, auf Wunsch zusammen mit der Surface als B-Spline-Fläche.
GetTrimCurveTopologyLiefert die Teilkanten, Eckpunkte und Lücken passend zu den Begrenzungskurven einer Fläche.
GetTrimCurveTopologyCountLiefert die Anzahl der Elemente der Begrenzungstopologie einer Fläche.
GetTrimCurveTopologyTypesLiefert die Art jedes Elements der Begrenzungstopologie einer Fläche.
GetUVBoundsLiefert den UV-Bereich einer Fläche auf ihrer Surface.
HasMaterialPropertyValuesLiefert, ob eine Fläche eine eigene Darstellung (Farbe) hat.
HasTextureCoordinatesLiefert, ob eine Fläche Texturkoordinaten hat.
HighlightHebt eine Fläche im Grafikbereich hervor oder nimmt die Hervorhebung zurück.
ImprintCurvePrägt eine Kurve auf eine Fläche und teilt sie dabei.
ImprintCurveCountLiefert, wie viele neue Kanten und Flächen beim Aufprägen einer Kurve entstehen würden.
IsCoincidentPrüft, ob diese Fläche mit einer Fläche eines anderen Körpers zusammenfällt.
IsSamePrüft, ob zwei Flächenobjekte dieselbe Fläche sind.
RemoveFaceIdEntfernt die Flächen-ID einer Fläche eines importierten Körpers.
RemoveInnerLoopsEntfernt Innenschleifen (Löcher) aus einer Fläche eines Flächenkörpers.
RemoveMaterialPropertyveraltet ersetzt durch Face2.RemoveMaterialProperty2
RemoveMaterialProperty2Entfernt die eigene Darstellung (Farbe) einer Fläche in bestimmten Konfigurationen.
RemoveRedundantTopologyEntfernt überflüssige Topologie einer Fläche.
RemoveTextureveraltet ersetzt durch Face2.RemoveTexture2
RemoveTexture2Entfernt die Textur einer Fläche in einer Konfiguration.
RemoveTextureByDisplayStateEntfernt die Textur einer Fläche in einem Anzeigezustand.
RemoveTrackingIDEntfernt die Tracking-ID einer Fläche zu einer Tracking-Definition.
ResetPropertyExtensionLöscht den mit AddPropertyExtension angehängten Wert einer Fläche.
ReverseEvaluateLiefert die UV-Parameter zu einem Punkt auf einer Fläche.
SetFaceIdSetzt die Flächen-ID einer Fläche eines importierten Körpers.
SetMaterialPropertyValues2Setzt Farbe und Lichteigenschaften einer Fläche in bestimmten Konfigurationen.
SetTextureWeist einer Fläche in einer Konfiguration eine Textur zu.
SetTextureByDisplayStateWeist einer Fläche in einem Anzeigezustand eine Textur zu.
SetTrackingIDGibt einer Fläche eine eigene Tracking-ID, an der du sie nach Änderungen wiedererkennst.

Nicht aufgeführt sind 42 C++-Varianten (Namen mit I davor, zum Beispiel ICreateSheetBody). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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