SolidWorksMakroprogrammierung

Objekt · SldWorks

BomTableSortData-Objekt

Die Sortierdaten einer Stückliste: bis zu drei Sortierspalten mit Richtung, Gruppen, Sortiermethode und ob die Positionsnummern bleiben.

Deklaration Dim x As SldWorks.BomTableSortData · in der englischen .NET-Hilfe: IBomTableSortData

Beschreibung

BomTableSortData gibt Zugriff auf die Sortierdaten einer Stückliste (BomTableAnnotation). Du holst das Objekt mit BomTableAnnotation.GetBomTableSortData, legst damit fest, wie sortiert werden soll, und übergibst es an BomTableAnnotation.Sort.

Zugriff

Beispiel

' Sortiert die ausgewählte Stückliste zuerst nach Spalte 1, dann nach Spalte 3, beide aufsteigend.
' Teile kommen vor benutzerdefinierten Zeilen, die Positionsnummern bleiben erhalten.
' Vorbedingung: Eine Zeichnung mit einer Stückliste ist offen, die Stückliste ist ausgewählt.
'               Die Positionsnummern folgen nicht der Reihenfolge der Baugruppe.
' Ergebnis:     Die Stückliste ist sortiert, das Schema ist in ihr gespeichert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swObj As Object
    Dim swTabelle As SldWorks.TableAnnotation
    Dim swBomAnn As SldWorks.BomTableAnnotation
    Dim swSortData As SldWorks.BomTableSortData
    Dim nGruppen(1) As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swObj = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swObj Is SldWorks.TableAnnotation Then Exit Sub
    Set swTabelle = swObj
    If swTabelle.Type <> swTableAnnotation_BillOfMaterials Then Exit Sub
    Set swBomAnn = swTabelle
    swModel.ClearSelection2 True

    Set swSortData = swBomAnn.GetBomTableSortData
    swSortData.ColumnIndex(0) = 1                       ' zuerst nach Spalte 1
    swSortData.Ascending(0) = True
    swSortData.ColumnIndex(1) = 3                       ' dann nach Spalte 3
    swSortData.Ascending(1) = True
    swSortData.ColumnIndex(2) = -1                      ' keine dritte Sortierung
    swSortData.SortMethod = swBomTableSortMethod_Literal
    nGruppen(0) = swBomTableSortItemGroup_Parts
    nGruppen(1) = swBomTableSortItemGroup_Other
    swSortData.ItemGroups = nGruppen
    swSortData.DoNotChangeItemNumber = True
    swSortData.SaveCurrentSortParameters = True
    Debug.Print "Sortiert: " & swBomAnn.Sort(swSortData)
End Sub

Bemerkungen

Ablauf: So beschreibt die Hilfe („Sorting Tables“) das Sortieren: Stückliste auswählen, als TableAnnotation holen, einer Variablen vom Typ BomTableAnnotation zuweisen, Sortierdaten holen, Eigenschaften setzen und BomTableAnnotation.Sort aufrufen. Das Beispiel folgt dem Hilfebeispiel „Sort Table“.

Drei Sortierspalten: BomTableSortData.ColumnIndex und BomTableSortData.Ascending haben einen Index: 0 für die erste, 1 für die zweite, 2 für die dritte Sortierung. Eine Sortierung, die du nicht brauchst, setzt du mit ColumnIndex auf -1.

Später neu sortieren: Mit BomTableSortData.SaveCurrentSortParameters = True speichert Sort die Einstellungen in der Stückliste. Später holst du nur die Sortierdaten und rufst BomTableAnnotation.ApplySavedSortScheme auf.

Reihenfolge der Baugruppe: Das Hilfebeispiel setzt voraus, dass die Positionsnummern nicht der Reihenfolge der Baugruppe folgen. Am Feature der Stückliste ist das BomFeature.FollowAssemblyOrder2 = False.

Frische Sortierdaten aus BomTableAnnotation.GetBomTableSortData haben alle drei ColumnIndex auf -1, Ascending True, SortMethod 1 (swBomTableSortMethod_Numeric), DoNotChangeItemNumber True und SaveCurrentSortParameters False.

Eigenschaften und Methoden

Eigenschaften 6, davon 6 beschrieben

NameBeschreibung
AscendingLiest oder setzt, ob die Stückliste nach der ersten, zweiten oder dritten Sortierspalte aufsteigend oder absteigend sortiert wird.
ColumnIndexLiest oder setzt, nach welcher Spalte die Stückliste als erstes, zweites oder drittes sortiert wird.
DoNotChangeItemNumberLiest oder setzt, ob die Positionsnummern beim Sortieren erhalten bleiben oder neu vergeben werden.
ItemGroupsLiest oder setzt, in welche Gruppen die Zeilen beim Sortieren eingeteilt werden und in welcher Reihenfolge: Baugruppen, Teile, benutzerdefinierte Zeilen.
SaveCurrentSortParametersLiest oder setzt, ob das Sortieren die Einstellungen in der Stückliste speichert, damit du später mit ApplySavedSortScheme neu sortieren kannst.
SortMethodLiest oder setzt, ob die Stückliste als Text oder als Zahlen sortiert wird.

Siehe auch

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

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