# 기본 용지 크기 및 페이지 설정 단위 구성

## Content

SpreadJS는 현재 문화권을 사용하여 인쇄 설정의 기본 용지 크기를 결정할 수 있습니다. 이를 통해 A4가 일반적으로 사용되는 문화권에서는 A4를 사용하는 것처럼 애플리케이션에서 해당 로캘에 적합한 용지 크기를 사용할 수 있습니다.
또한 용지 크기 및 여백과 같은 페이지 설정 값이 SpreadJS 디자이너 컴포넌트에 표시되는 방식을 구성할 수 있습니다.

## 용지 종류 및 표시 단위

SpreadJS는 인쇄 페이지 설정에 다음 두 가지 관련 설정을 사용합니다.

* **용지 종류 -** 새 용지 크기가 초기화될 때 사용되는 기본 용지 크기를 지정합니다.
* **단위 -** 용지 크기 및 여백과 같은 페이지 설정 값이 디자이너에 표시되는 방식을 지정합니다.

## 문화권별 기본 용지 크기 설정

문화권 정보의 `paperKind` 설정을 사용하여 현재 문화권의 기본 용지 크기를 설정할 수 있습니다. 값에는 [`GC.Spread.Sheets.Print.PaperKind`](/spreadjs/api/v19/enums/GC.Spread.Sheets.Print.PaperKind) 열거형을 사용합니다.

```javascript
GC.Spread.Common.CultureManager.getCultureInfo().paperKind = 
    GC.Spread.Sheets.Print.PaperKind.a4;
```

명시적인 용지 종류를 지정하지 않고 새 용지 크기를 만들면 SpreadJS는 현재 문화권의 용지 종류를 사용합니다. 현재 문화권에 용지 종류가 정의되어 있지 않으면 SpreadJS는 **Letter**를 사용합니다.

```javascript
var paperSize = new GC.Spread.Sheets.Print.PaperSize();
```

문화권 기반 용지 종류는 새 인쇄 설정을 만들 때 초기값으로 사용됩니다. 예를 들어 다음과 같은 경우에 적용됩니다.

* 새 워크시트 또는 시트 탭을 추가하는 경우
* 새 `PrintInfo` 인스턴스를 만드는 경우
* 명시적인 용지 종류를 지정하지 않고 새 `PaperSize` 인스턴스를 만드는 경우

## 기존 시트의 용지 크기 변경

현재 문화권의 용지 종류를 변경해도 이미 초기화된 용지 크기는 업데이트되지 않습니다. 기존 시트는 직접 변경할 때까지 현재 용지 크기를 유지합니다.
기존 시트의 용지 크기를 변경하려면 시트의 인쇄 정보에서 용지 크기를 설정합니다.

```javascript
var sheet = spread.getActiveSheet();
var printInfo = sheet.printInfo();

printInfo.paperSize(new GC.Spread.Sheets.Print.PaperSize(
    GC.Spread.Sheets.Print.PaperKind.a4
));

sheet.printInfo(printInfo);
```

## 디자이너에서 용지 크기 구성

SpreadJS 디자이너 컴포넌트에서는 **페이지 설정** 대화 상자에서 용지 크기를 선택할 수 있습니다.
![image-20260709.e46c54.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/36b63360-fb01-457c-a448-c3ce32aaf454/image-20260709.e46c54-20260821.b52e4c.png?width=800)
용지 크기를 구성하려면 다음 단계를 따릅니다.

1. **페이지 레이아웃** 탭을 엽니다.
2. **페이지 설정** 그룹에서 **페이지 설정** 대화 상자를 엽니다.
3. **페이지** 탭의 **용지 크기**에서 값을 선택합니다.
4. **확인**을 클릭합니다.

선택한 용지 크기가 현재 시트의 인쇄 설정에 적용됩니다.

## 프로그래밍 방식으로 페이지 설정 표시 단위 설정

[`setData`](/spreadjs/api/v19/designer/classes/GC.Spread.Sheets.Designer.Designer#setdata)를 사용하여 디자이너의 페이지 설정 표시 단위를 프로그래밍 방식으로 설정할 수 있습니다.

```javascript
designer.setData("PageSetupDisplayUnit", "Centimeters");
```

유효한 값은 다음과 같습니다.

* `"Inches"`
* `"Centimeters"`
* `"Millimeters"`

값이 유효하지 않으면 디자이너는 `"Inches"`를 사용합니다.
이 설정은 디자이너의 표시 단위에만 영향을 줍니다. 실제 용지 크기나 여백 값은 변경하지 않습니다.
선택한 단위는 **크기** 및 **여백** 메뉴, **페이지 설정** 대화 상자, **파일** \> **인쇄** 보기를 비롯하여 디자이너에서 용지 크기 및 여백 값이 표시되는 방식에 영향을 줍니다.

```auto
8.5" x 11"
21.59 cm x 27.94 cm
0.75"
1.91 cm
```

>type=note
> **참고:** **밀리미터**를 선택하면 드롭다운 또는 인쇄 미리 보기 영역의 용지 크기 및 여백 설명과 같은 일부 요약 표시에서 이에 해당하는 센티미터 값이 표시될 수 있습니다. **페이지 설정** 대화 상자의 여백 입력 필드에는 밀리미터 값이 표시될 수 있습니다.

## 가져오기 및 내보내기 동작

**SSJSON** 및 **SJS** 파일의 경우 용지 크기 정보가 파일에 이미 저장되어 있으면 해당 정보가 파일에서 복원됩니다.
Excel에서 가져올 때 SpreadJS는 파일에 저장된 용지 크기가 있는 경우 해당 크기를 사용합니다. 파일에 페이지 설정 정보가 포함되어 있지 않으면 SpreadJS는 현재 문화권의 용지 종류를 기본값으로 사용합니다. 파일에 페이지 설정 정보가 있지만 용지 크기가 지정되어 있지 않으면 SpreadJS는 **Letter**를 사용합니다.
Excel로 내보낼 때 SpreadJS는 용지 크기 정보를 내보낸 파일에 기록합니다.

## 참고

* 문화권 기반 용지 종류는 용지 크기 설정이 새로 초기화될 때만 사용됩니다.
* 문화권의 용지 종류가 변경되어도 기존 시트의 인쇄 설정은 자동으로 업데이트되지 않습니다.
* 현재 문화권에 용지 종류가 정의되어 있지 않으면 SpreadJS는 **Letter**를 사용합니다.
* 페이지 설정 표시 단위는 디자이너의 표시 값에만 영향을 줍니다.