ExportImageEX(controlNames, exportType, option) Image Added개요'ExportImageEx' API는 보고서 내의 컨트롤들을 이미지 형식으로 내보내는 기능을 제공합니다. 기존의 'ExportImage'함수를 대체하면서 발생하던 오류를 수정한 향상된 API 입니다. 이를 통해 원하는 형식의 확장자로 이미지를 공유하거나 문서화할 수 있습니다. API 구조ExportImageEx(controlNames, exportType, option) | parameter | Data Type | Default Value | 설명 |
|---|
| controlNames | string[] | controlNames | 이미지로 내보내기 할 컨트롤명을 배열로 전달 빈 배열을 전달받으면, 현재 Form 의 전체 컨트롤들을 이미지로 내보낸다 | | exportType | number | 6 | 내보내기 할 파일의 확장자를 전달 ( enum 값 ) | | option | object ( optional ) | { fileName: Matrix.GetReportInfo().NAME, useDocHeaderTitle: true, useProgressBar: true, callbackFunc: null } | 내보내기 할 파일명과 내보내기가 끝난 뒤 실행되는 콜백 함수를 객체의 형태로 전달# useDocHeaderTitle : | Key | Data Type | Default Value | Description |
|---|
| fileName | string | Matrix.GetReportInfo().NAME | 다운로드 되는 파일명 | | useDocHeaderTitle | boolean | true | exportType 유형이 문서형인 경우, 문서 타이틀에 [다운로드 파일명] 과 동일한 제목을 사용할 지 여부 옵션 |
※ 텍스트 변경 불가 | | useProgressBar | boolean | true | 내보내기 하는 중에 ProgressBar 를 띄울지 여부 옵션 | | callbackFunc | null | Function | null | 작업이 마무리 된 후, 호출되는 함수 |
|
| 패널 |
|---|
| borderColor | #dcdcdc |
|---|
| bgColor | #ededed |
|---|
| borderWidth | 1 |
|---|
| titleBGColor | #dcdcdc |
|---|
| borderStyle | solid |
|---|
| title | exportType |
|---|
| ExportImageEx 함수에서 지원하는 exportType 형식입니다. | exportType | 파일 형식 |
|---|
| 2 | Excel | 3 | HML | | 4 | PPT | | 5 | DOC | | 6 | PNG | | 7 | PDF |
|
사용 예시| 코드 블럭 |
|---|
| language | js |
|---|
| theme | Eclipse |
|---|
| title | 예제 코드 |
|---|
| linenumbers | true |
|---|
| function callback(){
console.log('image export operation has been successfully completed !!');
}
/**************************************
* 버튼 컨트롤이 클릭되는 시점에 발생합니다.
* * arguments :
* string Id (Readonly:False) : 컨트롤이름
* string Text (Readonly:False) : 라벨 값
**************************************/
var OnButtonClick = function(sender, args){
Matrix.ExportImageEx(['Chart'], 6, {
fileName: Matrix.GetReportInfo().NAME,
useDocHeaderTitle: true,
useProgressBar: true,
callbackFunc: callback
});
}; |
적용 화면 | 컨트롤 한 개만 출력 | 여러 컨트롤들을 출력 |
|---|
 Image Removed Image Added
이미지 크기는 컨트롤의 크기입니다. |  Image Removed Image Added
이미지 크기는 form의 크기입니다. 또한, 배경색은 form의 배경색과 동일합니다. |
| 정보 |
|---|
| - 기존의 ExportImage 함수도 사용 가능하나, API 문서에는 ExportImageEx 함수만 제공됩니다.
|
| 참고사항 |
|---|
| - Chart 컨트롤을 내보냈을 때 차트의 형태가 제대로 표현되지 않는 경우에는 차트의 Animation 속성을 조절해 주세요.
- HighChart-Ex 컨트롤을 이미지로 내보내기 위해서는 차트 스크립트에 accessibility: { enabled: false } 속성을 추가하셔야 합니다.
|
변경 전/후 제품 버전 | 변경 전(제품 버전) |
|---|
변경 전
|  Image Removed Image Added
다양한 옵션들이 존재했으나 이 옵션들의 목적을 명확하게 이해하기 어렵거나 원활한 작동에 어려움이 있었음 | 변경 후 |
 Image Removed Image Added
목적이 명확하고 실용적인 옵션들을 유지하여 개선함 |
|