Objekt · SldWorks
ReplaceFaceFeatureData-Objekt
Die Definition eines Features „Fläche ersetzen“: die Flächen, die ersetzt werden, und die Ersatzflächen.
Beschreibung
ReplaceFaceFeatureData gibt Zugriff auf die Daten eines Features „Fläche ersetzen“ (Replace Face). Das Feature ersetzt Flächen eines Körpers durch andere Flächen, etwa durch einen Flächenkörper. Du liest und setzt die Flächen, die ersetzt werden, und die Ersatzflächen. Die Befehle gibt es seit SOLIDWORKS 2001Plus.
Zugriff
Feature.GetDefinition: bei einem Feature mit dem TypnamenReplaceFace
Beispiel
' Gibt aus, wie viele Flächen das ausgewählte Feature ersetzt, zu welchen Features
' sie gehören und wie viele Ersatzflächen es hat.
' Vorbedingung: Ein Teil mit einem Feature „Fläche ersetzen“ ist offen, das Feature
' ist im FeatureManager ausgewählt.
' Ergebnis: Die Angaben stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSel As Object
Dim swFeat As SldWorks.Feature
Dim swDaten As SldWorks.ReplaceFaceFeatureData
Dim swFace As SldWorks.Face2
Dim vFlaechen As Variant
Dim i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
Set swFeat = swSel
If swFeat.GetTypeName2 <> "ReplaceFace" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swFeat.Name & ": " & swDaten.GetFacesForReplacementCount & " Fläche(n) ersetzt, " & _
swDaten.GetReplacementSurfacesCount & " Ersatzfläche(n)"
vFlaechen = swDaten.FacesForReplacement
If IsArray(vFlaechen) Then
For i = 0 To UBound(vFlaechen)
Set swFace = vFlaechen(i)
Debug.Print " Fläche aus " & swFace.GetFeature.Name
Next i
End If
swDaten.ReleaseSelectionAccess
End SubBemerkungen
Anlegen: Ein neues Feature legst du mit ModelDoc2.InsertFeatureReplaceFace an. Vorher wählst du die Flächen, die ersetzt werden, mit der Markierung 1 aus und die Ersatzflächen mit 2. So macht es das Hilfebeispiel „Create Replace Face Feature“, das als Ersatz einen Flächenkörper auswählt.
Ändern: Nach ReplaceFaceFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du ReplaceFaceFeatureData.ReleaseSelectionAccess auf.
Mehr dazu: Für die Arrays verweist die Hilfe auf das Thema „Accessing Selections that Define Features“.
Eigenschaften und Methoden
Eigenschaften 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| FacesForReplacement | Liest oder setzt die Flächen, die das Feature „Fläche ersetzen“ ersetzt. |
| ReplacementSurfaces | Liest oder setzt die Ersatzflächen des Features „Fläche ersetzen“. |
Methoden 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Feature „Fläche ersetzen“ zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetFacesForReplacementCount | Liefert die Zahl der Flächen, die das Feature „Fläche ersetzen“ ersetzt. |
| GetReplacementSurfacesCount | Liefert die Zahl der Ersatzflächen des Features „Fläche ersetzen“. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Feature „Fläche ersetzen“ nicht geändert hast. |
Nicht aufgeführt sind 5 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IReplaceFaceFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.