Füllungseinstellungen

Farben und Hintergrundmuster

Microsoft Excel kann die Vordergrund- (Rahmen) und Hintergrundfarben (Fülle) von Zellen sowie Hintergrundmuster festlegen.

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

Einstellen von Farben und Hintergrundmustern

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

Die Klasse Cell verfügt über die Methoden GetStyle und SetStyle, die zur Abfrage und Änderung der Formatierung einer Zelle verwendet werden. Die Klasse Style stellt Eigenschaften zur Festlegung der Vordergrund- und Hintergrundfarben der Zellen bereit. Aspose.Cells bietet eine Enumeration BackgroundType, die eine Reihe von vordefinierten Arten von Hintergrundmustern enthält, die unten aufgeführt sind.

Hintergrundmuster	Beschreibung
DiagonalCrosshatch	: Stellt das diagonale Kreuzmuster dar
DiagonalStripe	: Stellt das diagonale Streifenmuster dar
Gray6	: Stellt das 6,25%-graue Muster dar
Gray12	: Stellt das 12,5%-graue Muster dar
Gray25	: Stellt das 25%-graue Muster dar
Gray50	: Stellt das 50%-graue Muster dar
Gray75	: Stellt das 75%-graue Muster dar
HorizontalStripe	: Stellt das horizontale Streifenmuster dar
None	: Stellt keinen Hintergrund dar
ReverseDiagonalStripe	: Stellt das umgekehrte diagonale Streifenmuster dar
Solid	: Stellt das einfarbige Muster dar
ThickDiagonalCrosshatch	: Stellt das dicke diagonale Kreuzmuster dar
ThinDiagonalCrosshatch	: Stellt das dünnere diagonale Kreuzmuster dar
ThinDiagonalStripe	: Stellt das dünnere diagonale Streifenmuster dar
ThinHorizontalCrosshatch	: Stellt das dünnere horizontale Kreuzmuster dar
ThinHorizontalStripe	: Stellt das dünnere horizontale Streifenmuster dar
ThinReverseDiagonalStripe	Stellt ein dünn umgekehrtes diagonales Streifenmuster dar
ThinVerticalStripe	Stellt ein dünn vertikales Streifenmuster dar
VerticalStripe	Stellt ein vertikales Streifenmuster dar

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.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Create directory if it is not already present.
	bool IsExists = System.IO.Directory.Exists(dataDir);
	if (!IsExists)
	System.IO.Directory.CreateDirectory(dataDir);

	// Instantiating a Workbook object
	Workbook workbook = new Workbook();

	// Adding a new worksheet to the Workbook object
	int i = workbook.Worksheets.Add();

	// Obtaining the reference of the newly added worksheet by passing its sheet index
	Worksheet worksheet = workbook.Worksheets[i];

	// Define a Style and get the A1 cell style
	Style style = worksheet.Cells["A1"].GetStyle();

	// Setting the foreground color to yellow
	style.ForegroundColor = Color.Yellow;

	// Setting the background pattern to vertical stripe
	style.Pattern = BackgroundType.VerticalStripe;

	// Apply the style to A1 cell
	worksheet.Cells["A1"].SetStyle(style);

	// Get the A2 cell style
	style = worksheet.Cells["A2"].GetStyle();

	// Setting the foreground color to blue
	style.ForegroundColor = Color.Blue;

	// Setting the background color to yellow
	style.BackgroundColor = Color.Yellow;

	// Setting the background pattern to vertical stripe
	style.Pattern = BackgroundType.VerticalStripe;

	// Apply the style to A2 cell
	worksheet.Cells["A2"].SetStyle(style);

	// Saving the Excel file
	workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003);

view raw Examples-CSharp-Formatting-ColorsAndBackground-1.cs hosted with ❤ by GitHub

Wichtig zu wissen

Verwenden Sie zum Festlegen der Vordergrund- oder Hintergrundfarbe einer Zelle die Eigenschaften ForegroundColor oder BackgroundColor des Objekts Style. Beide Eigenschaften werden nur wirksam, wenn die Eigenschaft Pattern des Objekts Style konfiguriert ist.
Die Eigenschaft ForegroundColor legt die Schattierungsfarbe der Zelle fest. Die Eigenschaft Pattern legt den Typ des Hintergrundmusters fest, das für die Vordergrund- oder Hintergrundfarbe verwendet wird. Aspose.Cells bietet eine Aufzählung, BackgroundType, die eine Reihe von vordefinierten Arten 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 Style.ForegroundColor Color.Empty zurück, wenn Style.Pattern BackgroundType.None ist.

Anwendung von Verlaufsfülleffekten

