Zeilen und Spalten automatisch anpassen

Microsoft Excel bietet eine gute Funktion zum automatischen Anpassen der Breite und Höhe einer Zelle gemäß ihrem Inhalt. Diese Funktion steht auch Aspose.Cells-Benutzern mit der Möglichkeit zur Verfügung, die Abmessungen einer Zelle zur Laufzeit automatisch anzupassen.

Automatische Anpassung

Aspose.Cells bietet eine Klasse, Workbook, die eine Microsoft Excel-Datei darstellt. Die Workbook Klasse enthält eine Worksheets-Sammlung, die den Zugriff auf jede Arbeitsmappe in der Excel-Datei ermöglicht.

Eine Arbeitsmappe wird durch die Worksheet-Klasse repräsentiert. Die Worksheet-Klasse bietet eine Vielzahl von Eigenschaften und Methoden zur Verwaltung einer Arbeitsmappe. In diesem Artikel wird die Verwendung der Worksheet-Klasse zum automatischen Anpassen von Zeilen oder Spalten behandelt.

AutoFit Zeile - Einfach

Der einfachste Ansatz zum automatischen Anpassen der Breite und Höhe einer Zeile besteht darin, die Methode autoFitRow der Klasse Arbeitsblatt aufzurufen. Die Methode autoFitRow erfordert einen Zeilenindex (der zu ändernden Zeile) als Parameter.

AutoFit Zeile in einem Bereich von Zellen

Eine Zeile besteht aus vielen Spalten. Aspose.Cells ermöglicht es Entwicklern, eine Zeile basierend auf dem Inhalt in einem Bereich von Zellen in der Zeile automatisch anzupassen, indem sie eine überladene Version der Methode autoFitRow aufrufen. Sie nimmt die folgenden Parameter an:

• Zeilenindex, der Index der zu automatisch anzupassenden Zeile.
• Erster Spaltenindex, der Index der ersten Spalte der Zeile.
• Letzter Spaltenindex, der Index der letzten Spalte der Zeile.

Die Methode autoFitRow überprüft den Inhalt aller Spalten in der Zeile und passt dann die Zeile automatisch an.

Spalten automatisch anpassen - Einfach

Der einfachste Weg, die Breite und Höhe einer Spalte automatisch anzupassen, besteht darin, die Methode autoFitColumn der Klasse Worksheet aufzurufen. Die Methode autoFitColumn nimmt den Spaltenindex (der zu ändernden Spalte) als Parameter.

Spalten in einem Zellenbereich automatisch anpassen

Eine Spalte besteht aus vielen Zeilen. Es ist möglich, eine Spalte basierend auf dem Inhalt in einem Zellenbereich in der Spalte automatisch anzupassen, indem eine überladene Version der Methode autoFitColumn aufgerufen wird, die die folgenden Parameter annimmt:

• Spaltenindex, stellt den Index der Spalte dar, deren Inhalt automatisch angepasst werden soll
• Index der ersten Zeile, stellt den Index der ersten Zeile der Spalte dar
• Index der letzten Zeile, stellt den Index der letzten Zeile der Spalte dar

Die Methode autoFitColumn überprüft den Inhalt aller Zeilen in der Spalte und passt dann die Spalte automatisch an.

Automatisches Anpassen von Zeilen für zusammengeführte Zellen

Mit Aspose.Cells ist es möglich, auch für zusammengeführte Zellen mit der API AutoFitterOptions die Zeilen automatisch anzupassen. Die Klasse AutoFitterOptions bietet die Eigenschaft AutoFitMergedCellsType, die verwendet werden kann, um Zeilen für zusammengeführte Zellen automatisch anzupassen. AutoFitMergedCellsType akzeptiert das Enum AutoFitMergedCellsType mit folgenden Elementen:

• NONE: Zusammengeführte Zellen ignorieren.
• FIRST_LINE: Nur die Höhe der ersten Zeile erweitern.
• LAST_LINE: Nur die Höhe der letzten Zeile erweitern.
• EACH_LINE: Nur die Höhe jeder Zeile erweitern.

Sie können auch die überladenen Versionen der Methoden autoFitRows und autoFitColumns verwenden, die einen Bereich von Zeilen/Spalten und eine Instanz von AutoFitterOptions annehmen, um die ausgewählten Zeilen/Spalten entsprechend mit den gewünschten AutoFitterOptions automatisch anzupassen.

Die Signaturen der genannten Methoden lauten wie folgt:

1. autoFitRows(int startRow, int endRow, AutoFitterOptions options)
2. autoFitColumns(int firstColumn, int lastColumn, AutoFitterOptions options)

Wichtig zu wissen

Wenn eine Zelle zusammengeführt ist, werden die AutoFit-Methoden nicht angewendet, was dem gleichen Verhalten wie in Microsoft Excel entspricht. Darüber hinaus wird die Methode autoFitColumn auch nicht angewendet, wenn der Text in einer Zelle umgebrochen ist. Etwas, das Sie auch wissen müssen, ist, dass die AutoFit-Methoden zeitaufwändig sind. Daher sollten Sie diese Methoden so selten wie möglich aufrufen, um die Effizienz Ihrer Anwendung zu gewährleisten.