Темы и цвета Excel
Темы обеспечивают единообразный внешний вид с именованными стилями, графическими эффектами и другими объектами, используемыми в книге. Например, стиль Accent1 выглядит по-другому в темах Office и Apex. Часто вы применяете тему документа, а затем настраиваете ее согласно вашим потребностям.
Применение тем в Microsoft Excel
Получение и установка цветов темы
API Aspose.Cells предоставляет функции для настройки тем и цветов. Ниже перечислены несколько методов и свойств, реализующих цвета темы.
- Cвойство Style.ForegroundThemeColor можно использовать для установки цвета переднего плана.
- Cвойство Style.BackgroundThemeColor можно использовать для установки цвета фона.
- Cвойство Font.ThemeColor можно использовать для установки цвета шрифта.
- Метод Workbook.getThemeColor можно использовать для получения тематического цвета.
- Метод Workbook.setThemeColor можно использовать для установки тематического цвета.
В следующем примере показано, как получить и установить цвета темы.
В следующем примере используется шаблонный файл XLSX, получаются цвета для различных типов цветов темы, изменяются цвета и сохраняется файл Microsoft Excel.
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
| // The path to the documents directory. | |
| String dataDir = Utils.getDataDir(GetSetThemeColors.class); | |
| // Instantiate Workbook object | |
| // Open an exiting excel file | |
| Workbook workbook = new Workbook(dataDir + "book1.xlsx"); | |
| // Get the Background1 theme color | |
| Color c = workbook.getThemeColor(ThemeColorType.BACKGROUND_1); | |
| // Print the color | |
| System.out.println("theme color Background1: " + c); | |
| // Get the Accent2 theme color | |
| c = workbook.getThemeColor(ThemeColorType.ACCENT_1); | |
| // Print the color | |
| System.out.println("theme color Accent2: " + c); | |
| // Change the Background1 theme color | |
| workbook.setThemeColor(ThemeColorType.BACKGROUND_1, Color.getRed()); | |
| // Get the updated Background1 theme color | |
| c = workbook.getThemeColor(ThemeColorType.BACKGROUND_1); | |
| // Print the updated color for confirmation | |
| System.out.println("theme color Background1 changed to: " + c); | |
| // Change the Accent2 theme color | |
| workbook.setThemeColor(ThemeColorType.ACCENT_1, Color.getBlue()); | |
| // Get the updated Accent2 theme color | |
| c = workbook.getThemeColor(ThemeColorType.ACCENT_1); | |
| // Print the updated color for confirmation | |
| System.out.println("theme color Accent2 changed to: " + c); | |
| // Save the updated file | |
| workbook.save(dataDir + "GetAndSetThemeColorBook.xlsx"); |
Настройка тем
Следующий пример показывает, как применять пользовательские темы с выбранными вами цветами. В примере используется образец шаблонного файла, созданного вручную в Microsoft Excel 2007.
Файл шаблона CustomThemeColor.xlsx
Приведенный ниже пример загружает шаблонный файл XLSX, определяет цвета для различных типов цвета темы, применяет пользовательские цвета и сохраняет файл Excel.
Сгенерированный файл с настроенными тематическими цветами
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
| // The path to the documents directory. | |
| String dataDir = Utils.getDataDir(CustomizingThemes.class); | |
| // Define Color array (of 12 colors) for the Theme | |
| Color[] carr = new Color[12]; | |
| carr[0] = Color.getAntiqueWhite(); // Background1 | |
| carr[1] = Color.getBrown(); // Text1 | |
| carr[2] = Color.getAliceBlue(); // Background2 | |
| carr[3] = Color.getYellow(); // Text2 | |
| carr[4] = Color.getYellowGreen(); // Accent1 | |
| carr[5] = Color.getRed(); // Accent2 | |
| carr[6] = Color.getPink(); // Accent3 | |
| carr[7] = Color.getPurple(); // Accent4 | |
| carr[8] = Color.getPaleGreen(); // Accent5 | |
| carr[9] = Color.getOrange(); // Accent6 | |
| carr[10] = Color.getGreen(); // Hyperlink | |
| carr[11] = Color.getGray(); // Followed Hyperlink | |
| // Instantiate a Workbook | |
| // Open the spreadsheet file | |
| Workbook workbook = new Workbook(dataDir + "book1.xlsx"); | |
| // Set the custom theme with specified colors | |
| workbook.customTheme("CustomeTheme1", carr); | |
| // Save as the excel file | |
| workbook.save(dataDir + "CustomThemeColor.xlsx"); |
Использование тематических цветов
Приведенный ниже пример применяет передний план ячейки и цвета шрифта на основе цветов темы по умолчанию (рабочей книги). Он также сохраняет файл Excel на диск.
Следующий вывод генерируется при выполнении кода.
Тематические цвета, примененные к ячейке D3 рабочего листа
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
| // The path to the documents directory. | |
| String dataDir = Utils.getDataDir(UseThemeColors.class); | |
| // Instantiate a Workbook | |
| Workbook workbook = new Workbook(); | |
| // Get cells collection in the first (default) worksheet | |
| Cells cells = workbook.getWorksheets().get(0).getCells(); | |
| // Get the D3 cell | |
| Cell c = cells.get("D3"); | |
| // Get the style of the cell | |
| Style s = c.getStyle(); | |
| // Set background color for the cell from the default theme Accent2 color | |
| s.setBackgroundThemeColor(new ThemeColor(ThemeColorType.ACCENT_2, 0.5)); | |
| // Set the pattern type | |
| s.setPattern(BackgroundType.SOLID); | |
| // Get the font for the style | |
| Font f = s.getFont(); | |
| // Set the theme color | |
| f.setThemeColor(new ThemeColor(ThemeColorType.ACCENT_4, 0.1)); | |
| // Apply style | |
| c.setStyle(s); | |
| // Put a value | |
| c.putValue("Testing"); | |
| // Save the excel file | |
| workbook.save(dataDir + "UseThemeColors.xlsx"); |