Verwenden Sie zum Anwenden Ihrer gewünschten Verlaufsfülleffekte auf die Zelle die Methode SetTwoColorGradient des Objekts Style entsprechend.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Instantiate a new Workbook
	Workbook workbook = new Workbook();
	// Get the first worksheet (default) in the workbook
	Worksheet worksheet = workbook.Worksheets[0];
	// Input a value into B3 cell
	worksheet.Cells[2, 1].PutValue("test");

	// Get the Style of the cell
	Style style = worksheet.Cells["B3"].GetStyle();
	// Set Gradient pattern on
	style.IsGradient = true;
	// Specify two color gradient fill effects
	style.SetTwoColorGradient(Color.FromArgb(255, 255, 255), Color.FromArgb(79, 129, 189), GradientStyleType.Horizontal, 1);
	// Set the color of the text in the cell
	style.Font.Color = Color.Red;
	// Specify horizontal and vertical alignment settings
	style.HorizontalAlignment = TextAlignmentType.Center;
	style.VerticalAlignment = TextAlignmentType.Center;

	// Apply the style to the cell
	worksheet.Cells["B3"].SetStyle(style);

	// Set the third row height in pixels
	worksheet.Cells.SetRowHeightPixel(2, 53);

	// Merge the range of cells (B3:C3)
	worksheet.Cells.Merge(2, 1, 1, 2);

	// Save the Excel file
	workbook.Save(dataDir + "output.xlsx");

view raw Examples-CSharp-Formatting-ApproachesToFormatData-ApplyingGradientFillEffects-1.cs hosted with ❤ by GitHub

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.

Mit Aspose.Cells ist es möglich, nicht nur die vorhandenen Farben der Palette zu verwenden, sondern auch benutzerdefinierte Farben. Bevor Sie eine benutzerdefinierte Farbe verwenden, fügen Sie diese zunächst der Palette hinzu.

In diesem Thema wird erläutert, wie benutzerdefinierte Farben zur Palette hinzugefügt werden.

Hinzufügen von benutzerdefinierten Farben zur Palette

Aspose.Cells unterstützt Microsoft Excels 56-Farben-Palette. Um eine benutzerdefinierte Farbe zu verwenden, die in der Palette nicht definiert ist, fügen Sie die Farbe der Palette hinzu.

Aspose.Cells stellt eine Klasse Workbook bereit, die eine Microsoft Excel-Datei repräsentiert. Die Klasse Workbook bietet eine Methode ChangePalette, die die folgenden Parameter verwendet, um eine benutzerdefinierte Farbe zur Modifizierung der Palette hinzuzufügen:

Benutzerdefinierte Farbe, die benutzerdefinierte Farbe, die hinzugefügt werden soll.
Index, der Index der Farbe in der Palette, die die benutzerdefinierte Farbe ersetzen wird. Sollte zwischen 0-55 liegen.

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

	// Instantiating an Workbook object
	Workbook workbook = new Workbook();

	//Checks if a color is in the palette for the spreadsheet.
	Console.WriteLine(workbook.IsColorInPalette(Color.Orchid));

	// Adding Orchid color to the palette at 55th index
	workbook.ChangePalette(Color.Orchid, 55);

	Console.WriteLine(workbook.IsColorInPalette(Color.Orchid));

	// Adding a new worksheet to the Excel object
	int i = workbook.Worksheets.Add();

	// Obtaining the reference of the newly added worksheet by passing its sheet index
	Worksheet worksheet = workbook.Worksheets[i];

	// Accessing the "A1" cell from the worksheet
	Cell cell = worksheet.Cells["A1"];

	// Adding some value to the "A1" cell
	cell.PutValue("Hello Aspose!");

	// Defining new Style object
	Style styleObject = workbook.CreateStyle();
	// Setting the Orchid (custom) color to the font
	styleObject.Font.Color = workbook.Colors[55];

	// Applying the style to the cell
	cell.SetStyle(styleObject);

	// Saving the Excel file
	workbook.Save("out.xlsx");

view raw Examples-CSharp-Formatting-ColorsAndPalette-1.cs hosted with ❤ by GitHub

Die Palette bietet Platz für nur 56 Farben. Wenn Sie eine benutzerdefinierte Farbe zur Palette hinzufügen, wird die Palette geändert und jedes Element in der Datei, das zuvor mit der Farbe formatiert wurde, wird geändert. Wenn Sie also die Palette ändern, seien Sie bitte sehr vorsichtig. Außerdem handelt es sich hierbei ausschließlich um eine Einschränkung im XLS (Excel 97 - 2003) Dateiformat, da es für XLSX oder andere fortgeschrittene MS Excel (2007/2010 oder 2013) Dateiformate keine solche Einschränkung gibt.

Rahmeneinstellungen Setzen Sie bedingte Formate in Excel und ODS Dateien.