使用单元格

SpreadJS 允许您在单元格上执行各种操作，如下所述:

获取和设置单元格值

此示例获取并设置单元格值。

$(document).ready(function ()
{
    var spread =
    new GC.Spread.Sheets.Workbook(document.getElementById("ss"),{sheetCount:3});
    var sheet = spread.getActiveSheet();
    sheet.getCell(0, 0).formatter("0.00_);(0.00)");
    sheet.getCell(1, 0).formatter("0.00_);(0.00)");
    sheet.getCell(0, 1).formatter("0.00_);(0.00)");
    sheet.getCell(1, 1).formatter("0.00_);(0.00)");
   
    // 设置文本属性的值
    sheet.getCell(0, 0).text("10");
   
    //通过调用SetText方法设置值
    sheet.setText(1, 0, "10");
   
    //使用Value属性设置值
    sheet.getCell(0, 1).value(10);
   
    //通过调用SetValue方法设置值。
    sheet.setValue(1, 1, 10);

    //获取单元格值
    $("#button1").click(function()
     {
       alert("Obtaining cell values by referring to Text property: " +
       sheet.getCell(0, 0).text() + "\n" +
       "Obtaining cell values by calling GetText method: " + sheet.getText(1, 0) + "\n" +
       "Obtaining cell values by referring to Value property: " +
       sheet.getCell(0, 1).value() + "\n" +
       "Obtaining cell values by calling GetValue method: " + sheet.getValue(1, 1));
     });

});

获取和设置单元格的默认值（v16.2）

当单元格中没有值时，在 SpreadJS 中它显示为空白。为了管理这种情况，SpreadJS 允许您设置单元格的默认值。您可以将任何值或公式设置为单元格的默认值。设置单元格的默认值与设置单元格公式的方式相同。默认值只能针对工作表中的视口区域进行设置，但无法为整行或整列设置默认值。

请注意，当单元格为空并且已经设置了默认值时，以下条件适用：

只有该单元格的默认值或默认公式将包括在重新计算中。
在编辑模式下，单元格显示默认值或使用默认公式重新计算的值。
导出到Excel时，默认值将导出为单元格值。
用户可以更改单元格值，但不会覆盖默认值。

您可以使用以下方法设置或获取单元格的默认值。

使用 GC.Spread.Sheets.CellRange 类的defaultValue方法。

// 使用defaultValue()方法设置或获取单元格的默认值/公式
   activeSheet.getCell(0, 0).defaultValue(20);
   console.log("使用defaultValue方法获取单元格(0,0)的默认值：" + activeSheet.getCell(0, 0).defaultValue());
   activeSheet.getCell(0, 1).defaultValue("=IF(A1>10, A1*3)");
   console.log("使用defaultValue方法获取单元格(0,1)的默认值：" + activeSheet.getCell(0, 1).defaultValue());

使用 GC.Spread.Sheets.Worksheet 类的getDefaultValue和setDefaultValue方法。

// 使用setDefaultValue或getDefaultValue()方法设置或获取单元格的默认值/公式
   activeSheet.setDefaultValue(0, 0, 20);
   activeSheet.setDefaultValue(1, 0, 40);
   console.log("使用getDefaultValue方法获取单元格(0,0)的默认值：" + activeSheet.getDefaultValue(0, 0));
   activeSheet.setDefaultValue(2, 0, "=SUM(A1,A2)");
   console.log("使用getDefaultValue方法获取单元格(2,0)的默认值：" + activeSheet.getDefaultValue(2, 0));

此外，您还可以使用 CopyToOptions 枚举的defaultValue选项复制单元格的默认值。

// 使用CopyToOption枚举复制单元格的默认值/公式。
   activeSheet.getCell(0, 0).defaultValue("2048");
   activeSheet.copyTo(0, 0, 1, 1, 2, 2, GC.Spread.Sheets.CopyToOptions.defaultValue);
   activeSheet.getCell(0, 1).defaultValue("=A1 + 1000");
   activeSheet.copyTo(0, 1, 1, 1, 2, 2, GC.Spread.Sheets.CopyToOptions.defaultValue);

注意： 当将公式设置为单元格的默认值时，SpreadJS不支持动态数组和数组公式。在此情况下，单元格中只显示左上角的值。

使用设计器

您可以使用 SpreadJS 设计器来设置默认单元格值，方法是在单元格的上下文菜单中选择“Default Value...”选项。这将打开“Default Value Dialog”，您可以在其中设置所选单元格的默认值。设置完默认值后，对话框会显示单元格的默认值。

以下演示了如何使用设计器设置默认单元格值。

SetDefaultCellValue.5e8159

设置活动单元格

此示例设置活动单元格。

$("#button1").click(function ()
{  
     // 将单元格(3,3)设置为活动单元格
     activeSheet.setActiveCell(3, 3);
 });

设置活动单元格的位置

此示例设置活动单元格的位置。

$("#button1").click(function ()
{
   // 将单元格(3,3)设置为活动单元格
   sheet.setActiveCell(3, 3);
    
   // 在左上角显示活动单元格
   sheet.showCell(3, 3,
    GC.Spread.Sheets.VerticalPosition.top,
    GC.Spread.Sheets.HorizontalPosition.left);
});

