다양한 유형의 파일을 원하는 형식으로 변환하는 솔루션입니다. 신속하고 편리하게 높은 품질의 문서 변환 서비스를 만들어 보세요.

개발 가이드

개요

한컴 통합문서뷰어

한컴 통합문서뷰어의 API를 직접 호출하여 결과를 확인해 보세요.

한컴 통합문서뷰어 예제

개발자와 의견을 나누고 문제를 해결하거나 제품을 구매하여 활용해 보세요!

한컴 로그인은 한글과컴퓨터 서비스에서 제공하는 OAuth2.0 기반의 간편 로그인 기능입니다.

한컴 계정

한컴싸인에서 제공하는 Webhook/API 사용 방법에 대한 가이드입니다. Webhook/API를 통해 한컴싸인을 쉽고 빠르게 연동하여 사용할 수 있습니다.

한컴싸인

OLE Automation을 통해 한글 프로그램을 자동화하는 방법에 대한 가이드입니다. 외부 클라이언트에서 OLE(COM) Object를 이용하여 한글 기능을 실행하거나 문서를 제어할 수 있습니다.

한글 오토메이션


## Syntax

```js
    HwpCtrl.InsertBackgroundPicture(bordertype, path, embedded, filloption,
     watermark, effect, brightnss, contrast, callback)  
```

## Description

배경 이미지를 삽입합니다.

## Parameters

**bordertype**: 배경 유형을 지정

| bordertype           | 설명                                   | 비고                                                                      |
| -------------------- | -------------------------------------- | ------------------------------------------------------------------------- |
| "SelectedCell"       | 현재 선택된 표의 셀 배경을 변경합니다. |                                                                           |
| "SelectedCellDelete" | 현재 선택된 표의 셀 배경을 지웁니다.   | 반드시 셀이 선택되어야 하며 커서가 위치하는 것만으로는 동작하지 않습니다. |

**path**: 이미지 URL  
**embeded**: 이미지 파일을 문서에 포함할지 여부( `Boolean` Type ).

> 기존 ActiveX 한글 컨트롤과 호환을 위해서 존재하는 인자로 true/false 여부와 상관없이 Embeded 방식으로 동작합니다.

**filloption**: 삽입할 그림의 크기를 지정하는 옵션

| filloption | 설명                       | 비고                      |
| ---------- | -------------------------- | ------------------------- |
| 0          | 바둑판식으로 - 모두        |                           |
| 1          | 바둑판식으로 - 가로/위     |                           |
| 2          | 바둑판식으로 - 가로/아래   |                           |
| 3          | 바둑판식으로 - 세로/왼쪽   |                           |
| 4          | 바둑판식으로 - 세로/오른쪽 |                           |
| 5          | 크기에 맞추어              | 설정하지 않았을 때 기본값 |
| 6          | 가운데로                   |                           |
| 7          | 가운데 위로                |                           |
| 8          | 가운데 아래로              |                           |
| 9          | 왼쪽 가운데로              |                           |
| 10         | 왼쪽 위로                  |                           |
| 11         | 왼쪽 아래로                |                           |
| 12         | 오른쪽 가운데로            |                           |
| 13         | 오른쪽 위로                |                           |
| 14         | 오른쪽 아래로              |                           |

**effect**: 이미지 효과

| effect | 설명          | 비고                      |
| ------ | ------------- | ------------------------- |
| 0      | 원래 그림     | 설정하지 않았을 때 기본값 |
| 1      | 회색조        |                           |
| 2      | 흑백으로      |                           |

**watermark**: watermark 효과 유무( `Boolean` Type )를 나타내며 true인 경우 brightness와 contrast 옵션이 무시됨
**brightness**: 밝기 지정(-100 ~ 100), 기본값: 0  
**contrast**: 선명도 지정(-100 ~ 100), 기본값: 0  
**callback**: InsertBackgroundPicture 함수의 동작이 완료되면 수행될 함수

- parameter  
  result: 성공 시 true를 반환하고, 실패 시 false를 반환합니다.

## Return Values

성공 시 true를 반환하고, 실패 시 false를 반환합니다.

## Remark

브라우저에서는 로컬 파일 접근 권한이 없어 로컬 파일은 사용할 수 없습니다.

## Example

1. 표 생성
2. 셀 안으로 캐럿 이동
3. 예제 스크립트 실행

**결과: 셀에 배경 이미지 삽입**
::examplecode
::buttonrunexample

> **스크립트 실행 전**  
> ![Alt 스크립트 실행 전](/images/webhwp/InsertBackgroundPicture_1.png)

> **스크립트 실행 후**  
> ![Alt 스크립트 실행 후](/images/webhwp/InsertBackgroundPicture_2.png)


InsertBackgroundPicture

URI의 구성

변환 쌍 및 모듈명과 변환 API

매개 변수

응답 형식

응답 코드

문서 변환 API

file_path

ext_to

error code

HTML 문서 뷰어 API

릴리즈 노트

docsconverter

공통 가이드 

한컴 OAuth 로그인 

디자인 리소스 

hancomaccount

Webhook

hancomsign-api

구성/구조/지원되는 파일 형식

한글 컨트롤(ActiveX 기반) 대비 API 변경 사항

웹한글 기안기 API 기본 사용법

Properties

Methods

Action

CtrlCode

ParameterSet

ParameterArray

HwpCtrl

webhwp

한컴디벨로퍼

데스크톱에 한컴오피스 한글을 설치하지 않아도 웹 브라우저에 접속하여 한글 프로그램을 사용할 수 있습니다. 전자 결재를 상신하거나 양식 문서 또는 각종 보고서를 작성하는 시스템과 연동하여 활용해 보세요.

웹한글 기안기

웹한글 기안기의 API 예제를 직접 작성하여 결과를 확인해 보세요. 활용 가능한 API 정보는 문서 > 개발 가이드 →를 통해 확인할 수 있습니다.

PDF 다운로드

웹한글 기안기 예제