Objekt · SldWorks
RefPointFeatureData-Objekt
Die Definition eines Referenzpunkts: Art, Abstand entlang einer Kurve und die Elemente, auf die er sich stützt.
Beschreibung
RefPointFeatureData gibt Zugriff auf die Daten eines Referenzpunkt-Features. Du liest und setzt damit die Art des Punkts (auf einer Kurve, in der Mitte einer Fläche, im Schnitt usw.), bei Punkten entlang einer Kurve den Abstand und die Elemente, auf die sich der Punkt stützt. Die Lage des Punkts im Raum liefert dagegen RefPoint.GetRefPoint. Die Befehle gibt es seit SOLIDWORKS 2004.
Zugriff
Feature.GetDefinition: bei einem Feature mit dem TypnamenRefPoint
Beispiel
' Gibt Art, Abstand und die Elemente aus, auf die sich der ausgewählte
' Referenzpunkt stützt.
' Vorbedingung: Ein Teil mit einem Referenzpunkt ist offen, der Punkt ist 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.RefPointFeatureData
Dim vElemente 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 <> "RefPoint" Then Exit Sub
Set swDaten = swFeat.GetDefinition
Debug.Print swFeat.Name & ": Art " & swDaten.Type & " (swRefPointType_e)"
If swDaten.Type = swRefPointAlongCurve Then
Debug.Print "Entlang der Kurve: Option " & swDaten.AlongCurveOption & _
", Abstand " & swDaten.Distance * 1000 & " mm"
End If
If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
Debug.Print swDaten.GetSelectionsCount & " Element(e):"
vElemente = swDaten.Selections
If IsArray(vElemente) Then
For i = 0 To UBound(vElemente)
If TypeOf vElemente(i) Is SldWorks.SketchPoint Then
Debug.Print " Skizzenpunkt"
ElseIf TypeOf vElemente(i) Is SldWorks.SketchSegment Then
Debug.Print " Skizzenelement"
ElseIf Not vElemente(i) Is Nothing Then
Debug.Print " Element der Geometrie"
End If
Next i
End If
swDaten.ReleaseSelectionAccess
End SubBemerkungen
Ändern: Nach RefPointFeatureData.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du RefPointFeatureData.ReleaseSelectionAccess auf. Für Art, Verteilung und Abstand gibt es außerdem FeatureManager.EditReferencePoint, das die ausgewählten Referenzpunkte ändert.
Anlegen: Neue Referenzpunkte legst du mit FeatureManager.InsertReferencePoint an. Die Methode liefert die Features, deren Definition du mit Feature.GetDefinition holst. So macht es das Hilfebeispiel „Insert Reference Points“.
Elemente: Das Hilfebeispiel „Get Reference Point Data“ unterscheidet bei RefPointFeatureData.Selections zwischen Entity, SketchPoint und SketchSegment und wählt jedes Element aus.
Einheiten: Für RefPointFeatureData.Distance nennt die Hilfe keine Einheit. Die Hilfebeispiele rechnen den Wert mit * 1000 in Millimeter um, also Meter.
Eigenschaften und Methoden
Eigenschaften 4, davon 4 beschrieben
| Name | Beschreibung |
|---|---|
| AlongCurveOption | Liest oder setzt die Option für Referenzpunkte entlang einer Kurve. |
| Distance | Liest oder setzt den Abstand, in dem der Referenzpunkt erzeugt wurde oder erzeugt werden soll. |
| Selections | Liest oder setzt die Elemente, auf die sich der Referenzpunkt stützt. |
| Type | Liest oder setzt die Art des Referenzpunkts. |
Methoden 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor den Referenzpunkt zurück, damit du die Auswahlen lesen und ändern kannst, die ihn festlegen. |
| GetSelectionsCount | Liefert die Zahl der Elemente, auf die sich der Referenzpunkt stützt. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du den Referenzpunkt 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: IRefPointFeatureData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.