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.
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
Body2.GetFaces, oderBody2.GetFirstFacemitFace2.GetNextFace: alle Flächen eines KörpersFeature.GetFaces: die Flächen eines FeaturesSelectionMgr.GetSelectedObject6: eine ausgewählte Fläche (TypswSelFACES)PartDoc.GetEntityByName: eine benannte Fläche
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
| Name | Beschreibung |
|---|---|
| Check | Prüft eine Fläche auf Fehler und liefert die fehlerhaften Elemente. |
| MaterialIdName | Liefert oder setzt den Materialnamen einer Fläche. |
| MaterialPropertyValues | Liefert oder setzt Farbe und Lichteigenschaften einer Fläche in der aktiven Konfiguration. |
| MaterialUserName | Liefert oder setzt den sichtbaren Materialnamen einer Fläche. |
| Normal | Liefert die Normale einer ebenen Fläche als Einheitsvektor. |
Methoden 74, davon 70 beschrieben, 4 veraltet
| Name | Beschreibung |
|---|---|
| AddPropertyExtension | Hängt einen eigenen Wert (Zahl oder Text) an eine Fläche. |
| AttachSurface | Hängt eine andere Fläche (Surface) als Geometrie an eine Fläche. |
| CreateSheetBody | Legt aus einer Fläche einen Flächenkörper an. |
| CreateSheetBodyByFaceExtension | Legt einen Flächenkörper an, der die Fläche bis zu einem Quader verlängert. |
| DetachSurface | Löst die Geometrie (Surface) von einer Fläche. |
| EnumEdges | Liefert die Kanten einer Fläche als Aufzählung. |
| EnumLoops | Liefert die Schleifen einer Fläche als Aufzählung. |
| FaceInSurfaceSense | Liefert, ob die Normale der Fläche entgegen der Normalen ihrer Surface zeigt. |
| GetAllAssemblyDecalProperties | Liefert die Eigenschaften der Abziehbilder einer Fläche in einer Baugruppen-Komponente. |
| GetAllDecalProperties | Liefert die Eigenschaften der Abziehbilder einer Fläche in einem Teil. |
| GetArea | Liefert den Flächeninhalt einer Fläche in Quadratmetern. |
| GetBody | Liefert den Körper, zu dem eine Fläche gehört. |
| GetBox | Liefert einen Quader, der die Fläche umschließt. |
| GetClosestPointOn | Liefert den Punkt einer Fläche, der einem gegebenen Punkt am nächsten liegt. |
| GetDecalsCount | Liefert die Anzahl der Abziehbilder einer Fläche. |
| GetEdgeCount | Liefert die Anzahl der Kanten, die eine Fläche begrenzen. |
| GetEdges | Liefert die Kanten, die eine Fläche begrenzen. |
| GetFaceId | Liefert die Flächen-ID einer Fläche eines importierten Körpers. |
| GetFeature | Liefert das Feature, zu dem eine Fläche gehört. |
| GetFeatureId | Liefert die Nummer des Features, zu dem eine Fläche gehört. |
| GetFirstLoop | Liefert die erste Schleife einer Fläche, als Start für eine Schleife mit Loop2.GetNext. |
| GetLoopCount | Liefert die Anzahl der Schleifen einer Fläche. |
| GetLoops | Liefert alle Schleifen einer Fläche: den Rand und je eine für jedes Loch. |
| GetMaterialPropertyValues2 | Liefert Farbe und Lichteigenschaften einer Fläche in bestimmten Konfigurationen. |
| GetNextFace | Liefert die nächste Fläche eines Körpers. |
| GetPatternSeedFeature | Liefert das Ausgangs-Feature eines Musters, aus dem eine Fläche stammt. |
| GetProjectedPointOn | Projiziert einen Punkt in einer Richtung auf eine Fläche. |
| GetPropertyExtension | Liefert den mit AddPropertyExtension angehängten Wert einer Fläche. |
| GetSeedFeature | Liefert das Ausgangs-Feature eines gemusterten, gespiegelten oder kopierten Körpers, zu dem eine Fläche gehört. |
| GetShellType | Liefert, ob eine Fläche zu einer offenen, inneren oder äußeren Hülle gehört. |
| GetSilhoutteEdges | veraltet ersetzt durch Face2.GetSilhoutteEdgesVB |
| GetSilhoutteEdgesVB | Liefert die Silhouettenkanten einer Fläche für eine Blickrichtung. |
| GetSurface | Liefert die Geometrie (Surface) einer Fläche, etwa um zu prüfen, ob sie eben oder zylindrisch ist. |
| GetTessNorms | Liefert die Normalen der Dreiecke, aus denen die schattierte Darstellung einer Fläche besteht. |
| GetTessTextures | Liefert die Texturkoordinaten der Dreiecke einer Fläche. |
| GetTessTriangleCount | Liefert die Anzahl der Dreiecke, aus denen die schattierte Darstellung einer Fläche besteht. |
| GetTessTriangles | Liefert die Dreiecke, aus denen die schattierte Darstellung einer Fläche besteht. |
| GetTessTriStripEdges | Liefert, welche Kanten der Dreiecksstreifen einer Fläche auf dem Rand der Fläche liegen. |
| GetTessTriStripNorms | Liefert die Normalen an den Punkten der Dreiecksstreifen einer Fläche. |
| GetTessTriStrips | Liefert die Punkte der Dreiecksstreifen, aus denen die schattierte Darstellung einer Fläche besteht. |
| GetTessTriStripSize | Liefert die Anzahl der Werte, die GetTessTriStrips liefert. |
| GetTessTriStripTextures | Liefert die Texturkoordinaten an den Punkten der Dreiecksstreifen einer Fläche. |
| GetTexture | Liefert die Textur einer Fläche in einer Konfiguration. |
| GetTrackingIDs | Liefert die Tracking-IDs einer Fläche zu einer Tracking-Definition. |
| GetTrackingIDsCount | Liefert die Anzahl der Tracking-IDs einer Fläche zu einer Tracking-Definition. |
| GetTrimCurves | veraltet ersetzt durch Face2.GetTrimCurves2 |
| GetTrimCurves2 | Liefert die Begrenzungskurven einer Fläche als B-Splines im UV-Raum ihrer Surface, auf Wunsch zusammen mit der Surface als B-Spline-Fläche. |
| GetTrimCurveTopology | Liefert die Teilkanten, Eckpunkte und Lücken passend zu den Begrenzungskurven einer Fläche. |
| GetTrimCurveTopologyCount | Liefert die Anzahl der Elemente der Begrenzungstopologie einer Fläche. |
| GetTrimCurveTopologyTypes | Liefert die Art jedes Elements der Begrenzungstopologie einer Fläche. |
| GetUVBounds | Liefert den UV-Bereich einer Fläche auf ihrer Surface. |
| HasMaterialPropertyValues | Liefert, ob eine Fläche eine eigene Darstellung (Farbe) hat. |
| HasTextureCoordinates | Liefert, ob eine Fläche Texturkoordinaten hat. |
| Highlight | Hebt eine Fläche im Grafikbereich hervor oder nimmt die Hervorhebung zurück. |
| ImprintCurve | Prägt eine Kurve auf eine Fläche und teilt sie dabei. |
| ImprintCurveCount | Liefert, wie viele neue Kanten und Flächen beim Aufprägen einer Kurve entstehen würden. |
| IsCoincident | Prüft, ob diese Fläche mit einer Fläche eines anderen Körpers zusammenfällt. |
| IsSame | Prüft, ob zwei Flächenobjekte dieselbe Fläche sind. |
| RemoveFaceId | Entfernt die Flächen-ID einer Fläche eines importierten Körpers. |
| RemoveInnerLoops | Entfernt Innenschleifen (Löcher) aus einer Fläche eines Flächenkörpers. |
| RemoveMaterialProperty | veraltet ersetzt durch Face2.RemoveMaterialProperty2 |
| RemoveMaterialProperty2 | Entfernt die eigene Darstellung (Farbe) einer Fläche in bestimmten Konfigurationen. |
| RemoveRedundantTopology | Entfernt überflüssige Topologie einer Fläche. |
| RemoveTexture | veraltet ersetzt durch Face2.RemoveTexture2 |
| RemoveTexture2 | Entfernt die Textur einer Fläche in einer Konfiguration. |
| RemoveTextureByDisplayState | Entfernt die Textur einer Fläche in einem Anzeigezustand. |
| RemoveTrackingID | Entfernt die Tracking-ID einer Fläche zu einer Tracking-Definition. |
| ResetPropertyExtension | Löscht den mit AddPropertyExtension angehängten Wert einer Fläche. |
| ReverseEvaluate | Liefert die UV-Parameter zu einem Punkt auf einer Fläche. |
| SetFaceId | Setzt die Flächen-ID einer Fläche eines importierten Körpers. |
| SetMaterialPropertyValues2 | Setzt Farbe und Lichteigenschaften einer Fläche in bestimmten Konfigurationen. |
| SetTexture | Weist einer Fläche in einer Konfiguration eine Textur zu. |
| SetTextureByDisplayState | Weist einer Fläche in einem Anzeigezustand eine Textur zu. |
| SetTrackingID | Gibt 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.