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

개발 가이드

개요

한컴 통합문서뷰어

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

한컴 통합문서뷰어 예제

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

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

한컴 계정

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

한컴싸인

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

한글 오토메이션


## Syntax

```js
    HwpCtrl.InitScan(option, rang, spara, spos, epara, epos)
```

## Description

문서 검색을 위한 준비 작업을 수행합니다.

## Parameters

**option**: 다음과 같은 옵션을 지정할 수 있습니다. 0을 지정하면 모두 off되고, 생략하면 0이 지정됩니다.

| ID         | 값   | 설명                                                                                                  |
| ---------- | ---- | ----------------------------------------------------------------------------------------------------- |
| maskNormal | 0x00 | 본문을 대상으로 검색합니다. (하위 목록을 검색하지 않음)                                             |
| maskChar   | 0x01 | char 타입 컨트롤 마스크를 대상으로 합니다. (강제 줄 나눔, 문단 끝, 하이픈, 묶움 빈칸, 고정폭 빈칸 등)    |
| maskInline | 0x02 | inline 타입 컨트롤 마스크를 대상으로 합니다. (누름틀 필드 끝 등)                                    |
| maskCtrl   | 0x04 | extende 타입 컨트롤 마스크를 대상으로 합니다. (다단, 누름틀 필드 시작, Shape Object, 각주, 미주 등) |

**range**: 검색의 범위를 다음과 같은 옵션을 조합하여 지정할 수 있습니다. 생략하면 '문서 시작부터 - 문서의 끝까지' 검색 범위가 지정됩니다.

| ID                  | 값     | 설명                                       |
| ------------------- | ------ | ------------------------------------------ |
| scanSposCurrent     | 0x0000 | 캐럿 위치부터(시작 위치)                 |
| scanSposSpecified   | 0x0010 | spara, spos에 지정한 위치부터(시작 위치) |
| scanSposLine        | 0x0020 | 줄의 시작부터(시작 위치)                 |
| scanSposParagraph   | 0x0030 | 문단의 시작부터(시작 위치)               |
| scanSposSection     | 0x0040 | 구역의 시작부터(시작 위치)               |
| scanSposList        | 0x0050 | 목록의 시작부터(시작 위치)             |
| scanSposControl     | 0x0060 | 컨트롤의 시작부터(시작 위치)             |
| scanSposDocument    | 0x0070 | 문서의 시작부터(시작 위치)               |
| scanEposCurrent     | 0x0000 | 캐럿 위치까지(끝 위치)                   |
| scanEposSpecified   | 0x0001 | epara, epos에 지정한 위치까지(끝 위치)   |
| scanEposLine        | 0x0002 | 줄의 끝까지(끝 위치)                     |
| scanEposParagraph   | 0x0003 | 문단의 끝까지(끝 위치)                   |
| scanEposSection     | 0x0004 | 구역의 끝까지(끝 위치)                   |
| scanEposList        | 0x0005 | 목록의 끝까지(끝 위치)                 |
| scanEposControl     | 0x0006 | 컨트롤의 끝까지(끝 위치)                 |
| scanEposDocument    | 0x0007 | 문서의 끝까지(끝 위치)                   |
| scanWithinSelection | 0x00ff | 검색의 범위를 블록으로 제한               |
| scanForward         | 0x0000 | 정방향(검색 방향)                        |
| scanBackward        | 0x0100 | 역방향(검색 방향)                        |

**spara**: 검색 시작 위치의 문단 번호입니다. scanSposSpecified 옵션이 지정되었을 때만 유효합니다. 
**spos** : 검색 시작 위치의 문단 중 문자의 위치입니다. scanSposSpecified 옵션이 지정되었을 때만 유효합니다.  
**epara**: 검색 끝 위치의 문단 번호입니다. scanEposSpecified 옵션이 지정되었을 때만 유효합니다.  
**epos**: 검색 끝 위치의 문단 중 문자의 위치입니다. scanEposSpecified 옵션이 지정되었을 때만 유효합니다.

## Return Value

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

## Remark

기존 `ActiveX 한글 컨트롤`에서는 포인터를 인자로 받아서 처리했으며, 웹 환경에 맞춰 객체를 반환하는 방식으로 변경되었습니다.

## Example

1. 텍스트 입력
2. 텍스트의 맨 앞으로 캐럿 이동
3. 예제 스크립트 실행

**결과: 현재 캐럿부터 줄의 끝까지 포함된 Text를 가져옴**
::examplecode
::buttonrunexample


InitScan

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

웹한글 기안기 예제