Objekt · SldWorks
CustomSymbol-Objekt
Veraltetes Objekt für ein benutzerdefiniertes Symbol in einer Zeichnung. SketchBlockDefinition und SketchBlockInstance treten an seine Stelle.
Beschreibung
CustomSymbol ist mit allen Befehlen veraltet und durch SketchBlockDefinition und SketchBlockInstance ersetzt. Das Objekt stand für ein benutzerdefiniertes Symbol (custom symbol) in einer Zeichenansicht: eine Skizze mit Linien, Bögen, Dreiecken und Texten, die mit Winkel und Maßstab eingefügt und wahlweise mit einer Bezugslinie an ein Element gehängt wurde. Die alte Hilfe nennt als Nachfolger noch BlockDefinition und BlockInstance, die selbst veraltet sind. Seit wann CustomSymbol veraltet ist, sagt die Hilfe nicht.
Zugriff
Einen aktuellen Zugriff auf das alte Objekt nennt die Hilfe nicht mehr. Früher kam es aus View.GetFirstCustomSymbol und dann CustomSymbol.GetNext, veraltet ohne Nachfolger. Angelegt wurde es mit DrawingDoc.InsertCustomSymbol2, DrawingDoc.MakeCustomSymbol2 oder DrawingDoc.CreateCustomSymbol. Heute fügst du einen Block mit SketchManager.InsertSketchBlockInstance ein und legst ihn mit SketchManager.MakeSketchBlockFromFile, SketchManager.MakeSketchBlockFromSelected oder SketchManager.MakeSketchBlockFromSketch an. Die vorhandenen Blöcke liefern SketchManager.GetSketchBlockDefinitions und SketchBlockDefinition.GetInstances.
Beispiel
' Gibt für jeden Block des aktiven Dokuments die Zahl der Notizen und für jede
' Blockinstanz Name, Winkel und Textanzeige aus.
' Vorbedingung: Ein Dokument mit eingefügten Blöcken ist offen, etwa eine Zeichnung.
' Ergebnis: Die Werte stehen im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swBlockDef As SldWorks.SketchBlockDefinition
Dim swBlockInst As SldWorks.SketchBlockInstance
Dim vBloecke As Variant
Dim vInstanzen As Variant
Dim i As Long, j As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
vBloecke = swModel.SketchManager.GetSketchBlockDefinitions
If Not IsArray(vBloecke) Then Exit Sub
For i = 0 To UBound(vBloecke)
Set swBlockDef = vBloecke(i)
Debug.Print "Block " & i + 1 & ": " & swBlockDef.GetNoteCount & " Notiz(en)" ' statt CustomSymbol.GetNoteCount
vInstanzen = swBlockDef.GetInstances
If IsArray(vInstanzen) Then
For j = 0 To UBound(vInstanzen)
Set swBlockInst = vInstanzen(j)
Debug.Print " " & swBlockInst.Name & ", Winkel " & _
Round(swBlockInst.Angle * 57.2957795, 1) & " Grad" ' statt CustomSymbol.Angle
Debug.Print " Textanzeige: " & swBlockInst.TextDisplay ' statt TextVisible
Next j
End If
Next i
End SubBemerkungen
Ersatz: Die Hilfe nennt für die meisten Befehle einen Nachfolger:
- Angle und TextVisible:
SketchBlockInstance.AngleundSketchBlockInstance.TextDisplaymit Werten ausswBlockInstanceTextDisplay_estattTrueoderFalse. - Scale2: SketchBlockInstance.Scale, das selbst veraltet ist. Heute setzt du den Maßstab mit
SketchBlockInstance.Scale2und liest ihn mitSketchBlockInstance.GetScale3. - GetSketch, GetNoteCount und GetNotes: die gleichnamigen Befehle
SketchBlockDefinition.GetSketch,SketchBlockDefinition.GetNoteCountundSketchBlockDefinition.GetNotes. - GetText, GetTextCount und SetText:
SketchBlockDefinition.GetNoteCountundSketchBlockDefinition.GetNotes. Die Texte liest und setzt du dann an den einzelnen Notizen (Note). - Die Befehle für Texte, Linien, Bögen, Dreiecke, Bezugslinien und Pfeilspitzen sowie HasExtraLeader und IsAttached: die gleichnamigen Befehle an
Note, etwaNote.GetTextAtIndex,Note.GetArcAtIndex,Note.GetArrowHeadInfooderNote.IsAttached. - GetAnnotation, GetNext und GetSketchPosition: ohne Nachfolger. Die alte Hilfe nennt für GetAnnotation und GetNext noch
BlockInstance.GetAnnotationundBlockInstance.GetNext, die selbst veraltet sind und keinen Nachfolger haben. Die Blockinstanzen bekommst du überSketchBlockDefinition.GetInstancesoder, je Skizze, überSketch.GetSketchBlockInstances.
Aus der alten Hilfe: Den Winkel beschreibt die alte Hilfe in Grad zwischen -360 und +360, ein größerer Wert wie 365 werde auf 5 zurückgeführt. SketchBlockInstance.Angle gilt im Bogenmaß. Ob CustomSymbol.Angle tatsächlich in Grad arbeitete, lässt sich nicht mehr prüfen.
Beim Einfügen einer weiteren Instanz desselben Blocks kann SketchManager.MakeSketchBlockFromFile Nothing liefern, obwohl die Blockinstanz entsteht.
Eigenschaften und Methoden
Eigenschaften 3, davon 0 beschrieben, 3 veraltet
| Name | Beschreibung |
|---|---|
| Angle | veraltet ersetzt durch SketchBlockInstance.Angle |
| Scale2 | veraltet ersetzt durch SketchBlockInstance.Scale2 |
| TextVisible | veraltet ersetzt durch SketchBlockInstance.TextDisplay |
Methoden 31, davon 0 beschrieben, 31 veraltet
Nicht aufgeführt sind 12 C++-Varianten (Namen mit I davor, zum Beispiel IGetAnnotation). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: ICustomSymbol in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.