Objekt · SldWorks
RefPlaneFeatureData-Objekt
Die Definition einer Referenzebene: ihre Art, die Referenzen mit Bedingung, Winkel oder Abstand und weitere Optionen.
Beschreibung
RefPlaneFeatureData gibt Zugriff auf die Daten eines Referenzebenen-Features. Du liest damit, wie die Ebene festgelegt ist, und änderst Referenzen, Winkel, Abstände und Optionen. Die Lage der Ebene im Raum liefert dagegen das Objekt RefPlane, das du mit Feature.GetSpecificFeature2 holst. Die meisten Befehle gibt es seit SOLIDWORKS 2003, die Befehle für Ebenen mit Bedingungen seit 2010.
Wichtig ist der Unterschied zwischen zwei Arten von Ebenen. Ebenen, die ab SOLIDWORKS 2010 erstellt wurden, sind mit Bedingungen aufgebaut: Sie haben bis zu drei Referenzen, jede mit einer Bedingung wie parallel, senkrecht, im Abstand oder im Winkel. Ältere Ebenen haben stattdessen eine feste Art, etwa im Abstand, im Winkel oder durch drei Punkte. Welche Befehle gelten, hängt davon ab (siehe Bemerkungen).
Zugriff
Feature.GetDefinition: bei einem Feature mit dem TypnamenRefPlane
Beispiel
' Gibt aus, ob die ausgewählte Ebene mit Bedingungen aufgebaut ist, und dazu ihre
' Referenzen oder ihren Abstand.
' Vorbedingung: Ein Teil ist offen, eine Referenzebene 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.RefPlaneFeatureData
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 <> "RefPlane" Then Exit Sub
Set swDaten = swFeat.GetDefinition
If swDaten.Type2 = swRefPlaneConstraintBase Then
Debug.Print swFeat.Name & ": Ebene mit Bedingungen"
For i = swRefPlaneReference_First To swRefPlaneReference_Third
If swDaten.Constraint(i) <> 0 Then
Debug.Print " " & i + 1 & ". Referenz: Bedingung " & swDaten.Constraint(i) & _
", Winkel oder Abstand " & swDaten.AngleOrDistance(i)
End If
Next i
Else
Debug.Print swFeat.Name & ": Ebene ohne Bedingungen, Art " & swDaten.Type & " (swRefPlaneType_e)"
End If
Select Case swDaten.Type
Case swRefPlaneDistance: Debug.Print " Abstand " & swDaten.Distance * 1000 & " mm"
Case swRefPlaneAngle: Debug.Print " Winkel " & swDaten.Angle * 180 / 3.14159265358979 & " Grad"
End Select
End SubBemerkungen
Welche Befehle gelten: Prüfe zuerst mit RefPlaneFeatureData.Type2, ob die Ebene mit Bedingungen aufgebaut ist (swRefPlaneConstraintBase). Bei einer solchen Ebene sagt RefPlaneFeatureData.Type, ob sie eine Winkel- (swRefPlaneAngle) oder Abstandsreferenz (swRefPlaneDistance) hat. Bei älteren Ebenen liefert Type die Art. Es gelten:
- bei allen Ebenen: AccessSelections, GetSelectionsCount, ReleaseSelectionAccess und Selections, bei Ebenen mit Bedingungen ohne Winkel- oder Abstandsreferenz aber nur lesend
- nur bei Ebenen mit Bedingungen: Reference, Constraint und AngleOrDistance, die Tabelle in der Hilfe nennt auch Type2
- nicht bei Ebenen mit Bedingungen ohne Winkel- oder Abstandsreferenz: Angle, Distance, AutoSize, OriginOnCurve, ProjectionType, SolutionIndex, Type und UseNormalPlane
ReversedReferenceDirection und UpdatePlane fehlen in der Tabelle.
Ändern: Nach RefPlaneFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du RefPlaneFeatureData.ReleaseSelectionAccess auf. So ändert das Hilfebeispiel „Modify Plane by Editing Its Definition“ den Abstand einer Ebene.
Anlegen: Neue Referenzebenen legst du mit FeatureManager.InsertRefPlane an. Die Referenzen wählst du vorher mit ModelDocExtension.SelectByID2 und den Markierungen 0, 1 und 2 aus, die Bedingungen kommen aus swRefPlaneReferenceConstraints_e.
Ebene und Definition: Zum selben Feature gibt es zwei Objekte: RefPlane aus Feature.GetSpecificFeature2 mit Lage, Eckpunkten und umgebendem Quader, und RefPlaneFeatureData aus Feature.GetDefinition. Das Hilfebeispiel „Get Corner Points of Reference Plane“ deklariert beide.
Veraltet: ReverseDirection ist durch RefPlaneFeatureData.ReversedReferenceDirection ersetzt.
Einheiten: Winkel sind im Bogenmaß. Für Distance nennt die Hilfe widersprüchlich Meter und Bogenmaß, gemeint sind Meter. Für AngleOrDistance nennt sie keine Einheit.
Eigenschaften und Methoden
Eigenschaften 16, davon 15 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Winkel einer Referenzebene im Winkel zu einer anderen Ebene oder Fläche. |
| AngleOrDistance | Liest oder setzt den Winkel oder Abstand zu einer der bis zu drei Referenzen einer Ebene mit Bedingungen. |
| AutoSize | Liest oder setzt, ob sich die Größe der Referenzebene automatisch nach der Geometrie richtet. |
| Constraint | Liest oder setzt die Bedingung zu einer der bis zu drei Referenzen einer Ebene mit Bedingungen. |
| Distance | Liest oder setzt den Abstand einer Referenzebene im Abstand zu einer anderen Ebene oder Fläche. |
| OriginOnCurve | Liest oder setzt, ob der Ursprung der Referenzebene auf der Kurve liegt oder auf dem Eckpunkt oder Punkt. |
| ProjectionType | Liest oder setzt, wie eine Referenzebene auf einer Fläche projiziert wird. |
| Reference | Liest oder setzt das Element einer der bis zu drei Referenzen einer Ebene mit Bedingungen. |
| ReverseDirection | veraltet ersetzt durch RefPlaneFeatureData.ReversedReferenceDirection |
| ReversedReferenceDirection | Liest oder setzt, ob die Richtung einer der bis zu drei Referenzen einer Referenzebene umgekehrt ist. |
| Selections | Liest oder setzt die Elemente, auf denen die Referenzebene aufbaut. |
| SolutionIndex | Liest oder setzt, welche von mehreren möglichen Ebenen bei einer Referenzebene auf einer Fläche gemeint ist. |
| Type | Liefert die Art einer Referenzebene ohne Bedingungen oder, bei einer Ebene mit Bedingungen, ob sie eine Winkel- oder Abstandsreferenz hat. |
| Type2 | Liefert, ob die Referenzebene mit Bedingungen aufgebaut ist, also ab SOLIDWORKS 2010 erstellt wurde. |
| UpdatePlane | Liest oder setzt, ob die Referenzebene neu parallel zum Bildschirm ausgerichtet wird. |
| UseNormalPlane | Liest oder setzt, ob die Ebene senkrecht zur ausgewählten Ebene liegt und ihre Größe automatisch bekommt. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Referenzebene zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetSelectionsCount | Liefert die Zahl der Elemente, auf denen die Referenzebene aufbaut. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Referenzebene nicht geändert hast. |
Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IRefPlaneFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.