SolidWorksMakroprogrammierung

Objekt · SldWorks

Sketch-Objekt

Steht für eine Skizze und liefert ihren Inhalt: Linien, Bögen, Punkte und mehr.

Deklaration Dim x As SldWorks.Sketch · in der englischen .NET-Hilfe: ISketch

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

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 Sub

Bemerkungen

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

NameBeschreibung
ModelToSketchTransformLiefert die Transformation, die Modellkoordinaten in Koordinaten dieser Skizze umrechnet.
ModelToSketchXformveraltet ersetzt durch Sketch.ModelToSketchTransform
RelationManagerLiefert den SketchRelationManager, mit dem du Beziehungen der Skizze liest und anlegst.

Methoden 73, davon 56 beschrieben, 17 veraltet

NameBeschreibung
AutoDimensionveraltet ersetzt durch SketchManager.FullyDefineSketch
AutoDimension2veraltet ersetzt durch SketchManager.FullyDefineSketch
AutoTraceSketchPictureOhne Beschreibung in der Hilfe. Dem Namen nach zeichnet der Befehl ein Skizzenbild automatisch nach.
CheckFeatureUsePrüft, ob eine Skizze für ein bestimmtes Feature taugt, etwa für eine Extrusion, und zählt offene und geschlossene Konturen.
ConstrainAllVersucht, alle erkennbaren Beziehungen der Skizze anzulegen, und liefert ihre Anzahl.
GetArcCountLiefert die Anzahl der Bögen in der Skizze.
GetArcsveraltet ersetzt durch Sketch.GetArcs2
GetArcs2Liefert die Daten aller Bögen der Skizze in einem Zahlen-Array: Anfang, Ende, Mittelpunkt und Drehrichtung.
GetAutomaticSolveLiefert, ob SOLIDWORKS die Skizze nach jeder Änderung automatisch neu löst.
GetConstrainedStatusLiefert, wie weit die ganze Skizze bestimmt ist, etwa unterdefiniert oder vollständig definiert.
GetContourEdgeCountLiefert die Anzahl der Kanten einer Skizze, die genau eine geschlossene Kontur hat.
GetContourEdgesLiefert die Kanten einer Skizze mit genau einer Kontur, in Skizzen- oder Modellkoordinaten.
GetDetachSegmentOnDragLiefert, ob Skizzenelemente beim Ziehen von den anderen gelöst werden.
GetEllipseCountLiefert die Anzahl der Ellipsen in der Skizze.
GetEllipsesveraltet ersetzt durch Sketch.GetEllipses3
GetEllipses2veraltet ersetzt durch Sketch.GetEllipses3
GetEllipses3Liefert die Daten aller Ellipsen der Skizze in einem Zahlen-Array.
GetLineCountveraltet ersetzt durch Sketch.GetLineCount2
GetLineCount2Liefert die Anzahl der Linien in der Skizze, wahlweise mit oder ohne Schraffurlinien.
GetLinesveraltet ersetzt durch Sketch.GetLines2
GetLines2Liefert die Daten aller Linien der Skizze in einem Zahlen-Array, wahlweise mit oder ohne Schraffurlinien.
GetParabolaCountLiefert die Anzahl der Parabeln in der Skizze.
GetParabolasveraltet ersetzt durch Sketch.GetParabolas2
GetParabolas2Liefert die Daten aller Parabeln der Skizze in einem Zahlen-Array.
GetPolyLineCountNicht umgesetzt. Nicht verwenden.
GetPolylinesNicht umgesetzt. Nicht verwenden.
GetReferenceEntityLiefert die Ebene oder Fläche, auf der die Skizze liegt.
GetSketchBlockInstanceCountLiefert die Anzahl der Blockinstanzen in der Skizze.
GetSketchBlockInstancesLiefert die Blockinstanzen der Skizze als SketchBlockInstance-Objekte.
GetSketchContourCountLiefert die Anzahl der Konturen in der Skizze.
GetSketchContoursLiefert die Konturen der Skizze als SketchContour-Objekte.
GetSketchHatchesLiefert die Schraffuren der Skizze als SketchHatch-Objekte.
GetSketchPathCountLiefert die Anzahl der Skizzenpfade in der Skizze.
GetSketchPathsLiefert die Skizzenpfade der Skizze als SketchPath-Objekte.
GetSketchPictureCountLiefert die Anzahl der Skizzenbilder in der Skizze.
GetSketchPicturesLiefert die Skizzenbilder der Skizze als SketchPicture-Objekte.
GetSketchPointsveraltet ersetzt durch Sketch.GetSketchPoints2
GetSketchPoints2Liefert die Punkte der Skizze als SketchPoint-Objekte.
GetSketchPointsCountveraltet ersetzt durch Sketch.GetSketchPointsCount2
GetSketchPointsCount2Liefert die Anzahl der Punkte in der Skizze.
GetSketchRegionCountLiefert die Anzahl der Bereiche in der Skizze.
GetSketchRegionsLiefert die Bereiche der Skizze als SketchRegion-Objekte.
GetSketchSegmentsLiefert alle Elemente einer Skizze als Array: Linien, Bögen und Kreise, Splines, Parabeln und Ellipsen.
GetSketchSlotCountLiefert die Anzahl der Nuten in der Skizze.
GetSketchSlotsLiefert die Nuten der Skizze als SketchSlot-Objekte.
GetSketchTextSegmentsLiefert die Skizzenelemente, aus denen ein ausgewählter Skizzentext besteht.
GetSplineCountLiefert die Anzahl der Splines in der Skizze und die Anzahl der Punkte.
GetSplineInterpolateCountLiefert die Anzahl der Splines in der Skizze und die Anzahl ihrer Stützpunkte.
GetSplineParamsveraltet ersetzt durch Sketch.GetSplineParams5
GetSplineParams2veraltet ersetzt durch Sketch.GetSplineParams5
GetSplineParams3veraltet ersetzt durch Sketch.GetSplineParams5
GetSplineParams4veraltet ersetzt durch Sketch.GetSplineParams5
GetSplineParams5Liefert die Parameter eines Splines der Skizze als SplineParamData-Objekt.
GetSplineParamsCountveraltet ersetzt durch Sketch.GetSplineParamsCount3
GetSplineParamsCount2veraltet ersetzt durch Sketch.GetSplineParamsCount3
GetSplineParamsCount3Liefert die Anzahl der Splines in der Skizze und die Größe der Parameterdaten.
GetSplinesLiefert Punkte auf allen Splines der Skizze, angenähert nach der Darstellungsqualität.
GetSplinesInterpolateLiefert die Stützpunkte aller Splines der Skizze, also die Punkte, aus denen sie erzeugt wurden.
GetUserPointsveraltet ersetzt durch Sketch.GetUserPoints2
GetUserPoints2Liefert die Daten aller selbst gezeichneten Punkte der Skizze in einem Zahlen-Array.
GetUserPointsCountLiefert die Anzahl der selbst gezeichneten Punkte in der Skizze.
InsertRouteLineFügt in eine Explosionslinienskizze oder 3D-Skizze eine Routenlinie zwischen Flächen, Kanten oder Eckpunkten ein.
Is3DLiefert, ob die Skizze eine 3D-Skizze ist.
IsBoundaryBoxSketchLiefert, ob die Skizze ein Begrenzungsrahmen ist.
IsDerivedLiefert, ob die Skizze abgeleitet ist.
IsSharedLiefert, ob mehr als ein Feature die Skizze benutzt.
IsSketchEditableLiefert, ob die Skizze bearbeitet werden kann.
MergePointsVerschmilzt Skizzenpunkte, die näher als ein angegebener Abstand beieinander liegen.
SetAutomaticSolveSchaltet ein oder aus, ob SOLIDWORKS die Skizze nach jeder Änderung automatisch neu löst.
SetDetachSegmentOnDragLegt fest, ob Skizzenelemente beim Ziehen von den anderen gelöst werden.
SetEntityCountOhne Beschreibung in der Hilfe.
SetSketchEditableLegt fest, ob die Skizze bearbeitet werden kann oder schreibgeschützt ist.
SetWorkingPlaneOrientationLegt 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.