4.自定义批注.md

自定制批注

你可以定制批注, 比如格式化批注的文本，设置批注的边框、位置、大小等等。

在你添加批注之前, 你可以使用 text 方法来设置文本。批注的位置和大小也能够设置。比如：

comment.text('new comment!');
comment.location(new Excel.View.Sheets.Point(62, 20));
comment.width(200);
comment.height(100);

如果你在调整行高或者列宽的时候, 不想要批注的位置以及大小跟着调整， 你可以使用 dynamicMove 和 dynamicSize 方法来设置，例如：

comment.dynamicMove(false);
comment.dynamicSize(false);

如果批注的 dynamicMove 设置是 false 并且 dynamicSize 设置是 true，则不会有任何影响。

在你编辑完批注的文本后，你可以格式化文本, 比如字体, 文本修饰等，比如：

comment.fontFamily('sans-serif');
comment.fontStyle('italic');
comment.fontSize('10pt');
comment.foreColor('red');
comment.backColor('green');
comment.opacity(0.5);
comment.textDecoration(Excel.View.Sheets.TextDecorationType.underline);
comment.horizontalAlign(Excel.View.Sheets.HorizontalAlign.left);
var padding1 = new Excel.View.Sheets.Padding(10, 20, 30, 40);
comment.padding(padding1);
comment.autoSize(true);

你可以给批注添加一个边框， 批注的边框设置格式类似于标准 DOM 的边框设置。例如：

comment.borderStyle('dotted');
comment.borderWidth(5);
comment.borderColor('red');

当批注互相叠加的时候，你可以通过 zIndex 来设置批注的层叠顺序。

comment1.zIndex(100);
comment2.zIndex(101);

如果你不想要用户通过用户界面来改变批注，你可以使用 lock 方法来锁定它。 不过在锁定批注之前，你需要锁定表单。 如果你仅仅是不想要用户编辑文本，你可以使用 lockText 方法来锁定文本。

sheet.options.isProtected = true;
comment.lock(true);
comment.lockText(true);