Zellformate

Rahmen zu Zellen hinzufügen

Microsoft Excel ermöglicht Benutzern, Zellen zu formatieren, indem sie Rahmen hinzufügen.

Rahmeneinstellungen in Microsoft Excel

todo:image_alt_text

Die Art des Rahmens hängt davon ab, wo er hinzugefügt wird. Zum Beispiel ist ein oberer Rahmen einer, der an die obere Position einer Zelle hinzugefügt wird. Benutzer können auch den Linienstil und die Farbe der Rahmen ändern.

Mit Aspose.Cells können Entwickler Rahmen hinzufügen und anpassen, wie sie in Microsoft Excel in gleicher flexibler Weise aussehen.

Rahmen zu Zellen hinzufügen

Aspose.Cells bietet eine Klasse, Workbook, die eine Microsoft Excel-Datei repräsentiert. Die Workbook-Klasse enthält eine WorksheetCollection, die den Zugriff auf jede Arbeitsmappe in der Excel-Datei ermöglicht. Eine Arbeitsmappe wird durch die Worksheet-Klasse dargestellt. Die Worksheet-Klasse bietet eine Cells-Sammlung. Jedes Element in der Cells-Sammlung stellt ein Objekt der Cell-Klasse dar.

Aspose.Cells bietet die Methode setStyle in der Klasse Cell, um das Format einer Zelle festzulegen. Außerdem wird das Objekt der Klasse Style verwendet und bietet Eigenschaften zur Konfiguration von Schriftarteinstellungen.

Rahmen zu einer Zelle hinzufügen

Fügen Sie einem Zell mit der Methode setBorder des Style-Objekts Rahmenlinien hinzu. Der Border-Typ wird als Parameter übergeben. Alle Border-Typen sind in der Enumeration BorderType vorgegeben.

Rahmentypen	Beschreibung
BOTTOM_BORDER	Der untere Rand
DIAGONAL_DOWN	Eine diagonale Linie von oben links nach rechts unten
DIAGONAL_UP	Eine diagonale Linie von unten links nach oben rechts
LEFT_BORDER	Der linke Rand
RIGHT_BORDER	Der rechte Rand
TOP_BORDER	Der obere Rand
HORIZONTAL	Nur für dynamischen Stil, z. B. bedingte Formatierung.
VERTICAL	Nur für dynamischen Stil, z. B. bedingte Formatierung.
Um die Linienfarbe zu setzen, wählen Sie eine Farbe mit der Enumeration Color und übergeben Sie sie als Parameter an die Methode setBorder des Style-Objekts. Die Linienarten sind in der Enumeration CellBorderType vorgegeben.

Linienstile	Beschreibung
DASH_DOT	Repräsentiert eine dünne gestrichelte Linie
DASH_DOT_DOT	Repräsentiert eine dünne gestrichelte Linie mit Punkten
DASHED	Stellt gestrichelte Linie dar
DOTTED	Stellt gepunktete Linie dar
DOUBLE	Stellt doppelte Linie dar
HAIR	Stellt Haarlinie dar
MEDIUM_DASH_DOT	Repräsentiert eine mittlere gestrichelte Linie
MEDIUM_DASH_DOT_DOT	Repräsentiert mittel-dashed-dot-dot Linie
MEDIUM_DASHED	Repräsentiert mittlere gestrichelte Linie
NONE	Stellt keine Linie dar
MEDIUM	Stellt mittlere Linie dar
SLANTED_DASH_DOT	Repräsentiert schräg mittlere gestrichelte Linie
THICK	Stellt dicke Linie dar
THIN	Stellt dünne Linie dar
Wählen Sie einen der oben genannten Linienstile aus und weisen Sie ihn dann der Style-Objekt Methode setBorder zu.

Der folgende Output wird generiert, wenn der unten stehende Code ausgeführt wird.

Ränder auf allen Seiten einer Zelle angewendet

todo:image_alt_text

Hinzufügen von Rahmen zu einem Zellenbereich

Es ist möglich, Grenzen zu einem Zellbereich hinzuzufügen, anstatt nur zu einer einzelnen Zelle. Erstellen Sie zunächst einen Zellbereich, indem Sie die Cells-Sammlung aufrufen und die createRange Methode verwenden, welche die folgenden Parameter übernimmt:

Erste Zeile, erste Zeile des Bereichs.
Erste Spalte, erste Spalte des Bereichs.
Anzahl der Zeilen, Anzahl der Zeilen im Bereich.
Anzahl der Spalten, Anzahl der Spalten im Bereich.

Die createRange Methode gibt ein Range-Objekt zurück, das den angegebenen Bereich enthält. Das Range-Objekt bietet eine setOutlineBorders Methode, die die folgenden Parameter übernimmt:

CellBorderType, der Grenzlinienstil, ausgewählt aus der CellBorderType-Aufzählung.
Farbe, die Rahmenfarbe, ausgewählt aus der Color-Enumeration.

