Merge pull request #436 from telerik/new-kb-retrieve-cell-color-radspreadprocessing-c4a2efdcd8f248f383435b87ffcf51ae

Added new kb article retrieve-cell-color-radspreadprocessing

Author: dessyordanova

knowledge-base/images/worksheet-changing-theme-color.gif

@@ -0,0 +1,79 @@
+---
+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
+
+| Version | Product | Author | 
+| --- | --- | ---- | 
+| 2024.2.426| RadSpreadProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+## Description
+
+Let's import an Excel file with some cells formatted with color. Learn how to retrieve the cell color when the background color is set from MS Excel with a theme.
+
+It is possible to set a **Standard** Color (e.g. Yellow) or a **Theme** Color (e.g. Dark Teal, Accent 1) to a cell:
+
+|Standard Color|Theme Color|
+|----|----|
+|![Standard Color](images/worksheet-standard-color.png) |![Theme Color](images/worksheet-theme-color.png) |   
+
+The *Yellow* color will be fixed and after the changing the document's theme, it wouldn't change. However, the *Dark Teal, Accent 1* color will be changed if another theme is selected:
+
+![Changing Theme Color](images/worksheet-changing-theme-color.gif)    
+ 
+This article demonstrates how to extract the color value from a cell when it is applied via a theme color.
+
+## 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]({%slug radspreadprocessing-formats-and-conversion-xlsx-xlsxformatprovider%}) using the appropriate format provider.
+2. [Access the desired cell]({%slug radspreadprocessing-working-with-cells-accessing-cells-of-worksheet%}) or range of cells.
+3. Check if the cell's fill is of type [PatternFill](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/working-with-cells/get-set-clear-properties#fill-property).
+4. Retrieve the [ThemableColor]({%slug radspreadprocessing-features-styling-document-themes%}) object from the `PatternFill`.
+5. Use the [GetActualValue](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/features/styling/document-themes#getting-actual-values) 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]({%slug radspreadprocessing-features-styling-document-themes%}})
+- [Getting Actual Values](https://docs.telerik.com/devtools/document-processing/libraries/radspreadprocessing/features/styling/document-themes#getting-actual-values)
+
+---

knowledge-base/images/worksheet-standard-color.png

@@ -215,3 +215,4 @@ You can also remove a style from the __Styles__ collection. It is as easy as rem
 
  * [Document Themes]({%slug radspreadprocessing-features-styling-document-themes%})
  * [Whats is a Workbook?]({%slug radspreadprocessing-working-with-workbooks-what-is-workbook%})
+ * [Retrieving Themable Cell Color in RadSpreadProcessing]({%slug retrieve-cell-color-radspreadprocessing%})

knowledge-base/images/worksheet-theme-color.png

@@ -231,3 +231,4 @@ In order to get the actual value from __ThemableColor__ or __ThemableFontFamily_
 ## See Also
 
  * [Cell Styles]({%slug radspreadprocessing-features-styling-cell-styles%})
+ * [Retrieving Themable Cell Color in RadSpreadProcessing]({%slug retrieve-cell-color-radspreadprocessing%})