Rahmeneinstellungen
Rahmen zu Zellen hinzufügen
Microsoft Excel ermöglicht es Benutzern, Zellen durch Hinzufügen von Rahmen zu formatieren. Die Art des Rahmens hängt davon ab, wo er hinzugefügt wird. Zum Beispiel ist ein oberer Rahmen einer, der an der oberen Position einer Zelle hinzugefügt wird. Benutzer können auch den Linienstil und die Farbe der Rahmen ändern.
Mit Aspose.Cells für Python via .NET können Entwickler Rahmen hinzufügen und anpassen, wie sie in der gleichen flexiblen Weise wie in Microsoft Excel aussehen.
Rahmen zu Zellen hinzufügen
Aspose.Cells für Python via .NET stellt eine Klasse Workbook bereit, die eine Microsoft Excel-Datei repräsentiert. Die Klasse Workbook enthält eine worksheets Sammlung, die Zugriff auf jedes Arbeitsblatt in der Excel-Datei ermöglicht. Ein Arbeitsblatt wird durch die Klasse Worksheet dargestellt. Die Klasse Worksheet bietet die Cells Sammlung. Jedes Element in der Sammlung Cells stellt ein Objekt der Klasse Cell dar.
Aspose.Cells für Python via .NET bietet die get_style Methode in der Cell Klasse. Die set_style Methode wird verwendet, um den Formatierungsstil einer Zelle festzulegen. Die Style Klasse bietet Eigenschaften zum Hinzufügen von Rahmenlinien zu Zellen.
Rahmen zu einer Zelle hinzufügen
Entwickler können Rahmen zu einer Zelle hinzufügen, indem sie die Style-Objektsammlung borders verwenden. Der Rahmentyp wird als Index an die Sammlung borders übergeben. Alle Rahmentypen sind in der Aufzählung BorderType vordefiniert.
Rahmen-Aufzählung
| Rahmentypen | Beschreibung |
|---|---|
| BOTTOM_BORDER | Eine untere Rahmenlinie |
| DIAGONAL_DOWN | Eine diagonale Linie von oben links nach unten rechts |
| DIAGONAL_UP | Eine diagonale Linie von unten links nach oben rechts |
| LEFT_BORDER | Eine linke Rahmenlinie |
| RIGHT_BORDER | Eine rechte Rahmenlinie |
| TOP_BORDER | Eine obere Rahmenlinie |
The borders collection stores all borders. Each border in the Borders collection is represented by a Border object which provides two properties, color and line_style to set a border’s line color and style respectively.
Um die Linienfarbe eines Rahmens festzulegen, wählen Sie eine Farbe aus der Color-Enumeration (Teil des .NET Frameworks) aus und weisen Sie sie der Eigenschaft Color des Rahmenobjekts zu.
Der Linienstil des Rahmens wird festgelegt, indem ein Linienstil aus der CellBorderType-Enumeration ausgewählt wird.
Zellrahmentyp-Enumeration
| Linienstile | Beschreibung |
|---|---|
| DASH_DOT | Dünne gestrichelte Linie |
| DASH_DOT_DOT | Dünne gestrichelte-dotierte Linie |
| DASHED | Gestrichelte Linie |
| DOTTED | Gepunktete Linie |
| DOUBLE | Doppelte Linie |
| HAIR | Haarlinie |
| MEDIUM_DASH_DOT | Mittlere gestrichelte Linie |
| MEDIUM_DASH_DOT_DOT | Mittlere gestrichelte-dotierte Linie |
| MEDIUM_DASHED | Mittlere gestrichelte Linie |
| NONE | Keine Linie |
| MEDIUM | Mittlere Linie |
| SLANTED_DASH_DOT | Schräge mittlere gestrichelte Linie |
| THICK | Dicke Linie |
| THIN | Dünne Linie |
| Wählen Sie einen der Linienstile aus undweisen Sie ihn dann der Border Eigenschaft des line_style Objekts zu. |
| from aspose.cells import BorderType, CellBorderType, Workbook | |
| from aspose.pydrawing import Color | |
| from os import os, path | |
| # For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
| # The path to the documents directory. | |
| dataDir = RunExamples.GetDataDir(".") | |
| # Create directory if it is not already present. | |
| IsExists = path.isdir(dataDir) | |
| if notIsExists: | |
| os.makedirs(dataDir) | |
| # Instantiating a Workbook object | |
| workbook = Workbook() | |
| # Obtaining the reference of the first (default) worksheet by passing its sheet index | |
| worksheet = workbook.worksheets[0] | |
| # Accessing the "A1" cell from the worksheet | |
| cell = worksheet.cells.get("A1") | |
| # Adding some value to the "A1" cell | |
| cell.put_value("Visit Aspose!") | |
| # Create a style object | |
| style = cell.get_style() | |
| # Setting the line style of the top border | |
| style.borders.get(BorderType.TOP_BORDER).line_style = CellBorderType.THICK | |
| # Setting the color of the top border | |
| style.borders.get(BorderType.TOP_BORDER).color = Color.black | |
| # Setting the line style of the bottom border | |
| style.borders.get(BorderType.BOTTOM_BORDER).line_style = CellBorderType.THICK | |
| # Setting the color of the bottom border | |
| style.borders.get(BorderType.BOTTOM_BORDER).color = Color.black | |
| # Setting the line style of the left border | |
| style.borders.get(BorderType.LEFT_BORDER).line_style = CellBorderType.THICK | |
| # Setting the color of the left border | |
| style.borders.get(BorderType.LEFT_BORDER).color = Color.black | |
| # Setting the line style of the right border | |
| style.borders.get(BorderType.RIGHT_BORDER).line_style = CellBorderType.THICK | |
| # Setting the color of the right border | |
| style.borders.get(BorderType.RIGHT_BORDER).color = Color.black | |
| # Apply the border styles to the cell | |
| cell.set_style(style) | |
| # Saving the Excel file | |
| workbook.save(dataDir + "book1.out.xls") |
Hinzufügen von Rahmen zu einem Zellenbereich
Sie können auch einem Zellenbereich Rahmen hinzufügen, anstatt nur einer einzelnen Zelle. Dazu erstellen Sie zunächst einen Zellenbereich, indem Sie die Cells Methode der create_range Sammlung aufrufen. Sie nimmt die folgenden Parameter an:
- Erste Zeile, die erste Zeile des Bereichs.
- Erste Spalte, stellt die erste Spalte des Bereichs dar.
- Anzahl der Zeilen, die Anzahl der Zeilen im Bereich.
- Anzahl der Spalten, die Anzahl der Spalten im Bereich.
Die create_range Methode gibt ein Range Objekt zurück, das den angegebenen Zellenbereich enthält. Das Range Objekt bietet eine set_outline_border Methode an, die die folgenden Parameter annimmt, um einem Zellenbereich einen Rahmen hinzuzufügen:
- Rahmentyp, der aus der BorderType Aufzählung ausgewählte Rahmentyp.
- Linienstil, der aus der CellBorderType Aufzählung ausgewählte Linienstil.
- Farbe, die aus der Farb-Aufzählung ausgewählte Linienfarbe.
| from aspose.cells import BorderType, CellBorderType, Workbook | |
| from aspose.pydrawing import Color | |
| from os import os, path | |
| # For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
| # The path to the documents directory. | |
| dataDir = RunExamples.GetDataDir(".") | |
| # Create directory if it is not already present. | |
| IsExists = path.isdir(dataDir) | |
| if notIsExists: | |
| os.makedirs(dataDir) | |
| # Instantiating a Workbook object | |
| workbook = Workbook() | |
| # Obtaining the reference of the first (default) worksheet by passing its sheet index | |
| worksheet = workbook.worksheets[0] | |
| # Accessing the "A1" cell from the worksheet | |
| cell = worksheet.cells.get("A1") | |
| # Adding some value to the "A1" cell | |
| cell.put_value("Hello World From Aspose") | |
| # Creating a range of cells starting from "A1" cell to 3rd column in a row | |
| range = worksheet.cells.create_range(0, 0, 1, 3) | |
| # Adding a thick top border with blue line | |
| range.set_outline_border(BorderType.TOP_BORDER, CellBorderType.THICK, Color.blue) | |
| # Adding a thick bottom border with blue line | |
| range.set_outline_border(BorderType.BOTTOM_BORDER, CellBorderType.THICK, Color.blue) | |
| # Adding a thick left border with blue line | |
| range.set_outline_border(BorderType.LEFT_BORDER, CellBorderType.THICK, Color.blue) | |
| # Adding a thick right border with blue line | |
| range.set_outline_border(BorderType.RIGHT_BORDER, CellBorderType.THICK, Color.blue) | |
| # Saving the Excel file | |
| workbook.save(dataDir + "book1.out.xls") |