SolidWorksMakroprogrammierung

Methode · FeatureManager

InsertRefPlane-Methode (FeatureManager)

Fügt eine Referenzebene ein, festgelegt über bis zu drei ausgewählte Referenzen und ihre Bedingungen.

Syntax

Function InsertRefPlane( _
   ByVal FirstConstraint As Long, _
   ByVal FirstConstraintAngleOrDistance As Double, _
   ByVal SecondConstraint As Long, _
   ByVal SecondConstraintAngleOrDistance As Double, _
   ByVal ThirdConstraint As Long, _
   ByVal ThirdConstraintAngleOrDistance As Double _
) As Object
Set swEbene = swFeatMgr.InsertRefPlane(swRefPlaneReferenceConstraint_Distance, 0.05, 0, 0, 0, 0)

Parameter

FirstConstraintLongByVal
Bedingung für die erste Referenz, ein Wert aus swRefPlaneReferenceConstraints_e, etwa swRefPlaneReferenceConstraint_Distance (8), swRefPlaneReferenceConstraint_Angle (16) oder swRefPlaneReferenceConstraint_Parallel (1). Optionen wie swRefPlaneReferenceConstraint_OptionFlip (256) werden addiert.
FirstConstraintAngleOrDistanceDoubleByVal
Abstand in Metern oder Winkel im Bogenmaß für die erste Referenz.
SecondConstraintLongByVal
Bedingung für die zweite Referenz, 0, wenn es keine gibt.
SecondConstraintAngleOrDistanceDoubleByVal
Abstand oder Winkel für die zweite Referenz.
ThirdConstraintLongByVal
Bedingung für die dritte Referenz, 0, wenn es keine gibt.
ThirdConstraintAngleOrDistanceDoubleByVal
Abstand oder Winkel für die dritte Referenz.

Rückgabewert

Die neue Ebene. Im Code kannst du sie als Feature verwenden, etwa um sie mit Feature.Select2 auszuwählen oder umzubenennen.

Beispiel

' Legt parallel zur vorderen Ebene im Abstand 50 mm eine neue Ebene an und benennt sie.
' Vorbedingung: Ein Teil ist geöffnet (deutsche oder englische Vorlage).
' Ergebnis:     Eine Ebene "Ebene 50 mm" im FeatureManager.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swEbene As SldWorks.Feature
    Dim bErfolg As Boolean

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    bErfolg = swModel.Extension.SelectByID2("Ebene vorne", "PLANE", 0, 0, 0, False, 0, Nothing, swSelectOptionDefault)
    If False = bErfolg Then bErfolg = swModel.Extension.SelectByID2("Front Plane", "PLANE", 0, 0, 0, False, 0, Nothing, swSelectOptionDefault)
    If False = bErfolg Then Exit Sub

    Set swEbene = swModel.FeatureManager.InsertRefPlane(swRefPlaneReferenceConstraint_Distance, 0.05, 0, 0, 0, 0)
    If swEbene Is Nothing Then
        swApp.SendMsgToUser2 "Ebene nicht erzeugt.", swMbWarning, swMbOk
    Else
        swEbene.Name = "Ebene 50 mm"
    End If
End Sub

Bemerkungen

Die Referenzen wählst du vorher mit ModelDocExtension.SelectByID2 aus und gibst ihnen die Markierungen 0 (erste), 1 (zweite) und 2 (dritte). Das Beispiel hat nur eine Referenz, die vordere Ebene mit der Markierung 0.

Der Rückgabewert ist eine Referenzebene (RefPlane). Die Beispiele der Hilfe und die Praxis behandeln ihn als Feature. Das Objekt RefPlane mit Lage und Größe holst du daraus mit Feature.GetSpecificFeature2. Zum Ändern der Bedingungen gibt es RefPlaneFeatureData.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2010

Englisches Original: IFeatureManager::InsertRefPlane in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.