SolidWorksMakroprogrammierung

Methode · View

InsertPunchTable-Methode (View)

Fügt in die Abwicklungsansicht eines Blechteils eine Stanztabelle für die vorher ausgewählten Stanzungen ein.

Syntax

Function InsertPunchTable( _
   ByVal UseAnchorPoint As Boolean, _
   ByVal X As Double, _
   ByVal Y As Double, _
   ByVal AnchorType As Long, _
   ByVal StartValue As String, _
   ByVal TableTemplate As String _
) As PunchTableAnnotation
Set swPunchTableAnn = swView.InsertPunchTable(False, 0.22, 0.2, swBOMConfigurationAnchor_TopLeft, "A", sVorlage)

Parameter

UseAnchorPointBooleanByVal
True: Die Tabelle kommt an den Ankerpunkt des Blattformats, sofern das Blattformat einen hat. False: Die Tabelle kommt an die Stelle aus X und Y.
XDoubleByVal
X-Koordinate des Tabellenankers. Gilt nur bei UseAnchorPoint = False. Die Hilfe nennt hier weder Einheit noch Koordinatensystem; vermutlich Meter wie bei View.InsertHoleTable3.
YDoubleByVal
Y-Koordinate des Tabellenankers, wie X.
AnchorTypeLongByVal

Welche Ecke der Tabelle am Ankerpunkt liegt, als swBOMConfigurationAnchorType_e:

  • swBOMConfigurationAnchor_TopLeft (1): obere linke Ecke
  • swBOMConfigurationAnchor_TopRight (2): obere rechte Ecke
  • swBOMConfigurationAnchor_BottomLeft (3): untere linke Ecke
  • swBOMConfigurationAnchor_BottomRight (4): untere rechte Ecke
StartValueStringByVal
Startwert der Kennungen. Verwendet die Vorlage Buchstaben, ein Buchstabe von "A" bis "Z"; verwendet sie Zahlen, eine positive ganze Zahl (als Text, etwa "1").
TableTemplateStringByVal
Pfad und Dateiname der Vorlage für Stanztabellen (*.sldpuntbt, siehe Bemerkungen).

Rückgabewert

Die eingefügte Stanztabelle (PunchTableAnnotation). Was bei einem Fehler zurückkommt, sagt die Hilfe nicht; vermutlich Nothing.

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swView die Abwicklungsansicht (View). Koordinaten anpassen.
Dim swPunchTableAnn As SldWorks.PunchTableAnnotation
Dim swPunchTable As SldWorks.PunchTable
Dim bErfolg As Boolean
Dim sVorlage As String
If False = swView.IsFlatPatternView Then
    Debug.Print "Die Ansicht ist keine Abwicklung."
Else
    sVorlage = "C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\lang\english\punchtable-standard.sldpuntbt"
    bErfolg = swModel.Extension.SelectByID2("", "VERTEX", 0.13, 0.09, 0, False, 1, Nothing, 0)  ' Bezugsursprung
    bErfolg = swModel.Extension.SelectByID2("", "FACE", 0.15, 0.1, 0, True, 2, Nothing, 0)      ' Fläche mit Stanzungen
    Set swPunchTableAnn = swView.InsertPunchTable(False, 0.22, 0.2, swBOMConfigurationAnchor_TopLeft, "A", sVorlage)
    If swPunchTableAnn Is Nothing Then
        Debug.Print "Stanztabelle wurde nicht eingefügt."
    Else
        Set swPunchTable = swPunchTableAnn.PunchTable
        Debug.Print "Stanztabelle eingefügt, erste Kennung: " & swPunchTable.StartingValue
    End If
End If

Bemerkungen

Eine Stanztabelle listet die Stanzungen auf, die Umformwerkzeuge in einem Blechteil erzeugen. Sie enthält für die ausgewählten Stanzungen diese Spalten:

  • TAG: Kennung, die jede Stanzung in der Abwicklung bekommt
  • PUNCH ID: Eigenschaft des Umformwerkzeugs bzw. Bibliothek-Features
  • X Location, Y Location: Lage des Einfügepunkts des Umformwerkzeugs in der Abwicklung, gemessen von den Achsen
  • ANGLE: Winkel zwischen X-Achse und Umformwerkzeug
  • QUANTITY: wie oft die Stanzung in der Abwicklung vorkommt

Die Lage der Kennungen bezieht sich auf einen Bezugsursprung, den du vorher in der Ansicht auswählst. Vor dem Aufruf wählst du mit ModelDocExtension.SelectByID2 aus, jeweils mit dieser Markierung (Mark):

  • Eckpunkt als Bezugsursprung: 1
  • Kanten und Flächen der Stanzungen (bei mehreren Stanzungen): 2
  • Richtungsreferenz für die X-Achse des Ursprungs: 4
  • Richtungsreferenz für die Y-Achse des Ursprungs: 8

Ob die Richtungsreferenzen (4 und 8) Pflicht sind, sagt die Hilfe nicht.

Die Vorlage (*.sldpuntbt) liegt im Installationsordner unter lang\<Sprache>. StartValue muss zur Vorlage passen: Buchstabe bei einer Vorlage mit Buchstaben, Zahl bei einer Vorlage mit Zahlen. Die Spaltennamen oben stammen aus der englischen Hilfe; in einer deutschen Vorlage können sie anders heißen.

Die Ansicht muss die Abwicklungsansicht eines Blechteils sein. Prüf das vorher mit View.IsFlatPatternView. Die Einstellungen der Tabelle findest du über PunchTableAnnotation.PunchTable.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2012

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

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