ChangeBgFillStyles
Sets the background fill styles to the current theme format scheme.
Syntax
expression.ChangeBgFillStyles(arrBgFill);
expression
- A variable that represents a ApiThemeFormatScheme class.
Parameters
Name | Required/Optional | Data type | Default | Description |
---|---|---|---|---|
arrBgFill | Required | ApiFill[] | The array of background fill styles must contains 3 elements - subtle, moderate and intense fills. If an array is empty or NoFill elements are in the array, it will be filled with the Api.CreateNoFill() elements. |
Returns
This method doesn't return any data.
Example
This example sets the background fill styles to the current theme format scheme.
- Code
- Result
// How to change background fill styles of a format scheme.
// Get format scheme and update its background fill styles, adding pattern, solid and radial fills.
const presentation = Api.GetPresentation();
const slide = presentation.GetSlideByIndex(0);
slide.RemoveAllObjects();
const master = presentation.GetMaster(0);
const gs1 = Api.CreateGradientStop(Api.CreateRGBColor(255, 213, 191), 0);
const gs2 = Api.CreateGradientStop(Api.CreateRGBColor(255, 111, 61), 100000);
const bgFill1 = Api.CreateRadialGradientFill([gs1, gs2]);
const bgFill2 = Api.CreatePatternFill("dashDnDiag", Api.CreateRGBColor(255, 111, 61), Api.CreateRGBColor(51, 51, 51));
const bgFill3 = Api.CreateSolidFill(Api.CreateRGBColor(255, 111, 61));
let theme = slide.GetTheme();
const formatScheme = theme.GetFormatScheme();
formatScheme.ChangeBgFillStyles([bgFill1, bgFill2, bgFill3]);
const colorScheme = Api.CreateThemeColorScheme([
Api.CreateRGBColor(255, 111, 61), Api.CreateRGBColor(51, 51, 51), Api.CreateRGBColor(230, 179, 117), Api.CreateRGBColor(235, 235, 235),
Api.CreateRGBColor(163, 21, 21), Api.CreateRGBColor(128, 43, 43), Api.CreateRGBColor(0, 0, 0), Api.CreateRGBColor(128, 128, 128),
Api.CreateRGBColor(176, 196, 222), Api.CreateRGBColor(65, 105, 225), Api.CreateRGBColor(255, 255, 255), Api.CreateRGBColor(255, 213, 191)
], "New color scheme");
const fontScheme = Api.CreateThemeFontScheme("Arial", "Noto Sans Simplified Chinese", "Arabic", "Times New Roman", "Noto Serif Simplified Chinese", "Arabic", "New font scheme");
theme = Api.CreateTheme("Theme 1", master, colorScheme, formatScheme, fontScheme);
presentation.ApplyTheme(theme);
const chart = Api.CreateChart("bar3D", [
[200, 240, 280],
[250, 260, 280]
], ["Projected Revenue", "Estimated Costs"], [2014, 2015, 2016], 4051300, 2347595, 24);
chart.SetVerAxisTitle("USD In Hundred Thousands", 10);
chart.SetHorAxisTitle("Year", 11);
chart.SetLegendPos("bottom");
chart.SetShowDataLabels(false, false, true, false);
chart.SetTitle("Financial Overview", 20);
chart.SetSize(300 * 36000, 130 * 36000);
chart.SetPosition(608400, 1267200);
slide.AddObject(chart);