SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchText-Objekt

Ein Text in einer Skizze mit Inhalt, Lage, Textformat und den Kanten seiner Buchstaben.

Deklaration Dim x As SldWorks.SketchText · in der englischen .NET-Hilfe: ISketchText

Beschreibung

SketchText gibt Zugriff auf Skizzentexte. Ein Skizzentext ist zugleich ein SketchSegment. Du liest und änderst damit den Text, seine Lage und sein Textformat und holst die Kanten der Buchstaben, etwa um ihre Kurven auszuwerten. Die meisten Befehle gibt es seit SOLIDWORKS 2001Plus.

Zugriff

Beispiel

' Ersetzt den ersten Text der ausgewählten Skizze und verdoppelt seine Schrifthöhe.
' Vorbedingung: Ein Teil ist offen, eine Skizze mit einem Skizzentext ist im FeatureManager ausgewählt.
' Ergebnis:     Der Text heißt "Neuer Text" und ist doppelt so hoch, die Skizze ist wieder geschlossen.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swSketch As SldWorks.Sketch
    Dim swText As SldWorks.SketchText
    Dim swFormat As SldWorks.TextFormat
    Dim vTexte As Variant
    Dim vLage As Variant

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    Set swSketch = swFeat.GetSpecificFeature2
    If swSketch Is Nothing Then Exit Sub

    vTexte = swSketch.GetSketchTextSegments
    If IsEmpty(vTexte) Then Exit Sub
    swModel.EditSketch                                   ' Ändern nur im Bearbeitungsmodus
    Set swText = vTexte(0)
    vLage = swText.GetCoordinates
    Debug.Print "Alt: """ & swText.Text & """ bei " & vLage(0) * 1000 & " / " & vLage(1) * 1000 & " mm"

    swText.Text = "Neuer Text"
    Set swFormat = swText.GetTextFormat
    swFormat.CharHeight = swFormat.CharHeight * 2
    If False = swText.SetTextFormat(False, swFormat) Then Debug.Print "Textformat nicht gesetzt"
    swModel.SketchManager.InsertSketch True              ' Skizze schließen und neu aufbauen
End Sub

Bemerkungen

Bearbeitungsmodus: Text, Lage und Textformat änderst du nur, während die Skizze bearbeitet wird, etwa nach ModelDoc2.EditSketch oder SketchManager.InsertSketch. Den Text änderst du nur in sichtbaren Dokumenten. Das Hilfebeispiel „Replace Sketch Text“ öffnet die Skizze mit EditSketch und schließt sie danach wieder.

Textformat: Du holst das Format mit SketchText.GetTextFormat, änderst es mit den Befehlen von TextFormat und weist es mit SketchText.SetTextFormat wieder zu. Mit UseDoc = True nimmt der Text wieder das Standardformat des Dokuments an.

Kanten: SketchText.GetEdges2 und SketchText.EnumEdges liefern vorübergehende Kanten. Du nutzt sie nur, um die Kurven (Edge.GetCurve) zu lesen, und speicherst sie nicht. GetEdges2 ersetzt das veraltete GetEdges und liefert auch die Kanten von Einstrichschriften.

Einheiten: Die Hilfe nennt keine. Das Hilfebeispiel „Get All Elements of Sketch“ rechnet die Lage mit 1000 in Millimeter um, also Meter.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
TextLiest oder setzt den Text des Skizzentexts.

Methoden 8, davon 7 beschrieben, 1 veraltet

NameBeschreibung
EnumEdgesLiefert die Kanten der Buchstaben des Skizzentexts als Aufzählung (EnumEdges).
GetCoordinatesLiefert die Lage des Skizzentexts.
GetEdgesveraltet ersetzt durch SketchText.GetEdges2
GetEdges2Liefert die Kanten der Buchstaben des Skizzentexts.
GetTextFormatLiefert das Textformat des Skizzentexts.
GetUseDocTextFormatLiefert, ob der Skizzentext das Standard-Textformat des Dokuments verwendet.
SetCoordinatesSetzt die Lage des Skizzentexts.
SetTextFormatSetzt das Textformat des Skizzentexts: ein eigenes oder das Standardformat des Dokuments.

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

Siehe auch

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

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