Objekt · SldWorks
SketchText-Objekt
Ein Text in einer Skizze mit Inhalt, Lage, Textformat und den Kanten seiner Buchstaben.
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
ModelDoc2.InsertSketchText: ein neuer SkizzentextSketch.GetSketchTextSegments: alle Skizzentexte einer SkizzeSketch.GetSketchSegmentsundSketchSegment.GetType=swSketchTEXT, dann einer Variablen vom Typ SketchText zuweisen
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Text | Liest oder setzt den Text des Skizzentexts. |
Methoden 8, davon 7 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| EnumEdges | Liefert die Kanten der Buchstaben des Skizzentexts als Aufzählung (EnumEdges). |
| GetCoordinates | Liefert die Lage des Skizzentexts. |
| GetEdges | veraltet ersetzt durch SketchText.GetEdges2 |
| GetEdges2 | Liefert die Kanten der Buchstaben des Skizzentexts. |
| GetTextFormat | Liefert das Textformat des Skizzentexts. |
| GetUseDocTextFormat | Liefert, ob der Skizzentext das Standard-Textformat des Dokuments verwendet. |
| SetCoordinates | Setzt die Lage des Skizzentexts. |
| SetTextFormat | Setzt 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.