Der folgende Output wird generiert, wenn der unten stehende Code ausgeführt wird.

Angewendete Rahmen auf einem Zellenbereich

todo:image_alt_text

Farben und Palette

Eine Palette ist die Anzahl der verfügbaren Farben zur Erstellung eines Bildes. Die Verwendung einer standardisierten Palette in einer Präsentation ermöglicht es dem Benutzer, ein konsistentes Erscheinungsbild zu erstellen. Jede Microsoft Excel (97-2003)-Datei hat eine Palette von 56 Farben, die auf Zellen, Schriften, Gitterlinien, grafische Objekte, Füllungen und Linien in einem Diagramm angewendet werden können.

Paletten-Einstellungen in Microsoft Excel

todo:image_alt_text

Mit Aspose.Cells ist es nicht nur möglich, vorhandene Farben zu verwenden, sondern auch benutzerdefinierte Farben. Bevor Sie eine benutzerdefinierte Farbe verwenden, fügen Sie sie der Palette hinzu. In diesem Thema wird erläutert, wie benutzerdefinierte Farben der Palette hinzugefügt werden.

Hinzufügen von benutzerdefinierten Farben zur Palette

Aspose.Cells unterstützt auch eine Palette von 56 Farben. Eine Standard-Farbpalette wird oben gezeigt. Wenn Sie eine benutzerdefinierte Farbe verwenden möchten, die nicht in der Palette definiert ist, müssen Sie diese Farbe vor der Verwendung zur Palette hinzufügen.

Die Palette enthält nur 56 Farben. Wenn Sie eine benutzerdefinierte Farbe zur Palette hinzufügen, wird die Palette geändert und jedes Element in der Datei, das mit der vorherigen Farbe formatiert ist, wird geändert. Seien Sie also sehr vorsichtig, wenn Sie die Palette ändern. Außerdem ist dies nur eine Einschränkung bei XLS (Excel 97 - 2003)-Dateiformaten, da es keine solche Einschränkung für XLSX oder andere fortgeschrittene MS Excel (2007/2010)-Dateiformate gibt.

Aspose.Cells bietet eine Klasse, Workbook, die eine Microsoft Excel-Datei darstellt. Die Klasse bietet die changePalette Methode, die die folgenden Parameter übernimmt, um eine benutzerdefinierte Farbe zur Änderung der Palette hinzuzufügen:

Benutzerdefinierte Farbe, die benutzerdefinierte Farbe, die zur Palette hinzugefügt werden soll.
Index, der Index der Farbe, die durch die benutzerdefinierte Farbe ersetzt werden soll. Sollte zwischen 0-55 liegen.

Das folgende Beispiel fügt eine benutzerdefinierte Farbe zur Palette hinzu, bevor sie auf eine Schriftart angewendet wird.

Farben und Hintergrundmuster

Microsoft Excel kann Vordergrund- (Umriss) und Hintergrund- (Füll-)Farben von Zellen und Hintergrundmuster wie unten gezeigt festlegen.

Festlegen von Farben und Hintergrundmustern in Microsoft Excel

todo:image_alt_text

Aspose.Cells unterstützt diese Funktionen ebenfalls in flexibler Weise. In diesem Thema lernen wir, diese Funktionen mit Aspose.Cells zu verwenden.

Setzen von Farben & Hintergrundmustern

Aspose.Cells bietet eine Klasse, Workbook, die eine Microsoft Excel-Datei darstellt. Die Klasse Workbook enthält eine WorksheetCollection, die den Zugriff auf jedes Arbeitsblatt in der Excel-Datei ermöglicht. Ein Arbeitsblatt wird durch die Klasse Worksheet dargestellt. Die Klasse Worksheet bietet eine Cells-Sammlung. Jedes Element in der Cells-Sammlung stellt ein Objekt der Klasse Cell dar.

Aspose.Cells bietet die setStyle Methode in der Cell-Klasse, die verwendet wird, um die Formatierung einer Zelle festzulegen. Außerdem kann das Objekt der Style-Klasse verwendet werden, um Schriftarteinstellungen zu konfigurieren.

Um die Vordergrund- oder Hintergrundfarbe einer Zelle festzulegen, verwenden Sie die Eigenschaften setBackgroundColor oder setForegroundColor des Objekts Style. Diese Eigenschaften kommen nur dann zur Geltung, wenn die Eigenschaft setPattern des Objekts Style konfiguriert ist.

Die Eigenschaft setForegroundColor legt die Farbe des Zellenschattierung fest.

Die Eigenschaft setPattern legt das Hintergrundmuster fest, das für die Vordergrund- oder Hintergrundfarbe verwendet wird. Aspose.Cells bietet die Enumeration BackgroundType, die eine Reihe von vordefinierten Arten von Hintergrundmustern enthält.

