# PasteFocused (cfg)

> `Ctrl + V`로 붙여넣을 때 데이터가 적용되는 행 기준 동작 방식을 설정합니다.
> 붙여넣기 시작 열은 PasteCols 설정에 의해 결정됩니다.
> 붙여넣기 시 반드시 해당 시트에 Focus(현재 활성 셀 또는 행)가 존재해야 합니다.

### 셀 선택 영역(Selection) 붙여넣기 동작

- 여러 셀을 선택한 경우 선택 영역 크기에 맞게 데이터가 잘리거나 반복되어 채워집니다.
- 이 동작은 `0`을 제외한 모든 붙여넣기 모드(`1`~`10`)에서 공통 적용됩니다.

### Type

`number`

### Options

Value | Description
--- | ---
`0` | 붙여넣기 동작을 수행하지 않습니다. 단, 편집 상태에서는 붙여넣기가 가능합니다.
`1` | 포커스된 행에만 붙여넣기 합니다. 붙여넣을 범위에 행이 많으면 초과된 행은 무시됩니다.
`2` | 포커스된 행 기준으로 붙여넣기 합니다. 복사한 데이터가 붙여넣을 범위보다 많더라도 가능한 범위까지 모두 붙여넣기 됩니다. 시트 행 수보다 데이터가 많으면 초과된 데이터는 무시됩니다. 트리 시트에서는 동일 레벨(형제행)에 붙여넣기 되며, 초과 데이터는 무시됩니다.
`3` | 포커스된 행 기준으로 붙여넣기 합니다. 복사한 데이터가 붙여넣을 범위보다 많더라도 가능한 범위까지 모두 붙여넣기 됩니다. 시트 행 수보다 데이터가 많으면 초과된 데이터는 무시됩니다. 트리 시트에서는 레벨과 상관없이 붙여넣기 되며,초과 데이터는 무시됩니다. (`default`)
`4` | 포커스된 행 뒤에 붙여넣을 범위만큼 새 행을 삽입합니다. 포커스 행 자체는 변경되지 않으며, 트리 시트의 경우 같은 레벨로 행을 삽입합니다.
`5` | 포커스된 행 앞에 새 행 하나를 삽입합니다. 붙여넣을 데이터가 많으면 초과된 데이터는 무시됩니다. 포커스 행 자체는 변경되지 않으며, 트리 시트에서는 같은 레벨로 행을 삽입합니다.
`6` | 포커스된 행 앞에 붙여넣을 범위만큼 새 행을 삽입합니다. 포커스 행 자체는 변경되지 않으며, 트리 시트에서는 같은 레벨로 행을 삽입합니다.
`7` | 포커스된 행 앞에 새 행 하나를 삽입합니다. 붙여넣을 데이터가 많으면 초과된 데이터는 무시됩니다. 선택된 행 자체는 변경되지 않으며, 클립보드에 값이 하나만 있으면 해당 셀에 붙여넣습니다. 트리 시트에서는 같은 레벨로 행을 삽입합니다.
`8` | 포커스된 행 앞에 붙여넣을 범위만큼 새 행을 삽입합니다. 선택된 행 자체는 변경되지 않으며, 클립보드에 값이 하나만 있으면 해당 셀에 붙여넣습니다. 트리 시트에서는 같은 레벨로 행을 삽입합니다.
`9` | 포커스된 행 하단으로 붙여넣기 하다가 더 이상 덮어씌울 행이 없으면 행을 추가하여 붙여넣기 합니다. 트리 시트에서는 동일 레벨(형제행)에 붙여넣기하며, 붙여넣을 데이터가 선택 범위보다 많으면 가능한 범위까지만 붙여넣기 되고, 남은 데이터는 최상위 레벨 끝에 추가됩니다.
`10` | 포커스된 행 하단으로 붙여넣기 하다가 더 이상 덮어씌울 행이 없으면 행을 추가하여 붙여넣기 합니다. 트리 시트에서는 레벨과 상관없이 붙여넣기 되며, 남은 데이터는 최상위 레벨 끝에 추가됩니다.

### Example

    options = {
        Cfg :{
          PasteFocused: 6,  // ctrl+v 시 신규행을 추가
        }
    };

### Read More

- CanCopyPaste col
- CopyPasteHidden cfg
- PasteCols cfg
- onAfterPaste event

### Since

product | version | desc
--- | --- | ---
core | 8.0.0.0 | 기능 추가