SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchManager-Objekt

Öffnet und schließt Skizzen und zeichnet darin Linien, Rechtecke, Kreise und andere Skizzenelemente.

Deklaration Dim x As SldWorks.SketchManager · in der englischen .NET-Hilfe: ISketchManager

Beschreibung

Der SketchManager ist das Werkzeug zum Skizzieren per Makro. Er öffnet eine Skizze auf einer Ebene oder ebenen Fläche, zeichnet darin und schließt sie wieder. Fast alle Befehle beginnen mit Create, etwa CreateLine, CreateCornerRectangle oder CreateCircleByRadius.

Zugriff

Beispiel

' Skizziert auf der vorderen Ebene ein Rechteck 100 x 60 mm mit einem Kreis in der Mitte.
' Vorbedingung: Ein neues, leeres Teil ist geöffnet (deutsche oder englische Vorlage).
' Ergebnis:     Eine geschlossene Skizze mit Rechteck und Kreis.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSkMgr As SldWorks.SketchManager
    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 swSkMgr = swModel.SketchManager
    swSkMgr.InsertSketch True
    swSkMgr.AddToDB = True
    swSkMgr.CreateCornerRectangle -0.05, -0.03, 0, 0.05, 0.03, 0     ' 100 x 60 mm um den Ursprung
    swSkMgr.CreateCircleByRadius 0, 0, 0, 0.01                       ' Radius 10 mm
    swSkMgr.AddToDB = False
    swSkMgr.InsertSketch True
End Sub

Bemerkungen

Alle Koordinaten und Längen sind in Metern, egal welche Einheit das Dokument verwendet. 100 mm schreibst du als 0.1. Die Koordinaten beziehen sich auf die Skizze: X und Y liegen in der Skizzenebene, Z ist in einer 2D-Skizze 0.

Die Skizzenbefehle zeichnen nur, wenn eine Skizze offen ist. Ein Makro öffnet sie deshalb zuerst mit SketchManager.InsertSketch und schließt sie am Ende auf dieselbe Weise.

Ohne SketchManager.AddToDB verhält sich das Zeichnen wie mit der Maus: SOLIDWORKS fängt an vorhandenen Punkten und fügt automatische Beziehungen hinzu. Für Makros ist das meist unerwünscht.

Viele ältere Skizzenbefehle direkt auf ModelDoc2, etwa CreateLine2 oder CreateCircleByRadius2, sind veraltet. Ihre Nachfolger liegen hier.

Eigenschaften und Methoden

Eigenschaften 9, davon 7 beschrieben, 2 veraltet

NameBeschreibung
ActiveSketchLiefert die Skizze, die gerade zum Bearbeiten offen ist, oder Nothing, wenn keine offen ist.
AddToDBLegt fest, ob Skizzenelemente genau an die angegebenen Koordinaten gezeichnet werden, ohne Fangen und ohne automatische Beziehungen.
AutoInferenceveraltet ersetzt durch SldWorks.GetUserPreferenceToggle und SldWorks.SetUserPreferenceToggle
AutoSolveLiefert oder setzt, ob SOLIDWORKS die Skizze beim Zeichnen automatisch löst.
CurvatureDensityLiefert oder setzt die Dichte der Krümmungskämme von Splines.
CurvatureScaleLiefert oder setzt die Größe der Krümmungskämme von Splines.
DisplayWhenAddedLegt fest, ob neue Skizzenelemente sofort angezeigt werden. Abschalten macht das Zeichnen vieler Elemente schneller.
DocumentLiefert das Dokument, zu dem der SketchManager gehört.
InferenceModeveraltet ersetzt durch SldWorks.GetUserPreferenceToggle und SldWorks.SetUserPreferenceToggle

Methoden 78, davon 69 beschrieben, 9 veraltet

