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.