Added new kb article retrieve-cell-color-radspreadprocessing

Author: KB Bot

knowledge-base/retrieve-cell-color-radspreadprocessing.md

@@ -0,0 +1,72 @@
+---
+title: Retrieving Themable Cell Color in RadSpreadProcessing
+description: Learn how to retrieve the actual cell color in RadSpreadProcessing when the color comes from the document theme.
+type: how-to
+page_title: How to Retrieve Cell Color from Theme in RadSpreadProcessing
+slug: retrieve-cell-color-radspreadprocessing
+tags: radspreadprocessing, document processing, cell color, themable color, pattern fill
+res_type: kb
+ticketid: 1656165
+---
+
+## Environment
+
+| Product | RadSpreadProcessing for Document Processing |
+| --- | --- |
+| Version | 2021.3.1123 |
+
+## Description
+
+I have imported an Excel file with some cells formatted with color. Is it possible for me to retrieve the cell color in my program? When the background color is set from MS Excel, my implementation does not retrieve the actual background color.
+
+This KB article also answers the following questions:
+- How can I get the background color of a cell in RadSpreadProcessing?
+- How to handle cell colors that come from a document theme in RadSpreadProcessing?
+- What is the method to extract the actual color value of a cell formatted in Excel through RadSpreadProcessing?
+
+## Solution
+
+To retrieve the cell color in RadSpreadProcessing, especially when the color is applied through the document theme, follow these steps:
+
+1. Import the Excel document using the appropriate format provider.
+2. Access the desired cell or range of cells.
+3. Check if the cell's fill is of type `PatternFill`.
+4. Retrieve the `ThemableColor` object from the `PatternFill`.
+5. Use the `GetActualValue` method of the `ThemableColor` object, passing in the document's theme, to get the actual color value.
+
+Here is a sample code snippet demonstrating these steps:
+
+```csharp
+string filePath = "Book1.xlsx";
+Workbook workbook = new Workbook(); 
+IWorkbookFormatProvider formatProvider = new Telerik.Windows.Documents.Spreadsheet.FormatProviders.OpenXml.Xlsx.XlsxFormatProvider();
+
+using (Stream input = new FileStream(filePath, FileMode.Open))
+{
+    workbook = formatProvider.Import(input);
+}
+Worksheet worksheet = workbook.Worksheets.First();
+CellSelection selection = worksheet.Cells[0,1]; 
+PatternFill solidPatternFill = selection.GetFill().Value as PatternFill;
+if (solidPatternFill != null)
+{
+    PatternType type = solidPatternFill.PatternType;
+    ThemableColor patternColor = solidPatternFill.PatternColor;
+    Color color = patternColor.LocalValue;
+    ThemableColor bg = solidPatternFill.BackgroundColor;
+    Color bgcolor = bg.LocalValue;
+
+    Color actualColor = patternColor.GetActualValue(workbook.Theme);
+    // The actual color is the same as Accent1 color of the colorScheme 
+    Debug.WriteLine("RGB: " + actualColor.R.ToString() + ", " + actualColor.G.ToString() + ", " + actualColor.B.ToString());
+}
+```
+
+This approach ensures that even when a cell's color is derived from the document's theme, you can obtain the actual color value as displayed in the Excel file.
+
+## See Also
+
+- [Document Themes in RadSpreadProcessing](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/features/styling/document-themes)
+- [Getting Actual Values](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/features/styling/document-themes#getting-actual-values)
+
+---