Mustertyp	Beschreibung
DIAGONAL_CROSSHATCH	Repräsentiert diagonales Schraffurmuster
DIAGONAL_STRIPE	Repräsentiert diagonales Streifenmuster
GRAY_6	Repräsentiert grau Muster mit 6,25%
GRAY_12	Repräsentiert grau Muster mit 12,5%
GRAY_25	Repräsentiert grau Muster mit 25%
GRAY_50	Repräsentiert grau Muster mit 50%
GRAY_75	Repräsentiert grau Muster mit 75%
HORIZONTAL_STRIPE	Repräsentiert horizontales Streifenmuster
NONE	Stellt keinen Hintergrund dar
REVERSE_DIAGONAL_STRIPE	Repräsentiert Muster mit umgekehrten diagonalen Streifen
SOLID	Stellt das einfarbige Muster dar
THICK_DIAGONAL_CROSSHATCH	Repräsentiert dickes diagonales Schraffurmuster
THIN_DIAGONAL_CROSSHATCH	Repräsentiert dünnes diagonales Schraffurmuster
THIN_DIAGONAL_STRIPE	Repräsentiert dünnes diagonales Streifenmuster
THIN_HORIZONTAL_CROSSHATCH	Repräsentiert dünnes horizontalens Schraffurmuster
THIN_HORIZONTAL_STRIPE	Repräsentiert dünnes horizontalen Streifenmuster
THIN_REVERSE_DIAGONAL_STRIPE	Repräsentiert dünnes umgekehrtes diagonales Streifenmuster
THIN_VERTICAL_STRIPE	Repräsentiert dünnes vertikales Streifenmuster
VERTICAL_STRIPE	Repräsentiert vertikales Streifenmuster
Im folgenden Beispiel ist die Vordergrundfarbe der Zelle A1 festgelegt, aber A2 ist so konfiguriert, dass sowohl Vordergrund- als auch Hintergrundfarben mit einem vertikalen Streifenmuster hinterlegt sind.

Die folgende Ausgabe wird bei der Ausführung des Codes generiert.

Vordergrund- und Hintergrundfarben auf Zellen mit Hintergrundmustern angewendet

todo:image_alt_text

Wichtig zu wissen

Verwenden Sie für die Festlegung der Vordergrund- oder Hintergrundfarbe einer Zelle die Eigenschaften ForegroundColor oder BackgroundColor des Style-Objekts. Beide Eigenschaften wirken sich nur aus, wenn die Eigenschaft Pattern des Style-Objekts konfiguriert ist.
Die Eigenschaft ForegroundColor legt die Farbe des Zellenschattens fest. Die Eigenschaft Pattern gibt den Typ des verwendeten Hintergrundmusters für die Vordergrund- oder Hintergrundfarbe an. Aspose.Cells bietet eine Aufzählung BackgroundType, die eine Reihe vordefinierter Typen von Hintergrundmustern enthält.
Wenn Sie den Wert BackgroundType.NONE aus der Aufzählung BackgroundType auswählen, wird die Vordergrundfarbe nicht angewendet. Ebenso wird die Hintergrundfarbe nicht angewendet, wenn Sie die Werte BackgroundType.NONE oder BackgroundType.SOLID auswählen.
Beim Abrufen der Schattierungs-/Füllfarbe der Zelle gibt die Eigenschaft Style.ForegroundColor Color.Empty zurück, wenn Style.Pattern den Wert BackgroundType.NONE hat.

Formatieren ausgewählter Zeichen in einer Zelle

Umgang mit Schrifteinstellungen erklärte, wie Zellen formatiert werden, aber nur, wie der Inhalt der gesamten Zellen formatiert wird. Was ist, wenn Sie nur ausgewählte Zeichen formatieren möchten?

Aspose.Cells unterstützt diese Funktion. Dieser Artikel erläutert, wie Sie diese Funktion verwenden können.

Formatieren ausgewählter Zeichen

Die Cell Klasse bietet die characters Methode, die die folgenden Parameter übernimmt, um einen Bereich von Zeichen in einer Zelle auszuwählen:

Start-Index, der Index des Zeichens, von dem aus die Auswahl beginnen soll.
Anzahl der Zeichen: Die Anzahl der ausgewählten Zeichen.

In der Ausgabedatei ist in der Zelle A1 das Wort ‘Besuchen’ mit der Standardschrift formatiert, aber ‘Aspose!’ ist fett und blau.

Auswahl von formatierten Zeichen

todo:image_alt_text

Wenn Sie daran interessiert sind, einen Teil des Rich Texts in einer Zelle zu formatieren, sollten Sie die Cell.getCharacters & Cell.setCharacters Methoden verwenden. Die Cell.getCharacters Methode wird verwendet, um die Textabschnitte abzurufen, und Änderungen können mit der Cell.setCharacters Methode vorgenommen werden. Das get-Verfahren gibt ein Array von FontSetting Objekten zurück, die manipuliert werden können, um verschiedene Eigenschaften wie Schriftartname, Schriftfarbe, Fettdruck usw. festzulegen, während die set-Methode verwendet werden kann, um die Änderungen anzuwenden.

Erweiterte Themen

Formeln Berechnung von Formeln