SolidWorksMakroprogrammierung

Objekt · SldWorks

CustomSymbol-Objekt

Veraltetes Objekt für ein benutzerdefiniertes Symbol in einer Zeichnung. SketchBlockDefinition und SketchBlockInstance treten an seine Stelle.

Deklaration Dim x As SldWorks.CustomSymbol · in der englischen .NET-Hilfe: ICustomSymbol

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 Sub

Bemerkungen

Ersatz: Die Hilfe nennt für die meisten Befehle einen Nachfolger:

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

NameBeschreibung
Angleveraltet ersetzt durch SketchBlockInstance.Angle
Scale2veraltet ersetzt durch SketchBlockInstance.Scale2
TextVisibleveraltet ersetzt durch SketchBlockInstance.TextDisplay

Methoden 31, davon 0 beschrieben, 31 veraltet

NameBeschreibung
GetAnnotationveraltet
GetArcAtIndexveraltet ersetzt durch Note.GetArcAtIndex
GetArcCountveraltet ersetzt durch Note.GetArcCount
GetArrowHeadAtIndexveraltet ersetzt durch Note.GetArrowHeadAtIndex
GetArrowHeadCountveraltet ersetzt durch Note.GetArrowHeadCount
GetArrowHeadInfoveraltet ersetzt durch Note.GetArrowHeadInfo
GetLeaderAtIndexveraltet ersetzt durch Note.GetLeaderAtIndex
GetLeaderCountveraltet ersetzt durch Note.GetLeaderCount
GetLineAtIndexveraltet ersetzt durch Note.GetLineAtIndex
GetLineCountveraltet ersetzt durch Note.GetLineCount
GetNextveraltet
GetNoteCountveraltet ersetzt durch SketchBlockDefinition.GetNoteCount
GetNotesveraltet ersetzt durch SketchBlockDefinition.GetNotes
GetSketchveraltet ersetzt durch SketchBlockDefinition.GetSketch
GetSketchPositionveraltet
GetTextveraltet ersetzt durch SketchBlockDefinition.GetNoteCount und SketchBlockDefinition.GetNotes
GetTextAngleAtIndexveraltet ersetzt durch Note.GetTextAngleAtIndex
GetTextAtIndexveraltet ersetzt durch Note.GetTextAtIndex
GetTextCountveraltet ersetzt durch SketchBlockDefinition.GetNoteCount
GetTextHeightAtIndexveraltet ersetzt durch Note.GetTextHeightAtIndex
GetTextInvertAtIndexveraltet ersetzt durch Note.GetTextInvertAtIndex
GetTextJustificationAtIndexveraltet ersetzt durch Note.GetTextJustificationAtIndex (ebenfalls veraltet, ohne Nachfolger)
GetTextLineSpacingAtIndexveraltet ersetzt durch Note.GetTextLineSpacingAtIndex
GetTextPositionAtIndexveraltet ersetzt durch Note.GetTextPositionAtIndex
GetTextRefPositionAtIndexveraltet ersetzt durch Note.GetTextRefPositionAtIndex
GetTriangleAtIndexveraltet ersetzt durch Note.GetTriangleAtIndex
GetTriangleCountveraltet ersetzt durch Note.GetTriangleCount
HasExtraLeaderveraltet ersetzt durch Note.HasExtraLeader
IsAttachedveraltet ersetzt durch Note.IsAttached
SetTextveraltet ersetzt durch SketchBlockDefinition.GetNoteCount und SketchBlockDefinition.GetNotes
SetTextJustificationAtIndexveraltet ersetzt durch Note.SetTextJustificationAtIndex (ebenfalls veraltet, ohne Nachfolger)

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.