样式

您可以使用 Style 对象创建样式，也可以使用 Style 对象创建自己的命名样式。样式可以包含边框，颜色和字体等设置。您可以设置单元格，行，列和表单的样式。

单元格样式是根据优先级应用的设置的组合。单元格中的样式具有最高优先级。单元格所在的行的样式是下一个，单元格所在的列的样式是下一个，然后是表单的默认样式。

可以使用 setStyle 方法分配样式对象。使用-1指定整个行或整个列。

设置单元格的样式

您可以使用 setStyle 方法创建样式并将其应用于表格中的单元格。

下图显示了单元格B2中的样式：

示例代码

本示例使用 setStyle 方法将样式分配给单元格。

var style = new GC.Spread.Sheets.Style();
style.backColor = "red";
style.borderLeft = new GC.Spread.Sheets.LineBorder("blue",GC.Spread.Sheets.LineStyle.medium);
style.borderTop = new GC.Spread.Sheets.LineBorder("blue",GC.Spread.Sheets.LineStyle.medium);
style.borderRight = new GC.Spread.Sheets.LineBorder("blue",GC.Spread.Sheets.LineStyle.medium);
style.borderBottom = new GC.Spread.Sheets.LineBorder("blue",GC.Spread.Sheets.LineStyle.medium);
activeSheet.setStyle(1,1,style,GC.Spread.Sheets.SheetArea.viewport);
//行
//activeSheet.setStyle(1,-1,style,GC.Spread.Sheets.SheetArea.viewport);
//列
//activeSheet.setStyle(-1,2,style,GC.Spread.Sheets.SheetArea.viewport);

设置默认样式

您可以使用 SetDefaultStyle 方法为表格中的单元格指定默认样式。

下图显示了单元格的默认样式。

示例代码

本示例使用 setDefaultStyle 方法。

//设置默认样式。
activeSheet.setRowCount(5, GC.Spread.Sheets.SheetArea.viewport);
activeSheet.setColumnCount(5, GC.Spread.Sheets.SheetArea.viewport);
//设置默认样式。
var defaultStyle = new GC.Spread.Sheets.Style();
defaultStyle.backColor = "LemonChiffon";
defaultStyle.foreColor = "Red";
defaultStyle.formatter = "0.00";
defaultStyle.hAlign = GC.Spread.Sheets.HorizontalAlign.center;
defaultStyle.borderLeft = new GC.Spread.Sheets.LineBorder("Green",GC.Spread.Sheets.LineStyle.medium);
defaultStyle.borderTop = new GC.Spread.Sheets.LineBorder("Green",GC.Spread.Sheets.LineStyle.medium);
defaultStyle.borderRight = new GC.Spread.Sheets.LineBorder("Green",GC.Spread.Sheets.LineStyle.medium);
defaultStyle.borderBottom = new GC.Spread.Sheets.LineBorder("Green",GC.Spread.Sheets.LineStyle.medium);
activeSheet.setDefaultStyle(defaultStyle, GC.Spread.Sheets.SheetArea.viewport);
var rowCount = activeSheet.getRowCount();
var colCount = activeSheet.getColumnCount();
for(var i = 0; i < rowCount; i++){
    for(var j = 0; j < colCount; j++){
        activeSheet.setValue(i, j, i+j, GC.Spread.Sheets.SheetArea.viewport);
    }
}

为区域设置样式

您可以使用CellRange的setStyle方法指定样式并将其应用于单元格区域。例如，下图显示了在单元格区域上设置的两种不同样式。

以下代码示例显示了如何在单元格区域中设置样式。

// 在 cellRange 上使用 setStyle 方法
let style1 = new GC.Spread.Sheets.Style();
style1.formatter = "#,##0.00";
style1.backColor = "rgb(124,200,208)";
style1.hAlign = GC.Spread.Sheets.HorizontalAlign.center;
style1.font = "bold 12px sans-serif";
style1.borderLeft = new GC.Spread.Sheets.LineBorder("gray", GC.Spread.Sheets.LineStyle.double);
style1.borderTop = new GC.Spread.Sheets.LineBorder("gray", GC.Spread.Sheets.LineStyle.double);
style1.borderRight = new GC.Spread.Sheets.LineBorder("gray", GC.Spread.Sheets.LineStyle.double);
style1.borderBottom = new GC.Spread.Sheets.LineBorder("gray", GC.Spread.Sheets.LineStyle.double);
activeSheet.getRange("I2:J2").setStyle(style1);

