SolidWorksMakroprogrammierung

Methode · TableAnnotation

HorizontalAutoSplit-Methode (TableAnnotation)

Teilt eine Tabelle automatisch waagrecht, einmal oder laufend, nach einer Höchstzahl von Zeilen.

Syntax

Function HorizontalAutoSplit( _
   ByVal MaxNumberOfRows As Long, _
   ByVal Apply As Long, _
   ByVal PlacementOfNewSplitTables As Long _
) As Variant
vTeile = swTable.HorizontalAutoSplit(MaxNumberOfRows, Apply, PlacementOfNewSplitTables)

Parameter

MaxNumberOfRowsLongByVal
Höchstzahl der Zeilen je Teilstück.
ApplyLongByVal
Wie oft geteilt wird, aus swHorizontalAutoSplitApply_e: swHorizontalAutoSplitApply_ThisTimeOnly (0) oder swHorizontalAutoSplitApply_Continuousely (1).
PlacementOfNewSplitTablesLongByVal
Wo die neuen Teilstücke hinkommen, aus swHorizontalAutoSplitPlacementOfSplitTable_e: …_NextToLastSplit (0) neben oder …_BelowLastSplit (1) unter das letzte.

Rückgabewert

Ein Array mit den Teilstücken (TableAnnotation).

Beispiel

' swTable ist eine Stückliste (TableAnnotation), etwa aus der Auswahl.
Dim vTeile As Variant
vTeile = swTable.HorizontalAutoSplit(20, swHorizontalAutoSplitApply_ThisTimeOnly, _
    swHorizontalAutoSplitPlacementOfSplitTable_NextToLastSplit)
If IsArray(vTeile) Then Debug.Print UBound(vTeile) + 1 & " Teilstücke"

Bemerkungen

Der Befehl teilt Bohrungstabellen, Stücklisten und allgemeine Tabellen.

Teilst du laufend, hältst du das mit TableAnnotation.StopAutoSplitting = True wieder an. Die Hilfe nennt den Wert dafür „Continuously“, in der Enumeration heißt er swHorizontalAutoSplitApply_Continuousely.

Ob das Array auch die ursprüngliche Tabelle enthält, sagt die Hilfe nicht.

Hat die Tabelle weniger Zeilen als MaxNumberOfRows, wird nicht geteilt; der Befehl liefert dann trotzdem ein Array mit einem Element.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2014

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

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