SolidWorksMakroprogrammierung

Objekt · SldWorks

PunchTable-Objekt

Das Feature einer Stanztabelle in einer Blechzeichnung: Kennzeichnung der Stanzungen, Zusammenfassen von Zeilen und Zellen, Maße in zwei Einheiten, das Feature selbst und seine Tabellen.

Deklaration Dim x As SldWorks.PunchTable · in der englischen .NET-Hilfe: IPunchTable

Beschreibung

PunchTable gibt Zugriff auf die Angaben und Werte einer Stanztabelle. Eine Stanztabelle listet die Stanzungen, die Umformwerkzeuge in einem Blechteil erzeugen, in der Abwicklungsansicht einer Zeichnung. Die Tabelle, die du siehst, ist eine PunchTableAnnotation. PunchTable ist das Feature dahinter, an dem du die Einstellungen der Tabelle liest und setzt. Die Befehle gibt es seit SOLIDWORKS 2012.

Eine Stanztabelle hat diese Spalten:

  • TAG: die Kennung, die jede Stanzung in der Abwicklungsansicht bekommt
  • PUNCH ID: eine Eigenschaft des Umformwerkzeugs oder Bibliotheks-Features
  • X LOCATION und Y LOCATION: der Abstand des Einfügepunkts des Umformwerkzeugs von der x- und der y-Achse
  • ANGLE: der Winkel zwischen der x-Achse und dem Umformwerkzeug
  • QUANTITY: wie oft das Umformwerkzeug in der Abwicklungsansicht vorkommt

Zugriff

Beispiel

' Fügt in die Abwicklungsansicht eine Stanztabelle ein, gibt ihre Einstellungen aus
' und stellt die Kennungen auf Zahlen ab 1 um.
' Vorbedingung: Eine Zeichnung mit der Abwicklungsansicht eines Blechteils mit
'               Umformwerkzeugen ist offen. In der Ansicht sind eine Ecke als Bezugspunkt
'               (Markierung 1) und die Fläche mit den Stanzungen (Markierung 2)
'               ausgewählt. Den Pfad der Vorlage passt du an deine Installation an.
' Ergebnis:     Die Stanztabelle steht auf dem Blatt, die Einstellungen stehen im
'               Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swView As SldWorks.View
    Dim swStanzTabelle As SldWorks.PunchTableAnnotation
    Dim swStanzTab As SldWorks.PunchTable
    Dim sVorlage As String

    sVorlage = "C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\lang\english\punchtable-standard.sldpuntbt"

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub
    Set swView = swModel.SelectionManager.GetSelectedObjectsDrawingView2(1, -1)
    If swView Is Nothing Then Exit Sub

    Set swStanzTabelle = swView.InsertPunchTable(False, 0.22, 0.2, swBOMConfigurationAnchor_TopLeft, "A", sVorlage)
    swModel.ClearSelection2 True
    If swStanzTabelle Is Nothing Then
        Debug.Print "Stanztabelle wurde nicht eingefügt."
        Exit Sub
    End If

    Set swStanzTab = swStanzTabelle.PunchTable
    Debug.Print "Feature:               " & swStanzTab.GetFeature.Name
    Debug.Print "Kennzeichnung:         " & swStanzTab.TagStyle      ' Wert aus swPunchTableTagStyle_e
    Debug.Print "Erste Kennung:         " & swStanzTab.StartingValue
    Debug.Print "Kennungen zusammen:    " & swStanzTab.CombineTags
    Debug.Print "Zellen zusammen:       " & swStanzTab.CombineSameSize
    Debug.Print "Zwei Einheiten:        " & swStanzTab.DualDimensions
    Debug.Print "Einheiten anzeigen:    " & swStanzTab.ShowUnits
    Debug.Print "Tabellen:              " & swStanzTab.GetTableAnnotationCount

    swStanzTab.TagStyle = swPunchTable_NumericTags
    swStanzTab.StartingValue = "1"
End Sub

Bemerkungen

Hilfebeispiel: Das Beispiel „Insert Punch Table“ wählt in der Ansicht eine Ecke als Bezugspunkt mit Markierung 1 und eine Fläche mit Stanzungen mit Markierung 2 aus. Alle Werte der Spalten X LOCATION und Y LOCATION beziehen sich auf diesen Bezugspunkt. Dann fügt es mit View.InsertPunchTable die Tabelle ein und gibt alle Einstellungen von PunchTable aus.

Zusammenfassen: PunchTable.CombineTags fasst Stanzungen mit derselben Stempel-ID zu einer Zeile mit einer Kennung und der Anzahl zusammen. PunchTable.CombineSameSize lässt die Zeilen stehen und fasst nur die gleichen Zellen der Spalte PUNCH ID zusammen. CombineSameSize gilt nur, wenn CombineTags False ist.

Vorgaben für neue Tabellen: Die Einstellungen von PunchTable gelten für eine vorhandene Stanztabelle. Die Vorgaben für neue Stanztabellen sind Dokumenteigenschaften: swPunchTableCombineTags, swPunchTableCombineSameSize, swTablePunchDualDimensionsDisplay und swTablePunchShowUnitsForDualDisplay aus swUserPreferenceToggle_e sowie swPunchTableTagStyle aus swUserPreferenceIntegerValue_e.

Geteilte Stanztabelle: Zu einer Stanztabelle gehört meist eine Tabelle. Ist sie geteilt, sind es zwei, beide liefert PunchTable.GetTableAnnotations.

Vorhandene Stanztabellen: Als Zugang zu PunchTable nennt die Hilfe nur PunchTableAnnotation.PunchTable. Eine vorhandene Stanztabelle ist eine Tabelle vom Typ swTableAnnotation_PunchTable (swTableAnnotationType_e), etwa aus View.GetTableAnnotations. Ob du daraus mit Set eine PunchTableAnnotation bekommst, sagt die Hilfe nicht.

Eigenschaften und Methoden

Eigenschaften 6, davon 6 beschrieben

NameBeschreibung
CombineSameSizeLiest oder setzt, ob die Stanztabelle gleiche Werte der Spalte PUNCH ID innerhalb einer Kennung zu einer Zelle zusammenfasst.
CombineTagsLiest oder setzt, ob die Stanztabelle Stanzungen mit derselben Stempel-ID zu einer Zeile mit einer gemeinsamen Kennung zusammenfasst.
DualDimensionsLiest oder setzt, ob die Stanztabelle die Maße zusätzlich in der zweiten Einheit zeigt.
ShowUnitsLiest oder setzt, ob die Stanztabelle bei den Maßen in der zweiten Einheit die Einheit mit anzeigt.
StartingValueLiest oder setzt die erste Kennung der Stanzungen in der Stanztabelle, etwa „A“ oder „1“.
TagStyleLiest oder setzt, ob die Stanztabelle die Stanzungen mit Buchstaben oder mit Zahlen kennzeichnet.

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetFeatureLiefert das Feature der Stanztabelle.
GetTableAnnotationCountLiefert, aus wie vielen Tabellen die Stanztabelle besteht: meist eine, bei einer geteilten Stanztabelle zwei.
GetTableAnnotationsLiefert die Tabellen der Stanztabelle, bei einer geteilten Stanztabelle mehrere.

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

Siehe auch

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

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