Excel.WorksheetFreezePanes class
属性
| context | 与对象关联的请求上下文。 这将加载项的进程连接到 Office 主机应用程序的进程。 |
方法
| freeze |
设置活动工作表视图中的冻结单元格。 提供的范围对应于将在最顶部和最左侧窗格中冻结的单元格。 |
| freeze |
将工作表的第一列或第一列固定到位。 |
| freeze |
将工作表的首行或多行冻结到位。 |
| get |
获取用于描述活动工作表视图中的冻结单元格的区域。 冻结范围对应于在最顶部和最左侧窗格中冻结的单元格。 |
| get |
获取用于描述活动工作表视图中的冻结单元格的区域。 冻结范围对应于在最顶部和最左侧窗格中冻结的单元格。 如果没有冻结窗格，则此方法将返回其 |
| toJSON() | 覆盖 JavaScript |
| unfreeze() | 移除工作表中的所有冻结窗格。 |
属性详细信息
context
方法详细信息
freezeAt(frozenRange)
设置活动工作表视图中的冻结单元格。 提供的范围对应于将在最顶部和最左侧窗格中冻结的单元格。
freezeAt(frozenRange: Range | string): void;参数
- frozenRange
-
Excel.Range | string
表示要冻结 null 或删除所有冻结窗格的单元格的区域。
返回
void
注解
示例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-freeze-panes.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
// Freeze the specified range in top-and-left-most pane of the worksheet.
sheet.freezePanes.freezeAt(sheet.getRange("H2:K5"));
await context.sync();
});
freezeColumns(count)
将工作表的第一列或第一列固定到位。
freezeColumns(count?: number): void;参数
- count
-
number
要冻结的列数（可选），或为零以取消冻结所有列
返回
void
注解
示例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-freeze-panes.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
// Freeze the first two columns in the worksheet.
sheet.freezePanes.freezeColumns(2);
await context.sync();
});
freezeRows(count)
将工作表的首行或多行冻结到位。
freezeRows(count?: number): void;参数
- count
-
number
可选行数以冻结，或零以取消冻结所有行
返回
void
注解
示例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-freeze-panes.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
// Freeze the top two rows in the worksheet.
sheet.freezePanes.freezeRows(2);
await context.sync();
});
getLocation()
获取用于描述活动工作表视图中的冻结单元格的区域。 冻结范围对应于在最顶部和最左侧窗格中冻结的单元格。
getLocation(): Excel.Range;返回
注解
getLocationOrNullObject()
获取用于描述活动工作表视图中的冻结单元格的区域。 冻结范围对应于在最顶部和最左侧窗格中冻结的单元格。 如果没有冻结窗格，则此方法将返回其 isNullObject 属性设置为 true的对象。 有关详细信息，请参阅 *OrNullObject 方法和属性。
getLocationOrNullObject(): Excel.Range;返回
注解
示例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-freeze-panes.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
const frozenRange = sheet.freezePanes.getLocationOrNullObject();
frozenRange.load("address");
await context.sync();
if (frozenRange.isNullObject) {
console.log(`The worksheet does not contain a frozen pane.`);
} else {
console.log(`The address of the frozen range (cells that are frozen in the top-and-left-most pane) is "${frozenRange.address}"`);
}
});
toJSON()
覆盖 JavaScript toJSON() 方法，以便在将 API 对象传递给 JSON.stringify()时提供更有用的输出。 (JSON.stringify反过来调用 toJSON 传递给它的对象的方法。) 虽然原始 Excel.WorksheetFreezePanes 对象是 API 对象， toJSON 但该方法返回一个纯 JavaScript 对象， (类型化为 Excel.Interfaces.WorksheetFreezePanesData) ，其中包含从原始对象加载的任何子属性的浅层副本。
toJSON(): {
[key: string]: string;
};返回
{ [key: string]: string; }
unfreeze()
移除工作表中的所有冻结窗格。
unfreeze(): void;返回
void
注解
示例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/54-worksheet/worksheet-freeze-panes.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
sheet.freezePanes.unfreeze();
await context.sync();
});