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 ObjectSet swEbene = swFeatMgr.InsertRefPlane(swRefPlaneReferenceConstraint_Distance, 0.05, 0, 0, 0, 0)Parameter
FirstConstraintLongByVal- Bedingung für die erste Referenz, ein Wert aus
swRefPlaneReferenceConstraints_e, etwaswRefPlaneReferenceConstraint_Distance(8),swRefPlaneReferenceConstraint_Angle(16) oderswRefPlaneReferenceConstraint_Parallel(1). Optionen wieswRefPlaneReferenceConstraint_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 SubBemerkungen
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.