SolidWorksMakroprogrammierung

Objekt · SldWorks

WeldmentCutListAnnotation-Objekt

Eine Zuschnittsliste einer Schweißkonstruktion als Tabelle in der Zeichnung: Spalten mit benutzerdefinierten Eigenschaften, Sortieren und ihr Feature.

Deklaration Dim x As SldWorks.WeldmentCutListAnnotation · in der englischen .NET-Hilfe: IWeldmentCutListAnnotation

Beschreibung

WeldmentCutListAnnotation gibt Zugriff auf die Tabelle einer Zuschnittsliste einer Schweißkonstruktion (weldment cut list). Das Objekt ist von TableAnnotation abgeleitet. Zeilen, Spalten und Zellen liest und setzt du also über TableAnnotation, dieselbe Tabelle weist du dafür einfach einer Variablen des anderen Typs zu. Die meisten Befehle gibt es seit SOLIDWORKS 2007.

Zugriff

Beispiel

' Gibt die verfügbaren Eigenschaften und die Spaltentitel der ausgewählten Zuschnittsliste
' aus und sortiert sie absteigend nach der dritten Spalte.
' Vorbedingung: Eine Zeichnung mit der Zuschnittsliste einer Schweißkonstruktion ist offen,
'               die Tabelle ist ausgewählt.
' Ergebnis:     Die Angaben stehen im Direktfenster, die Tabelle ist sortiert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swTabelle As SldWorks.TableAnnotation
    Dim swZuschnitt As SldWorks.WeldmentCutListAnnotation
    Dim vEigenschaften As Variant
    Dim i As Long

    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.TableAnnotation Then Exit Sub
    Set swTabelle = swSel
    If swTabelle.Type <> swTableAnnotation_WeldmentCutList Then Exit Sub
    Set swZuschnitt = swTabelle                        ' dieselbe Tabelle, anderer Typ

    Debug.Print "Feature: " & swZuschnitt.WeldmentCutListFeature.GetFeature.Name
    vEigenschaften = swZuschnitt.GetAllCustomProperties
    If IsArray(vEigenschaften) Then
        For i = 0 To UBound(vEigenschaften)
            Debug.Print "  verfügbar: " & vEigenschaften(i)
        Next i
    End If
    For i = 0 To swTabelle.ColumnCount - 1
        Debug.Print "Spalte " & i & ": " & swTabelle.GetColumnTitle2(i, True) & _
                    " -> " & swZuschnitt.GetColumnCustomProperty(i)
    Next i

    If False = swZuschnitt.Sort(2, False) Then Debug.Print "Nicht sortiert"
End Sub

Bemerkungen

Eigenschaften: Zu den verfügbaren Eigenschaften gehören alle Einträge der Tabelle, also die Dateiinfos (file summary) und die gesetzten benutzerdefinierten Eigenschaften der Datei. Das Hilfebeispiel „Get Weldment Cut List Feature and Annotations“ läuft durch den FeatureManager, holt jedes Feature vom Typ WeldmentTableFeat mit Feature.GetSpecificFeature2 und gibt für jede Tabelle diese Eigenschaften aus.

Sortieren: Du sortierst nach jeder Spalte außer der Positionsnummer. Der Abschnitt „Sorting Tables“ des Programmierhandbuchs nennt dafür ColumnIndex > 0. Das Hilfebeispiel „Sort Table“ sortiert eine Zuschnittsliste absteigend nach der dritten Spalte.

Tabelle erkennen: Zuschnittslisten erkennst du an TableAnnotation.Type mit dem Wert swTableAnnotation_WeldmentCutList aus swTableAnnotationType_e.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
WeldmentCutListFeatureLiefert das Feature der Zuschnittsliste.

Methoden 5, davon 5 beschrieben

NameBeschreibung
GetAllCustomPropertiesLiefert die Namen der Eigenschaften, die für eine Eigenschaftsspalte der Zuschnittsliste in Frage kommen.
GetAllCustomPropertiesCountLiefert die Zahl der Eigenschaften, die für eine Eigenschaftsspalte der Zuschnittsliste in Frage kommen.
GetColumnCustomPropertyLiefert die Eigenschaft, die einer benutzerdefinierten Spalte der Zuschnittsliste zugeordnet ist.
SetColumnCustomPropertyOrdnet einer benutzerdefinierten Spalte der Zuschnittsliste eine Eigenschaft zu, deren Wert dann in jeder Zeile erscheint.
SortSortiert die Zuschnittsliste nach einer Spalte auf- oder absteigend.

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

Siehe auch

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

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