NameBeschreibung
AddAlongXDimensionBemaßt in einer 3D-Skizze den Abstand zweier ausgewählter Punkte entlang der X-Achse.
AddAlongYDimensionBemaßt in einer 3D-Skizze den Abstand zweier ausgewählter Punkte entlang der Y-Achse.
AddAlongZDimensionBemaßt in einer 3D-Skizze den Abstand zweier ausgewählter Punkte entlang der Z-Achse.
ConvertEntitiesNicht umgesetzt. Stattdessen SketchUseEdge3 verwenden.
Create3PointArcZeichnet einen Bogen durch drei Punkte: Anfang, Ende und einen Punkt dazwischen.
Create3PointCenterRectangleZeichnet ein gedrehtes Rechteck über drei Punkte, ausgehend vom Mittelpunkt.
Create3PointCornerRectangleZeichnet ein gedrehtes Rechteck über drei Eckpunkte.
CreateArcZeichnet einen Bogen über Mittelpunkt, Anfangspunkt, Endpunkt und Drehrichtung.
CreateBoundaryHatchFüllt eine ausgewählte geschlossene Kontur mit einer Schraffur oder Vollfläche.
CreateCenterLineZeichnet eine Mittellinie zwischen zwei Punkten.
CreateCenterRectangleZeichnet ein achsparalleles Rechteck vom Mittelpunkt aus.
CreateChamferFügt zwischen zwei ausgewählten Skizzenelementen eine Fase ein.
CreateCircleZeichnet einen Kreis über Mittelpunkt und einen Punkt auf dem Kreis.
CreateCircleByRadiusZeichnet einen Kreis über Mittelpunkt und Radius in der offenen Skizze.
CreateCircularSketchStepAndRepeatErzeugt ein kreisförmiges Skizzenmuster aus den ausgewählten Skizzenelementen.
CreateConicZeichnet einen Kegelschnitt über Brennpunkt, Scheitel, Anfangs- und Endpunkt.
CreateConstructionGeometryMacht die ausgewählten Skizzenelemente zu Konstruktionslinien.
CreateCornerRectangleZeichnet ein achsparalleles Rechteck über zwei gegenüberliegende Ecken in der offenen Skizze.
CreateEllipseZeichnet eine Ellipse über Mittelpunkt und je einen Punkt auf der großen und der kleinen Achse.
CreateEllipticalArcZeichnet einen Ellipsenbogen über Mittelpunkt, Achsenpunkte, Anfang, Ende und Drehrichtung.
CreateEquationSplineveraltet ersetzt durch SketchManager.CreateEquationSpline2
CreateEquationSpline2Zeichnet eine gleichungsgesteuerte Kurve, explizit als y = f(x) oder als Parameterkurve in 2D oder 3D.
CreateFilletRundet die Ecke zwischen den ausgewählten Skizzenelementen mit einem Radius ab.
CreateLineZeichnet eine Linie von einem Punkt zum anderen in der offenen Skizze.
CreateLinearSketchStepAndRepeatErzeugt ein lineares Skizzenmuster aus den ausgewählten Skizzenelementen, in einer oder zwei Richtungen.
CreateParabolaZeichnet eine Parabel über Brennpunkt, Scheitel, Anfangs- und Endpunkt.
CreateParallelogramZeichnet ein Parallelogramm über drei Eckpunkte.
CreatePointZeichnet einen Punkt in der offenen 2D- oder 3D-Skizze.
CreatePolygonZeichnet ein regelmäßiges Vieleck über Mittelpunkt, einen Eckpunkt und die Anzahl der Seiten.
CreateRegionHatchFüllt die geschlossene Kontur, in der ein Punkt liegt, mit einer Schraffur oder Vollfläche.
CreateSketchBeltErzeugt einen Riemen in einer Skizze um die ausgewählten Riemenscheiben.
CreateSketchPlaneErzeugt in einer 3D-Skizze eine Skizzenebene aus bis zu drei ausgewählten Elementen.
CreateSketchSlotZeichnet eine Nut (Langloch), gerade oder als Bogen.
CreateSplineveraltet ersetzt durch SketchManager.CreateSpline3
CreateSpline2veraltet ersetzt durch SketchManager.CreateSpline3
CreateSpline3Zeichnet einen Spline durch Punkte, in einer 2D-Skizze oder auf Flächen projiziert.
CreateSplineByEqnParamsZeichnet einen Spline aus B-Spline-Daten: Kontrollpunkte und Knotenvektor.
CreateSplineParamDataErzeugt ein leeres SplineParamData-Objekt, das du mit Spline-Daten füllst.
CreateSplinesByEqnParamsveraltet ersetzt durch SketchManager.CreateSplinesByEqnParams2
CreateSplinesByEqnParams2Zeichnet einen oder mehrere Splines aus einem SplineParamData-Objekt.
CreateTangentArcZeichnet einen Bogen, der tangential an das Ende eines vorhandenen Elements anschließt.
EditCircularSketchStepAndRepeatÄndert ein vorhandenes kreisförmiges Skizzenmuster.
EditLinearSketchStepAndRepeatÄndert ein vorhandenes lineares Skizzenmuster.
EditSketchBlockÖffnet die ausgewählte Blockdefinition zum Bearbeiten.
EndEditSketchBlockBeendet das Bearbeiten eines Blocks und übernimmt oder verwirft die Änderungen.
ExplodeSketchBlockInstanceLöst eine Blockinstanz in einzelne Skizzenelemente auf.
FullyDefineSketchDefiniert eine Skizze vollständig, indem SOLIDWORKS selbst Beziehungen und Bemaßungen anlegt.
GetDynamicMirrorLiefert, ob neue Skizzenelemente automatisch an einer Mittellinie gespiegelt werden.
GetSketchBlockDefinitionCountLiefert die Anzahl der Blockdefinitionen im Modell.
GetSketchBlockDefinitionsLiefert alle Blockdefinitionen des Modells als SketchBlockDefinition-Objekte.
Insert3DSketchÖffnet eine neue 3D-Skizze oder schließt die offene Skizze.
InsertExplodeLineSketchÖffnet oder schließt eine Explosionslinienskizze in einer explodierten Ansicht.
InsertSketchÖffnet eine Skizze auf der ausgewählten Ebene oder Fläche, oder schließt die offene Skizze, wie der Knopf „Skizze“.
InsertSketchBlockInstanceFügt eine Instanz eines Blocks an einer Stelle ein, mit Maßstab und Drehwinkel.
InsertSketchPictureveraltet ersetzt durch SketchManager.InsertSketchPicture2
InsertSketchPicture2Fügt ein Bild aus einer Datei in die offene Skizze ein.
IntersectCurvesErzeugt Schnittkurven der ausgewählten Elemente in der offenen Skizze.
MakeSketchBlockFromFileLegt eine Blockdefinition aus einer Blockdatei an.
MakeSketchBlockFromSelectedLegt aus den ausgewählten Skizzenelementen eine Blockdefinition an.
MakeSketchBlockFromSketchLegt aus allen Elementen einer Skizze eine Blockdefinition an.
MakeSketchChainMacht aus den ausgewählten Skizzenelementen einen Skizzenpfad.
PerimeterCircleZeichnet einen Kreis durch drei Punkte.
ReverseEndPointTangentKehrt die Tangentenrichtung am Endpunkt der ausgewählten Splines und Bögen um.
RotateOrCopy3DAboutVectorDreht die ausgewählten Elemente einer 3D-Skizze um eine Achse, wahlweise als Kopie.
RotateOrCopy3DAboutXYZDreht die ausgewählten Elemente einer 3D-Skizze um die Achsen X, Y und Z, wahlweise als Kopie.
SetDynamicMirrorSchaltet das dynamische Spiegeln ein oder aus: Neue Elemente werden automatisch an einer ausgewählten Mittellinie gespiegelt.
SetGridOptionsLegt die Einstellungen des Skizzenrasters fest: Anzeige, Abstand, Fangen.
SketchExtendVerlängert das ausgewählte Skizzenelement bis zum nächsten Element.
SketchOffsetveraltet ersetzt durch SketchManager.SketchOffset2
SketchOffset2Versetzt die ausgewählten Skizzenelemente um einen Abstand, wie „Elemente versetzen“ in der Oberfläche.
SketchReplaceveraltet ersetzt durch SketchManager.SketchReplace2
SketchReplace2Ersetzt ein Skizzenelement durch ein anderes und behält dabei alle Referenzen.
SketchTrimTrimmt die ausgewählten Skizzenelemente, wie das Werkzeug „Elemente trimmen“.
SketchUseEdgeveraltet ersetzt durch SketchManager.SketchUseEdge3
SketchUseEdge2veraltet ersetzt durch SketchManager.SketchUseEdge3
SketchUseEdge3Übernimmt ausgewählte Kanten, Schleifen, Flächen oder Kurven in die offene Skizze, wie „Elemente übernehmen“.
SplitClosedSegmentTeilt ein ausgewähltes geschlossenes Skizzenelement, etwa einen Kreis, an zwei Punkten in zwei Teile.
SplitOpenSegmentTeilt ein ausgewähltes offenes Skizzenelement, etwa eine Linie, an einem Punkt in zwei Teile.

Nicht aufgeführt sind 5 C++-Varianten (Namen mit I davor, zum Beispiel ICreateSpline). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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