let style2 = new GC.Spread.Sheets.Style();
style2.backColor = "rgb(218, 241, 243)";
style2.borderLeft = new GC.Spread.Sheets.LineBorder("gray", GC.Spread.Sheets.LineStyle.double);
style2.borderTop = new GC.Spread.Sheets.LineBorder("gray", GC.Spread.Sheets.LineStyle.double);
style2.borderRight = new GC.Spread.Sheets.LineBorder("gray", GC.Spread.Sheets.LineStyle.double);
style2.borderBottom = new GC.Spread.Sheets.LineBorder("gray", GC.Spread.Sheets.LineStyle.double);
activeSheet.getRange("I3:J7").setStyle(style2);

设置命名样式

您可以使用 addNamedStyle 方法创建自己的命名样式并将其添加到表单或跨页中。您可以变更样式设置或删除命名的样式。使用 setStyleName 方法在单元格上使用样式。使用-1指定整个行或整个列。

如果一种样式被使用多次或在许多单元格中使用，则命名样式很有用。将命名样式用于JSON数据存储或Excel导入和导出，因为使用的数据较少。

示例代码

以下代码示例使用命名样式来设置表头和表数据的样式。

// 在单元格上使用 setStyleName 方法
let styleCell = new GC.Spread.Sheets.Style();
styleCell.name = "header_style";
styleCell.font = "bold 14px sans-serif";
styleCell.hAlign = GC.Spread.Sheets.HorizontalAlign.center;
styleCell.backColor = "rgb(255, 225, 0)";
styleCell.borderLeft = new GC.Spread.Sheets.LineBorder("purple", GC.Spread.Sheets.LineStyle.hair);
styleCell.borderTop = new GC.Spread.Sheets.LineBorder("purple", GC.Spread.Sheets.LineStyle.hair);
styleCell.borderRight = new GC.Spread.Sheets.LineBorder("purple", GC.Spread.Sheets.LineStyle.hair);
styleCell.borderBottom = new GC.Spread.Sheets.LineBorder("purple", GC.Spread.Sheets.LineStyle.hair);
activeSheet.addNamedStyle(styleCell);
activeSheet.setStyleName(1, 1, "header_style");
activeSheet.setStyleName(1, 2, "header_style");

// 对单元格区域使用 setStyleName 方法
let style = new GC.Spread.Sheets.Style();
style.name = "score_style";
style.font = "italic 12px sans-serif";
style.hAlign = GC.Spread.Sheets.HorizontalAlign.center;
style.backColor = "rgb(255,149,126)";
style.borderLeft = new GC.Spread.Sheets.LineBorder("red", GC.Spread.Sheets.LineStyle.hair);
style.borderTop = new GC.Spread.Sheets.LineBorder("red", GC.Spread.Sheets.LineStyle.hair);
style.borderRight = new GC.Spread.Sheets.LineBorder("red", GC.Spread.Sheets.LineStyle.hair);
style.borderBottom = new GC.Spread.Sheets.LineBorder("red", GC.Spread.Sheets.LineStyle.hair);
activeSheet.addNamedStyle(style);
activeSheet.getRange("B3:C8").setStyleName("score_style");

您还可以设置应用标志，以帮助处理定义的命名样式中不同属性的效果。这提供了一个选项，可以为一个单元格设置多个命名样式，而不影响彼此的格式选项。

下表显示了GC.Spread.Sheets.Style中所有可用的应用标志以及 namedStyle受影响的属性：

应用标志	受影响的属性
applyNumberFormat	formatter
applyFont	foreColor font themeFont textDecoration
applyFill	backColor
applyBorder	borderLeft boderRight borderTop borderBottom diagonalDown diagonalUp
applyAlignment	vAlign hAlign textIndent wordWrap isVerticalText
applyProtection	locked

应用标志的默认值与 true 相同。如果为 namedStyle 定义了值，这些属性将保存在导出的 JSON 中。

示例

例如，可以向单元格中添加两种不同的命名样式，其中“字体样式”控制字体属性，“对齐样式”控制对齐属性；下面的代码示例显示了如何实现相同的功能。

var style = new GC.Spread.Sheets.Style();
style.name = "Font style";
style.font = "Verdana";
style.backColor = "red";
style.formatter = "yyyy/mm/dd";
style.hAlign = GC.Spread.Sheets.HorizontalAlign.center;
style.applyFill = false;
style.applyAlignment = false;
spread.addNamedStyle(style);

var style2 = new GC.Spread.Sheets.Style();
style2.name = "Align style";
style2.font = "Calibri";
style2.backColor = "yellow";
style2.formatter = "dd/mm/yy";
style2.hAlign = GC.Spread.Sheets.HorizontalAlign.right;
style2.wordWrap = false;
style2.applyFont = false;
style2.applyNumberFormat = false;
spread.addNamedStyle(style2);


activeSheet.setStyleName(0, 1, "Font style");
activeSheet.setStyleName(0, 1, "Align style");
//另一种用法
activeSheet.setStyle(0, 0, "Font style");
activeSheet.setStyle(0, 0, "Align style");