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

개발 가이드

개요

한컴 통합문서뷰어

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

한컴 통합문서뷰어 예제

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

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

한컴 계정

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

한컴싸인

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

한글 오토메이션


## Syntax

```js
    HwpCtrl.InsertPicture(path, embeded, sizeoption, reverse, watermark,
      effect, width, height, callback)  
```

## Description

현재 캐럿의 위치에 그림을 삽입합니다.

## Parameters

**path**: 이미지 URL  
**embeded**: 이미지 파일을 문서에 포함할지 여부(true/false)

> 기존 API 사용자와 호환을 위해서 존재하는 Parameter로 true/false 여부와 상관없이 Embeded 방식으로 동작합니다.

**sizeoption**: 삽입할 그림의 크기를 지정하는 옵션  
| sizeoption | 설명 |  
|---|---|  
| 0 | 이미지 원래의 크기로 삽입합니다. width와 height를 지정할 필요가 없습니다. |  
| 1 | width와 height에 지정한 크기로 그림을 삽입합니다. |  
| 2 | width는 셀의 width만큼, height는 셀의 height만큼 확대/축소됩니다. |  
| 3 | 현재 캐럿이 표의 셀 안에 있을 경우, 셀의 크기에 맞춰 원본 이미지의 가로 및 세로의 비율을 동일하게 확대 또는 축소하여 삽입합니다. |

**reverse**: 이미지의 반전 유무(true/false)  
**watermark**: watermark 효과 유무(true/false)  
**effect**: 그림 효과  
| option | 설명 |  
|---|---|  
| 0 | 실제 이미지 그대로 |  
| 1 | 회색조 |  
| 2 | 흑백 효과 |

**width**: 그림의 가로 크기를 지정하며 단위는 mm입니다.  
**height**: 그림의 높이 크기를 지정하며 단위는 mm입니다.  
**callback**: InsertPicture 함수의 동작이 완료되면 수행될 함수입니다.

- ctrl: 성공 시 생성된 컨트롤 객체이며 실패 시 null을 반환합니다.

## Return Value

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

## Remark

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

## Example

1. 예제 스크립트 실행

**결과: 셀에 배경 이미지를 넣고, 제거**
::examplecode
::buttonrunexample

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

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


InsertPicture

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 다운로드

웹한글 기안기 예제