Objekt · SldWorks
Sketch-Objekt
Steht für eine Skizze und liefert ihren Inhalt: Linien, Bögen, Punkte und mehr.
Beschreibung
Ein Sketch-Objekt gibt Auskunft über den Inhalt einer Skizze: welche Elemente sie hat, welche Punkte, ob sie 2D oder 3D ist. Den Namen und die Stellung im Baum liefert dagegen das Feature, das zu der Skizze gehört.
Skizzen gibt es in Teilen und Baugruppen als Grundlage für Features, aber auch in Zeichnungen, wenn dort Linien oder Bögen von Hand gezeichnet werden.
Zugriff
SketchManager.ActiveSketch: die gerade offene SkizzeFeature.GetSpecificFeature2: aus einem Feature vom TypProfileFeature, also einer Skizze im BaumSketchSegment.GetSketch: die Skizze, zu der ein Element gehört
Beispiel
' Zeigt, wie viele Elemente die im FeatureManager ausgewählte Skizze hat und ob sie 3D ist.
' Vorbedingung: In einem Teil ist im FeatureManager eine Skizze angeklickt.
' Ergebnis: Meldung mit Name, Anzahl der Elemente und 2D oder 3D.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swFeat As SldWorks.Feature
Dim swSketch As SldWorks.Sketch
Dim vSegmente As Variant
Dim nAnzahl As Long
Dim sArt As String
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.SelectionManager.GetSelectedObjectType3(1, -1) <> swSelSKETCHES Then
swApp.SendMsgToUser2 "Bitte eine Skizze im FeatureManager anklicken.", swMbWarning, swMbOk
Exit Sub
End If
Set swFeat = swModel.SelectionManager.GetSelectedObject6(1, -1)
Set swSketch = swFeat.GetSpecificFeature2
vSegmente = swSketch.GetSketchSegments
If Not IsEmpty(vSegmente) Then nAnzahl = UBound(vSegmente) + 1
If swSketch.Is3D Then sArt = "3D" Else sArt = "2D"
swApp.SendMsgToUser2 swFeat.Name & ": " & nAnzahl & " Elemente, " & sArt, swMbInformation, swMbOk
End SubBemerkungen
Eine im FeatureManager ausgewählte Skizze liefert SelectionMgr.GetSelectedObject6 als Feature. Daraus wird eine Skizze mit Feature.GetSpecificFeature2, wie im Beispiel. Umgekehrt weist du eine Skizze einer Variable vom Typ Feature zu, wenn du ihren Namen brauchst, siehe SketchManager.ActiveSketch.
Die Typnamen ProfileFeature für eine 2D-Skizze und 3DProfileFeature für eine 3D-Skizze liefert Feature.GetTypeName2. Sie sind in jeder Sprache gleich, anders als die Namen Skizze1 oder Sketch1.
Zum Zeichnen in einer Skizze ist nicht das Sketch-Objekt da, sondern der SketchManager.
Eigenschaften und Methoden
Eigenschaften 3, davon 2 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| ModelToSketchTransform | Liefert die Transformation, die Modellkoordinaten in Koordinaten dieser Skizze umrechnet. |
| ModelToSketchXform | veraltet ersetzt durch Sketch.ModelToSketchTransform |
| RelationManager | Liefert den SketchRelationManager, mit dem du Beziehungen der Skizze liest und anlegst. |
Methoden 73, davon 56 beschrieben, 17 veraltet
| Name | Beschreibung |
|---|---|
| AutoDimension | veraltet ersetzt durch SketchManager.FullyDefineSketch |
| AutoDimension2 | veraltet ersetzt durch SketchManager.FullyDefineSketch |
| AutoTraceSketchPicture | Ohne Beschreibung in der Hilfe. Dem Namen nach zeichnet der Befehl ein Skizzenbild automatisch nach. |
| CheckFeatureUse | Prüft, ob eine Skizze für ein bestimmtes Feature taugt, etwa für eine Extrusion, und zählt offene und geschlossene Konturen. |
| ConstrainAll | Versucht, alle erkennbaren Beziehungen der Skizze anzulegen, und liefert ihre Anzahl. |
| GetArcCount | Liefert die Anzahl der Bögen in der Skizze. |
| GetArcs | veraltet ersetzt durch Sketch.GetArcs2 |
| GetArcs2 | Liefert die Daten aller Bögen der Skizze in einem Zahlen-Array: Anfang, Ende, Mittelpunkt und Drehrichtung. |
| GetAutomaticSolve | Liefert, ob SOLIDWORKS die Skizze nach jeder Änderung automatisch neu löst. |
| GetConstrainedStatus | Liefert, wie weit die ganze Skizze bestimmt ist, etwa unterdefiniert oder vollständig definiert. |
| GetContourEdgeCount | Liefert die Anzahl der Kanten einer Skizze, die genau eine geschlossene Kontur hat. |
| GetContourEdges | Liefert die Kanten einer Skizze mit genau einer Kontur, in Skizzen- oder Modellkoordinaten. |
| GetDetachSegmentOnDrag | Liefert, ob Skizzenelemente beim Ziehen von den anderen gelöst werden. |
| GetEllipseCount | Liefert die Anzahl der Ellipsen in der Skizze. |
| GetEllipses | veraltet ersetzt durch Sketch.GetEllipses3 |
| GetEllipses2 | veraltet ersetzt durch Sketch.GetEllipses3 |
| GetEllipses3 | Liefert die Daten aller Ellipsen der Skizze in einem Zahlen-Array. |
| GetLineCount | veraltet ersetzt durch Sketch.GetLineCount2 |
| GetLineCount2 | Liefert die Anzahl der Linien in der Skizze, wahlweise mit oder ohne Schraffurlinien. |
| GetLines | veraltet ersetzt durch Sketch.GetLines2 |
| GetLines2 | Liefert die Daten aller Linien der Skizze in einem Zahlen-Array, wahlweise mit oder ohne Schraffurlinien. |
| GetParabolaCount | Liefert die Anzahl der Parabeln in der Skizze. |
| GetParabolas | veraltet ersetzt durch Sketch.GetParabolas2 |
| GetParabolas2 | Liefert die Daten aller Parabeln der Skizze in einem Zahlen-Array. |
| GetPolyLineCount | Nicht umgesetzt. Nicht verwenden. |
| GetPolylines | Nicht umgesetzt. Nicht verwenden. |
| GetReferenceEntity | Liefert die Ebene oder Fläche, auf der die Skizze liegt. |
| GetSketchBlockInstanceCount | Liefert die Anzahl der Blockinstanzen in der Skizze. |
| GetSketchBlockInstances | Liefert die Blockinstanzen der Skizze als SketchBlockInstance-Objekte. |
| GetSketchContourCount | Liefert die Anzahl der Konturen in der Skizze. |
| GetSketchContours | Liefert die Konturen der Skizze als SketchContour-Objekte. |
| GetSketchHatches | Liefert die Schraffuren der Skizze als SketchHatch-Objekte. |
| GetSketchPathCount | Liefert die Anzahl der Skizzenpfade in der Skizze. |
| GetSketchPaths | Liefert die Skizzenpfade der Skizze als SketchPath-Objekte. |
| GetSketchPictureCount | Liefert die Anzahl der Skizzenbilder in der Skizze. |
| GetSketchPictures | Liefert die Skizzenbilder der Skizze als SketchPicture-Objekte. |
| GetSketchPoints | veraltet ersetzt durch Sketch.GetSketchPoints2 |
| GetSketchPoints2 | Liefert die Punkte der Skizze als SketchPoint-Objekte. |
| GetSketchPointsCount | veraltet ersetzt durch Sketch.GetSketchPointsCount2 |
| GetSketchPointsCount2 | Liefert die Anzahl der Punkte in der Skizze. |
| GetSketchRegionCount | Liefert die Anzahl der Bereiche in der Skizze. |
| GetSketchRegions | Liefert die Bereiche der Skizze als SketchRegion-Objekte. |
| GetSketchSegments | Liefert alle Elemente einer Skizze als Array: Linien, Bögen und Kreise, Splines, Parabeln und Ellipsen. |
| GetSketchSlotCount | Liefert die Anzahl der Nuten in der Skizze. |
| GetSketchSlots | Liefert die Nuten der Skizze als SketchSlot-Objekte. |
| GetSketchTextSegments | Liefert die Skizzenelemente, aus denen ein ausgewählter Skizzentext besteht. |
| GetSplineCount | Liefert die Anzahl der Splines in der Skizze und die Anzahl der Punkte. |
| GetSplineInterpolateCount | Liefert die Anzahl der Splines in der Skizze und die Anzahl ihrer Stützpunkte. |
| GetSplineParams | veraltet ersetzt durch Sketch.GetSplineParams5 |
| GetSplineParams2 | veraltet ersetzt durch Sketch.GetSplineParams5 |
| GetSplineParams3 | veraltet ersetzt durch Sketch.GetSplineParams5 |
| GetSplineParams4 | veraltet ersetzt durch Sketch.GetSplineParams5 |
| GetSplineParams5 | Liefert die Parameter eines Splines der Skizze als SplineParamData-Objekt. |
| GetSplineParamsCount | veraltet ersetzt durch Sketch.GetSplineParamsCount3 |
| GetSplineParamsCount2 | veraltet ersetzt durch Sketch.GetSplineParamsCount3 |
| GetSplineParamsCount3 | Liefert die Anzahl der Splines in der Skizze und die Größe der Parameterdaten. |
| GetSplines | Liefert Punkte auf allen Splines der Skizze, angenähert nach der Darstellungsqualität. |
| GetSplinesInterpolate | Liefert die Stützpunkte aller Splines der Skizze, also die Punkte, aus denen sie erzeugt wurden. |
| GetUserPoints | veraltet ersetzt durch Sketch.GetUserPoints2 |
| GetUserPoints2 | Liefert die Daten aller selbst gezeichneten Punkte der Skizze in einem Zahlen-Array. |
| GetUserPointsCount | Liefert die Anzahl der selbst gezeichneten Punkte in der Skizze. |
| InsertRouteLine | Fügt in eine Explosionslinienskizze oder 3D-Skizze eine Routenlinie zwischen Flächen, Kanten oder Eckpunkten ein. |
| Is3D | Liefert, ob die Skizze eine 3D-Skizze ist. |
| IsBoundaryBoxSketch | Liefert, ob die Skizze ein Begrenzungsrahmen ist. |
| IsDerived | Liefert, ob die Skizze abgeleitet ist. |
| IsShared | Liefert, ob mehr als ein Feature die Skizze benutzt. |
| IsSketchEditable | Liefert, ob die Skizze bearbeitet werden kann. |
| MergePoints | Verschmilzt Skizzenpunkte, die näher als ein angegebener Abstand beieinander liegen. |
| SetAutomaticSolve | Schaltet ein oder aus, ob SOLIDWORKS die Skizze nach jeder Änderung automatisch neu löst. |
| SetDetachSegmentOnDrag | Legt fest, ob Skizzenelemente beim Ziehen von den anderen gelöst werden. |
| SetEntityCount | Ohne Beschreibung in der Hilfe. |
| SetSketchEditable | Legt fest, ob die Skizze bearbeitet werden kann oder schreibgeschützt ist. |
| SetWorkingPlaneOrientation | Legt in einer 3D-Skizze die Arbeitsebene fest, auf der neue Elemente entstehen. |
Nicht aufgeführt sind 30 C++-Varianten (Namen mit I davor, zum Beispiel IEnumSketchHatches). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ISketch in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.