그리드의 내용을 엑셀 파일로 다운로드한다.
| Parameters | Type | Description |
|---|---|---|
| sFileName | STRING | 엑셀 파일 이름 |
| bShowOption | BOOL | 옵션창 표시 여부 |
| bSaveOneRow | BOOL | 한줄로 저장 여부 (멀티라인 그리드에만 적용됨) |
| bIncPattern | BOOL | 패턴 포함 여부 |
| bIncHeader | BOOL | 헤더 포함 여부 |
| bIncStatData | BOOL | 통계 데이터 포함 여부 |
| bIncBorder | BOOL | 테두리 포함 여부 |
| bIncAlign | BOOL | 정렬 포함 여부 |
| bIncBackColor | BOOL | 배경색 포함 여부 |
| bIncFont | BOOL | 폰트 포함 여부 |
| bIncForeColor | BOOL | [옵션] 전경색 포함 여부 (기본값: false) |
| bIncItemStyle | BOOL | [옵션] 아이템별 스타일 적용 여부 (기본값: false) |
| bIncItemMerge | BOOL | [옵션] 아이템별 병합 적용 여부 (기본값: false) |
| bIncLineNumber | BOOL | [옵션] 순번 데이터 포함 여부 (기본값: false) |
| bIncMasking | BOOL | [옵션] 데이터 마스킹 포함 여부 (기본값: true) |
| nFileDownType | short | [옵션] 파일 다운로드 유형 (기본값: 0) |
| nConvNumberType | short | [옵션] 숫자 변환 타입 (기본값: 0) |
| bCheckRowOnly | BOOL | [옵션] 체크된 행만 저장 여부 (기본값: false) |
| bSaveOneRowMergeData | BOOL | [옵션] 한줄로 저장시 병합된 데이터 포함 여부 (기본값: true) (멀티라인 그리드에만 적용됨) |
| sExcelPassword | STRING | [옵션] 엑셀 패스워드(XLSX 파일만 지원) (기본값: 공백문자열) |
| Type | Description |
|---|---|
| BOOL | 엑셀 파일 다운로드 절차가 정상적으로 시작되었는지 여부 |
파라미터 값이 유효하지 않은 경우, false가 리턴된다.
bShowOption 파라미터 값이 true인 경우에, bIncMasking 옵션 파라미터 값이 false인 경우에만, 마스킹 설정 변경 체크박스가 표시된다.
** nFileDownType 파라미터 값 - 0: 엑셀 파일을 사용자 PC에 저장한다. (서버에 저장하지 않음) - 1: 엑셀 파일을 서버에 저장하고, 사용자 PC에 저장하지 않는다. - 2: 엑셀 파일을 저장하지 않고 바로 본다. (전용 브라우저 환경에서만 지원)
nFileDownType 파라미터 파라미터 값이 1인 경우, 서버의 저장 경로는 XExcelDownload 서블릿의 TEMP_DIR 파라미터를 기준으로 결정된다. - 지정: 파라미터값 경로명 하위의 temp 디렉토리 - 미지정: XExcelDownload 서블릿이 실행되는 Context Root의 하위의 temp 디렉토리
** nConvNumberType 파라미터 값 - 0: 변환하지 않음 - 1: 문자로 무조건 변환 - 2: 지수표현 대상 문자 변환 - 3: 15자리이상 숫자 문자 변환
XEXCEL_DOWNLOAD_AJAX 실행 파라미터 값이 true로 설정된 경우, 엑셀 다운로드 동작이 진행중인 상태인 경우, false값이 리턴되며, on_fileload 이벤트도 발생하지 않는다.
use_checkrow 속성이 false인 경우에는 bCheckRowOnly 파라미터가 무시된다.
function btn_downloadexcel_on_mouseup(objInst)
{
var excel_file_name, is_show_option, is_save_onerow,
is_include_pattern, is_include_header, is_include_statdata,
is_include_border, is_include_align, is_include_backcolor,
is_include_font, is_include_forecolor, is_include_itemstyle,
is_include_itemmerge, is_include_linenumber, is_include_masking,
file_download_type, convert_number_type, is_checkrow_only,
is_save_onerow_mergedata, excel_password;
excel_file_name = "download.xlsx";
is_show_option = false;
is_save_onerow = true;
is_include_pattern = true;
is_include_header = true;
is_include_statdata = true;
is_include_border = true;
is_include_align = true;
is_include_backcolor = true;
is_include_font = true;
is_include_forecolor = true;
is_include_itemstyle = true;
is_include_itemmerge = true;
is_include_linenumber = true;
is_include_masking = true;
file_download_type = 0; // 0: local download, 1: server_save_only
convert_number_type = 0;
is_checkrow_only = false;
is_save_onerow_mergedata = true;
excel_password = "";
grd.downloadexcelex(excel_file_name, is_show_option, is_save_onerow,
is_include_pattern, is_include_header, is_include_statdata,
is_include_border, is_include_align, is_include_backcolor,
is_include_font, is_include_forecolor, is_include_itemstyle,
is_include_itemmerge, is_include_linenumber, is_include_masking,
file_download_type, convert_number_type, is_checkrow_only,
is_save_onerow_mergedata, excel_password);
}