Einstellungen füllen

Farben und Hintergrundmuster

Microsoft Excel kann die Vordergrund- (Umriss-) und Hintergrund- (Füll-) Farben von Zellen und Hintergrundmustern festlegen.

Aspose.Cells unterstützt diese Features ebenfalls flexibel. In diesem Thema lernen wir, diese Funktionen mit Aspose.Cells zu verwenden.

Einstellen von Farben und Hintergrundmustern

Aspose.Cells bietet eine Klasse,Arbeitsmappe das stellt eine Microsoft Excel-Datei dar. DasArbeitsmappe Klasse enthält aArbeitsblätter Sammlung, die den Zugriff auf jedes Arbeitsblatt in der Excel-Datei ermöglicht. Ein Arbeitsblatt wird durch dargestelltArbeitsblatt Klasse. DasArbeitsblatt Klasse bietet aCells Sammlung. Jeder Artikel in derCells Sammlung stellt ein Objekt derCellKlasse.

DasCell hat dieGetStyle undSetStyle Methoden, die zum Abrufen und Festlegen der Formatierung einer Zelle verwendet werden. DasStil-Klasse bietet Eigenschaften zum Festlegen der Vorder- und Hintergrundfarbe der Zellen. Aspose.Cells bietet eineHintergrundtypAufzählung, die einen Satz vordefinierter Arten von Hintergrundmustern enthält, die unten angegeben sind.

Hintergrundmuster	Beschreibung
Diagonale Kreuzschraffur	Stellt ein diagonales Schraffurmuster dar
DiagonalStreifen	Stellt ein diagonales Streifenmuster dar
Grau6	Repräsentiert 6,25 % graues Muster
Grau12	Repräsentiert 12,5 % graues Muster
Grau25	Repräsentiert 25 % graues Muster
Grau50	Repräsentiert 50 % graues Muster
Grau75	Repräsentiert 75 % graues Muster
HorizontalStripe	Repräsentiert ein horizontales Streifenmuster
Keiner	Stellt keinen Hintergrund dar
ReverseDiagonalStripe	Stellt umgekehrtes diagonales Streifenmuster dar
Solide	Stellt ein durchgehendes Muster dar
Dicke Diagonale Kreuzschraffur	Stellt ein dickes diagonales Schraffurmuster dar
ThinDiagonalCrosshatch	Stellt ein dünnes diagonales Schraffurmuster dar
ThinDiagonalStripe	Stellt ein dünnes diagonales Streifenmuster dar
ThinHorizontalCrosshatch	Stellt ein dünnes horizontales Schraffurmuster dar
ThinHorizontalStripe	Repräsentiert ein dünnes horizontales Streifenmuster
ThinReverseDiagonalStripe	Repräsentiert ein dünnes umgekehrtes diagonales Streifenmuster
ThinVerticalStripe	Stellt ein dünnes vertikales Streifenmuster dar
VerticalStripe	Stellt ein vertikales Streifenmuster dar

Im Beispiel unten ist die Vordergrundfarbe der A1-Zelle eingestellt, aber A2 ist so konfiguriert, dass sie sowohl Vorder- als auch Hintergrundfarbe mit einem vertikalen Streifenhintergrundmuster hat.

// 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);

Wichtig zu wissen

• Um die Vorder- oder Hintergrundfarbe einer Zelle festzulegen, verwenden Sie dieStil ObjektVordergrundfarbe oderHintergrundfarbe Eigenschaften. Beide Eigenschaften werden nur wirksam, wenn dieStil ObjektMusterEigenschaft konfiguriert ist.
• DasVordergrundfarbe-Eigenschaft legt die Schattierungsfarbe der Zelle fest. DasMuster-Eigenschaft gibt den Typ des Hintergrundmusters an, das für die Vorder- oder Hintergrundfarbe verwendet wird. Aspose.Cells liefert eine Aufzählung,Hintergrundtypdas eine Reihe vordefinierter Arten von Hintergrundmustern enthält.
• Wenn Sie auswählenBackgroundType.None Wert aus demHintergrundtypAufzählung wird die Vordergrundfarbe nicht angewendet. Ebenso wird die Hintergrundfarbe nicht angewendet, wenn Sie die auswählenBackgroundType.None oderBackgroundType.Solid Werte.
• Beim Abrufen der Schattierungs-/Füllfarbe der Zelle, wennStil.Muster istBackgroundType.None, Style.ForegroundColor wird zurückkehrenFarbe.Leer.

Anwenden von Verlaufsfülleffekten

Um die gewünschten Verlaufsfülleffekte auf die Zelle anzuwenden, verwenden Sie dieStil ObjektSetTwoColorGradientMethode 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");

Farben und Palette

Eine Palette ist die Anzahl der Farben, die zur Verwendung beim Erstellen eines Bildes zur Verfügung stehen. 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, Schriftarten, Gitterlinien, Grafikobjekte, 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, sondern auch benutzerdefinierte Farben zu verwenden. Bevor Sie eine benutzerdefinierte Farbe verwenden, fügen Sie sie zuerst der Palette hinzu.

In diesem Thema wird erläutert, wie Sie der Palette benutzerdefinierte Farben hinzufügen.

Hinzufügen benutzerdefinierter Farben zur Palette

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

Aspose.Cells bietet eine Klasse,Arbeitsmappe , die eine Microsoft Excel-Datei darstellt. DasArbeitsmappe Klasse bietet aPalette ändern Methode, die die folgenden Parameter benötigt, um eine benutzerdefinierte Farbe hinzuzufügen, um die Palette zu ändern:

• Benutzerdefinierte Farbe, die hinzuzufügende benutzerdefinierte Farbe.
• Index, der Index der Farbe in der Palette, die durch die benutzerdefinierte Farbe ersetzt wird. Sollte zwischen 0-55 liegen.

Im folgenden Beispiel wird der Palette eine benutzerdefinierte Farbe (Orchidee) hinzugefügt, 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");

Die Palette enthält nur 56 Farben. Wenn Sie der Palette eine benutzerdefinierte Farbe hinzufügen, wird die Palette geändert und alle Elemente in der Datei, die mit der vorherigen Farbe formatiert wurden, werden geändert. Seien Sie also bitte sehr vorsichtig, wenn Sie die Palette ändern. Darüber hinaus ist dies nur die Einschränkung im Dateiformat XLS (Excel 97 - 2003), da es keine solche Einschränkung für XLSX oder andere erweiterte MS Excel-Dateiformate (2007/2010 oder 2013) gibt.