틀 고정

IWorksheetData.freeze를 사용하여 워크시트의 틀 고정 상태를 구성할 수 있습니다. 인터페이스 정의는 다음과 같습니다.

TypeScript
interface IFreeze {  /**   * The number of frozen columns   */  xSplit: number  /**   * The number of frozen rows   */  ySplit: number  /**   * The starting row that can be scrolled (the starting row of the main view area)   */  startRow: number  /**   * The starting column that can be scrolled (the starting column of the main view area)   */  startColumn: number}

예를 들어 B열과 2행을 고정하려면 다음과 같이 구성할 수 있습니다.

JSON
{  "xSplit": 1, // Freeze 1 column, which is column B  "ySplit": 1, // Freeze 1 row, which is row 2  "startRow": 2, // The starting row that can be scrolled is row 3  "startColumn": 2 // The starting column that can be scrolled is column C}

틀 고정 미리보기

가로와 세로로 스크롤하여 고정된 셀을 확인하세요.

ABCDEFGH
1A1B1C1D1E1F1G1H1
2A2B2C2D2E2F2G2H2
3A3B3C3D3E3F3G3H3
4A4B4C4D4E4F4G4H4
5A5B5C5D5E5F5G5H5
6A6B6C6D6E6F6G6H6
7A7B7C7D7E7F7G7H7
8A8B8C8D8E8F8G8H8
9A9B9C9D9E9F9G9H9
10A10B10C10D10E10F10G10H10
11A11B11C11D11E11F11G11H11
12A12B12C12D12E12F12G12H12
13A13B13C13D13E13F13G13H13
14A14B14C14D14E14F14G14H14
15A15B15C15D15E15F15G15H15
16A16B16C16D16E16F16G16H16
17A17B17C17D17E17F17G17H17
18A18B18C18D18E18F18G18H18
{
  "startRow": 1,
  "startColumn": 1,
  "ySplit": 1,
  "xSplit": 1
}

split은 고정할 개수이고 start는 스크롤 영역의 시작 인덱스(0부터)입니다. 앞쪽 행과 열은 현재 보기에 없습니다.

Facade API

FWorksheet 클래스는 워크시트에서 행과 열의 틀 고정 상태를 관리하는 여러 메서드를 제공합니다. 이러한 메서드를 사용하여 고정 창을 설정하고, 가져오고, 해제할 수 있습니다.

틀 고정 설정

TypeScript
const worksheet = univerAPI.getActiveWorkbook().getActiveSheet()worksheet.setFreeze({  xSplit: 1, // Freeze 1 column, which is column B  ySplit: 1, // Freeze 1 row, which is row 2  startRow: 2, // The starting row that can be scrolled is row 3  startColumn: 2, // The starting column that can be scrolled is column C})console.log('The current freeze state:', worksheet.getFreeze())

고정 열 설정

TypeScript
const worksheet = univerAPI.getActiveWorkbook().getActiveSheet()// Set freeze for columns A-Bworksheet.setFrozenColumns(2)

고정 행 설정

TypeScript
const worksheet = univerAPI.getActiveWorkbook().getActiveSheet()// Set freeze for the first 3 rowsworksheet.setFrozenRows(3)

틀 고정 상태 가져오기

TypeScript
const worksheet = univerAPI.getActiveWorkbook().getActiveSheet()const freezeState = worksheet.getFreeze()

고정 열 가져오기

TypeScript
const worksheet = univerAPI.getActiveWorkbook().getActiveSheet()const frozenColumns = worksheet.getFrozenColumns()

고정 행 가져오기

TypeScript
const worksheet = univerAPI.getActiveWorkbook().getActiveSheet()const frozenRows = worksheet.getFrozenRows()

틀 고정 해제

TypeScript
const worksheet = univerAPI.getActiveWorkbook().getActiveSheet()// Cancel all freezesworksheet.cancelFreeze()

이 가이드는 어떠셨나요?

© 2026 DreamNum Co., Ltd.