Rahmeneinstellungen
Rahmen zu Zellen hinzufügen
Microsoft Excel ermöglicht es Benutzern, Zellen durch Hinzufügen von Rändern zu formatieren. Der Randtyp hängt davon ab, wo er hinzugefügt wird. Zum Beispiel ist ein oberer Rand einer, der an die obere Position einer Zelle gesetzt wird. Benutzer können auch den Linienstil und die Farbe der Ränder anpassen.
Mit Aspose.Cells for Node.js via C++ können Entwickler Rahmen hinzufügen und das Aussehen in der gleichen flexiblen Weise wie in Microsoft Excel anpassen.
Rahmen zu Zellen hinzufügen
Aspose.Cells bietet eine Klasse, Workbook, die eine Microsoft Excel-Datei repräsentiert. Die Workbook-Klasse enthält eine worksheets–Sammlung, die Zugriff auf jedes Arbeitsblatt in der Excel-Datei ermöglicht. Ein Arbeitsblatt wird durch die Worksheet-Klasse dargestellt. Die Worksheet-Klasse bietet die cells-Sammlung. Jedes Element in der cells-Sammlung repräsentiert ein Objekt der Cell-Klasse.
Aspose.Cells bietet die getStyle-Methode in der Cell-Klasse. Die setStyle-Methode wird verwendet, um den Formatierungsstil einer Zelle festzulegen. Die Style-Klasse stellt Eigenschaften zum Hinzufügen von Rändern zu Zellen bereit.
Rahmen zu einer Zelle hinzufügen
Entwickler können Ränder zu einer Zelle hinzufügen, indem sie die Style-Eigenschaftensammlung des borders-Objekts verwenden. Der Rahmentyp wird als Index an die borders-Sammlung übergeben. Alle Rahmentypen sind in der BorderType-Aufzählung vorab definiert.
Rahmen-Aufzählung
Rahmentypen | Beschreibung |
---|---|
BottomBorder | Eine untere Rahmenlinie |
DiagonalDown | Eine diagonale Linie von oben links nach rechts unten |
DiagonalUp | Eine diagonale Linie von unten links nach oben rechts |
LeftBorder | Eine Linie am linken Rand |
RightBorder | Eine Linie am rechten Rand |
TopBorder | Eine Linie am oberen Rand |
Die borders-Sammlung speichert alle Ränder. Jeder Rand in der borders-Sammlung wird durch ein Border-Objekt repräsentiert, das zwei Eigenschaften, setColor und setLineStyle, zur Festlegung der Linienfarbe und des Stils eines Rands bereitstellt.
Um die Linienfarbe eines Rands festzulegen, wählen Sie eine Farbe aus der Color-Aufzählung (Teil von Node.js) und weisen Sie sie der Farbeigenschaft des Border-Objekts zu.
Der Linienstil des Rands wird festgelegt, indem ein Linienstil aus der CellBorderType-Aufzählung ausgewählt wird.
Zellrahmentyp-Enumeration
Linienstile | Beschreibung |
---|---|
DashDot | Dünne gestrichelt-punktierte Linie |
DashDotDot | Dünne gestrichelt-punkt-punktierte Linie |
Dashed | Gestrichelte Linie |
Dotted | Gepunktete Linie |
Double | Doppelte Linie |
Hair | Haarlinie |
MediumDashDot | Mittlere gestrichelt-punktierte Linie |
MediumDashDotDot | Mittlere gestrichelt-punkt-punktierte Linie |
MediumDashed | Mittlere gestrichelte Linie |
None | Keine Linie |
Medium | Mittlere Linie |
SlantedDashDot | Geneigte mittlere Strichpunktlinie |
Thick | Dicke Linie |
Thin | Dünne Linie |
Wählen Sie einen der Linienstile aus und weisen Sie ihn der Border-Eigenschaft des lineStyle-Objekts zu. |
Hinzufügen von Rahmen zu einem Zellenbereich
Es ist auch möglich, Ränder an einen Zellbereich statt nur an eine einzelne Zelle hinzuzufügen. Dazu erstellen Sie zunächst einen Zellbereich, indem Sie die cells-Sammlung mit der createRange-Methode aufrufen. Diese nimmt die folgenden Parameter:
- 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 createRange-Methode gibt ein Range-Objekt zurück, das den angegebenen Zellbereich enthält. Das Range-Objekt bietet eine setOutlineBorder-Methode, die die folgenden Parameter akzeptiert, um einen Rand zum Zellbereich hinzuzufügen:
- Ramentyp, der Randtyp, ausgewählt aus der BorderType-Aufzählung.
- Linienstil, der Linienstil des Rands, ausgewählt aus der CellBorderType-Aufzählung.
- Farbe, die aus der Farb-Aufzählung ausgewählte Linienfarbe.