ExportImageEX(controlNames, exportType, option)개요'ImageExportExExportImageEx' API는 보고서 내의 컨트롤들을 이미지 형식으로 내보내는 기능을 제공합니다. 기존의 'ImageExportExportImage'함수를 대체하면서 대체하면서 발생하던 오류를 수정한 향상된 API 입니다. 이를 통해 원하는 형식의 확장자로 이미지를 공유하거나 문서화할 수 있습니다. API 구조ExportImageEx(controlNames, exportType, option) parameter | Data Type | 설명 |
---|
controlNames | string[] | 이미지로 내보내기 할 컨트롤명을 배열로 전달 빈 배열을 전달받으면, 현재 Form 의 전체 컨트롤들을 이미지로 내보낸다 | exportType | number | 내보내기 할 파일의 확장자를 전달 ( enum 값 ) | option | object ( optional ) | 객체의 형태로 내보내기 할 파일명과 내보내기가 끝난 뒤 실행되는 콜백 함수를 전달 { fileName: '파일명', callbackFunc: null } |
패널 |
---|
borderColor | #dcdcdc |
---|
borderWidth | 1 |
---|
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,
callbackFunc: callback
});
}; |
적용 화면
정보 |
---|
| - 기존의 ExportImage 함수도 사용 가능하나, API 문서에는 ExportImageEx 함수만 제공됩니다.
|
참고사항 |
---|
| - Chart 컨트롤을 내보냈을 때 차트의 형태가 제대로 표현되지 않는 경우에는 Animation 속성을 조절해 주세요.
- HighChart-Ex 컨트롤을 이미지로 내보내기 위해서는 accessibility: false 속성을 추가하셔야 합니다.
|
변경 전/후 제품 버전 | 변경 전(제품 버전) |
---|
변경 전
|
다양한 옵션들이 존재했으나 이 옵션들의 목적을 명확하게 이해하기 어렵거나 원활한 작동에 어려움이 있었음 | 변경 후 |
목적이 명확하고 실용적인 옵션을 유지하여 개선함 |
|