SolidWorksMakroprogrammierung

Methode · TableAnnotation

SetColumnWidth-Methode (TableAnnotation)

Setzt die Breite einer Spalte, aller Spalten oder des aktuellen Bereichs einer Tabelle. Liefert die tatsächliche Breite.

Syntax

Function SetColumnWidth( _
   ByVal Index As Long, _
   ByVal Width As Double, _
   ByVal Options As Long _
) As Double
dBreite = swTable.SetColumnWidth(Index, Width, Options)

Parameter

IndexLongByVal
Nummer der Spalte, beginnend bei 0. Oder ein Wert aus swTableCellRangeIdentifier_e: swTableCellRange_All (-2) für alle Spalten, swTableCellRange_Current (-1) für den aktuellen Bereich aus TableAnnotation.SetCellRange.
WidthDoubleByVal
Die neue Breite in Systemeinheiten, das sind in der API Meter.
OptionsLongByVal
Was mit dem Rest der Tabelle passiert, aus swTableRowColSizeChangeBehavior_e, siehe Bemerkungen.

Rückgabewert

Die Breite, die die Spalte tatsächlich bekommen hat. Bei einem Bereich die der ersten Spalte.

Beispiel

' swTable ist eine Tabelle (TableAnnotation), etwa aus View.GetFirstTableAnnotation2.
Dim dIst As Double
dIst = swTable.SetColumnWidth(0, 0.015, swTableRowColChange_TableSizeCanChange)
If Abs(dIst - 0.015) > 0.000001 Then Debug.Print "Breite ist " & dIst * 1000 & " mm geworden"

Bemerkungen

Options:

  • swTableRowColChange_TableSizeCanChange (0): Die anderen Spalten behalten ihre Breite und rücken vom Anker weg. Die Tabelle wird breiter oder schmaler.
  • swTableRowColChange_AbsorbedByNext (1): Die Tabelle behält ihre Breite. Erst die Spalte rechts gleicht aus, geht das nicht, die links, sonst passiert nichts.
  • swTableRowColChange_AbsorbedByPrevious (2): wie oben, erst links, dann rechts.

Mit Ausgleich klappt es nicht immer. Dann rechnest du die Gesamtbreite selbst und setzt die Spalten einzeln mit TableSizeCanChange.

Rückgabewert prüfen: Die tatsächliche Breite kann abweichen. Ist die gewünschte kleiner als die kleinste mögliche, nimmt SOLIDWORKS die kleinste. Reicht beim Ausgleich die Nachbarspalte nicht, bleibt die alte Breite.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2004

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

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