选择多个单元格

本示例创建了多个选择。

$(document).ready(function ()
{
    var spread =
    new GC.Spread.Sheets.Workbook(document.getElementById("ss"),{sheetCount:3});
    var sheet = spread.getActiveSheet();
   
    // 允许选择多个范围
    sheet.selectionPolicy(GC.Spread.Sheets.SelectionPolicy.MultiRange);
   
    // 创建两个不同的选择范围。
    sheet.addSelection(0, 0, 2, 2);
    sheet.addSelection(3, 3, 2, 2);
});

获取所选单元格范围

此示例获取选择的范围。

window.onload = function()
{
   var spread =
   new GC.Spread.Sheets.Workbook(document.getElementById("ss"),{sheetCount:3});
   var activeSheet = spread.getActiveSheet();
   activeSheet.setRowCount(5);
   activeSheet.setColumnCount(5);
   $("#button1").click(function()
   {       
     // 获取选择范围
     var selectedRanges = spread.getActiveSheet().getSelections();
     for(var i = 0; i < selectedRanges.length; i++)
        {
             console.log("---------------------------");
             console.log("Using Range class");
             console.log("-------------------------");
             console.log("Selected top row index: " + selectedRanges[i].row);
             console.log("Number of selected rows: " + selectedRanges[i].rowCount);
             console.log("Selected first column index: " + selectedRanges[i].col);
             console.log("Number of selected columns: " + selectedRanges[i].colCount);
         }
   });
}

设置单元格的条件格式

这个示例为单元格设置了条件格式样式

window.onload = function()
{
  var spread =
  new GC.Spread.Sheets.Workbook(document.getElementById("ss"),{sheetCount:3});
  var activeSheet = spread.getActiveSheet();

  // 创建各自的条件样式。
  var styleBlue = new GC.Spread.Sheets.Style();
  var stylePink = new GC.Spread.Sheets.Style();
  var styleLime = new GC.Spread.Sheets.Style();
  var styleYellow = new GC.Spread.Sheets.Style();
  var styleEmpty = new GC.Spread.Sheets.Style();
  styleBlue.backColor = "blue";
  styleBlue.foreColor = "white";
  stylePink.backColor = "pink";
  styleLime.backColor = "lime";
  styleYellow.backColor = "yellow";
  styleEmpty.backColor = undefined;
  styleEmpty.foreColor = undefined;

  // 为各自的单元格设置条件格式。
  activeSheet.conditionalFormats.addCellValueRule(
  GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.EqualsTo,
  0, undefined, styleEmpty,
  [new GC.Spread.Sheets.Range(1, 1, 1, 1)]);
  activeSheet.conditionalFormats.addCellValueRule(
  GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.LessThan,
  10,undefined,styleBlue,
  [new GC.Spread.Sheets.Range(1, 1, 1, 1)]);
  activeSheet.conditionalFormats.addCellValueRule(
  GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.Between,
  20,50,stylePink,
  [new GC.Spread.Sheets.Range(2, 1, 1, 1)]);
  activeSheet.conditionalFormats.addCellValueRule(
  GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.Between,
  50,80,styleLime,
  [new GC.Spread.Sheets.Range(3, 1, 1, 1)]);
  activeSheet.conditionalFormats.addCellValueRule(
  GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.GreaterThan,
  80, undefined, styleYellow,
  [new GC.Spread.Sheets.Range(4, 1, 1, 1)]);
  activeSheet.getCell(2, 1).value(25);
  activeSheet.getCell(3, 1).value(77);
  activeSheet.getCell(4, 1).value(88);
}

获取单元格的位置和大小

此示例获取特定单元格的位置和大小。

spread.getActiveSheet().bind(GC.Spread.Sheets.Events.CellClick, function (e, info)
{
     if(info.sheetArea ===GC.Spread.Sheets.SheetArea.viewport)
   {
     console.log("Clicked cell index (" + info.row + "," + info.col + ")");
    
     /* 获取指定的索引位置单元格的坐标信息
        */

     var cellRect = spread.getActiveSheet().getCellRect(info.row, info.col);
     console.log("X coordinate:" + cellRect.x);
     console.log("Y coordinate:" + cellRect.y);
     console.log("Cell width:" + cellRect.width);
     console.log("Cell height:" + cellRect.height);
     }
 });

鼠标点击获得单元格索引

单击单元格时可以获得单元格索引。

var spread = new GC.Spread.Sheets.Workbook($("#ss")[0]);
var activeSheet = spread.getActiveSheet();
$("#ss").click(function (e)
{
    
  /* 鼠标点击普通单元格点获取单元格索引
    既不是固定的行/列，也不是行/列标题。*/

     var offset = $("#ss").offset();
     var x = e.pageX - offset.left;
     var y = e.pageY - offset.top;
     var target = spread.getActiveSheet().hitTest(x, y);
     if(target &&
     (target.rowViewportIndex === 0 || target.rowViewportIndex === 1) &&
     (target.colViewportIndex === 0 || target.colViewportIndex === 1))
     {
         console.log("Row index of mouse-clicked cells: " + target.row);
         console.log("Column index of mouse-clicked cells: " + target.col);
     }
});