SolidWorksMakroprogrammierung

Objekt · SldWorks

RefPointFeatureData-Objekt

Die Definition eines Referenzpunkts: Art, Abstand entlang einer Kurve und die Elemente, auf die er sich stützt.

Deklaration Dim x As SldWorks.RefPointFeatureData · in der englischen .NET-Hilfe: IRefPointFeatureData

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

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 Sub

Bemerkungen

Ä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

NameBeschreibung
AlongCurveOptionLiest oder setzt die Option für Referenzpunkte entlang einer Kurve.
DistanceLiest oder setzt den Abstand, in dem der Referenzpunkt erzeugt wurde oder erzeugt werden soll.
SelectionsLiest oder setzt die Elemente, auf die sich der Referenzpunkt stützt.
TypeLiest oder setzt die Art des Referenzpunkts.

Methoden 3, davon 3 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor den Referenzpunkt zurück, damit du die Auswahlen lesen und ändern kannst, die ihn festlegen.
GetSelectionsCountLiefert die Zahl der Elemente, auf die sich der Referenzpunkt stützt.
ReleaseSelectionAccessHebt 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.