개요
ExcelExportObject 에서 ExportItemType 별로 추가할 아이템 정보를 갖는 오브젝트입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성
exceptstyle
Grid 에 적용된 CSS 관련 속성 중 Export 시 제외할 속성을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
strExceptStyle ::= <Exceptlist> | <Exceptlist> ',' strExceptStyle <Exceptlist> ::= 'none' | 'align' | 'background' | 'color' | 'font' | 'border' * 각 설정값을 콤마(",")로 구분하여 중복 설정할 수 있습니다. | ||
var objExpItem = new ExportItem(); objExpItem.exceptstyle = "color,background"; | ||
"none" | Export 에서 제외되는 속성이 없습니다. | |
|---|---|---|
"align" | Align 관련 -nexa-text-align, -nexa-vertical-align 속성값이 Export 에서 제외됩니다. | |
"background" | background 의 color 관련 속성값이 Export 에서 제외됩니다. | |
"color" | color 속성값이 Export 에서 제외됩니다. | |
"font" | font 속성값이 Export 에서 제외됩니다. | |
"border" | -nexa-border 속성값이 Export 에서 제외됩니다. | |
참고
- exceptstyle 속성값을 설정하지 않으면 "none" 으로 적용됩니다.
exporthead
Grid 의 Head, Summary 영역에 대한 Export 방식을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☑ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
enumExportHead ::= 'allband' | 'nohead' | 'nosumm' | 'nohead,nosumm' | ||
var objExpItem = new ExportItem(); objExpItem.exporthead = "nosumm"; | ||
"allband" | Grid 의 Head, Summary 영역을 모두 Export 합니다. | |
|---|---|---|
"nohead" | Grid 의 Head 영역은 Export 하지 않고, Summary 영역만 Export 합니다. | |
"nosumm" | Grid 의 Head 영역만 Export 하고, Summary 영역은 Export 하지 않습니다. | |
"nohead,nosumm" | Grid 의 Head, Summary 영역을 모두 Export 하지 않습니다. | |
참고
- exporthead 속성값을 설정하지 않으면 ExportItem 의 exportselect 속성값이 "allrecord" 인 경우 "allband" 로 적용됩니다. exporthead 속성값을 설정하지 않으면 ExportItem 의 exportselect 속성값이 "selectrecord" 인 경우 "nohead,nosumm" 으로 적용됩니다. - Grid 의 selecttype 속성값이 "area", "multiarea" 인 경우 exporthead 속성값 설정여부와 관계없이 항상 "nohead,nosumm" 으로 적용됩니다.
exportimage
Grid 의 Cell 에 설정된 이미지의 Export 방식을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☑ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
enumExportImage ::= 'none' | 'url' | 'image' | ||
var objExpItem = new ExportItem(); objExpItem.exportimage = "url"; | ||
"none" | 설정된 이미지 정보를 무시하고 공백으로 Export 합니다. | |
|---|---|---|
"url" | 설정된 이미지의 위치정보를 URL 형식의 문자열로 Export 합니다. | |
"image" | 설정된 이미지의 위치가 "http://", "https://" 로 시작하는 인터넷 URL 경로일 경우만 이미지를 그대로 Export 합니다. | |
참고
- exportimage 속성값을 설정하지 않으면 "none" 으로 적용됩니다.
활용 예제
exportmerge
Grid 에서 포맷과 관계없이 논리적으로 병합된 Cell 의 Export 방식을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☑ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
enumExportMerge ::= 'suppress' | 'nosuppress' | 'merge' | ||
var objExpItem = new ExportItem(); objExpItem.exportmerge = "merge"; | ||
"suppress" | 논리적으로 병합된 결과를 무시하고 각 Cell 을 분할하여 Export 합니다. 논리적으로 병합된 결과에 맞게 1개 Cell 에만 값을 Export 합니다. 나머지 Cell 은 공백값을 Export 합니다. | |
|---|---|---|
"nosuppress" | 논리적으로 병합된 결과를 무시하고 각 Cell 을 분할하여 Export 합니다. 논리적으로 병합된 결과에 따라 각 Cell 에 동일값을 Export 합니다. | |
"merge" | 논리적으로 병합된 결과에 맞게 Cell 을 병합하여 Export 합니다. 논리적으로 병합된 결과에 맞게 1개 Cell 로 값을 Export 합니다. | |
참고
- exportmerge 속성값을 설정하지 않으면 "suppress" 로 적용됩니다. exportselect 속성값을 "selectrecord" 로 설정한 경우는 항상 "nosuppress" 로 적용됩니다. - 논리적인 병합이란 suppress 속성 또는 mergeCell() 메소드에 의해 Grid 에 표시된 데이터가 병합된 것을 의미합니다. - suppresshorzcell 속성으로 병합된 Cell 은 항상 "suppress" 형태로 Export 됩니다. - mergeContentsCell() 메소드 또는 Grid Contents Editor 의 Merge Cells 기능으로 포맷이 병합된 Cell 은 exportmerge 속성이 적용되지 않습니다.
exportselect
Grid 에서 Export 시킬 영역을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☑ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
enumExportSelect ::= 'allrecord' | 'selectrecord' | ||
var objExpItem = new ExportItem(); objExpItem.exportselect = "selectrecord"; | ||
"allrecord" | Grid 의 모든 Row 를 Export 합니다. | |
|---|---|---|
"selectrecord" | Grid 에서 선택된 Row 또는 Cell 만 Export 합니다. Grid 의 selecttype 속성값이 "row" 또는 "multirow" 일 경우 선택된 Row 만 Export 됩니다. Grid 의 selecttype 속성값이 "cell", "area", "multiarea" 일 경우 선택된 Cell 만 Export 됩니다. | |
참고
- exportselect 속성값을 설정하지 않으면 "allrecord" 로 적용됩니다. - exportselect 속성값을 "allrecord" 로 지정시, ExportItem 의 exporthead 속성값이 설정되지 않으면 "allband" 로 적용됩니다. exportselect 속성값을 "selectrecord" 로 지정시, ExportItem 의 exporthead 속성값이 설정되지 않으면 "nohead,nosumm" 으로 적용됩니다. - Grid 의 selecttype 속성값이 "area", "multiarea" 인 경우 ExportItem 의 exporthead 속성값 설정여부와 관계없이 항상 "nohead,nosumm" 으로 적용됩니다.
exportvalue
엑셀 파일로 Export 시킬 경우 Export 되는 내용과 형식을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☑ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
enumExportValue ::= 'allstyle' | 'selectstyle' | ||
var objExpItem = new ExportItem(); objExpItem.exportvalue = "selectstyle"; | ||
"allstyle" | value, format, calendardateformat, font, color, background(color), -nexa-text-aign, -nexa-vertical-align, -nexa-border 속성의 설정이 모두 Export 됩니다. 선택된 영역이 있을 경우 선택에 의해 변경된 설정은 Export 되지 않습니다. | |
|---|---|---|
"selectstyle" | value, format, calendardateformat, font, color, background(color), -nexa-text-aign, -nexa-vertical-align, -nexa-border 속성의 설정이 모두 Export 됩니다. 선택된 영역이 있을 경우 선택에 의해 변경된 설정도 Export 됩니다. | |
참고
- exportvalue 속성값을 설정하지 않으면 "allstyle" 로 적용됩니다. - background 속성에 Gradation 이 지정된 경우 Gradation의 중간값(50%위치값) 색상으로 Export 됩니다. - GridCellControl 에 설정한 CSS 관련 속성값만 Export 시 적용됩니다.
range
엑셀 또는 한셀 파일에 Export 되는 위치를 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
var objExpItem = new ExportItem(); objExpItem.range = "Sheet1!A1"; | ||
strRange | "시트명!셀영역" 또는 "셀영역" 형태로 오브젝트 내용이 Export 되는 위치를 지정합니다. | |
|---|---|---|
source
Export 대상이 되는 오브젝트를 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
var objExpItem = new ExportItem(); objExpItem.source = this.Grid00; | ||
objSource | Export 대상이 되는 컴포넌트를 오브젝트로 설정합니다. 현재 Grid 만 Export 할 수 있으며 "this.Grid00" 형태로 설정하여야 합니다. | |
|---|---|---|
type
Export 대상이 되는 오브젝트의 종류를 상수값으로 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
var objExpItem = new ExportItem(); objExpItem.type = nexacro.ExportItemTypes.GRID; | ||
nType | Export 대상이 되는 컴포넌트의 종류를 상수값으로 설정합니다. 현재 Grid 만 Export 할 수 있으며 "nexacro.ExportItemTypes.GRID" 로 설정하여야 합니다. | |
|---|---|---|
valuetypebandid
valuetypecellindex 속성값을 적용할 Band를 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
strBandId ::= "head" | "body" | "summ" | ||
var objExpItem = new ExportItem(); objExpItem.valuetypebandid = "head"; | ||
"head" | valuetypecellindex 속성값을 head band에만 적용합니다. | |
|---|---|---|
"body" | valuetypecellindex 속성값을 body band에만 적용합니다. | |
"summ" | valuetypecellindex 속성값을 summary band에만 적용합니다. | |
참고
- valuetypecellindex 속성으로 설정한 값을 적용할 Band를 설정하는 속성입니다. valuetypecellindex 속성과 같이 설정해야 합니다. - valuetypebandid 속성값을 설정하지 않으면 모든 Band를 대상으로 적용됩니다.
valuetypecellindex
Export 시 바인드된 Column 값을 적용할 Cell 의 인덱스를 배열로 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
var objExpItem = new ExportItem(); var arrCellIdx = [1, 5, 6]; objExpItem.valuetypecellindex = arrCellIdx; | ||
arrCellIndex | 바인드된 Column 값을 적용할 Cell 의 인덱스를 배열로 설정합니다. 인덱스가 설정된 Cell 은 표시된 텍스트값이 아닌 바인드된 Column 값을 Export 합니다. 인덱스가 설정되지 않은 Cell 은 사용 메소드에 따라 결과가 달라질 수 있습니다.
| |
|---|---|---|
참고
- valuetypecellindex 속성값 설정 시 Export 결과의 일관성을 위하여 exportDataEx() 메소드를 사용하는 것을 권장합니다. - Cell 의 displaytype 속성값이 "decoratetext" 일 때 설정된 Tag 는 HTML 형식이므로 Export 시 Decorate 효과가 적용되지 않습니다. valuetypecellindex 속성값과 사용 메소드에 따라 Tag 가 텍스트로 Export 되거나 Tag 가 제거된 텍스트가 Export 됩니다.