/// <summary>
/// Set a gradient stop given a position and a color. Used in conjunction with SetCustomGradient().
/// </summary>
/// <param name="Position">Specifies position of the color, ranging from 0.0 to 1.0.</param>
/// <param name="ColorTheme">The theme color to be used.</param>
/// <param name="ColorTint">The tint applied to the theme color, ranging from -1.0 to 1.0. Negative tints darken the theme color and positive tints lighten the theme color.</param>
public void AppendGradientStop(double Position, SLThemeColorIndexValues ColorTheme, double ColorTint)
{
SLColor clr = new SLColor(this.listThemeColors, this.listIndexedColors);
clr.SetThemeColor(ColorTheme, ColorTint);
GradientStop gs = new GradientStop();
gs.Position = Position;
gs.Color = clr.ToSpreadsheetColor();
listGradientStops.Add(gs);
}
/// <summary>
/// Set a gradient fill given the shading style and 2 colors.
/// </summary>
/// <param name="ShadingStyle">The gradient shading style.</param>
/// <param name="Color1Theme">The first color as one of the theme colors.</param>
/// <param name="Color1Tint">The tint applied to the first theme color, ranging from -1.0 to 1.0. Negative tints darken the theme color and positive tints lighten the theme color.</param>
/// <param name="Color2Theme">The second color as one of the theme colors.</param>
/// <param name="Color2Tint">The tint applied to the second theme color, ranging from -1.0 to 1.0. Negative tints darken the theme color and positive tints lighten the theme color.</param>
public void SetGradientFill(SLGradientShadingStyleValues ShadingStyle, SLThemeColorIndexValues Color1Theme, double Color1Tint, SLThemeColorIndexValues Color2Theme, double Color2Tint)
{
SLColor clr1 = new SLColor(this.listThemeColors, this.listIndexedColors);
SLColor clr2 = new SLColor(this.listThemeColors, this.listIndexedColors);
clr1.SetThemeColor(Color1Theme, Color1Tint);
clr2.SetThemeColor(Color2Theme, Color2Tint);
SetGradientFill(ShadingStyle, clr1, clr2);
}
/// <summary>
/// Set a gradient fill given the shading style and 2 colors.
/// </summary>
/// <param name="ShadingStyle">The gradient shading style.</param>
/// <param name="Color1Theme">The first color as one of the theme colors.</param>
/// <param name="Color1Tint">The tint applied to the first theme color, ranging from -1.0 to 1.0. Negative tints darken the theme color and positive tints lighten the theme color.</param>
/// <param name="Color2">The second color.</param>
public void SetGradientFill(SLGradientShadingStyleValues ShadingStyle, SLThemeColorIndexValues Color1Theme, double Color1Tint, System.Drawing.Color Color2)
{
SLColor clr1 = new SLColor(this.listThemeColors, this.listIndexedColors);
SLColor clr2 = new SLColor(this.listThemeColors, this.listIndexedColors);
clr1.SetThemeColor(Color1Theme, Color1Tint);
clr2.Rgb = string.Format("{0}{1}{2}", Color2.R.ToString("x2"), Color2.G.ToString("x2"), Color2.B.ToString("x2"));
SetGradientFill(ShadingStyle, clr1, clr2);
}
/// <summary>
/// Set a custom 3-color scale.
/// </summary>
/// <param name="MinType">The conditional format type for the minimum.</param>
/// <param name="MinValue">The value for the minimum. If <paramref name="MinType"/> is Value, you can just set this to "0".</param>
/// <param name="MinColor">The theme color for the minimum.</param>
/// <param name="MinColorTint">The tint applied to the theme color, ranging from -1.0 to 1.0. Negative tints darken the theme color and positive tints lighten the theme color.</param>
/// <param name="MidPointType">The conditional format type for the midpoint.</param>
/// <param name="MidPointValue">The value for the midpoint.</param>
/// <param name="MidPointColor">The theme color for the midpoint.</param>
/// <param name="MidPointColorTint">The tint applied to the theme color, ranging from -1.0 to 1.0. Negative tints darken the theme color and positive tints lighten the theme color.</param>
/// <param name="MaxType">The conditional format type for the maximum.</param>
/// <param name="MaxValue">The value for the maximum. If <paramref name="MaxType"/> is Value, you can just set this to "0".</param>
/// <param name="MaxColor">The theme color for the maximum.</param>
/// <param name="MaxColorTint">The tint applied to the theme color, ranging from -1.0 to 1.0. Negative tints darken the theme color and positive tints lighten the theme color.</param>
public void SetCustom3ColorScale(SLConditionalFormatMinMaxValues MinType, string MinValue, SLThemeColorIndexValues MinColor, double MinColorTint,
SLConditionalFormatRangeValues MidPointType, string MidPointValue, SLThemeColorIndexValues MidPointColor, double MidPointColorTint,
SLConditionalFormatMinMaxValues MaxType, string MaxValue, SLThemeColorIndexValues MaxColor, double MaxColorTint)
{
List<System.Drawing.Color> listempty = new List<System.Drawing.Color>();
SLColor minclr = new SLColor(listempty, listempty);
if (MinColorTint == 0) minclr.SetThemeColor(MinColor);
else minclr.SetThemeColor(MinColor, MinColorTint);
SLColor maxclr = new SLColor(listempty, listempty);
if (MaxColorTint == 0) maxclr.SetThemeColor(MaxColor);
else maxclr.SetThemeColor(MaxColor, MaxColorTint);
SLColor midclr = new SLColor(listempty, listempty);
if (MidPointColorTint == 0) midclr.SetThemeColor(MidPointColor);
else midclr.SetThemeColor(MidPointColor, MidPointColorTint);
this.SetCustomColorScale(MinType, MinValue, minclr, true, MidPointType, MidPointValue, midclr, MaxType, MaxValue, maxclr);
}
/// <summary>
/// Set a custom 2-color scale.
/// </summary>
/// <param name="MinType">The conditional format type for the minimum.</param>
/// <param name="MinValue">The value for the minimum. If <paramref name="MinType"/> is Value, you can just set this to "0".</param>
/// <param name="MinColor">The theme color for the minimum.</param>
/// <param name="MinColorTint">The tint applied to the theme color, ranging from -1.0 to 1.0. Negative tints darken the theme color and positive tints lighten the theme color.</param>
/// <param name="MaxType">The conditional format type for the maximum.</param>
/// <param name="MaxValue">The value for the maximum. If <paramref name="MaxType"/> is Value, you can just set this to "0".</param>
/// <param name="MaxColor">The color for the maximum.</param>
public void SetCustom2ColorScale(SLConditionalFormatMinMaxValues MinType, string MinValue, SLThemeColorIndexValues MinColor, double MinColorTint,
SLConditionalFormatMinMaxValues MaxType, string MaxValue, System.Drawing.Color MaxColor)
{
List<System.Drawing.Color> listempty = new List<System.Drawing.Color>();
SLColor minclr = new SLColor(listempty, listempty);
if (MinColorTint == 0) minclr.SetThemeColor(MinColor);
else minclr.SetThemeColor(MinColor, MinColorTint);
SLColor maxclr = new SLColor(listempty, listempty);
maxclr.Color = MaxColor;
SLColor midclr = new SLColor(listempty, listempty);
this.SetCustomColorScale(MinType, MinValue, minclr, false, SLConditionalFormatRangeValues.Percentile, "", midclr, MaxType, MaxValue, maxclr);
}
/// <summary>
/// Set a custom data bar formatting.
/// </summary>
/// <param name="ShowBarOnly">True to show only the data bar. False to show both data bar and value.</param>
/// <param name="MinLength">The minimum length of the data bar as a percentage of the cell width. The default value is 10.</param>
/// <param name="MaxLength">The maximum length of the data bar as a percentage of the cell width. The default value is 90.</param>
/// <param name="ShortestBarType">The conditional format type for the shortest bar.</param>
/// <param name="ShortestBarValue">The value for the shortest bar. If <paramref name="ShortestBarType"/> is Value, you can just set this to "0".</param>
/// <param name="LongestBarType">The conditional format type for the longest bar.</param>
/// <param name="LongestBarValue">The value for the longest bar. If <paramref name="LongestBarType"/> is Value, you can just set this to "0".</param>
/// <param name="BarColor">The theme color to be used for the data bar.</param>
/// <param name="Tint">The tint applied to the theme color, ranging from -1.0 to 1.0. Negative tints darken the theme color and positive tints lighten the theme color.</param>
public void SetCustomDataBar(bool ShowBarOnly, uint MinLength, uint MaxLength, SLConditionalFormatMinMaxValues ShortestBarType, string ShortestBarValue, SLConditionalFormatMinMaxValues LongestBarType, string LongestBarValue, SLThemeColorIndexValues BarColor, double Tint)
{
List<System.Drawing.Color> listempty = new List<System.Drawing.Color>();
SLColor clr = new SLColor(listempty, listempty);
clr.SetThemeColor(BarColor, Tint);
this.SetCustomDataBar(ShowBarOnly, MinLength, MaxLength, ShortestBarType, ShortestBarValue, LongestBarType, LongestBarValue, clr);
}
