Objekt · SldWorks
SketchManager-Objekt
Öffnet und schließt Skizzen und zeichnet darin Linien, Rechtecke, Kreise und andere Skizzenelemente.
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
ModelDoc2.SketchManager: der SketchManager eines Dokuments
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| ActiveSketch | Liefert die Skizze, die gerade zum Bearbeiten offen ist, oder Nothing, wenn keine offen ist. |
| AddToDB | Legt fest, ob Skizzenelemente genau an die angegebenen Koordinaten gezeichnet werden, ohne Fangen und ohne automatische Beziehungen. |
| AutoInference | veraltet ersetzt durch SldWorks.GetUserPreferenceToggle und SldWorks.SetUserPreferenceToggle |
| AutoSolve | Liefert oder setzt, ob SOLIDWORKS die Skizze beim Zeichnen automatisch löst. |
| CurvatureDensity | Liefert oder setzt die Dichte der Krümmungskämme von Splines. |
| CurvatureScale | Liefert oder setzt die Größe der Krümmungskämme von Splines. |
| DisplayWhenAdded | Legt fest, ob neue Skizzenelemente sofort angezeigt werden. Abschalten macht das Zeichnen vieler Elemente schneller. |
| Document | Liefert das Dokument, zu dem der SketchManager gehört. |
| InferenceMode | veraltet ersetzt durch SldWorks.GetUserPreferenceToggle und SldWorks.SetUserPreferenceToggle |
Methoden 78, davon 69 beschrieben, 9 veraltet
| Name | Beschreibung |
|---|---|
| AddAlongXDimension | Bemaßt in einer 3D-Skizze den Abstand zweier ausgewählter Punkte entlang der X-Achse. |
| AddAlongYDimension | Bemaßt in einer 3D-Skizze den Abstand zweier ausgewählter Punkte entlang der Y-Achse. |
| AddAlongZDimension | Bemaßt in einer 3D-Skizze den Abstand zweier ausgewählter Punkte entlang der Z-Achse. |
| ConvertEntities | Nicht umgesetzt. Stattdessen SketchUseEdge3 verwenden. |
| Create3PointArc | Zeichnet einen Bogen durch drei Punkte: Anfang, Ende und einen Punkt dazwischen. |
| Create3PointCenterRectangle | Zeichnet ein gedrehtes Rechteck über drei Punkte, ausgehend vom Mittelpunkt. |
| Create3PointCornerRectangle | Zeichnet ein gedrehtes Rechteck über drei Eckpunkte. |
| CreateArc | Zeichnet einen Bogen über Mittelpunkt, Anfangspunkt, Endpunkt und Drehrichtung. |
| CreateBoundaryHatch | Füllt eine ausgewählte geschlossene Kontur mit einer Schraffur oder Vollfläche. |
| CreateCenterLine | Zeichnet eine Mittellinie zwischen zwei Punkten. |
| CreateCenterRectangle | Zeichnet ein achsparalleles Rechteck vom Mittelpunkt aus. |
| CreateChamfer | Fügt zwischen zwei ausgewählten Skizzenelementen eine Fase ein. |
| CreateCircle | Zeichnet einen Kreis über Mittelpunkt und einen Punkt auf dem Kreis. |
| CreateCircleByRadius | Zeichnet einen Kreis über Mittelpunkt und Radius in der offenen Skizze. |
| CreateCircularSketchStepAndRepeat | Erzeugt ein kreisförmiges Skizzenmuster aus den ausgewählten Skizzenelementen. |
| CreateConic | Zeichnet einen Kegelschnitt über Brennpunkt, Scheitel, Anfangs- und Endpunkt. |
| CreateConstructionGeometry | Macht die ausgewählten Skizzenelemente zu Konstruktionslinien. |
| CreateCornerRectangle | Zeichnet ein achsparalleles Rechteck über zwei gegenüberliegende Ecken in der offenen Skizze. |
| CreateEllipse | Zeichnet eine Ellipse über Mittelpunkt und je einen Punkt auf der großen und der kleinen Achse. |
| CreateEllipticalArc | Zeichnet einen Ellipsenbogen über Mittelpunkt, Achsenpunkte, Anfang, Ende und Drehrichtung. |
| CreateEquationSpline | veraltet ersetzt durch SketchManager.CreateEquationSpline2 |
| CreateEquationSpline2 | Zeichnet eine gleichungsgesteuerte Kurve, explizit als y = f(x) oder als Parameterkurve in 2D oder 3D. |
| CreateFillet | Rundet die Ecke zwischen den ausgewählten Skizzenelementen mit einem Radius ab. |
| CreateLine | Zeichnet eine Linie von einem Punkt zum anderen in der offenen Skizze. |
| CreateLinearSketchStepAndRepeat | Erzeugt ein lineares Skizzenmuster aus den ausgewählten Skizzenelementen, in einer oder zwei Richtungen. |
| CreateParabola | Zeichnet eine Parabel über Brennpunkt, Scheitel, Anfangs- und Endpunkt. |
| CreateParallelogram | Zeichnet ein Parallelogramm über drei Eckpunkte. |
| CreatePoint | Zeichnet einen Punkt in der offenen 2D- oder 3D-Skizze. |
| CreatePolygon | Zeichnet ein regelmäßiges Vieleck über Mittelpunkt, einen Eckpunkt und die Anzahl der Seiten. |
| CreateRegionHatch | Füllt die geschlossene Kontur, in der ein Punkt liegt, mit einer Schraffur oder Vollfläche. |
| CreateSketchBelt | Erzeugt einen Riemen in einer Skizze um die ausgewählten Riemenscheiben. |
| CreateSketchPlane | Erzeugt in einer 3D-Skizze eine Skizzenebene aus bis zu drei ausgewählten Elementen. |
| CreateSketchSlot | Zeichnet eine Nut (Langloch), gerade oder als Bogen. |
| CreateSpline | veraltet ersetzt durch SketchManager.CreateSpline3 |
| CreateSpline2 | veraltet ersetzt durch SketchManager.CreateSpline3 |
| CreateSpline3 | Zeichnet einen Spline durch Punkte, in einer 2D-Skizze oder auf Flächen projiziert. |
| CreateSplineByEqnParams | Zeichnet einen Spline aus B-Spline-Daten: Kontrollpunkte und Knotenvektor. |
| CreateSplineParamData | Erzeugt ein leeres SplineParamData-Objekt, das du mit Spline-Daten füllst. |
| CreateSplinesByEqnParams | veraltet ersetzt durch SketchManager.CreateSplinesByEqnParams2 |
| CreateSplinesByEqnParams2 | Zeichnet einen oder mehrere Splines aus einem SplineParamData-Objekt. |
| CreateTangentArc | Zeichnet 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. |
| EndEditSketchBlock | Beendet das Bearbeiten eines Blocks und übernimmt oder verwirft die Änderungen. |
| ExplodeSketchBlockInstance | Löst eine Blockinstanz in einzelne Skizzenelemente auf. |
| FullyDefineSketch | Definiert eine Skizze vollständig, indem SOLIDWORKS selbst Beziehungen und Bemaßungen anlegt. |
| GetDynamicMirror | Liefert, ob neue Skizzenelemente automatisch an einer Mittellinie gespiegelt werden. |
| GetSketchBlockDefinitionCount | Liefert die Anzahl der Blockdefinitionen im Modell. |
| GetSketchBlockDefinitions | Liefert 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“. |
| InsertSketchBlockInstance | Fügt eine Instanz eines Blocks an einer Stelle ein, mit Maßstab und Drehwinkel. |
| InsertSketchPicture | veraltet ersetzt durch SketchManager.InsertSketchPicture2 |
| InsertSketchPicture2 | Fügt ein Bild aus einer Datei in die offene Skizze ein. |
| IntersectCurves | Erzeugt Schnittkurven der ausgewählten Elemente in der offenen Skizze. |
| MakeSketchBlockFromFile | Legt eine Blockdefinition aus einer Blockdatei an. |
| MakeSketchBlockFromSelected | Legt aus den ausgewählten Skizzenelementen eine Blockdefinition an. |
| MakeSketchBlockFromSketch | Legt aus allen Elementen einer Skizze eine Blockdefinition an. |
| MakeSketchChain | Macht aus den ausgewählten Skizzenelementen einen Skizzenpfad. |
| PerimeterCircle | Zeichnet einen Kreis durch drei Punkte. |
| ReverseEndPointTangent | Kehrt die Tangentenrichtung am Endpunkt der ausgewählten Splines und Bögen um. |
| RotateOrCopy3DAboutVector | Dreht die ausgewählten Elemente einer 3D-Skizze um eine Achse, wahlweise als Kopie. |
| RotateOrCopy3DAboutXYZ | Dreht die ausgewählten Elemente einer 3D-Skizze um die Achsen X, Y und Z, wahlweise als Kopie. |
| SetDynamicMirror | Schaltet das dynamische Spiegeln ein oder aus: Neue Elemente werden automatisch an einer ausgewählten Mittellinie gespiegelt. |
| SetGridOptions | Legt die Einstellungen des Skizzenrasters fest: Anzeige, Abstand, Fangen. |
| SketchExtend | Verlängert das ausgewählte Skizzenelement bis zum nächsten Element. |
| SketchOffset | veraltet ersetzt durch SketchManager.SketchOffset2 |
| SketchOffset2 | Versetzt die ausgewählten Skizzenelemente um einen Abstand, wie „Elemente versetzen“ in der Oberfläche. |
| SketchReplace | veraltet ersetzt durch SketchManager.SketchReplace2 |
| SketchReplace2 | Ersetzt ein Skizzenelement durch ein anderes und behält dabei alle Referenzen. |
| SketchTrim | Trimmt die ausgewählten Skizzenelemente, wie das Werkzeug „Elemente trimmen“. |
| SketchUseEdge | veraltet ersetzt durch SketchManager.SketchUseEdge3 |
| SketchUseEdge2 | veraltet ersetzt durch SketchManager.SketchUseEdge3 |
| SketchUseEdge3 | Übernimmt ausgewählte Kanten, Schleifen, Flächen oder Kurven in die offene Skizze, wie „Elemente übernehmen“. |
| SplitClosedSegment | Teilt ein ausgewähltes geschlossenes Skizzenelement, etwa einen Kreis, an zwei Punkten in zwei Teile. |
| SplitOpenSegment | Teilt 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.