WebSquare.uiplugin.gridView

그리드뷰. 대량 데이터를 그리드로 표시.
대량 데이터를 그리드로 표시하고 수정할 수 있는 컴포넌트.
데이터를 담당하는 DataList와 바인딩하여 사용함.
소계/합계, 동적 그룹핑, 엑셀 파일 업로드/다운로드, 정렬, 필터링 등을 지원.
최상위는 <div> 태그 하에 <table> 및 복합 태그를 사용하여 데이터를 구성.
GridView 주요 API의 파라메터 중 컬럼(열) id는 body의 column id 혹은 header id를 사용.

Type

uiplugin

Property Summary

adaptive: 적응형 웹(다양한 화면크기와 디바이스에 맞게 레이아웃을 변경) 모드.
adaptiveThreshold: adaptive가 설정되어 있을 경우 레이아웃 변경을 하기 위한 임계값
applyAllColumnStyle: 컬럼에 정의된 스타일들을 모두 적용
arrowMove: 셀 내부의 첫번째 혹은 마지막 문자열에서 좌우 방향키를 이용한 셀 이동 허용. (옵션 설명) "true" : 이동 가능. "false" (기본 값) : 이동 불가.</xmp></xmp>
autoFit: GridView의 모든 컬럼 폭을 균등하게 배분하여 전체 화면 폭을 채우는 기능. [default: none, lastColumn, allColumn]
autoFitMinWidth: autoFit="allColumn" 설정을 적용하기 위해 필요한 GridView의 최소 너비. (단위: px)
captionAuto: captionTitle과 헤더의 Title을 조합해서 표 제목으로 표시. [default: false]
captionTitle: 표의 각 Header Title 앞에 표시할 내용
checkDisabledOnCut: disabled="true" 컬럼에 대해 Ctrl(또는 cmd)+X를 통한 잘라내기 허용
checkEditableInputClass: inputType = "text" 이고 cell의 상태가 readOnly 혹은 disable인 경우, nobr 태그에 "w2grid_input" class를 삭제
checkReadOnlyOnCut: readOnly="true" 컬럼에 대해 Ctrl(또는 cmd)+X를 통한 잘라내기 허용
checkReadOnlyOnPaste: readOnly="true" 컬럼에 Ctrl(또는 cmd)+V를 통한 붙여넣기 허용
checkReadOnlyOnPasteEnable: checkReadOnlyOnPaste="false" 설정을 적용할 컬럼을 지정
class: HTML의 class 속성과 동일한 기능을 제공.
columnMove: 헤더 드래킹을 통한 컬럼 이동을 허용.
columnMoveWithFooter: 컬럼 이동 시 푸터를 함께 이동. [default: false, true]
contextMenu: context menu 사용 여부
customFilterBox: groupby(); 함수 실행 후 사용자 정의 필터 유지 여부. [default: false, true]
dataDragDrop: GridView 간의 데이터 드래그-앤-드롭을 허용. [true, false]
dataDragSelect: 여러 개의 셀들을 드래깅으로 선택. [true, false]
dataDragSelectAutoScroll: 드래깅을 통해 복수의 셀을 선택할 경우(dataDragSelect="true"), 마우스가 화면 밖을 벗어나면 자동으로 스크롤이 되는 기능
dataDragSelectAutoScrollLevel: dataDragSelectAutoScroll 기능 사용 시 현재의 스크롤링 속도가 2배로 빨라지기까지의 시간. (단위: ms) [default: 1300]
dataDragSelectAutoScrollPeriod: dataDragSelectAutoScroll 기능 사용 시 스크롤링이 발생하는 주기. (단위: ms) [default: 70]
dataList: gridView의 data에 해당하는 DataCollection의 DataList id
defaultCellHeight: 셀의 기본 높이
disabledBackgroundColor: disabled="true" 설정이 적용된 셀 혹은 행의 배경색
disabledFontColor: disabled="true" 설정이 적용된 셀 혹은 행의 글자색
disabledScrollHidden: disabled인 경우 스크롤도 함께 숨김. [default: false, true]
dragDisplayColumn: 데이터를 드래깅(dataDragDrop="true")할 때 툴팁으로 표시할 컬럼의 ID를 지정.
dragEndFunction: 드래그 종료시 실행될 함수.
dragStartFunction: 드래깅 시작 시 실행할 함수.
drilldownToggleScrollFix: drilldown 컬럼에서 +버튼을 클릭하여 목록을 펼칠 때 스크롤을 고정
dynamic: 껍데기만 그려놓고 setGridStyle을 통해 동적으로 생성. [default: false, true]
editModeEvent: 셀 수정 모드로 진입하기 위해 필요한 마우스 동작 이벤트
editModeEventIcon: viewType="icon"인 컬럼에서 수정 모드로 진입하기 위해 필요한 마우스 동작 이벤트
enterKeyMove: 셀에서 Enter 키를 입력할 경우 포커스 이동 방향
escape: <>&"를 HTML Escape 문자로 변환하여 화면에 표시
euroMask: 화폐 단위 변경을 위해 dataType="euro" 설정이나 changeCurrency(); 함수를 사용할 경우 적용되는 마스킹 값
evenRowBackgroundColor: 짝수 행의 배경색
excludeDeletedRows: subtotal(소계)과 footer(합계) 등에서 삭제된 행을 제외하고 계산을 실행
excludeModifiedRows: subtotal(소계)과 footer(합계) 등에서 modifyRowStatus();로 "D" 상태가 적용된 row를 제외하고 계산
fastScroll: 세로 스크롤 이동시 고속 스크롤링 효과를 추가.
filterBoxvisibleRowNum: 필터링 조건 목록에 표시할 필터링 조건의 수
filterFocusMode: sort이벤트 발생 시 이벤트 발생 전 body의 cell/row에 선택되어있는 focus를 제거 할지에 대한 속성
filterShowAlways: useFilter="true" 컬럼에서 컬럼 너비가 좁을 때 filter 아이콘을 최우선으로 표시
fixedColumn: 틀고정을 적용할 컬럼의 위치
fixedColumnNoMove: fixedColumn 지정된 컬럼의 columnMove 허용 여부
fixedColumnScrollHidden: 틀고정을 할 경우, 고정된 영역의 스크롤을 감춤
fixedColumnWithHidden: fixedColumn 속성의 위치 값에 hiddenColumn을 포함하여 계산할지 여부
fixedRow: 틀고정을 시킬 행의 위치
focusDefaultColumn: true 설정 시 rowNum 컬럼 및 rowStatus 컬럼이 focus를 받을 수 있는 상태가 된다
focusFlow: 포커스 이동 방향을 설정
focusMode: 셀 선택(포커싱) 시 선택 영역 표현 방법
focusMove: 방향키를 통한 포커스 이동 허용
footerCaption: 바닥글(footer)의 내용
footerCaption: grid footer의 caption
footerCaptionAuto: captionAuto 설정에 상관 없이 footerCaption 속성에 바닥글을 자동 생성. [default: false, true] (관련 속성) captionTitle footerCaption</xmp></xmp>
footerSummary: 바닥글(footer)의 내용 요약
footerSummary: grid footer의 요약
footerSummaryAuto: captionAuto 설정에 상관 없이 footer의 summary 속성에 바닥글을 자동 생성. [default: ""(빈 값)] (관련 속성) captionTitle footerSummary</xmp></xmp>
groupbyFilterBox: 필터링 기능(groupby)을 사용할 때 필터링 조건 목록의 표시 여부.
groupbyFilterBoxFormatter: groupby FilterBox에 추가될 목록의 label을 변경한다(format을 지정).
groupbyFilterBoxLocation: 필터링 조건 목록(groupbyFilterBox)을 표시할 위치. (옵션 설명) "top" : 상단에 표시. "bottom" (기본 값): 하단에 표시.</xmp></xmp>
groupbyMaxCount: groupby 가능한 최대 컬럼 개수를 지정
groupbyZone: groupby 기능을 사용.
groupbyZoneHeight: groupbyZone의 높이를 설정
groupbyZoneMessage: groupbyZone이 초기 상태일 경우 출력할 메세지를 설정
hammerEnabled: 모바일에서 dblclick 이벤트를 Hammer
hammerPressTime: pres s이벤트가 발생하기까지 누르고 있어야 할 시간
hideHeader: 헤더 숨기기
id: 컴포넌트 ID.
ignoreCellClick: 셀 클릭을 무시
ignoreNonEditableCell: 셀 편집이 불가능할 경우, Tab이나 Enter 키 입력을 무시
ignoreNonEditableCellTabEnter: ignoreNonEditableCell="true"인 경우,readOnly="true" 셀에서 방향키를 통한 이동 허용
ignoreToggleOnDisabled: 드릴 다운 시 disabled된 셀인 경우 토글 이미지를 클릭을 무시
initFixedHeightByRowNum: 최초 렌데렁된 GridView의 행의 수를 기준으로 GridView의 높이를 초기화.
keepDefaultColumnWidth: autoFit="true"인 경우,rowNum 컬럼과 rowStatus 컬럼의 폭을 고정
keyMoveEditMode: Tab이나 Enter 키를 눌러서 포커스를 이동할 때 즉시 수정 모드로 진입할지 여부
loadCount: onscrollend 이벤트를 발생에 필요한 남은 행의 수.
mergeCells: 행 또는 열 기준으로 연속적으로 같은 데이터들을 병합함
mergeCellsFixedCols: fixedColumn 영역 내에서 행 또는 열 기준으로 연속적으로 같은 데이터들을 병합
mergeCellsFixedRows: fixedRow 영역 내에서 행 또는 열 기준으로 연속적으로 같은 데이터들을 병합
mergeCol: mergeCells 속성 사용 시 특정 컬럼만 mergeCells를 적용할 때 대상이 되는 컬럼을 지정
moveKeyEditMode: 상(Up) 및 하(Down) 방향키로 포커스 이동 시 즉시 편집 모드로 진입 여부
moveKeyEditModeAll: 상(Up), 하(Down), 좌(Left), 우(Right) 방향키로 포커스 이동 시 즉시 편집 모드로 진입 여부. [default: false, true] (옵션 설명) "true" : 상(Up), 하(Down), 좌(Left), 우(Right) 방향키를 누르면 포커스 이동과 함게 바로 수정 모드로 진입. "false" (기본 값) : 상(Up), 하(Down), 좌(Left), 우(Right) 방향키를 누르면 포커스만 이동됨. </xmp></xmp>
nextTabID: Tab 키로 이동할 경우, Tab 키를 누를 때 선택되는 컴포넌트의 ID
noResultMessage: 조회 결과가 없을 경우(DataList의 데이터가 0건일 때) 표시할 메세지
noResultMessageClass: 조회 결과 없음(DataList의 데이터가 0건일 때) 메시지에 별도의 스타일을 적용하기 위한 클래스.
noResultMessageStyle: 조회 결과 없음(DataList에 해당 데이터가 없을때) 메시지에 별도의 스타일을 적용.
noResultMessageVisible: 조회 결과가 없을 때(DataList에 데이터가 없을 때) 메시지 표시 여부
numberMask: 화폐 단위 변경을 위해 dataType="number" 설정이나 changeCurrency(); 함수를 사용할 경우 적용되는 마스킹 값
oddEvenColorDisplay: 짝/홀 수 행 마다 서로 다른 색을 사용
oddRowBackgroundColor: 홀수 행의 배경색
overflowX: 가로 스크롤 표시 여부
overflowY: 세로 스크롤 표시 여부
pasteOption: Ctrl(또는 cmd)+V를 통해 데이터를 클립보드에 붙여넣을 방법을 지정
preventAddRowOnPaste: Ctrl(또는 cmd)+V를 눌러 클립보드에서 그리드로 붙여넣기하는 경우 새로운 행의 추가 여부
preventCopy: Ctrl(또는 cmd)+C를 눌러 그리드 전체의 데이터를 클립보드에 복사하는 동작을 방지
preventCopyColumn: Ctrl(또는 cmd)+C를 통해 데이터를 클립보드에 복사하는 동작을 방지할 컬럼의 ID를 지정
preventMultisort: 다중 정렬을 방지
preventPaste: Ctrl(또는 cmd)+V를 통해 데이터를 클립보드에 붙여넣는 동작을 방지
preventPasteColumn: Ctrl(또는 cmd)+V를 통해 데이터를 클립보드에 붙여넣는 동작을 방지할 컬럼의 ID를 지정
readOnly: 전체 셀을 읽기 전용으로 설정. [default: false, true]
readOnlyBackgroundColor: readOnly="true" 속성이 설정된 셀의 배경색
readOnlyBackgroundImg: readOnly="true" 속성이 설정된 셀의 배경 이미지 경로
readOnlyBackgroundImgCSS: readOnly="true" 속성이 설정된 셀의 배경 이미지의 CSS.
readOnlyPriority
readOnlyTabIgnore: Tab 키를 누를 때 readOnly="true" 속성이 적용된 셀을 무시
resize: 컬럼 드래깅을 통한 컬럼 폭 조절 허용
rowMouseOver: 마우스-오버 시에 마우스가 위치한 행의 배경색을 표시
rowMouseOverColor: 마우스-오버된 행의 배경색
rowNumBackgroundColor: Body 컬럼의 배경색
rowNumHeaderValue: 헤더에 표시할 텍스트
rowNumLocaleRef: rowNum 컬럼에 설정할 localeRef 키
rowNumStatusResize: rowNum 및 rosStatus 컬럼의 폭 크기 조절 가능 여부
rowNumStatusUniqueId: rowNum 혹은 rowStatus 사용 시 각 행 별로 유일한 ID를 사용. [default: false, true]
rowNumVisible: 연동된 DataList의 데이터를 기준으로 행 번호 표시 여부
rowNumWidth: rowNumVisible="true" 설정을 적용할 경우, rowNum 컬럼의 폭
rowStatusHeaderValue: 헤더에 표시할 텍스트
rowStatusLocaleRef: rowStatus 컬럼에 설정할 localeRef 키
rowStatusVisible: 각 행의 상태(추가/수정/삭제)를 별도의 컬럼에 아이콘으로 표시
rowStatusWidth: rowStatusVisible="true" 설정을 적용할 경우, rowStatus 컬럼의 폭
rupeeMask: 화폐 단위 변경을 위해 dataType="rupee" 설정이나 changeCurrency(); 함수를 사용할 경우 적용되는 마스킹 값
scrollByColumn: 가로 스크롤이 컬럼 단위로 이동
scrollByColumnAdaptive: adaptive 상태일 때 가로 스크롤을 컬럼 단위로 이동
selectedCellColor: 선택된 셀의 배경색
selectedCellOverColor: 선택된 셀에 마우스-오버할 때 표시할 셀의 배경 색.
selectedRowColor: 선택된 행의 배경색
selectedRowOverColor: 선택된 셀에 마우스-오버할 때 표시할 행의 배경 색.
senseReader: 웹 접근성을 지원하기 위한 모드. [default: false, true] (옵션 설명) "false" (기본 값) "true" : Tab 키로 모든 셀을 순회 가능. </xmp></xmp>
setCellInputTypeCustom: inputType이 custom인 셀의 inputType을 동적으로 변경하기 위한 옵션
showImageTooltip: inputType = "image"인 경우, 툴팁을을 표시
showSortableImage: 정렬 가능한 컬럼의 헤더에 정렬 이미지를 출력
showSortableUseFilter: useFilterList와 showSortableImage 속성을 동시에 사용할 때 정렬 아이콘(sortable)과 사용자 정의 필터 아이콘(useFilterList) 모두를 헤더에 표시. [default: false, true] (옵션 설명) "true" : 사용자 정의 필터 아이콘과 정렬 아이콘 모두를 헤더에 표시. "false" (기본 값): 정렬 아이콘만 표시.</xmp></xmp>
sortable: gridView의 헤더 클릭을 통한 데이터 정렬 지원 여부
sortedIconPosition: 정렬 관련 이미지를 표시할 위치
sortEvent: 정렬을 수행할 이벤트를 정의. [default: ondblclick, onclick]
sortOrderReverse: 헤더 클릭을 통한 데이터 정렬 시 내림차순 정렬을 먼저 수행
summary: HTML <table> 태그의 summary 속성과 동일.
summaryAuto: 웹접근성 지원 시, GridView table 속성 중 summary 항목에 헤더 컬럼 명을 자동으로 설정
summaryOnlyAuto: 헤더 타이틀이 HTML 태그를 포함한 경우, 태그를 제외한 텍스트만 summary 항목으로 지정. [default: false, true] (옵션 설명) "true" : HTML 태그를 제외한 텍스트만 summary로 설정. "false" (기본 값): HTML 태그까지 포함하여 summary로 설정.</xmp></xmp>
syncScroll: 다수의 GridView에 대해 동시에 세로 스크롤링을 수행.
syncScrollId: 스크롤을 동기화할 GridView의 ID
tengeMask: 화폐 단위 변경을 위해 dataType="tenge" 설정이나 changeCurrency(); 함수를 사용할 경우 적용되는 마스킹 값
titleAuto: title을 자동 생성. [default: false, true]
titleFormatter: 사용자가 정의한 값을 title 속성으로 사용. [default: false, true]
tooltipDisplay: 전체 데이터가 셀에 모두 표시되지 않는 경우, 마우스-오버 시 툴팁으로 데이터를 표시
tooltipDisplayColumn: 특정 컬럼만 tooltip이 표현되도록 컬럼명을 설정함
tooltipFormatter: tooltipDisplay="true"인 경우, 툴팁 내용을 변환할 함수.
tooltipFormatterHeader: tooltipDisplay="true"인 경우, 툴팁 내용을 변경할 사용자 함수.
tooltipHeader: 헤더에 툴팁을 표시. [default: false, true]
tooltipHeaderShowAlways: 헤더 내용의 잘림 여부에 상관 없이 항상 툴팁을 표시할지 여부. [default: false, true]
tooltipPositionX: 툴팁의 X 좌표. (단위: px) [default: 20]
tooltipPositionY: 툴팁의 X 좌표. (단위: px) [default: cellHeight+3]
tooltipShowAlways: 툴팁을 항상 표시. [default: false, true]
tooltipShowAlwaysColumns: 툴팁을 항상 표시할 컬럼을 지정. [default: ""]
useCtrlKey: Ctrl 키를 통한 복수의 셀 선택을 허용
useCtrlOnMultisort: 다중 정렬을 위해 Ctrl 키를 통한 복수의 컬럼 선택을 허용
useFilterList: 필터링 대상 값을 목록으로 표시. [default: false, true]
useFilterListSync: DataList의 setFilter(); 및 setColumnFilter(); 등의 함수를 통해 필터링한 경우, 해당 필터를 필너 목록에 표시. [default: false, true]
userData1: 사용자 정의 데이터 속성.
userData2: 사용자 정의 데이터 속성.
userData3: 사용자 정의 데이터 속성.
useShiftKey: shift key를 이용하여 복수 셀의 선택에 대한 적용 여부
visibleRowNum: 화면에 표현할 행 수.
wheelRows: 마우스 휠을 이용하여 세로 스크롤이 이동 될 때 한번 이동하는 행의 수
wheelStop: 스크롤이 맨 아래로 내려갔을 때 wheel을 한 경우 브라우저 스크롤을 중단

Event Summary

onaftercolumnmove: 컬럼이동이 발생한 직후 발생
onaftercolumnresize: 컬럼 리사이즈 직후 발생
onafteredit: 셀의 수정이 끝나서 포커스가 빠져나온 경우 발생.
onbeforecolumnmove: 컬럼이동이 발생하기 직전에 발생
onbeforeedit: 셀 수정모드로 들어가기 전에 발생
onbeforesort: 컬럼 정렬 직전에 발생
onblankclick: gridView 영역 내의 빈 화면을 클릭할 때 발생
onbodymouseout: 그리드의 body에 마우스가 벗어난 경우 발생
onbodymouseover: 그리드의 body에 마우스가 오버된 경우 발생
oncellclick: 셀이 클릭 된 경우 발생
oncelldblclick: 셀이 더블 클릭된 경우 발생
oncellindexchange: 방향키 또는 마우스를 이용하여 셀을 선택하여 선택 된 셀이 변경되거나 API를 이용하여 cell의 focus를 적용하여 선택 된 셀이 변경되었을 때 발생
oncolumnindexchange: 방향키 또는 마우스를 이용하여 셀을 선택하여 선택 된 셀의 열이 변경되거나 API를 이용하여 cell의 focus를 적용하여 선택 된 셀의 열이 변경되었을 때 발생
oncolumnwidthchange: 컬럼 길이가 변하는 경우 발생
oncustomcopy: gridView의 copy이벤트를 대체할 이벤트 정의.
oncustompaste: gridView의 paste이벤트를 대체할 이벤트 정의.
ondatadragover: dataDragDrop 옵션이 true일때, 데이터를 다른 그리드에 오버하면 발생하는 이벤트.
ondatadragstart: dataDragDrop 옵션이 true일때, 데이터 드래그를 시작하면 발생하는 이벤트.
ondatadrop: dataDragDrop 옵션이 true일때, 데이터를 다른 그리드에 드랍하면 발생.
ondateselect: inputType 이 calendar인 경우 날짜 선택 시 발생
oneditdblclick: 수정중인 셀에 더블클릭시 발생.
oneditend: 셀의 에디트가 끝난 경우 발생하며, onafteredit보다 먼저 발생
oneditkeydown: 셀의 에디트시 키를 누른 경우 발생.
oneditkeyup: 키보드에서 키를 눌렀다 놓았을 때 발생.
onfilereadend: gridView에 엑셀 업로드가 끝난 뒤 발생
onfooterclick: footer가 클릭된 경우 발생
onheaderclick: header가 클릭된 경우 발생
onheaderdblclick: header가 더블클릭된 경우 발생
onkeydown: 키보드에서 키를 눌렀을 때 발생
onkeyup: 키보드에서 키를 눌렀다 놓았을 때 발생
onrightbuttonclick: body영역의 셀에서 마우스 오른쪽 버튼이 클릭된 경우 발생
onrowindexchange: 방향키 또는 마우스를 이용하여 셀을 선택하여 선택 된 셀의 행이 변경되거나 API를 이용하여 cell의 focus를 적용하여 선택 된 셀의 행이 변경되었을 때 발생
onrownumclick: rowNum Column이 클릭된 경우 발생
onrowstatusclick: rowStatus Column이 클릭된 경우 발생
onscrollend: 세로 스크롤이 하단에 닿을 때 발생
onscrollx: 가로 스크롤을 움직이는 경우 발생
onscrolly: 세로 스크롤을 움직이는 경우 발생
onsort: sortable 속성이 적용된 헤더에서 클릭이나 더블클릭을 통하여 정렬방식이 변경되었을 경우 발생
onsubtotalclick: subtotal이 클릭된 경우 발생
onsubtotaldblclick: subtotal이 더블클릭된 경우 발생
ontextimageclick: inputType 이 textImage 인 경우 image가 클릭 된 경우 발생
ontoggleclick: inputType이 drilldown일 때, 토글버튼 클릭시 발생
onviewchange: 키보드 또는 마우스 조작을 통해 값이 변경된 경우 발생.

Method Summary

advancedExcelDownload( options , infoArr ): 그리드의 데이터를 엑셀 파일로 저장
advancedExcelUpload( options ): 엑셀 파일을 읽어 그리드의 데이터를 설정. (JDK 1.5 이상에서 사용 가능)
changeCurrency( columnID , dataType , displayFormat , delimeter , decimalDelimeter ): 컬럼 단위로 화면에 나타나는 셀 값들의 화폐 단위를 동적으로 변경.
checkAll( colIndex , dataValue ): 체크 박스로 이루어진 열을 한번에 체크하거나 언체크
clearGroupby( ): groupBy를 해제
clearRowVisible( ): setRowVisible(); API를 이용하여 숨김 처리한 행을 모두 표시하도록 처리
drillTo( rowIndex ): drilldown 사용시 rowIndex에 해당하는 행을 표현하기 위해 모든 조상 행들을 오픈
getAllDisplayData( ): 화면에 보이는 data를 1차원 배열로 반환한다.(displayFormat등이 적용 된 data)
getAllDisplayJSON( ): 화면에 (displayFormat 등이 적용되어)출력된 데이터를 JSON으로 반환.
getAllDisplayXML( ): 화면에 보이는 data를 XML로 반환한다.(displayFormat등이 적용 된 data)
getAllFocusedIndex( ): 선택 된 셀의 rowIndex와 colIndex를 반환.
getAllFocusedRowIndex( ): 포커스 된 셀들의 rowIndex를 반환한다
getAllVisibleData( ): 현재 보이는 data를 1차원 배열로 반환
getAllVisibleJSON( ): 화면에 (displayFormat 등이 적용되어)출력된 데이터를 JSON으로 반환.
getAllVisibleXML( ): 현재 보이는 data를 XML로 반환
getAncestorRowIndexArray( rowIndex ): drilldown 사용시 rowIndex에 해당하는 행의 모든 조상 행들의 rowIndex를 반환
getBottomRowIndex( ): 현재 눈에 보여지는 gridVeiw의 최하단 row의 rowIndex를 반환.
getCellBackgroundColor( rowIndex , colIndex ): rowIndex와 colIndex에 해당하는 셀의 배경색을 반환.
getCellChecked( rowIndex , colIndex ): rowIndex와 colIndex로 해당하는 셀의 check 여부를 반환
getCellClass( rowIndex , colIndex ): grid 셀에 동적으로 적용한 사용자 class 이름을 반환
getCellColor( rowIndex , colIndex ): rowIndex와 colIndex에 해당하는 셀의 글자색을 반환.
getCellDisabled( rowIndex , colIndex ): colIndex와 rowIndex 해당하는 셀의 disabled속성 값을 반환.
getCellDisplayData( rowIndex , colIndex ): rowIndex와 colIndex에 해당하는 셀의 화면에 보이는 데이터를 반환.
getCellPosition( row , colIndex , propertyName ): 셀의 위치 정보(top 또는 left)를 반환
getCellReadOnly( rowIndex , colIndex ): colIndex와 rowIndex에 해당하는 셀의 readonly 속성 값을 반환.
getCellSize( row , colIndex , sizeName ): 셀의 크기 정보(width나 height)를 반환
getCheckedData( colIndex ): colIndex에 해당하는 열이 radio/checkbox일 경우 check된 행의 data를 배열로 반환한다
getCheckedIndex( colIndex ): colIndex에 해당하는 열의 inputType속성이 radio/checkbox인 경우 check된 행의 index를 배열로 반환
getCheckedJSON( colIndex ): colIndex에 해당하는 열이 radio/checkbox일 경우 check된 행의 JSON Data를 Array에 담아 반환.
getCheckedXML( colIndex ): colIndex에 해당하는 열이 radio/checkbox일 경우 check된 행의 data를 XML로 반환
getChildrenRowIndexArray( rowIndex ): drilldown 사용시 rowIndex에 해당하는 행의 자식(1 depth 하위)행들의 rowIndex를 배열로 반환
getColIdByHeaderId( headerId ): header의 columnId에 해당하는 body의 columnId를 반환
getColumnBackgroundColor( colIndex ): colIndex에 해당하는 열의 배경색을 반환.
getColumnColor( colIndex ): colIndex에 해당하는 열의 글자색을 반환.
getColumnDataListInfo( colIndex ): colIndex에 해당하는 컬럼에 바인딩된 데이터리스트정보를 반환.
getColumnDisabled( colIndex ): colIndex에 해당하는 열에 disabled속성 값을 반환.
getColumnID( colIndex ): 컬럼의 index를 입력받아 해당하는 컬럼의 id를 반환
getColumnIdListMultiRow( ): 그리드의 모든 컬럼의 ID를 2차원 배열 형태로 반환.
getColumnIndex( colIndex ): 컬럼 id를 입력받아 해당하는 컬럼의 index를 반환
getColumnNodeSet( colIndex ): inputType = "select" 또는 "autoComplete"인 경우, 연결된 NodeSet 정보를 반환.
getColumnOrder( byName ): 현재 컬럼 순서를 배열로 반환한다
getColumnReadOnly( colIndex ): colIndex에 해당하는 열에 적용된 readonly속성 값을 반환.
getColumnType( colIndex ): colIndex에 해당하는 열의 inputType 속성 값을 반환
getColumnVisible( colIndex ): colIndex에 해당하는 열의 visible여부를 반환
getDataDragDrop( ): 그리드의 컬럼에 dataDragDrop 값을 반환
getDataLength( ): [deprecated]getRowCount()를 사용한다
getDataList( ): 현재 binding된 dataList의 Id를 반환
getDataListInfo( ): 컴포넌트와 바인딩된 DataList를 반환
getDataType( colID ): 특정 column의 dataType 속성을 반환
getDescendantRowIndexArray( rowIndex ): drilldown 사용시 rowIndex에 해당하는 행의 모든 자손 행들의 rowIndex를 반환
getDisabled( type , rowIndex , colIndex ): type에 따라 세부 disabled 속성을 반환
getFixedColumnLastIndex( includeDefaultColumn ): 그리드에 fixedColumn이 설정되어 있을 경우 fixedColumn 중 맨 오른쪽 끝에 해당하는 column의 index를 반환합니다
getFixedRightColumnLastIndex( ): 그리드에 FixedRightColumn이 설정되어 있을 경우 FixedRightColumn 중 맨 오른쪽 끝에 해당하는 column의 index를 반환합니다
getFixedRow( ): gridView가 가로 틀고정된 경우, 틀고정 위치를 반환
getFocusedColumnID( ): 포커스가 위치한 셀이 속한 column의 ID를 반환한다
getFocusedColumnIndex( ): 포커스가 위치한 셀의 colIndex를 반환
getFocusedRowIndex( ): 포커스가 위치한 셀의 rowIndex를 반환
getFocusedRowStatus( ): 포커스가 위치한 셀이 속한 row의 상태를 상태문자로 반환
getFooterData( footerId , display ): footerId에 해당하는 footer의 값을 반환.
getFooterStyle( footerId , style ): 그리드의 footerId에 해당하는 footer의 스타일 속성값을 가져옴
getFormattedHeaderValue( headerId , value ): header에 설정된 dispalyFormat으로 formatted된 값을 반환
getGridReadOnly( ): gridView 전체에 대한 readOnly 속성을 반환한다
getHeaderBackgroundColor( headerId ): header 셀에 적용된 배경색 값을 반환
getHeaderClass( headerId ): grid header셀에 동적으로 적용한 사용자 class이름 반환
getHeaderColor( headerId ): header 셀에 적용 된 글씨 색상값을 반환
getHeaderID( header ): header index로 header id를 반환
getHeaderIndex( header ): header id로 header index를 반환
getHeaderPosition( headerId , propertyName ): header 셀의 위치 정보(top이나 left)를 반환
getHeaderSize( headerId , sizeName ): header 셀의 크기 정보(width나 height)를 반환
getHeaderValue( headerId ): header의 값을 반환
getMaxLength( colIndex ): 그리드의 컬럼에 maxLength값 반환합니다
getMerged( rowIndex , colIndex ): 특정 셀의 병합여부를 반환
getOpenStatus( rowIndex ): gridView에 drilldown을 적용한 경우 rowIndex에 해당하는 행의 drilldown이 열려있는지 닫혀있는지 여부를 boolean으로 반환
getOverflowX( ): overflowX 속성의 설정값을 반환
getOverflowY( ): overflowY 속성의 설정값을 반환
getParentRowIndex( rowIndex ): drilldown 사용시 rowIndex에 해당하는 행의 부모 행의 rowIndex를 반환
getReadOnly( type , rowIndex , colIndex ): type에 따라 readOnly 속성을 반환
getRealRowIndex( rowIndex ): drilldown을 적용 한 경우 화면에 표현 된 rowIndex를 기준으로 실제 데이터의 rowIndex를 반환
getRowBackgroundColor( rowIndex ): rowIndex에 해당하는 행의 배경색을 반환
getRowColor( rowIndex ): rowIndex에 해당하는 행의 글자색을 반환
getRowDisabled( rowIndex ): rowIndex에 해당하는 행에 적용된 disabled 속성 값을 반환
getRowNumVisible( ): rowNumVisible 옵션 값을 반환
getRowReadOnly( rowIndex ): rowIndex에 해당하는 행에 적용된 readonly속성 값을 반환
getRowVisible( rowIndex ): 특정 row를 감추거나 표시
getSortableArr( ): header의 각 컬럼이 sortable한지 여부를 array로 반환
getSortableStatus( ): sorting된 컬럼의 순서대로 해당 컬럼의 header 정보를 담은 object를 array로 반환.
getTopRowIndex( ): 현재 화면에 보여지는 최상단 row의 rowIndex를 반환.
getTotalCol( ): 전체 컬럼 개수를 반환
getTotalHeaderCol( options ): colIndex에 해당하는 열의 visible여부를 반환
getTotalRow( ): 행의 개수를 반환
getUncheckedData( colIndex ): colIndex에 해당하는 열이 radio/checkbox일 경우 uncheck된 행의 data를 배열로 반환
getUncheckedIndex( colIndex ): colIndex에 해당하는 열의 inputType속성이 radio/checkbox인 경우 uncheck된 행의 index를 배열로 반환
getUncheckedJSON( colIndex ): colIndex에 해당하는 열이 radio/checkbox일 경우 uncheck된 행의 data를 JSON으로 변환하여 배열에 담아 반환
getUncheckedXML( colIndex ): colIndex에 해당하는 열의 inputType속성이 radio/checkbox인 경우 uncheck된 행의 data를 XML로 반환
getVisibleColData( colIndex ): colIndex에 해당하는 열의 화면에 보이는 데이터(filter나 sort가 반영 된)를 배열로 반환
getVisibleRowNum( ): 현재 화면(눈에 보여지는 영역)에 그려진 row의 수를 반환.
groupby( Options ): 둘 이상의 컬럼의 데이터를 그룹핑하여 그룹핑 결과(통계)만 표시.
hasChild( rowIndex ): drilldown이 적용 된 경우 rowIndex에 해당하는 행이 child row를 가지고 있는지의 여부를 반환
hideGroupbyZone( ): groupbyZone 영역을 숨김 처리
initGrid( ): 전체 데이터 삭제, 필터 삭제, 컬럼 기본정보(selectbox의 nodeset 등)를 초기화하고 가지고 있던 데이터를 1차원 배열로 반환한다
isEditing( ): GridView의 현재 편집 상태를 반환
mergeByCol( options ): 같은 column 내에서 같은 데이터가 연속적으로 나타나는경우 이들을 모두 병합
mergeByColRec( options ): mergeByCol을 수행하고, 그 후에 병합되지 않은 cell들을 대상으로 mergeByRow를 수행.
mergeByRestriCol( options ): 같은 column 내에서 연속적으로 데이터가 같으면서 동시에 자신의 왼쪽에 위치한 column이 merge된 경우 해당 row들을 병합.
mergeByRestricRow( options ): 같은 row 내에서 연속적으로 데이터가 같으면서 동시에 자신의 위쪽에 위치한 row가 merge된 경우 해당 row들을 병합.
mergeByRow( options ): 같은 row 내에서 같은 데이터가 연속적으로 나타나는경우 이들을 모두 병합
mergeByRowRec( options ): mergeByRow를 수행하고, 그 후에 병합되지 않은 cell들을 대상으로 mergeByCol을 수행.
mergeCell( mergeInfo ): 동적으로 셀을 병합
mergeCells( mergeOptionStr , options ): 행 또는 열 기준으로 연속적으로 같은 데이터들을 병합
mergeCellsFixedCols( mergeOptionStr , options ): fixedColumn 영역 내에서 mergeCells를 실행
mergeCellsFixedRows( mergeOptionStr , options ): fixedRow 영역 내에서 mergeCells를 실행
mergeClear( ): 동적으로 병합된 셀들의 병합을 모두 해제한다.
mergeCol( colIndex , flag ): 데이터를 통해 자동으로 merge하는 기능을 사용할 때 특정 컬럼을 제외하기 위해 사용
mergeFocusedCell( ): 현재 포커스된 셀만 병합
mergeRow( rowIndex , flag ): 데이터를 통해 자동으로 merge하는 기능을 사용할 때 특정 행을 제외하기 위해 사용
mergeSplitFocusedCell( ): 포커스를 받은 셀의 병합을 분리
modifyCheckedStatus( colIndex , status ): col에 해당하는 열의 inputType이 checkbox일 때 check된 행의 상태코드값을 일괄 변경
modifyUncheckStatus( col , status ): col에 해당하는 열의 inputType이 checkbox일 때 uncheck된 행의 상태코드값을 일괄 변경
moveFooterColumn( fromIdx , toIdx ): footer 컬럼을 fromIdx 위치로 부터 toIdx 이전의 위치로 이동
readCSV( options ): csv 파일을 읽어 그리드의 데이터를 설정
redrawColumn( colIndex , valid ): col에 해당하는 열을 다시 그림
refreshCell( rowIndex , colIndex ): 해당 인덱스의 cell을 다시 렌더링
refreshColumn( colIndex ): 해당 인덱스의 column을 다시 렌더링
refreshColumnItemset( col ): inputType이 select인 경우에만 동작하며 col에 해당하는 컬럼의 itemset을 갱신
refreshRow( rowIndex ): 해당 인덱스의 row를 다시 렌더링
removeCellClass( rowIndex , colIndex ): grid 셀에 적용된 사용자 class를 삭제
removeFocusedCell( ): 셀에 적용 된 모든 포커스(선택되어있는 셀)를 제거
removeFocusedMultiCell( startRow , startCol , endRow , endCol ): 직사각형 영역만큼 cell의 focus를 해제
removeHeaderClass( headerId ): grid Header 셀에 적용된 사용자 class를 삭제
saveCSV( options ): 데이터를 CSV 파일로 저장
setAutoFit( options ): autoFit 속성을 적용.
setBottomRowIndex( bottomRowIndex ): 화면에 보여지는 gridView 영역에 bottomRowIndex 해당하는 row가 최하단에 위치하도록 조정.
setCaption( htmlStr ): gridView의 HTML caption 속성의 값을 설정
setCaptionAuto( captionTitle ): captionTitle 값을 표 제목으로 설정
setCellAllowChar( rowIndex , colIndex , allowChar ): 특정 cell의 allowChar 속성을 변경
setCellBackgroundColor( rowIndex , colIndex , color ): rowIndex와 colIndex에 해당하는 셀의 배경색을 설정
setCellChecked( rowIndex , colIndex , flag ): inputType="checkbox" 혹은 "radio"인 경우, 해당 셀을 선택하거나 선택 해제
setCellClass( rowIndex , colIndex , className ): grid 셀에 동적으로 사용자 class를 적용
setCellColor( rowIndex , colIndex , color ): rowIndex와 colIndex에 해당하는 셀의 글자색을 설정
setCellCustomFormatter( rowIndex , colIndex , formatter ): 특정 cell의 customFormatter 속성을 변경
setCellDataType( rowIndex , colIndex , dataType ): 특정 cell의 dataType 속성을 변경
setCellDisabled( rowIndex , colIndex , disabled ): colIndex와 rowIndex에 해당하는 셀의 disabled속성 값을 설정
setCellDisableEdit( rowIndex , colIndex , onoff ): inputType이 custom인 셀이 autoComplete인 경우 disableEdit 속성을 변경
setCellDisplayFormat( rowIndex , colIndex , displayFormat ): 특정 cell의 displayFormat 속성을 변경
setCellDisplayFormatter( rowIndex , colIndex , formatter ): 특정 cell의 displayFormatter 속성을 변경
setCellInputType( rowIndex , colIndex , info ): rowIndex와 colIndex에 해당하는 셀의 inputType을 변경.
setCellMaxLength( rowIndex , colIndex , maxLength ): 특정 cell의 maxLength 속성을 변경
setCellReadOnly( rowIndex , colIndex , readOnly ): colIndex와 rowIndex에 해당하는 셀의 readonly속성 값을 설정
setColumnBackgroundColor( colIndex , color ): colIndex에 해당하는 열의 배경색을 일괄 설정
setColumnChooseOption( colIndex , chooseOptionValue , chooseOptionLabel ): gridView column의 inputType이 select인 경우, selectBox의 chooseOption 속성의 value 및 label 값을 변경
setColumnColor( colIndex , color ): colIndex에 해당하는 열의 글자색을 일괄 설정
setColumnDisabled( colIndex , disabled ): colIndex에 해당하는 열에 disabled속성을 일괄 설정
setColumnDisableEdit( rowIndex , onoff ): inputType이 autoComplete인 경우 column의 disableEdit 속성을 변경
setColumnDisplayFormat( colIndex , displayFormat ): 컬럼의 displayFormat속성을 설정한다. 기존의 setDisplayFormat을 대체한 API.
setColumnDisplayFormatter( colIndex , displayFormatter ): 컬럼의 displayFormatter 속성을 설정.
setColumnGridItemset( colIndex , obj ): inputType = "select"이고 gridViewItemset을 사용하는 경우 gridViewItemset을 동적으로 변경한다
setColumnIoFormat( colIndex , ioFormat , dateMast ): 컬럼의 ioFormat 속성을 설정.
setColumnNodeSet( colIndex , nodeset , label , value ): itemset을 설정할 수 있는 컬럼의 nodeset을 설정.
setColumnOrder( columnOrderArray ): 주어진 array를 기준으로 컬럼 순서를 재설정하며 파라메터에 정의되지 않은 컬럼은 파라메터 컬럼 뒤쪽으로 위치함
setColumnReadOnly( colIndex , readOnly ): colIndex에 해당하는 열에 readonly 속성을 설정
setColumnVisible( colIndex , colVisibleFlag ): column의 hidden 여부를 설정
setColumnVisibleColumn( gridColumnId , 해당 , visibleColumnFalseValue ): 지정한 GridView 컬럼이 선택 목록을 표시하는 경우, 일부 선택 목록을 숨길 수 있는 기능.
setColumnWidth( colIndex , size ): 컬럼의 width을 변경
setCustomFormatter( colIndex , customFormatter ): 컬럼의 customFormatter 속성을 설정
setDataDragDrop( onoff ): 그리드의 dataDragDrop 값을 변경
setDataType( colIndex , dataType ): 특정 column의 dataType 속성을 변경.
setDisabled( type , rowIndex , colIndex , disableFlag ): type에 따라 disabled 속성 값을 설정한다
setDrillDownDragDrop( value ): drillDown 컬럼에 드래그-앤-드롭을 설정.
setFixedColumn( fixedColNum ): 세로 틀고정을 설정
setFixedRightColumn( count ): 우측에 고정할 컬럼 수(fixedRightColun)를 동적으로 제어
setFocusedCell( rowIndex , colIndex , editMode ): 셀로 포커스(선택)를 주고 해당 셀로 이동
setFocusedHeaderObj( headerId ): 헤더에 text가 아닌 inputType이 selectbox, checkbox와 같은 Object일 경우 포커스를 설정
setFocusedMultiCell( startRow , startCol , endRow , endCol ): 직사각형 영역만큼 cell에 focus를 줌
setFooterCaption( htmlStr ): 그리드 footer 테이블의 caption의 innerHTML 값을 설정
setFooterData( footerId , data ): footer의 inputType이 text인 경우 data를 footer에 설정
setFooterDisplayFormat( footerId , displayFormat ): footer의 displayFormat을 설정.
setFooterStyle( footerId , style , value ): footer cell의 스타일 속성을 설정
setFooterSummary( str ): 그리드 footer 테이블의 summary 값을 설정
setFooterValue( footerId , data ): footer의 inputType이 text인 경우만 적용되며 data의 값을 footer에 설정
setGridHeight( height ): gridView의 높이를 설정한다
setGridReadOnly( readOnly ): gridView 전체에 readOnly 속성을 설정한다
setGridSize( width , height ): gridView의 높이와 넓이을 설정한다
setGridWidth( width ): gridView의 넓이를 설정한다
setHeaderBackgroundColor( headerId , color ): header 셀의 배경 색상을 설정
setHeaderClass( headerId , className ): grid header 셀에 동적으로 사용자 class를 적용
setHeaderColor( headerId , color ): header 셀의 글씨 색상을 설정
setHeaderDisabled( headerId , disabled ): header의 disalbled를 설정
setHeaderHide( hide ): header의 hidden 여부를 설정
setHeaderNodeSet( headerId , nodeset , label , value ): header의 inputType이 select의 경우 적용되며 list의 nodeSet을 설정한다
setHeaderSortImage( headerId , orderNum , sortOrd ): header의 sort 이미지를 설정하며 data의 sort는 dataList의 sort API를 이용해야 함
setHeaderStyle( headerId , style , value ): 그리드의 headerId에 해당하는 header cell의 스타일을 설정
setHeaderValue( headerId , value , useFormat ): displayFormat에 따라 포맷된 값을 헤더에 설정.
setImageSrc( colIndex , src ): inputType이 textimage인 image를 동적으로 변경하기 함수
setMaxLength( colIndex , len ): 그리드의 컬럼의 maxLength 값을 설정
setNoResultMessage( message ): gridView에 데이터가 없을 경우 표시할 문자열을 설정
setNoResultMessageVisible( visible ): noResultMessageVisible 값을 동적으로 설정
setReadOnly( type , rowIndex , colIndex , readOnlyFlag ): type에 따라 readOnly 속성값을 설정
setRowBackgroundColor( rowIndex , color ): rowIndex에 해당하는 행의 배경색을 설정
setRowColor( rowIndex , color ): rowIndex에 해당하는 행의 글자색을 설정
setRowDisabled( rowIndex , disableFlag ): colIndex에 해당하는 행의 disabled속성을 설정
setRowNumColumnWidth( size ): rowNum 컬럼의 폭을 변경한다
setRowReadOnly( rowIndex , readOnly ): rowIndex에 해당하는 행의 readonly 속성을 설정
setRowStatusColumnWidth( size ): rowStatus컬럼의 폭을 변경한다
setRowVisible( rowIndex , flag ): 특정 행의 표시/숨김 여부를 설정.
setScrollLeft( left ): 그리드의 가로 스크롤의 위치를 입력받은 값만큼 이동
setScrollTop( top ): 그리드의 세로 스크롤을 감싸는 div의 스타일의 top을 param으로 들어온 top으로 설정
setStartRowNumber( rowIndex ): rowNum 컬럼에 표현되는 행번호의 시작되는 숫자의 index를 설정.
setStyleAll( styleObj ): 그리드의 스타일을 지정하는 함수
setSubtotalVisible( flag ): subtotal을 숨기거나 다시 표시
setSummary( str ): gridView의 HTML summary 속성값을 설정
setTopRowIndex( topRowIndex , noEvent , autoFocus ): 세로 스크롤의 위치를 옮겨 topRowIndex에 해당하는 row가 첫번째 row에 보여지도록 설정
setUseFilter( colId , flag ): gridView 특정 header의 useFilter 속성을 동적으로 변경
setUseFilterList( flag ): gridView의 useFilterList속성을 동적으로 제어
showChooseOption( colIndex , chooseOption ): gridView 컬럼의 inputType이 select일때 selectbox의 chooseOption 속성 설정
showCustomFilter2( headerID ): 사용자 필터를 지정할 수 있는 "사용자 지정 필터" 팝업 창을 표시
showCustomFilterReset( ): 사용자 필터를 초기화시킬 수 있는 버튼을 출력.
showGroupbyZone( ): groupbyZone 영역을 (hideGroupbyZone에 의해 감춰진 경우) 다시 표시
spanAll( openFlag ): drilldown을 사용하는 gridView에서 전체 데이터를 모두 펼치거나 모두 접는 기능.
toggle( rowIndex ): drilldown을 적용 한 경우 rowIndex에 해당하는 행에 drilldown을 토글링.

Property Detail

adaptive: 적응형 웹(다양한 화면크기와 디바이스에 맞게 레이아웃을 변경) 모드.
Chrome, Safari, Firefox, Opera, IE10+에서 지원되는 기능.
adaptiveThreshold: adaptive가 설정되어 있을 경우 레이아웃 변경을 하기 위한 임계값. [default: 480]
applyAllColumnStyle: 컬럼에 정의된 스타일들을 모두 적용.
arrowMove: 셀 내부의 첫번째 혹은 마지막 문자열에서 좌우 방향키를 이용한 셀 이동 허용.
autoFit: GridView의 모든 컬럼 폭을 균등하게 배분하여 전체 화면 폭을 채우는 기능. [default: none, lastColumn, allColumn]
해당 기능을 사용할 경우, 가로 스크롤이 표시되지 않음.
autoFitMinWidth: autoFit="allColumn" 설정을 적용하기 위해 필요한 GridView의 최소 너비. (단위: px)
GridView의 너비가 autoFitMinWidth 값 보다 적은 경우, autoFit="allColumn" 설정은 적용되지 않고 가로 스크롤이 생성됨.
captionAuto: captionTitle과 헤더의 Title을 조합해서 표 제목으로 표시. [default: false]
TableLayout 컴포넌트에서 본 속성을 사용할 경우, tagName="table"로 지정해야 함.
captionTitle: 표의 각 Header Title 앞에 표시할 내용. [default:""]
checkDisabledOnCut: disabled="true" 컬럼에 대해 Ctrl(또는 cmd)+X를 통한 잘라내기 허용. [default: false, true]
checkEditableInputClass: inputType = "text" 이고 cell의 상태가 readOnly 혹은 disable인 경우, nobr 태그에 "w2grid_input" class를 삭제. [default: false, true]
checkReadOnlyOnCut: readOnly="true" 컬럼에 대해 Ctrl(또는 cmd)+X를 통한 잘라내기 허용. [default: false, true]
checkReadOnlyOnPaste: readOnly="true" 컬럼에 Ctrl(또는 cmd)+V를 통한 붙여넣기 허용. [default: false, true]
checkReadOnlyOnPasteEnable: checkReadOnlyOnPaste="false" 설정을 적용할 컬럼을 지정. [default:""]
class: HTML의 class 속성과 동일한 기능을 제공.
CSS 파일이나 style 블럭에 정의한 여러 개의 class를 공백으로 구분하여 적용 가능.
Engine 내부에서 각 컴포넌트 별로 지정된 class를 적용하나, class 속성을 이용하여 컴포넌트의 CSS를 제어 가능.
GridView는 매우 복잡한 구조를 가진 컴포넌트로 CSS의 selector를 이용하여 하위 항목에 접근해야 함.
columnMove: 헤더 드래킹을 통한 컬럼 이동을 허용.
드래깅 시 헤더의 value 속성에 설정된 값이 툴팁으로 표시됨.
columnMoveWithFooter: 컬럼 이동 시 푸터를 함께 이동. [default: false, true]
setColumnOrder 함수를 호출하여 컬럼을 이동하거나 columnMove="true" 설정인 경우 마우스 드래깅을 통해 칼럼을 이동할 때 해당.
(단, footer가 header 및 body와 병합 구조가 다른 경우에는 미지원.)
contextMenu: context menu 사용 여부. [default: false, true]
customFilterBox: groupby(); 함수 실행 후 사용자 정의 필터 유지 여부. [default: false, true]
필터링을 적용하여 사용자 정의 필터가 설정된 상태에서 groupby(); 함수를 실행할 경우, 해당 필터를 계속 표시할지 여부.
즉, 필터링과 그룹핑 동시 적용 가능.
dataDragDrop: GridView 간의 데이터 드래그-앤-드롭을 허용. [true, false]
기본적으로 2개의 GridView가 서로 다른 DataList와 연동되어 있고, 모두 본 속성을 사용해야 함.
dataDragSelect 기능은 같이 사용할 수 없음.
(주의: FireFox에서는 Ctrl 키를 누르고 사용 해야함.)
dataDragSelect: 여러 개의 셀들을 드래깅으로 선택. [true, false]
useShiftKey 속성을 사용할 때 유요하며, dataDragDrop 속성과 함께 사용할 수 없음.
dataDragSelectAutoScroll: 드래깅을 통해 복수의 셀을 선택할 경우(dataDragSelect="true"), 마우스가 화면 밖을 벗어나면 자동으로 스크롤이 되는 기능. [default: false, true]
dataDragSelectAutoScrollLevel: dataDragSelectAutoScroll 기능 사용 시 현재의 스크롤링 속도가 2배로 빨라지기까지의 시간. (단위: ms) [default: 1300]
즉, 드래깅 시간이 길어질수록 스크롤링 속도도 증가.
dataDragSelectAutoScrollPeriod: dataDragSelectAutoScroll 기능 사용 시 스크롤링이 발생하는 주기. (단위: ms) [default: 70]
값이 작을 수록 스크롤링 속도가 빨라짐.
dataList: gridView의 data에 해당하는 DataCollection의 DataList id.
defaultCellHeight: 셀의 기본 높이.
disabledBackgroundColor: disabled="true" 설정이 적용된 셀 혹은 행의 배경색.
disabledFontColor: disabled="true" 설정이 적용된 셀 혹은 행의 글자색.
disabledScrollHidden: disabled인 경우 스크롤도 함께 숨김. [default: false, true]
IE를 제외한 다른 브라우저의 경우, GridView가 disabled되더라도 스크롤은 움직일 수 있는 현상을 원천적으로 차단하기 위한 속성.
dragDisplayColumn: 데이터를 드래깅(dataDragDrop="true")할 때 툴팁으로 표시할 컬럼의 ID를 지정.
해당 컬럼의 데이터가 툴팁으로 표시됨.
여러 컬럼을 지정할 경우 컬럼 ID를 ","로 구분하여 설정.
본 속성을 정의하지 않을 경우, 클릭된 컬럼의 데이터가 툴팁에 표시됨.
dragEndFunction: 드래그 종료시 실행될 함수.
dragStartFunction과 함께 사용.
드릴-다운인 경우와 그렇지 않은 경우를 구분해서 해당 함수를 정의해야 함.
dragStartFunction: 드래깅 시작 시 실행할 함수.
dragEndFunction과 함께 사용.
드릴-다운인 경우와 그렇지 않은 경우를 구분해서 해당 함수를 정의해야 함.
drilldownToggleScrollFix: drilldown 컬럼에서 +버튼을 클릭하여 목록을 펼칠 때 스크롤을 고정. [default: false, true]
dynamic: 껍데기만 그려놓고 setGridStyle을 통해 동적으로 생성. [default: false, true]
dynamic=true일 경우 gridView에 w2:header나 w2:body가 존재하지 않더라도 경고 메세지를 출력하지 않음.
editModeEvent: 셀 수정 모드로 진입하기 위해 필요한 마우스 동작 이벤트. [default: ondblclick, onclick, onsecondclick]
editModeEventIcon: viewType="icon"인 컬럼에서 수정 모드로 진입하기 위해 필요한 마우스 동작 이벤트. [default: onclick, ondblclick]
enterKeyMove: 셀에서 Enter 키를 입력할 경우 포커스 이동 방향. [default: down, right, none, edit]
escape: <>&"를 HTML Escape 문자로 변환하여 화면에 표시.
euroMask: 화폐 단위 변경을 위해 dataType="euro" 설정이나 changeCurrency(); 함수를 사용할 경우 적용되는 마스킹 값. [default: ""]
evenRowBackgroundColor: 짝수 행의 배경색.
excludeDeletedRows: subtotal(소계)과 footer(합계) 등에서 삭제된 행을 제외하고 계산을 실행. [default: false, true]
excludeModifiedRows: subtotal(소계)과 footer(합계) 등에서 modifyRowStatus();로 "D" 상태가 적용된 row를 제외하고 계산. [default: false, true]
fastScroll: 세로 스크롤 이동시 고속 스크롤링 효과를 추가.
시간 내에 그릴수 있는 부분까지만 표현됨. 아직 그려지지 않은 영역은 "화면 갱신 중 입니다." 메세지를 표시.
filterBoxvisibleRowNum: 필터링 조건 목록에 표시할 필터링 조건의 수.
filterFocusMode: sort이벤트 발생 시 이벤트 발생 전 body의 cell/row에 선택되어있는 focus를 제거 할지에 대한 속성.
filterShowAlways: useFilter="true" 컬럼에서 컬럼 너비가 좁을 때 filter 아이콘을 최우선으로 표시. [default: false, true]
fixedColumn: 틀고정을 적용할 컬럼의 위치.
fixedColumnNoMove: fixedColumn 지정된 컬럼의 columnMove 허용 여부. [default: false, true]
fixedColumnScrollHidden: 틀고정을 할 경우, 고정된 영역의 스크롤을 감춤.
fixedColumnWithHidden: fixedColumn 속성의 위치 값에 hiddenColumn을 포함하여 계산할지 여부. [default: true, false]
fixedRow: 틀고정을 시킬 행의 위치.
focusDefaultColumn: true 설정 시 rowNum 컬럼 및 rowStatus 컬럼이 focus를 받을 수 있는 상태가 된다. [default:false, true]
focusFlow: 포커스 이동 방향을 설정. [default: default, linear]
focusMode: 셀 선택(포커싱) 시 선택 영역 표현 방법. [default: cell, row, both, none]
focusMove: 방향키를 통한 포커스 이동 허용. [default: true, false, vertical, horizontal]
footerCaption: 바닥글(footer)의 내용. [default: ""(빈 값)]
footerCaption: grid footer의 caption
footerCaptionAuto: captionAuto 설정에 상관 없이 footerCaption 속성에 바닥글을 자동 생성. [default: false, true]
footerSummary: 바닥글(footer)의 내용 요약. [default: "" (빈 값)]
footerSummary: grid footer의 요약
footerSummaryAuto: captionAuto 설정에 상관 없이 footer의 summary 속성에 바닥글을 자동 생성. [default: ""(빈 값)]
groupbyFilterBox: 필터링 기능(groupby)을 사용할 때 필터링 조건 목록의 표시 여부.
사용자는 표시된 목록에서 조건을 선택하여 필터링 수행 가능.
groupbyFilterBoxFormatter: groupby FilterBox에 추가될 목록의 label을 변경한다(format을 지정).
data, isGroupby 두 개의 인자를 전달받음.
groupbyFilterBoxLocation: 필터링 조건 목록(groupbyFilterBox)을 표시할 위치.
groupbyMaxCount: groupby 가능한 최대 컬럼 개수를 지정.
groupbyZone: groupby 기능을 사용.
groupby 기능이란 특정 컬럼들을 기준으로 컬럼 내의 같은 데이터들을 그룹핑하여 표시.
groupbyZoneHeight: groupbyZone의 높이를 설정.
groupbyZoneMessage: groupbyZone이 초기 상태일 경우 출력할 메세지를 설정.
hammerEnabled: 모바일에서 dblclick 이벤트를 Hammer.JS의 press 이벤트로 처리. [default: true, false]
hammerPressTime: pres s이벤트가 발생하기까지 누르고 있어야 할 시간. (단위: ms) [default: 251]
hideHeader: 헤더 숨기기. [default: false, true]
id: 컴포넌트 ID.
컴포넌트 ID는 전역 객체로 할당됨.
각 컴포넌트 ID를 통해 Script에서 해당 컴포넌트에 접근 가능.
ignoreCellClick: 셀 클릭을 무시.
ignoreNonEditableCell: 셀 편집이 불가능할 경우, Tab이나 Enter 키 입력을 무시.
ignoreNonEditableCellTabEnter: ignoreNonEditableCell="true"인 경우,readOnly="true" 셀에서 방향키를 통한 이동 허용.
ignoreToggleOnDisabled: 드릴 다운 시 disabled된 셀인 경우 토글 이미지를 클릭을 무시.
initFixedHeightByRowNum: 최초 렌데렁된 GridView의 행의 수를 기준으로 GridView의 높이를 초기화.
즉, 화면에 표시할 행의 수를 고정할 수 있는 속성.
keepDefaultColumnWidth: autoFit="true"인 경우,rowNum 컬럼과 rowStatus 컬럼의 폭을 고정. [default:false, true]
keyMoveEditMode: Tab이나 Enter 키를 눌러서 포커스를 이동할 때 즉시 수정 모드로 진입할지 여부. [default: false, true]
loadCount: onscrollend 이벤트를 발생에 필요한 남은 행의 수.
세로 스크롤이 하단에 닿은 후 본 속성으로 지정한 값만큼의 행이 남아 있는 경우, onscrollend 이벤트가 발생함.
본 속성을 지정하지 않으면 세로 스크롤이 하단에 닿을 때마다 onscrollend 이벤트가 발생함.
mergeCells: 행 또는 열 기준으로 연속적으로 같은 데이터들을 병합함.
mergeCellsFixedCols: fixedColumn 영역 내에서 행 또는 열 기준으로 연속적으로 같은 데이터들을 병합.
mergeCellsFixedRows: fixedRow 영역 내에서 행 또는 열 기준으로 연속적으로 같은 데이터들을 병합.
mergeCol: mergeCells 속성 사용 시 특정 컬럼만 mergeCells를 적용할 때 대상이 되는 컬럼을 지정.
moveKeyEditMode: 상(Up) 및 하(Down) 방향키로 포커스 이동 시 즉시 편집 모드로 진입 여부. [default: false, true]
moveKeyEditModeAll: 상(Up), 하(Down), 좌(Left), 우(Right) 방향키로 포커스 이동 시 즉시 편집 모드로 진입 여부. [default: false, true]
nextTabID: Tab 키로 이동할 경우, Tab 키를 누를 때 선택되는 컴포넌트의 ID.
noResultMessage: 조회 결과가 없을 경우(DataList의 데이터가 0건일 때) 표시할 메세지. [default: 조회 결과가 없습니다.]
noResultMessageClass: 조회 결과 없음(DataList의 데이터가 0건일 때) 메시지에 별도의 스타일을 적용하기 위한 클래스.
해당 메세지는 <div> 태그 내에 텍스트가 표현됨.
noResultMessageStyle: 조회 결과 없음(DataList에 해당 데이터가 없을때) 메시지에 별도의 스타일을 적용.
기본적으로 적용되는 스타일 대신, 본 속성으로 정의된 스타일이 적용됨.
해당 메세지는 <div> 태그 내에 텍스트가 표현됨.
position과 display가 정의되지 않은 경우 엔진에서 absolute 및 block 값을 할당.
noResultMessageVisible: 조회 결과가 없을 때(DataList에 데이터가 없을 때) 메시지 표시 여부. [default: true, false]
numberMask: 화폐 단위 변경을 위해 dataType="number" 설정이나 changeCurrency(); 함수를 사용할 경우 적용되는 마스킹 값. [default: ""]
oddEvenColorDisplay: 짝/홀 수 행 마다 서로 다른 색을 사용. [default:true, false]
oddRowBackgroundColor: 홀수 행의 배경색.
overflowX: 가로 스크롤 표시 여부. [default: auto, hidden, scroll]
overflowY: 세로 스크롤 표시 여부. [default: auto, hidden, scroll]
pasteOption: Ctrl(또는 cmd)+V를 통해 데이터를 클립보드에 붙여넣을 방법을 지정. [default: "", focus]
preventAddRowOnPaste: Ctrl(또는 cmd)+V를 눌러 클립보드에서 그리드로 붙여넣기하는 경우 새로운 행의 추가 여부. [default: false, true]
preventCopy: Ctrl(또는 cmd)+C를 눌러 그리드 전체의 데이터를 클립보드에 복사하는 동작을 방지. [default: false, true]
preventCopyColumn: Ctrl(또는 cmd)+C를 통해 데이터를 클립보드에 복사하는 동작을 방지할 컬럼의 ID를 지정. [default: ""]
preventMultisort: 다중 정렬을 방지.
preventPaste: Ctrl(또는 cmd)+V를 통해 데이터를 클립보드에 붙여넣는 동작을 방지. [default: false, true]
preventPasteColumn: Ctrl(또는 cmd)+V를 통해 데이터를 클립보드에 붙여넣는 동작을 방지할 컬럼의 ID를 지정. [default: ""]
readOnly: 전체 셀을 읽기 전용으로 설정. [default: false, true]
Body 컬럼에 readOnly 속성이 설정된 경우 해당 컬럼의 속성이 우선함.
readOnly 속성은 gridView, column, row, cell 별로 속성이나 함수를 통해 설정 가능.
readOnlyBackgroundColor: readOnly="true" 속성이 설정된 셀의 배경색.
readOnlyBackgroundImg: readOnly="true" 속성이 설정된 셀의 배경 이미지 경로.
readOnlyBackgroundImgCSS: readOnly="true" 속성이 설정된 셀의 배경 이미지의 CSS.
readOnlyBackgroundImg 속성보다 우선 적용됨.
readOnlyPriority
readOnlyTabIgnore: Tab 키를 누를 때 readOnly="true" 속성이 적용된 셀을 무시. [default: false, true]
resize: 컬럼 드래깅을 통한 컬럼 폭 조절 허용. [default:true, false]
rowMouseOver: 마우스-오버 시에 마우스가 위치한 행의 배경색을 표시. [default:true, false]
rowMouseOverColor: 마우스-오버된 행의 배경색.
rowNumBackgroundColor: Body 컬럼의 배경색. rowNumVisiblue="true"인 경우에만 유효.
rowNumHeaderValue: 헤더에 표시할 텍스트. rowNumVisiblue="true"인 경우에만 유효.
rowNumLocaleRef: rowNum 컬럼에 설정할 localeRef 키.
rowNumStatusResize: rowNum 및 rosStatus 컬럼의 폭 크기 조절 가능 여부. [default:false, true]
rowNumStatusUniqueId: rowNum 혹은 rowStatus 사용 시 각 행 별로 유일한 ID를 사용. [default: false, true]
W3C validator를 통과하려면 본 속성을 "true"로 지정해야 함.
rowNumVisible: 연동된 DataList의 데이터를 기준으로 행 번호 표시 여부. [default:false, true]
rowNumWidth: rowNumVisible="true" 설정을 적용할 경우, rowNum 컬럼의 폭.
rowStatusHeaderValue: 헤더에 표시할 텍스트. rowStatusVisiblue="true"인 경우에만 유효.
rowStatusLocaleRef: rowStatus 컬럼에 설정할 localeRef 키.
rowStatusVisible: 각 행의 상태(추가/수정/삭제)를 별도의 컬럼에 아이콘으로 표시. [default: false, true]
rowStatusWidth: rowStatusVisible="true" 설정을 적용할 경우, rowStatus 컬럼의 폭.
rupeeMask: 화폐 단위 변경을 위해 dataType="rupee" 설정이나 changeCurrency(); 함수를 사용할 경우 적용되는 마스킹 값. [default: ""]
scrollByColumn: 가로 스크롤이 컬럼 단위로 이동. [default: false, true]
scrollByColumnAdaptive: adaptive 상태일 때 가로 스크롤을 컬럼 단위로 이동. [default: false, true]
selectedCellColor: 선택된 셀의 배경색.
selectedCellOverColor: 선택된 셀에 마우스-오버할 때 표시할 셀의 배경 색.
지정하지 않으면 rowMouseOverColor 속성 값을 사용.
selectedRowColor: 선택된 행의 배경색.
selectedRowOverColor: 선택된 셀에 마우스-오버할 때 표시할 행의 배경 색.
지정하지 않으면 rowMouseOverColor 속성의 값을 사용.
senseReader: 웹 접근성을 지원하기 위한 모드. [default: false, true]
setCellInputTypeCustom: inputType이 custom인 셀의 inputType을 동적으로 변경하기 위한 옵션. (typeGetter와 동시에 사용 불가)
showImageTooltip: inputType = "image"인 경우, 툴팁을을 표시. [default: false, true]
showSortableImage: 정렬 가능한 컬럼의 헤더에 정렬 이미지를 출력. [default: false, true]
showSortableUseFilter: useFilterList와 showSortableImage 속성을 동시에 사용할 때 정렬 아이콘(sortable)과 사용자 정의 필터 아이콘(useFilterList) 모두를 헤더에 표시. [default: false, true]
sortable: gridView의 헤더 클릭을 통한 데이터 정렬 지원 여부
sortedIconPosition: 정렬 관련 이미지를 표시할 위치.
sortEvent: 정렬을 수행할 이벤트를 정의. [default: ondblclick, onclick]
sortable="true"인 경우 유효.
sortOrderReverse: 헤더 클릭을 통한 데이터 정렬 시 내림차순 정렬을 먼저 수행.
summary: HTML <table> 태그의 summary 속성과 동일.
일반적으로 웹접근성 준수를 위해 사용.
summaryAuto: 웹접근성 지원 시, GridView table 속성 중 summary 항목에 헤더 컬럼 명을 자동으로 설정.
summaryOnlyAuto: 헤더 타이틀이 HTML 태그를 포함한 경우, 태그를 제외한 텍스트만 summary 항목으로 지정. [default: false, true]
syncScroll: 다수의 GridView에 대해 동시에 세로 스크롤링을 수행.
단, GridView의 행 수가 동일한 경우에만 동작.
syncScrollId: 스크롤을 동기화할 GridView의 ID.
tengeMask: 화폐 단위 변경을 위해 dataType="tenge" 설정이나 changeCurrency(); 함수를 사용할 경우 적용되는 마스킹 값. [default: ""]
titleAuto: title을 자동 생성. [default: false, true]
헤더가 inputType = "text"이고,
셀이 inputType="text"(혹은 link, checkbox, button, radio, select(tableRender = "ul"인 경우), secret)인 경우 때,
셀의 title 속성 값을 자동으로 생성함.
titleFormatter: 사용자가 정의한 값을 title 속성으로 사용. [default: false, true]
헤더가 inputType = "text"이고,
셀이 inputType="text"(혹은 link, checkbox, button, radio, select(tableRender = "ul"인 경우), secret)인 경우 때,
사용자가 정의한 값을 title 속성으로 사용. (웹 접근성 지원용.)
tooltipDisplay: 전체 데이터가 셀에 모두 표시되지 않는 경우, 마우스-오버 시 툴팁으로 데이터를 표시. [default: false, true]
tooltipDisplayColumn: 특정 컬럼만 tooltip이 표현되도록 컬럼명을 설정함. [default: false, true]
tooltipFormatter: tooltipDisplay="true"인 경우, 툴팁 내용을 변환할 함수.
해당 함수는 rowIndex, colIndex, label, isOverflow를 인자로 받아 스트링을 반환.
tooltipFormatterHeader: tooltipDisplay="true"인 경우, 툴팁 내용을 변경할 사용자 함수.
사용자 함수는 colId, label을 인자로 받아 스트링을 반환.
tooltipHeader: 헤더에 툴팁을 표시. [default: false, true]
기존의 툴팁 관련 속성이 tooltipDisplay 및 tooltipDisplayTime 등과 기능이 일치.
tooltipHeaderShowAlways: 헤더 내용의 잘림 여부에 상관 없이 항상 툴팁을 표시할지 여부. [default: false, true]
헤더에 마우스 커서를 이동할 경우 툴팁이 항상 표시됨. 단, 데이터가 공백("")인 경우는 제외.
tooltipPositionX: 툴팁의 X 좌표. (단위: px) [default: 20]
Body 셀의 왼쪽 끝이 원점.
좌표 계산용 수식도 사용 가능. cellWidth(셀의 폭)와 cellHeight(셀의 높이)를 수식에 사용 가능.
tooltipPositionY: 툴팁의 X 좌표. (단위: px) [default: cellHeight+3]
Body 셀의 왼쪽 상단이 원점.
좌표 계산용 수식도 사용 가능. cellWidth(셀의 폭)와 cellHeight(셀의 높이)를 수식에 사용 가능.
tooltipShowAlways: 툴팁을 항상 표시. [default: false, true]
"true"로 설정할 경우 데이터가 공백("")인 경우를 제외하고는 항상 데이터를 툴팁으로 표시함.
tooltipShowAlwaysColumns: 툴팁을 항상 표시할 컬럼을 지정. [default: ""]
데이터가 공백("")인 경우를 제외하고는 해당 컬럼에서는 항상 데이터가 툴팁으로 표시됨.
useCtrlKey: Ctrl 키를 통한 복수의 셀 선택을 허용. [default: true, false]
useCtrlOnMultisort: 다중 정렬을 위해 Ctrl 키를 통한 복수의 컬럼 선택을 허용.
useFilterList: 필터링 대상 값을 목록으로 표시. [default: false, true]
이 때 목록의 첫번째 항목으로 "사용자 필터"를 표시함.
사용자가 "사용자 필터"를 클릭하면 사용자 지정 필터 팝업 창이 표시됨. GridView 전체에 설정.
useFilterListSync: DataList의 setFilter(); 및 setColumnFilter(); 등의 함수를 통해 필터링한 경우, 해당 필터를 필너 목록에 표시. [default: false, true]
GridView 전체에 설정.
userData1: 사용자 정의 데이터 속성.
getUserData("userData1") API를 통해 설정한 값을 얻어올 수 있음.
userData2: 사용자 정의 데이터 속성.
getUserData("userData2") API를 통해 설정한 값을 얻어올 수 있음.
userData3: 사용자 정의 데이터 속성.
getUserData("userData3") API를 통해 설정한 값을 얻어올 수 있음.
useShiftKey: shift key를 이용하여 복수 셀의 선택에 대한 적용 여부.
visibleRowNum: 화면에 표현할 행 수.
"all"로 설정 시 모든 행이 스크롤 없이 표시됨.
wheelRows: 마우스 휠을 이용하여 세로 스크롤이 이동 될 때 한번 이동하는 행의 수. [default:3]
wheelStop: 스크롤이 맨 아래로 내려갔을 때 wheel을 한 경우 브라우저 스크롤을 중단. [default: false, true]

Event Detail

onaftercolumnmove

컬럼이동이 발생한 직후 발생.

Parameter
name	type	description
info	Object	startColumnID, startColumnIndex, endColumnID, endColumnIndex를 포함한 오브젝트를 반환.

onaftercolumnresize

컬럼 리사이즈 직후 발생.

Parameter
name	type	description
info	Object	colIndex, oldWidth, newWidth를 포함한 오브젝트를 반환.

onafteredit

셀의 수정이 끝나서 포커스가 빠져나온 경우 발생.
oneditend 후에 발생.

Parameter
name	type	description
row	Number	셀의 행 index
col	Number	셀의 열 index
value	String	셀의 입력된 값

onbeforecolumnmove

컬럼이동이 발생하기 직전에 발생.

Parameter
name	type	description
info	Object	startColumnID, startColumnIndex, endColumnID, endColumnIndex를 포함한 오브젝트를 반환.

onbeforeedit

셀 수정모드로 들어가기 전에 발생.

Parameter
name	type	description
row	Number	셀의 행 index
col	Number	셀의 열 index (config.xml에서 colIdToColIndex 속성을 true로 줘야 한다.)
value	String	셀의 입력된 값

onbeforesort

컬럼 정렬 직전에 발생.

Parameter
name	type	description
sortInfo	Object	headerId, bodyColId, sortOrder를 포함한 오브젝트를 반환.

onblankclick

gridView 영역 내의 빈 화면을 클릭할 때 발생.

Parameter
name	type	description
e	Object	event 객체

onbodymouseout

그리드의 body에 마우스가 벗어난 경우 발생.

Parameter
name	type	description
info	Object	rowIndex, colIndex를 포함한 오브젝트를 반환한다.

Sample

onbodymouseover

그리드의 body에 마우스가 오버된 경우 발생.

Parameter
name	type	description
info	Object	rowIndex, colIndex를 포함한 오브젝트를 반환한다.

Sample

oncellclick

셀이 클릭 된 경우 발생.

Parameter
name	type	description
row	Number	클릭된 셀의 행 index
col	Number	클릭된 셀의 열 index
colId	String	클릭된 셀의 컬럼 id

oncelldblclick

셀이 더블 클릭된 경우 발생.

Parameter
name	type	description
row	Number	클릭된 셀의 행 index
col	Number	클릭된 셀의 열 index
colId	String	클릭된 셀의 컬럼 id

oncellindexchange

방향키 또는 마우스를 이용하여 셀을 선택하여 선택 된 셀이 변경되거나 API를 이용하여 cell의 focus를 적용하여 선택 된 셀이 변경되었을 때 발생.

Parameter
name	type	description
row	Number	현재 선택 된 셀의 행 index
col	Number	현재 선택 된 셀의 열 index
oldRow	Number	이전 셀의 행 index
oldCol	Number	이전 셀의 열 index

oncolumnindexchange

방향키 또는 마우스를 이용하여 셀을 선택하여 선택 된 셀의 열이 변경되거나 API를 이용하여 cell의 focus를 적용하여 선택 된 셀의 열이 변경되었을 때 발생.

Parameter
name	type	description
col	Number	현재 선택 된 셀의 열 index
oldCol	Number	이전 열 index

oncolumnwidthchange

컬럼 길이가 변하는 경우 발생.

Parameter
name	type	description
info	Object	columnIndex, columnID, oldWidth, newWidth를 포함한 오브젝트를 반환.

oncustomcopy

gridView의 copy이벤트를 대체할 이벤트 정의.
단, 기본 copy이벤트를 대체하고 싶을 경우 해당 이벤트 함수가 false를 반환함.

Parameter
name	type	description
e	Object	Event 객체

oncustompaste

gridView의 paste이벤트를 대체할 이벤트 정의.
단, 기본 paste이벤트를 대체하고 싶을 경우 해당 이벤트 함수가 false를 반환함.

Parameter
name	type	description
e	Object	Event 객체

ondatadragover

dataDragDrop 옵션이 true일때, 데이터를 다른 그리드에 오버하면 발생하는 이벤트.
데이터가 오버된 컴포넌트에서 이벤트가 발생.

Parameter
name	type	description
fromId	String	데이터 드래그가 시작된 그리드의 id.
fromRowIndex	Number	드래그가 시작된 행의 index

ondatadragstart

dataDragDrop 옵션이 true일때, 데이터 드래그를 시작하면 발생하는 이벤트.
드래그를 시작하는 컴포넌트에서 이벤트가 발생.

Parameter
name	type	description
rowIndex	Number	드래그 대상 행의 index

ondatadrop

dataDragDrop 옵션이 true일때, 데이터를 다른 그리드에 드랍하면 발생.
데이터가 드랍된 컴포넌트에서 이벤트가 발생.

Parameter
name	type	description
info	Object	드랍된 데이터 정보

ondateselect

inputType 이 calendar인 경우 날짜 선택 시 발생.

Parameter
name	type	description
row	Number	수정되고 있는 셀의 행 번호
col	Number	수정되고 있는 셀의 열 번호
dateStr	String	선택한 날짜의 문자열
dateObj	Date	선택한 날짜의 Date 객체

Sample

//사용자가 2002년 04월 15일을 선택 한 경우 엔진에서 넘겨주는 파라메터 예시 row : 2 col : 1 dateStr : "20020415" (String 객체) dateObj : Mon Apr 15 2002 00:00:00 GMT+0900 (Date 객체)

oneditdblclick

수정중인 셀에 더블클릭시 발생.
inputType="text", "textImage", "drilldown", 혹은 "secret"인 경우만 지원.

Parameter
name	type	description
row	Number	더블클릭된 셀의 행 index
col	Number	더블클릭된 셀의 열 index
colId	String	클릭된 셀의 컬럼 id

oneditend

셀의 에디트가 끝난 경우 발생하며, onafteredit보다 먼저 발생.

Parameter
name	type	description
row	Number	셀의 행번호
col	Number	셀의 열번호
value	String	입력한 값

oneditkeydown

셀의 에디트시 키를 누른 경우 발생.
Opera와 Firefox에서 2-byte짜리 문자(한글)를 입력할 때는 첫 입력시 또는 문자 조합이 완료된 후에만 발생.

Parameter
name	type	description
info	Object	rowIndex, colIndex를 포함한 오브젝트를 반환한다.

Sample

oneditkeyup

키보드에서 키를 눌렀다 놓았을 때 발생.
rowIndex, colIndex, oldValue, newValue, keyCode, inputType를 포함한 JSON객체가 인자로 추가로 넘어옴.
inputType이 [text, textarea, textImage, secret, calendar] 인 경우에만 지원하는 이벤트.

Parameter
name	type	description
info	JSON	rowIndex, colIndex, oldValue, newValue, keyCode, inputType를 포함한 JSON을 반환. info.inputType : 이벤트가 발생한 cell의 inputType

Sample

<w2:gridView id="gridView1" ev:oneditkeyup="scwin.gridView1_oneditkeyup" dataList="dataList1"> ... </w2:gridView> scwin.gridView1_oneditkeyup = function(info) { var logStr = "rowIndex=" + info.rowIndex + ", colIndex=" + info.colIndex + ", colID=" + info.colID + ", inputType=" + info.inputType; logStr += ", oldValue=" + info.oldValue + ", newValue=" + info.newValue + ", keyCode=" + info.keyCode; WebSquare.logger.printLog(logStr); console.log(logStr); }

onfilereadend

gridView에 엑셀 업로드가 끝난 뒤 발생.

Parameter
name	type	description
value	String	업로드한 파일명

Sample

onfooterclick

footer가 클릭된 경우 발생.

Parameter
name	type	description
footerId	String	클릭된 footer의 id

onheaderclick

header가 클릭된 경우 발생.

Parameter
name	type	description
headerId	String	클릭된 header의 id

onheaderdblclick

header가 더블클릭된 경우 발생.

Parameter
name	type	description
headerId	String	더블클릭된 header의 id

onkeydown

키보드에서 키를 눌렀을 때 발생.

Parameter
name	type	description
e	Object	Event 객체

onkeyup

키보드에서 키를 눌렀다 놓았을 때 발생.

Parameter
name	type	description
e	Object	Event 객체

onrightbuttonclick

body영역의 셀에서 마우스 오른쪽 버튼이 클릭된 경우 발생.

Parameter
name	type	description
row	Number	클릭된 셀의 행 index
col	Number	클릭된 셀의 열 index

onrowindexchange

방향키 또는 마우스를 이용하여 셀을 선택하여 선택 된 셀의 행이 변경되거나 API를 이용하여 cell의 focus를 적용하여 선택 된 셀의 행이 변경되었을 때 발생.

Parameter
name	type	description
row	Number	현재 선택 된 셀의 행 index
oldRow	Number	이전 행의 index

onrownumclick

rowNum Column이 클릭된 경우 발생.

Parameter
name	type	description
row	Number	클릭된 셀의 행 index

onrowstatusclick

rowStatus Column이 클릭된 경우 발생.

Parameter
name	type	description
row	Number	클릭된 셀의 행 index

onscrollend

세로 스크롤이 하단에 닿을 때 발생.

onscrollx

가로 스크롤을 움직이는 경우 발생.

onscrolly

세로 스크롤을 움직이는 경우 발생.

onsort

sortable 속성이 적용된 헤더에서 클릭이나 더블클릭을 통하여 정렬방식이 변경되었을 경우 발생.

onsubtotalclick

subtotal이 클릭된 경우 발생.

Parameter
name	type	description
info	JSON	colID, startRowIndex, endRowIndex, element를 포함한 JSON

onsubtotaldblclick

subtotal이 더블클릭된 경우 발생.

Parameter
name	type	description
info	JSON	colID, startRowIndex, endRowIndex, element를 포함한 JSON

ontextimageclick

inputType 이 textImage 인 경우 image가 클릭 된 경우 발생.

Parameter
name	type	description
row	Number	클릭된 셀의 행 번호
col	Number	클릭된 셀의 열 번호

ontoggleclick

inputType이 drilldown일 때, 토글버튼 클릭시 발생.

Parameter
name	type	description
isCollapsed	Boolean	펼치는지 접히는지의 여부
rowIndex	Number	클릭된 셀의 rowIndex

onviewchange

키보드 또는 마우스 조작을 통해 값이 변경된 경우 발생.
스크립트를 통해 값이 변경된 경우에는 발생하지 않음. (native onchange 이벤트와 유사함.)

Parameter
name	type	description
info	Object	oldValue, newValue, rowIndex, colIndex를 포함한 오브젝트를 반환한다.

Sample

Method Detail

advancedExcelDownload( options , infoArr )

그리드의 데이터를 엑셀 파일로 저장. (JDK 1.5이상에서 사용 가능)

Parameter
name	type	required	description
options	Object	Y	JSON 형태로 저장된 그리드의 엑셀 다운로드 옵션. 파일 정보 관련 옵션 다운로드 요청 관련 옵션 다운로드 데이터 관련 옵션 Excel 파일 관련 옵션 Excel 파일 스타일 관련 옵션 Excel 파일 스타일 관련 옵션 - Header Excel 파일 스타일 관련 옵션 - Body Excel 파일 스타일 관련 옵션 - SubTotal Excel 파일 스타일 관련 옵션 - Footer Excel 파일 스타일 관련 옵션 - 홀/짝수 줄 행 번호 표시 컬럼 관련 옵션 행 번호 표시 컬럼 스타일 관련 옵션 - Header 행 번호 표시 컬럼 스타일 관련 옵션 - Body 행 번호 표시 컬럼 스타일 관련 옵션 - Footer 행 번호 표시 컬럼 스타일 관련 옵션 - Subtotal 상태창 관련 옵션 대용량 다운로드 관련 옵션 줄바꿈 관련 옵션 출력 황목 관련 옵션 병합 상태 관련 옵션 컬럼 이동 관련 옵션 필터 관련 옵션 인쇄 관련 옵션 기타
infoArr	Object	N	그리드에 대한 내용을 추가로 다른 셀에 표현하는 경우 사용하는 배열

Sample

//별도의 옵션 없이 excel을 download 할 경우 var excelOpt = {}; //excel download 옵션 excelOpt.fileName = "excelData.xls"; //또는 xlsx 확장자 사용 gridView1.advancedExcelDownload( excelOpt );

advancedExcelUpload( options )

엑셀 파일을 읽어 그리드의 데이터를 설정. (JDK 1.5 이상에서 사용 가능)
업로드하는 엑셀 파일이 Excel 97 이상인 경우 지원. (Excel 5.0/7.0 미지원.)

Parameter
name	type	required	description
options	Object	Y	JSON형태로 저장된 그리드의 엑셀 업로드 옵션 업로드 정보 관련 옵션 업로드 데이터 관련 옵션 업로드 항목 관련 옵션 컬럼 설정 관련 옵션 업로드 팝업창 기타

Sample

//별도의 옵션 없이 excel을 upload 할 경우 gridView1.advancedExcelUpload( {} ); // 별도의 옵션을 지정하지 않는 경우 빈 객체를 넘겨야 함.

changeCurrency( columnID , dataType , displayFormat , delimeter , decimalDelimeter )

컬럼 단위로 화면에 나타나는 셀 값들의 화폐 단위를 동적으로 변경.
단, 컬럼의 dataType이 "number", "tenge", "rupee", "euro"인 경우만 지원. (gridView.column의 관련 속성) dataType="number" dataType="tenge" dataType="rupee" dataType="euro"

Parameter
name	type	required	description
columnID	String	Y	화폐단위를 적용할 컬럼 id
dataType	String	Y	적용할 화폐단위(number, euro, rupee, tenge)
displayFormat	String	N	컬럼에 적용할 displayFormat
delimeter	String	N	통화 구분자
decimalDelimeter	String	N	통화 소수 구분자

Sample

gridView1.changeCurrency("standardAmt", "euro", "#.###,00");를 호출하면, 컬럼 ID가 "standardAmt"인 컬럼의 중의 cell값이 "1234"인 경우, gridView에 나타나는 값은 "1.234,00" 이 된다. 또한 gridView1에 옵션으로 다음과 같이 설정되어 있다면, euroMask="#.###,00" gridView1.changeCurrency("standardAmt", "euro");를 호출하면, 컬럼 ID가 "standardAmt"인 컬럼의 중의 cell값이 "1234"인 경우, gridView에 나타나는 값은 동일하게 "1.234,00" 이 된다.

checkAll( colIndex , dataValue )

체크 박스로 이루어진 열을 한번에 체크하거나 언체크.

Parameter
name	type	required	description
colIndex	String	Y	체크 박스 열의 column id 또는 index.
dataValue	String	Y	체크 여부에 대한 true/false 또는 trueValue/falseValue 또는 1/0. (valueType을 정의 하지 않는 경우 check는 1, uncheck는 0으로 설정 된다).

clearGroupby( )

groupBy를 해제.

clearRowVisible( )

setRowVisible(); API를 이용하여 숨김 처리한 행을 모두 표시하도록 처리. (관련 함수) setRowVisible();

Sample

// (예제) // setRowVisible로 숨김 처리한 행을 모두 표시. gridView1.clearRowVisible();

drillTo( rowIndex )

drilldown 사용시 rowIndex에 해당하는 행을 표현하기 위해 모든 조상 행들을 오픈.

Parameter
name	type	required	description
rowIndex	Number	Y	화면에 표현하려는 행의 인덱스

getAllDisplayData( )

화면에 보이는 data를 1차원 배열로 반환한다.(displayFormat등이 적용 된 data)
본 API는 filter는 무시되며 filter가 반영 된 Data는 getAllVisibleData API를 사용.

Return
type	description
Array	data가 담긴 1차원 배열

getAllDisplayJSON( )

화면에 (displayFormat 등이 적용되어)출력된 데이터를 JSON으로 반환.
데이터가 필터링된 경우, 필터링은 무시하고 전체 데이터를 JSON으로 반환. 필터링된 경우 소트상태 또한 무시.
관련 함수: getAllVisibleJSON (필터링된 결과를 JSON으로 반환할 경우)
비슷한 함수: getAllDisplayData (전체 데이터를 1차원 배열로 반환), getAllDisplayXML (전체 데이터를 XML로 반환)

Return
type	description
JSON	JSON 데이터

Sample

gridView1.getAllDisplayJSON = function () {return JSON;}

getAllDisplayXML( )

화면에 보이는 data를 XML로 반환한다.(displayFormat등이 적용 된 data)
본 API는 filter는 무시되며 filter가 반영 된 Data는 getAllVisibleXML API를 사용.

Return
type	description
XML	XML 데이터

getAllFocusedIndex( )

선택 된 셀의 rowIndex와 colIndex를 반환.
보통 ctrl키를 이용하여 다중 cell이 선택 된 경우 사용.

Return
type	description
Array	선택 된 셀의 rowIndex와 colIndex의 정보가 담긴 JOSN을 담은 array

Sample

//ctrl키를 이용하여 다중 cell을 선택하였을 경우 gridView1.getAllFocusedIndex(); //(반환 예) [ {col: 1, row: 2}, {col: 0, row: 4} ]

getAllFocusedRowIndex( )

포커스 된 셀들의 rowIndex를 반환한다. ctrl키를 이용하여 다중 cell을 선택한 경우 사용.

Return
type	description
Array	포커스 된 셀들의 rowIndex를 담은 array

Sample

//ctrl키를 이용하여 다중 cell을 선택하였을 경우 gridView1.getAllFocusedRowIndex(); //(반환 예) [ 0 , 1 ]

getAllVisibleData( )

현재 보이는 data를 1차원 배열로 반환.(filter 적용)

Return
type	description
Array	data가 담긴 1차원 배열

Sample

//DataList에 2개의 컬럼이 정의 되고 4행의 데이터가 set 된 경우 gridView1.getAllVisibleData(); // (반환 예) ["아이유", "19930516", "정형돈", "19780207", "유승호", "19930817", "김민희", "19820301"]

getAllVisibleJSON( )

화면에 (displayFormat 등이 적용되어)출력된 데이터를 JSON으로 반환.
데이터가 필터링된 경우, 필터링이 적용된 데이터를 JSON으로 반환.

Return
type	description
JSON	JSON 데이터

Sample

gridView1.getAllVisibleJSON = function () {return JSON;}

getAllVisibleXML( )

현재 보이는 data를 XML로 반환.(filter 적용)

Return
type	description
XML	XML 데이터

getAncestorRowIndexArray( rowIndex )

drilldown 사용시 rowIndex에 해당하는 행의 모든 조상 행들의 rowIndex를 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	조상을 찾으려는 행의 index

Return
type	description
Array	rowIndex가 담긴 1차원 배열

getBottomRowIndex( )

현재 눈에 보여지는 gridVeiw의 최하단 row의 rowIndex를 반환.
그려진 행이 없으면 "-1"이 반환됨.

Return
type	description
Number	최하단 row의 rowIndex

Sample

// 총 10건의 row의 데이터가 셋팅되고 화면에는 4건의 데이터가 보여지는 경우, // gridView의 height가 작아 10건의 데이터를 다 표현하지 못하고 스크롤이 생겨 4건의 데이터만 눈에 보여질 때, // 아래를 수행. gridView1.getBottomRowIndex(); // (반환 예) 3

getCellBackgroundColor( rowIndex , colIndex )

rowIndex와 colIndex에 해당하는 셀의 배경색을 반환.
API로 별도의 BackgroundColor를 지정하지 않은 경우 ""(empty string)이 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	배경색을 반환할 행 index
colIndex	String\|\|Number	Y	배경색을 반환할 열 index 또는 id

Return
type	description
String	해당 행에 지정된 배경색

getCellChecked( rowIndex , colIndex )

rowIndex와 colIndex로 해당하는 셀의 check 여부를 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	셀의 행 index
colIndex	Number\|\|String	Y	셀의 열 index 또는 id

Return
type	description
Boolean	셀의 check여부

getCellClass( rowIndex , colIndex )

grid 셀에 동적으로 적용한 사용자 class 이름을 반환

Parameter
name	type	required	description
rowIndex	Number	Y	셀의 행번호
colIndex	Number	Y	셀의 열번호 혹은 컬럼 아이디

Return
type	description
String:Y	셀에 적용된 사용자 class이름

getCellColor( rowIndex , colIndex )

rowIndex와 colIndex에 해당하는 셀의 글자색을 반환.
API로 별도의 글자색을 지정하지 않은 경우 ""(empty string)이 반환됨.

Parameter
name	type	required	description
rowIndex	Number	Y	글자색을 반환할 행 index
colIndex	String\|\|Number	Y	글자색을 반환할 열 index 또는 id

Return
type	description
String	해당 cell의 글자색

getCellDisabled( rowIndex , colIndex )

colIndex와 rowIndex 해당하는 셀의 disabled속성 값을 반환.
disable을 별도로 지정하지 않은 경우 ""(empty string)이 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	disabled속성을 가져올 행 index
colIndex	String\|\|Number	Y	disabled속성을 가져올 열 index 또는 id

Return
type	description
Boolean	해당 셀에 적용된 disabled속성값으로 별도로 지정하지 않은 경우 ""(empty string)이 반환됨.

getCellDisplayData( rowIndex , colIndex )

rowIndex와 colIndex에 해당하는 셀의 화면에 보이는 데이터를 반환.
displayFormat등이 적용 된 data.

Parameter
name	type	required	description
rowIndex	Number	Y	셀의 행 번호
colIndex	String\|\|Number	Y	셀의 컬럼 index 또는 id

Return
type	description
String	rowIndex와 colIndex에 해당하는 셀의 화면에 보이는 데이터

getCellPosition( row , colIndex , propertyName )

셀의 위치 정보(top 또는 left)를 반환.

Parameter
name	type	required	description
row	Number	Y	셀의 행 index (세로 스크롤 위치와는 무관하게 현재 그리드에서 최상단 행에 위치한 셀의 행 index를 0으로 보고 계산.)
colIndex	String\|\|Number	Y	셀의 컬럼 index 또는 id
propertyName	String	Y	[top, left] 반환 할 위치 정보명

Return
type	description
Number	셀의 위치 정보(top이나 left)의 값

getCellReadOnly( rowIndex , colIndex )

colIndex와 rowIndex에 해당하는 셀의 readonly 속성 값을 반환.
별도로 readonly 속성을 지정하지 않은 경우 ""(empty string)을 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	readonly속성을 가져올 행 index
colIndex	String\|\|Number	Y	readonly속성을 가져올 열 index 또는 id

Return
type	description
Boolean	해당 셀에 적용된 readonly속성값

getCellSize( row , colIndex , sizeName )

셀의 크기 정보(width나 height)를 반환.

Parameter
name	type	required	description
row	Number	Y	셀의 행 index
colIndex	String\|\|Number	Y	셀의 열 index 또는 id
sizeName	String	Y	[width, height] 반환 할 크기 정보명.

Return
type	description
Number	셀의 크기 정보(width나 height)의 값

Sample

//gridView에 3개의 column과 2개의 row 데이터가 셋팅 된 경우 //1번째 row의 name 컬럼의 width를 가져올 때 var tmpCellWidth = gridView1.getCellSize(0,"name","width"); // (반환 예) 154 //1번째 row의 2 컬럼의 height를 가져올 때 var tmpCellHeight = gridView1.getCellSize(0,1,"height"); // (반환 예) 20

getCheckedData( colIndex )

colIndex에 해당하는 열이 radio/checkbox일 경우 check된 행의 data를 배열로 반환한다. 해당 컬럼이 checkbox가 아닐 경우 비어있는 배열을 반환한다.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	열 index 또는 id

Return
type	description
Array	data가 담긴 2차원 배열.

Sample

//checkbox, 이름, 생년월일이 정의 된 gridView가 정의되어 있고 checkbox의 컬럼의 ID가 chk 인 경우 var tmpRs = gridView1.getCheckedData("chk"); // (반환 예) [["1","정형돈","19780207"],["1","유승호","19930817"],["1","김민희","19820301"]]

getCheckedIndex( colIndex )

colIndex에 해당하는 열의 inputType속성이 radio/checkbox인 경우 check된 행의 index를 배열로 반환.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	컬럼의 index 또는 id

Return
type	description
Array	행 index가 담긴 1차원 배열

Sample

//checkbox, 이름, 생년월일이 정의 된 gridView가 정의되어 있고 checkbox의 컬럼의 ID가 chk 인 경우 var tmpRs = gridView1.getCheckedIndex("chk"); // (반환 예) [1,2,3]

getCheckedJSON( colIndex )

colIndex에 해당하는 열이 radio/checkbox일 경우 check된 행의 JSON Data를 Array에 담아 반환.
해당 컬럼이 checkbox가 아닐경우 비어있는 배열을 반환.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	열 index 또는 id

Return
type	description
Array	JSON Data를 담은 1차원 배열

Sample

//checkbox, 이름, 생년월일이 정의 된 gridView가 정의되어 있고 checkbox의 컬럼의 ID가 chk 인 경우 var tmpRs = gridView1.getCheckedJSON("chk"); // (반환 예) [{"name":"정형돈","birthday":"19780207","chk":"1","rowStatus":"U"},{"name":"유승호","birthday":"19930817","chk":"1","rowStatus":"U"},{"name":"김민희","birthday":"19820301","chk":"1","rowStatus":"U"}]

getCheckedXML( colIndex )

colIndex에 해당하는 열이 radio/checkbox일 경우 check된 행의 data를 XML로 반환.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	열 index 또는 id

Return
type	description
XML	XML Data

Sample

//checkbox, 이름, 생년월일이 정의 된 gridView가 정의되어 있고 checkbox의 컬럼의 ID가 chk 인 경우 var tmpRs = gridView1.getCheckedData("chk"); //return 예시 ) <list> <map status="1" statusValue="U" id="1"> <chk>1</chk> <name>정형돈</name> <birthday>19780207</birthday> </map> <map status="1" statusValue="U" id="2"> <chk>1</chk> <name>유승호</name> <birthday>19930817</birthday> </map> </list>

getChildrenRowIndexArray( rowIndex )

drilldown 사용시 rowIndex에 해당하는 행의 자식(1 depth 하위)행들의 rowIndex를 배열로 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	자식을 찾으려는 행의 index

Return
type	description
Array	rowIndex가 담긴 1차원 배열

getColIdByHeaderId( headerId )

header의 columnId에 해당하는 body의 columnId를 반환.

Parameter
name	type	required	description
headerId	String	Y	header의 ID

Return
type	description
String	body의 columnId

getColumnBackgroundColor( colIndex )

colIndex에 해당하는 열의 배경색을 반환.
API로 별도의 backgroundColor를 지정하지 않은 경우 ""(empty string)을 반환.

Parameter
name	type	required	description
colIndex	String\|\|Number	Y	배경색을 반환할 열 index 또는 id

Return
type	description
String	해당 열에 지정된 배경색

getColumnColor( colIndex )

colIndex에 해당하는 열의 글자색을 반환.
API로 별도의 글자색을 지정하지 않은 경우 ""(empty string)을 반환.

Parameter
name	type	required	description
colIndex	String\|\|Number	Y	글자색을 반환 할 열 index 또는 id

Return
type	description
String	해당 열에 글자색

getColumnDataListInfo( colIndex )

colIndex에 해당하는 컬럼에 바인딩된 데이터리스트정보를 반환.
inputType="selectbox", "autoComplete", 혹은 "checkcombobox" 컬럼만 지원.

Parameter
name	type	required	description
colIndex	Number	Y	컬럼의 index

Return
type	description
Object:Y	dataList id

getColumnDisabled( colIndex )

colIndex에 해당하는 열에 disabled속성 값을 반환.
별도로 disable을 지정하지 않은 경우 ""(empty string)을 반환.

Parameter
name	type	required	description
colIndex	String\|\|Number	Y	disabled속성을 가져올 열 index 또는 id

Return
type	description
Boolean	해당 열에 적용된 disabled속성값

getColumnID( colIndex )

컬럼의 index를 입력받아 해당하는 컬럼의 id를 반환.

Parameter
name	type	required	description
colIndex	Number	Y	컬럼의 index

Return
type	description
String	컬럼의 ID

getColumnIdListMultiRow( )

그리드의 모든 컬럼의 ID를 2차원 배열 형태로 반환.
첫 번째 차원에는 각 multiRow에 해당하는 rowIndex가 할당됨.
두 번째 차원에는 각 multiRow에 해당하는 column의 ID가 배열 형태로 할당됨.
단일 row인 경우에도 2차원 배열로 반환하며 이 때 첫번째 차원의 크기는 1이다.

Return
type	description
Array	그리드의 모든 컬럼의 ID값을 담은 2차원 배열.

Sample

// case1 : 두 개의 multiRow로 이루어져 있고 첫번째 행은 col1,col2 두번째 행은 col3,col4로 이루어진 경우 gridView1.getMultiRowIndex(); // 결과값 : [["col1","col2"], ["col3,col4"]] // case2 : 단일 row로 이루어져 있고 컬럼이 col1,col2,col3인 경우 gridView1.getMultiRowIndex(); // 결과값 : [["col1","col2","col3"]]

getColumnIndex( colIndex )

컬럼 id를 입력받아 해당하는 컬럼의 index를 반환.

Parameter
name	type	required	description
colIndex	String	Y	컬럼 id

Return
type	description
Number	컬럼의 index

getColumnNodeSet( colIndex )

inputType = "select" 또는 "autoComplete"인 경우, 연결된 NodeSet 정보를 반환.
setColumnNodeSet API와 대응.

Parameter
name	type	required	description
colIndex	String\|\|Number	Y	컬럼 ID 혹은 Index

Return
type	description
Object	itemsetObj colIndex에 해당하는 컬럼의 NodeSet정보를 담은 객체 해당 객체는 nodeset, label, value 등을 포함.

Sample

var itemsetObj = gridView.getColumnNodeSet("col1"); var nodeset = itemsetObj.nodeset; var label = itemsetObj.label; var value = itemsetObj.value;

getColumnOrder( byName )

현재 컬럼 순서를 배열로 반환한다. 기본적으로는 컬럼 index를 담은 배열을 반환하고, byName이 true인 경우 id를 담은 배열을 반환한다.

Parameter
name	type	required	description
byName	Boolean	N	[defulat:false, true]반환 할 컬럼의 순서에서 컬럼 index 대신 컬럼 id를 사용할지 여부

Return
type	description
Array	현재 컬럼 순서를 차례대로 담고 있는 배열

getColumnReadOnly( colIndex )

colIndex에 해당하는 열에 적용된 readonly속성 값을 반환.
별도의 readonly가 지정되지 않은 경우 ""(empty string)을 반환.

Parameter
name	type	required	description
colIndex	String\|\|Number	Y	열 index 또는 id

Return
type	description
Boolean	해당 열에 적용된 readonly속성값

getColumnType( colIndex )

colIndex에 해당하는 열의 inputType 속성 값을 반환.

Parameter
name	type	required	description
colIndex	String\|\|Number	Y	column id 또는 index

Return
type	description
String	colIndex에 해당하는 컬럼의 타입

getColumnVisible( colIndex )

colIndex에 해당하는 열의 visible여부를 반환.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	visible여부를 반환할 colunm의 index 또는 id

Return
type	description
Boolean	column의 visible여부

getDataDragDrop( )

그리드의 컬럼에 dataDragDrop 값을 반환.

Return
type	description
Boolean	dataDragDrop

Sample

gridView1.getDataDragDrop(); // 현재 설정된 dataDragDrop 값을 반환

getDataLength( )

[deprecated]getRowCount()를 사용한다. 행의 수를 반환.

Return
type	description
number	행의 수

getDataList( )

현재 binding된 dataList의 Id를 반환. (dataList속성 값)

Return
type	description
String	data의 Id

getDataListInfo( )

컴포넌트와 바인딩된 DataList를 반환.

Return
type	description
Object	nodeset, label, value id를 객체로 반환

Sample

// 사용 예 gridView1.getDataListInfo();

getDataType( colID )

특정 column의 dataType 속성을 반환.

Parameter
name	type	required	description
colID	String	Y	column의 id

Return
type	description
String	해당 column의 dataType 속성값

getDescendantRowIndexArray( rowIndex )

drilldown 사용시 rowIndex에 해당하는 행의 모든 자손 행들의 rowIndex를 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	자손을 찾으려는 행의 index

Return
type	description
Array	rowIndex가 담긴 1차원 배열

getDisabled( type , rowIndex , colIndex )

type에 따라 세부 disabled 속성을 반환. (type에 따른 세부 내용) "all" : gridView 전체, row, column, cell 에 지정된 disabled 속성값들을 전부 체크하여 해당 cell에 적용된 실제 disabled 속성값을 반환. "grid" : gridView 전체에 disabled 속성의 적용여부를 반환. "row" : 해당 row에 disabled 속성의 적용여부를 반환하며 getRowDisabled API와 동일. gridView 전체에 disabled속성을 넣더라도 해당 row에 disabled속성을 직접 넣은 경우가 아닌 경우 false를 반환. "column" : 해당 column에 disabled 속성의 적용여부를 반환하며 getColumnDisabled API와 동일. gridView 전체에 disabled속성을 넣더라도 해당 column에 disabled속성을 직접 넣은 경우가 아닌 경우 false를 반환. "cell" : 해당 cell에 disabled 속성의 적용여부를 반환하며 getCellDisabled API와 동일. gridView 전체 또는 해당 cell을 포함하는 row나 column에 disabled속성을 넣더라도 해당 cell에 disabled속성을 직접 넣은 경우가 아닌 경우 false를 반환.

Parameter
name	type	required	description
type	String	Y	[default:grid, row, column, cell, all]disabled 속성을 가져 올 type.
rowIndex	Number	Y	disabled속성을 가져올 행 index
colIndex	Number\|\|String	Y	disabled속성을 가져올 열 index 또는 id

Return
type	description
Boolean	해당 type에 적용된 disabled속성값

getFixedColumnLastIndex( includeDefaultColumn )

그리드에 fixedColumn이 설정되어 있을 경우 fixedColumn 중 맨 오른쪽 끝에 해당하는 column의 index를 반환합니다.

Parameter
name	type	required	description
includeDefaultColumn	boolean	Y	rowNum 컬럼 및 rowStatus 컬럼 갯수 포함 여부. 기본은 포함.

Return
type	description
Number	맨 오른쪽에 위치한 fixedColumn의 index

getFixedRightColumnLastIndex( )

그리드에 FixedRightColumn이 설정되어 있을 경우 FixedRightColumn 중 맨 오른쪽 끝에 해당하는 column의 index를 반환합니다.

Return
type	description
Number	맨 오른쪽에 위치한 FixedRightColumn의 index

getFixedRow( )

gridView가 가로 틀고정된 경우, 틀고정 위치를 반환. 첫번째 행일 경우 "1"을 반환.

getFocusedColumnID( )

포커스가 위치한 셀이 속한 column의 ID를 반환한다.

Return
type	description
String	포커스가 위치한 셀이 속한 column의 ID

getFocusedColumnIndex( )

포커스가 위치한 셀의 colIndex를 반환.

Return
type	description
Number	포커스가 위치한 셀의 colIndex

getFocusedRowIndex( )

포커스가 위치한 셀의 rowIndex를 반환.

Return
type	description
Number	포커스가 위치한 셀의 rowIndex

getFocusedRowStatus( )

포커스가 위치한 셀이 속한 row의 상태를 상태문자로 반환. (상태값의 세부 내용) 초기상태 : "R" 갱신 : "U" 삽입 : "C" 삭제 : "D" 삽입 후 삭제 : "V"

Return
type	description
String	포커스가 위치한 셀이 속한 row의 상태를 나타내는 문자

getFooterData( footerId , display )

footerId에 해당하는 footer의 값을 반환.
inputType="expression"인 경우 계산된 값을 반환.

Parameter
name	type	required	description
footerId	String\|\|Number	Y	footer의 id 혹은 index
display	String	N	[displayData] displayData를 넘긴 경우 foramt된 값이 반환됨.

Return
type	description
string	footerId에 해당하는 footer의 값

getFooterStyle( footerId , style )

그리드의 footerId에 해당하는 footer의 스타일 속성값을 가져옴.

Parameter
name	type	required	description
footerId	Number\|\|String	Y	그리드 컬럼의 index 또는 id
style	String	Y	가져올 스타일 속성

getFormattedHeaderValue( headerId , value )

header에 설정된 dispalyFormat으로 formatted된 값을 반환.

Parameter
name	type	required	description
headerId	String	Y	header의 id
value	String	Y	formatted될 값

Return
type	description
String	header에 설정된 formatter가 적용된 값

getGridReadOnly( )

gridView 전체에 대한 readOnly 속성을 반환한다.

Return
type	description
Boolean	그리드의 읽기 전용 속성

getHeaderBackgroundColor( headerId )

header 셀에 적용된 배경색 값을 반환.

Parameter
name	type	required	description
headerId	String	Y	header cell의 id

Return
type	description
String	header 셀의 배경색 값

getHeaderClass( headerId )

grid header셀에 동적으로 적용한 사용자 class이름 반환.

Parameter
name	type	required	description
headerId	Number	Y	header cell의 id

Return
type	description
String:Y	셀에 적용된 사용자 class이름

getHeaderColor( headerId )

header 셀에 적용 된 글씨 색상값을 반환.

Parameter
name	type	required	description
headerId	String	Y	header cell의 id

Return
type	description
String	header 셀이 글씨 색상값

getHeaderID( header )

header index로 header id를 반환.

Parameter
name	type	required	description
header	Number	Y	index

Return
type	description

getHeaderIndex( header )

header id로 header index를 반환.

Parameter
name	type	required	description
header	String	Y	id

Return
type	description

getHeaderPosition( headerId , propertyName )

header 셀의 위치 정보(top이나 left)를 반환.

Parameter
name	type	required	description
headerId	String	Y	header의 Id
propertyName	String	Y	[top, left] 반환할 위치 정보의 이름

Return
type	description
Number	header의 위치 값

getHeaderSize( headerId , sizeName )

header 셀의 크기 정보(width나 height)를 반환.

Parameter
name	type	required	description
headerId	String	Y	header의 Id
sizeName	String	Y	[width, height]반환할 크기 정보의 이름

Return
type	description
Number	header의 크기값

getHeaderValue( headerId )

header의 값을 반환.

Parameter
name	type	required	description
headerId	String	Y	header의 id

Return
type	description
String	header의 value

getMaxLength( colIndex )

그리드의 컬럼에 maxLength값 반환합니다.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	컬럼의 index 또는 id

Return
type	description
Number	maxLength값

Sample

gridView1.getMaxLength("a"); // id가 "a"인 컬럼에 maxLength를 반환

getMerged( rowIndex , colIndex )

특정 셀의 병합여부를 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	병합 여부를 알고 싶은 셀의 row Index
colIndex	Number	Y	병합 여부를 알고 싶은 셀의 column Index

Sample

gridView1.getMerged(0, 0); // (0, 0)의 병합여부를 반환.

getOpenStatus( rowIndex )

gridView에 drilldown을 적용한 경우 rowIndex에 해당하는 행의 drilldown이 열려있는지 닫혀있는지 여부를 boolean으로 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	openStatus를 가져오려는 행의 index

Return
type	description
Boolean	[true, false]drilldown의 open 여부

getOverflowX( )

overflowX 속성의 설정값을 반환.

Return
type	description
String	[default:auto, hidden, scroll]overflowX속성의 설정값

getOverflowY( )

overflowY 속성의 설정값을 반환.

Return
type	description
String	[default:auto, hidden, scroll]overflowY속성의 설정값

getParentRowIndex( rowIndex )

drilldown 사용시 rowIndex에 해당하는 행의 부모 행의 rowIndex를 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	부모를 찾으려는 행의 index

Return
type	description
Number	부모행의 rowIndex

getReadOnly( type , rowIndex , colIndex )

type에 따라 readOnly 속성을 반환. (type에 따른 세부 내용) "grid" : gridView 전체에 readOnly 속성의 적용여부를 반환. "row" : 해당 row에 readOnly 속성의 적용여부를 반환하며 getRowReadOnly API와 동일. gridView 전체에 readOnly속성을 넣더라도 해당 row에 readOnly속성을 직접 넣은 경우가 아닌 경우 false를 반환. "column" : 해당 column에 readOnly 속성의 적용여부를 반환하며 getColumnReadOnly API와 동일. gridView 전체에 readOnly속성을 넣더라도 해당 column에 readOnly속성을 직접 넣은 경우가 아닌 경우 false를 반환. "cell" : 해당 cell에 readOnly 속성의 적용여부를 반환하며 getCellReadOnly API와 동일. gridView 전체 또는 해당 cell을 포함하는 row나 column에 readOnly속성을 넣더라도 해당 cell에 readOnly 속성을 직접 넣은 경우가 아닌 경우 false를 반환. "all" : gridView 전체, row, column, cell에 지정된 readOnly 속성값들을 전부 계산하여 해당 cell에 적용된 실제 readOnly 속성값을 반환.

Parameter
name	type	required	description
type	String	Y	[default:grid, row, column, cell, all]readOnly 속성을 가져올 type
rowIndex	Number	Y	readOnly속성을 가져올 행 index
colIndex	Number\|\|String	Y	readOnly속성을 가져올 열 index 또는 id

Return
type	description
Boolean	해당 type에 적용된 readOnly속성값

getRealRowIndex( rowIndex )

drilldown을 적용 한 경우 화면에 표현 된 rowIndex를 기준으로 실제 데이터의 rowIndex를 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	현재 표시되고 있는 행의 index

Return
type	description
Number	row의 실제 index

getRowBackgroundColor( rowIndex )

rowIndex에 해당하는 행의 배경색을 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	배경색을 반환할 행의 index

Return
type	description
String	행의 배경색

getRowColor( rowIndex )

rowIndex에 해당하는 행의 글자색을 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	글자색을 반환할 행의 index

Return
type	description
String	행의 글자색

getRowDisabled( rowIndex )

rowIndex에 해당하는 행에 적용된 disabled 속성 값을 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	disabled속성을 가져올 행의 index

Return
type	description
Boolean	해당 행에 적용된 disabled속성값

getRowNumVisible( )

rowNumVisible 옵션 값을 반환.

Return
type	description
Boolean	rowNumVisible 설정 값

getRowReadOnly( rowIndex )

rowIndex에 해당하는 행에 적용된 readonly속성 값을 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	readonly속성을 가져올 행 index

Return
type	description
Boolean	해당 행에 적용된 readonly속성값으로 별도로 속성을 지정하지 않은 경우 ""(empty string)을 반환.

getRowVisible( rowIndex )

특정 row를 감추거나 표시.

Parameter
name	type	required	description
rowIndex	Number	Y	hidden여부를 가져올 row의 index.

Return
type	description
Boolean	해당 row의 visible 여부. 감춰진 상태면 false, 보이는 상태면 true 반환.

Sample

gridView1.getRowVisible(30); // 30번째 row의 visible 여부를 반환.

getSortableArr( )

header의 각 컬럼이 sortable한지 여부를 array로 반환.

Return
type	description
Boolean	각 컬럼의 sortable 여부

getSortableStatus( )

sorting된 컬럼의 순서대로 해당 컬럼의 header 정보를 담은 object를 array로 반환.
sorting된 컬럼이 없을 경우 빈 array를 반환.
반환된 array의 각 object는 colID, dataType, sortOrder를 담고 있음.
sortOrder="1"은 오름 정렬이고, sortableOrder="-1"은 내림 정렬.

Return
type	description
Object	sorting된 header의 정보

getTopRowIndex( )

현재 화면에 보여지는 최상단 row의 rowIndex를 반환.
GridView에 표현 된 데이터가 없으면 "-1"을 반환.

Return
type	description
Number	최상단 row의 rowIndex

getTotalCol( )

전체 컬럼 개수를 반환.(rowNum 및 rowStatus 컬럼 제외)

Return
type	description
Number	(rowNum 및 rowStatus 컬럼을 제외한) 전체 컬럼 개수

getTotalHeaderCol( options )

colIndex에 해당하는 열의 visible여부를 반환.

Parameter
name	type	required	description
options	Object	N	header column의 갯수를 가져올 때 설정할 옵션

Return
type	description
Number	header column의 개수

getTotalRow( )

행의 개수를 반환.

Return
type	description
Number	행의 개수

getUncheckedData( colIndex )

colIndex에 해당하는 열이 radio/checkbox일 경우 uncheck된 행의 data를 배열로 반환.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	ckeck여부를 검사할 컬럼 index 또는 id

Return
type	description
Array	row data를 배열로 저장한 배열로 2차원 배열

Sample

//checkbox, 이름, 생년월일이 순서대로 컬럼에 정의 된 gridView가 있고 inputType속성이 checkbox인 컬럼의 id가 chk인 경우 var tmpRs = gridView1.getUncheckedData("chk"); //checkbox컬럼의 id가 chk. // (반환 예) [["0","아이유","19930516"],["0","정형돈","19780207"],["0","유승호","19930817"]]

getUncheckedIndex( colIndex )

colIndex에 해당하는 열의 inputType속성이 radio/checkbox인 경우 uncheck된 행의 index를 배열로 반환.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	컬럼의 index 혹은 컬럼 id

Return
type	description
Array	행 index가 담긴 1차원 배열

Sample

//checkbox, 이름, 생년월일이 순서대로 컬럼에 정의 된 gridView가 있고 inputType속성이 checkbox인 컬럼의 id가 chk인 경우 gridView1.getUncheckedIndex("chk"); //checkbox컬럼의 id가 chk. // (반환 예) [0,2,3]

getUncheckedJSON( colIndex )

colIndex에 해당하는 열이 radio/checkbox일 경우 uncheck된 행의 data를 JSON으로 변환하여 배열에 담아 반환.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	ckeckbox여부를 검사할 열 index 또는 id

Return
type	description
Array	행의 JSON Data를 담은 1차원 배열

getUncheckedXML( colIndex )

colIndex에 해당하는 열의 inputType속성이 radio/checkbox인 경우 uncheck된 행의 data를 XML로 반환.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	컬럼의 index 또는 id

Return
type	description
XML	XML Data

Sample

//checkbox, 이름, 생년월일이 순서대로 컬럼에 정의 된 gridView가 있고 inputType속성이 checkbox인 컬럼의 id가 chk인 경우 var tmpRs = gridView1.getUncheckedXML("chk"); //checkbox컬럼의 id가 chk. // (반환 예) <list> <map status="0" statusValue="R" id="0"> <chk>0</chk> <name>아이유</name> <birthday>19930516</birthday> </map> <map status="0" statusValue="R" id="1"> <chk>0</chk> <name>정형돈</name> <birthday>19780207</birthday> </map> </list>

getVisibleColData( colIndex )

colIndex에 해당하는 열의 화면에 보이는 데이터(filter나 sort가 반영 된)를 배열로 반환.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	데이터를 가져올 컬럼의 index 혹은 컬럼 id

Return
type	description
Array	colIndex에 해당하는 열의 데이터가 담긴 배열

getVisibleRowNum( )

현재 화면(눈에 보여지는 영역)에 그려진 row의 수를 반환.
subTotal 및 footer는 제외.
총 10건의 row의 데이터가 설정된 경우, 화면에는 4건이 표시되고 넘치는 영역은 스크롤로 표현 될 때, 반환 값은 "4".

Return
type	description
Number	현재 눈에 보여지는 row의 수

groupby( Options )

둘 이상의 컬럼의 데이터를 그룹핑하여 그룹핑 결과(통계)만 표시.
columnMove 속성과 동시에 사용할 수 없음.

Parameter
name	type	required	description
Options	Object	N	그룹핑 옵션

Sample

var options = { sortIndex: [2], sortOrder: [1], hideHeader: false, hideFooter: true, groupbyHeader: { depth_0: [{colSpan:"3", value: "일자별 합계"}, {inputType: "expression", expression: " SUM('complete')", className:"aaa"}] } }; gridView1.groupby(options);

hasChild( rowIndex )

drilldown이 적용 된 경우 rowIndex에 해당하는 행이 child row를 가지고 있는지의 여부를 반환.

Parameter
name	type	required	description
rowIndex	Number	Y	child row를 가지고 있는지 검사 할 rowIndex

Return
type	description
Boolean	child row를 가지고 있는지 여부

hideGroupbyZone( )

groupbyZone 영역을 숨김 처리.

initGrid( )

전체 데이터 삭제, 필터 삭제, 컬럼 기본정보(selectbox의 nodeset 등)를 초기화하고 가지고 있던 데이터를 1차원 배열로 반환한다.

Return
type	description
array	전체 데이터를 담은 1차원 배열

isEditing( )

GridView의 현재 편집 상태를 반환.

Return
type	description
Boolean	편집중 인지의 여부

mergeByCol( options )

같은 column 내에서 같은 데이터가 연속적으로 나타나는경우 이들을 모두 병합. (세로 병합)

Parameter
name	type	required	description
options	Object	N	병합 세부 설정.

mergeByColRec( options )

mergeByCol을 수행하고, 그 후에 병합되지 않은 cell들을 대상으로 mergeByRow를 수행.
세로 병합이 더 우선순위가 높음.

Parameter
name	type	required	description
options	JSON	N	병합 세부 설정.

mergeByRestriCol( options )

같은 column 내에서 연속적으로 데이터가 같으면서 동시에 자신의 왼쪽에 위치한 column이 merge된 경우 해당 row들을 병합.
n+1컬럼에서 n컬럼을 upperColumn으로 지정한 형태.

Parameter
name	type	required	description
options	JSON	N	병합 세부 설정.

mergeByRestricRow( options )

같은 row 내에서 연속적으로 데이터가 같으면서 동시에 자신의 위쪽에 위치한 row가 merge된 경우 해당 row들을 병합.
n+1행에서 n행을 upperRow으로 지정한 형태.

Parameter
name	type	required	description
options	JSON	N	병합 세부 설정.

mergeByRow( options )

같은 row 내에서 같은 데이터가 연속적으로 나타나는경우 이들을 모두 병합. (가로 병합)

Parameter
name	type	required	description
options	JSON	N	병합 세부 설정.

mergeByRowRec( options )

mergeByRow를 수행하고, 그 후에 병합되지 않은 cell들을 대상으로 mergeByCol을 수행.
가로 병합이 더 우선순위가 높다.

Parameter
name	type	required	description
options	JSON	N	병합 세부 설정.

mergeCell( mergeInfo )

동적으로 셀을 병합.

Parameter
name	type	required	description
mergeInfo	JSON	Y	병합 대상 셀의 정보를 포함한 객체 (rowIndex, colIndex, colSpan, rowSpan)

Sample

gridView1.mergeCell({"rowIndex" : 3, "colIndex" : 2, "colSpan" : 2, "rowSpan" : 2}); // 실행결과 : (3,2) 좌표에 위치한 셀이 2*2 크기로 병합된다. // 즉, (3,2), (3,3), (4,2), (4,3)셀이 병합되며, 병합된 셀은 모두 (3,2)의 데이터를 갖는다.

mergeCells( mergeOptionStr , options )

행 또는 열 기준으로 연속적으로 같은 데이터들을 병합.

Parameter
name	type	required	description
mergeOptionStr	String	Y	자동 병합 방식을 지정. 설정 관련 string은 아래와 같음. never : mergeCells에 의해 자동으로 merge된 것들을 해제한다. bycol : 같은 column 내에서 연속적으로 데이터가 같은 row들을 병합. byrow : 같은 row 내에서 연속적으로 데이터가 같은 column들을 병합. bycolrec : bycol후, merge되지 않은 cell들을 대상으로 byrow를 실행. byrowrec : byrow후, merge되지 않은 cell들을 대상으로 bycol을 수행.
options	JSON	N	병합 세부 설정.

mergeCellsFixedCols( mergeOptionStr , options )

fixedColumn 영역 내에서 mergeCells를 실행.

Parameter
name	type	required	description
mergeOptionStr	String	Y	자동 병합 방식을 지정한다. 설정 관련 string은 아래와 같음. never : mergeCells에 의해 자동으로 merge된 것들을 해제. bycol : 같은 column 내에서 연속적으로 데이터가 같은 row들을 병합. byrow : 같은 row 내에서 연속적으로 데이터가 같은 column들을 병합. bycolrec : bycol후, merge되지 않은 cell들을 대상으로 byrow를 실행. byrowrec : byrow후, merge되지 않은 cell들을 대상으로 bycol을 수행.
options	JSON	N	병합 세부 설정.

mergeCellsFixedRows( mergeOptionStr , options )

fixedRow 영역 내에서 mergeCells를 실행.

Parameter
name	type	required	description
mergeOptionStr	String	Y	자동 병합 방식을 지정. 설정 관련 string은 아래와 같음. never : mergeCells에 의해 자동으로 merge된 것들을 해제. bycol : 같은 column 내에서 연속적으로 데이터가 같은 row들을 병합. byrow : 같은 row 내에서 연속적으로 데이터가 같은 column들을 병합. bycolrec : bycol후, merge되지 않은 cell들을 대상으로 byrow를 실행. byrowrec : byrow후, merge되지 않은 cell들을 대상으로 bycol을 수행.
options	JSON	N	병합 세부 설정.

mergeClear( )

동적으로 병합된 셀들의 병합을 모두 해제한다.
mergeCell 또는 mergeCells등의 API에 의해 동적으로 병합된 셀들의 병합만 해제.

mergeCol( colIndex , flag )

데이터를 통해 자동으로 merge하는 기능을 사용할 때 특정 컬럼을 제외하기 위해 사용.

Parameter
name	type	required	description
colIndex	Number	Y	자동으로 merge하는 기능을 사용할지 말지를 지정할 대상 column.
flag	Boolean	Y

Sample

grid1.mergeCol(1, false); // 2번째 column을 data를 통한 merge기능에서 제외. grid1.mergeByCol(); // 2번째 column을 제외하고 mergeByCol이 수행됨.

mergeFocusedCell( )

현재 포커스된 셀만 병합.

Sample

(6,6),(6,7),(7,6),(7,7)이 현재 포커스된 상태에서 아래를 실행 gridView1.mergeFocusedCell(); // 실행결과: (6,6)에 해당하는 셀이 2*2 크기로 병합된다. // 즉, (6,6), (6,7), (7,6), (7,7)셀이 병합되며, 병합된 셀은 모두 셀 (6,6)이 갖던 데이터를 갖는다.

mergeRow( rowIndex , flag )

데이터를 통해 자동으로 merge하는 기능을 사용할 때 특정 행을 제외하기 위해 사용.

Parameter
name	type	required	description
rowIndex	Number	Y	자동으로 merge하는 기능을 사용할지 말지를 지정할 대상 row.
flag	Boolean	Y

Sample

grid1.mergeRow(1, false); // 2번째 row를 data를 통한 merge기능에서 제외. grid1.mergeByRow(); // 2번째 row를 제외하고 mergeByRow가 수행됨.

mergeSplitFocusedCell( )

포커스를 받은 셀의 병합을 분리.

Sample

(6,6),(6,7),(7,6),(7,7)이 병합된 셀에 포커스를 둔 채로 아래를 실행 gridView1.mergeFocusedCell(); // 실행결과 : (6,6), (6,7), (7,6), (7,7)셀로 분할.

modifyCheckedStatus( colIndex , status )

col에 해당하는 열의 inputType이 checkbox일 때 check된 행의 상태코드값을 일괄 변경.

Parameter
name	type	required	description
colIndex	String	Y	check여부를 검사할 컬럼의 index 혹은 컬럼 id
status	String	Y	[R,C,U,D,V]변경할 상태코드값

Sample

//checkbox, name 컬럼이 정의 된 gridView가 있고 2건의 row가 셋팅되어있고 checkbox의 컬럼 id는 chk임. //1번째 row의 checkbox는 check가 되어있고 2번째 row의 checkbox는 uncheck되었을 경우 //modifyCheckedStatus API를 이용하여 checkbox 컬럼의 id를 통해 check된 컬럼의 상태값을 일괄 D 상태로 변경. gridView1.modifyCheckedStatus("chk","D"); //1번째 row의 Status를 가져온다.(checkbox가 check 된 경우) var tmpRs1 = gridView1.getRowStatus(0); // (반환 예) "D" //2번째 row의 Status를 가져온다.(checkbox가 uncheck 된 경우) var tmpRs2 = gridView1.getRowStatus(1); // (반환 예) "R" // row에 별도의 수정 작업을 하지 않은 경우

modifyUncheckStatus( col , status )

col에 해당하는 열의 inputType이 checkbox일 때 uncheck된 행의 상태코드값을 일괄 변경.

Parameter
name	type	required	description
col	String	Y	uncheck 여부를 검사할 컬럼의 index 혹은 컬럼 id
status	String	Y	[R,C,U,D,V]변경할 상태코드값

Sample

//checkbox, name 컬럼이 정의 된 gridView가 있고 2건의 row가 셋팅되어있고 checkbox의 컬럼 id는 chk임. //1번째 row의 checkbox는 check가 되어있고 2번째 row의 checkbox는 uncheck되었을 경우 //modifyCheckedStatus API를 이용하여 checkbox 컬럼의 id를 통해 uncheck된 컬럼의 상태값을 일괄 D 상태로 변경. gridView1.modifyUncheckedStatus("chk","D"); //1번째 row의 Status를 가져온다.(checkbox가 check 된 경우) var tmpRs1 = gridView1.getRowStatus(0); // (반환 예) "R" // row에 별도의 수정 작업을 하지 않은 경우 //2번째 row의 Status를 가져온다.(checkbox가 uncheck 된 경우) var tmpRs2 = gridView1.getRowStatus(1); // (반환 예) "D"

moveFooterColumn( fromIdx , toIdx )

footer 컬럼을 fromIdx 위치로 부터 toIdx 이전의 위치로 이동.

Parameter
name	type	required	description
fromIdx	String	Y	이동 대상 footer 컬럼의 id 또는 index
toIdx	String	Y	이동 목적지의 오른쪽에 위치한 footer 컬럼의 id 또는 index

Sample

gridView1.moveFooterColumn("column5, "column2"); // 실행결과: column5가 column2의 바로 왼쪽, 혹은 column2 이전의 위치로 이동.

readCSV( options )

csv 파일을 읽어 그리드의 데이터를 설정. (JDK 1.5이상에서 사용 가능)

Parameter
name	type	required	description
options	JSON	Y	JSON형태로 저장된 그리드의 csv 업로드 옵션 업로드 정보 관련 옵션 데이터 관련 옵션 Hidden 컬럼 관련 옵션 업로드 창 관련 옵션 기타 옵션

Sample

var options = { type: "1", delim: ",", escapeChar: "'", startRowIndex: 1, append: "0", hidden: "0", fillHidden: "0", skipSpace: "1" }; gridView1.readCSV(options); //별도의 옵션이 없을 경우 빈 객체를 파라메터로 넘겨줘야 한다. gridView1.readCSV({});

redrawColumn( colIndex , valid )

col에 해당하는 열을 다시 그림. (Reset.)

Parameter
name	type	required	description
colIndex	String\|\|Number	Y	컬럼의 id 또는 index
valid	Boolean	N	[default:true, false] inputType="select"인 경우 selectbox와 cell의 value의 적합성에 따라 데이터를 처리 유무.

refreshCell( rowIndex , colIndex )

해당 인덱스의 cell을 다시 렌더링.

Parameter
name	type	required	description
rowIndex	Number	Y	행의 index
colIndex	Number	Y	컬럼의 index

refreshColumn( colIndex )

해당 인덱스의 column을 다시 렌더링.

Parameter
name	type	required	description
colIndex	Number	Y	컬럼의 index

refreshColumnItemset( col )

inputType이 select인 경우에만 동작하며 col에 해당하는 컬럼의 itemset을 갱신.

Parameter
name	type	required	description
col	String	Y	갱신할 column의 id 또는 index

refreshRow( rowIndex )

해당 인덱스의 row를 다시 렌더링.

Parameter
name	type	required	description
rowIndex	Number	Y	행의 index

removeCellClass( rowIndex , colIndex )

grid 셀에 적용된 사용자 class를 삭제

Parameter
name	type	required	description
rowIndex	Number	Y	셀의 행번호
colIndex	Number	Y	셀의 열번호 혹은 컬럼 아이디

removeFocusedCell( )

셀에 적용 된 모든 포커스(선택되어있는 셀)를 제거.

removeFocusedMultiCell( startRow , startCol , endRow , endCol )

직사각형 영역만큼 cell의 focus를 해제.

Parameter
name	type	required	description
startRow	Number	Y	해제할 포커스영역 시작지점의 row값. 즉, 포커스 해제영역 왼쪽 최상단 셀의 rowIndex.
startCol	Number	Y	해제할 포커스영역 시작지점의 column값. 즉, 포커스 해제영역 왼쪽 최상단 셀의 colIndex
endRow	Number	Y	해제할 포커스영역 종료지점의 row값. 즉, 포커스 해제영역 우측 최하단 셀의 rowIndex
endCol	Number	Y	해제할 포커스영역 종료지점 column값. 즉, 포커스 해제영역 우측 최하단 셀의 colIndex

Sample

gridView1.removeFocusedMultiCell(3,2,4,3); // 실행결과 : (3,2), (3,3), (4,2), (4,3)셀의 포커스가 해제됨. // 포커스가 걸려있지 않았던 셀은 아무 동작을 하지 않음.

removeHeaderClass( headerId )

grid Header 셀에 적용된 사용자 class를 삭제.

Parameter
name	type	required	description
headerId	Number	Y	header cell의 id

saveCSV( options )

데이터를 CSV 파일로 저장. (JDK 1.5이상에서 사용 가능)

Parameter
name	type	required	description
options	JSON	Y	JSON형태로 저장된 그리드의 csv 다운로드 옵션 다운로드 정보 관련 옵션 다운로드 데이터 관련 옵션 컬럼 이동 관련 옵션 드릴다운 및 병합 관련 옵션 기타 옵션

Sample

//저장 할 컬럼 정의 var colArr = []; colArr[0] = "name"; colArr[1] = "corp"; //저장 옵션 var options = { fileName: "saveCSV.csv", type: "1", delim: ";", saveList: colArr }; gridView1.saveCSV(options); //별도의 옵션이 없을 경우 빈 객체를 파라메터로 넘겨줘야 한다. gridView1.saveCSV({});

setAutoFit( options )

autoFit 속성을 적용.
그리드의 사이즈에 맞게 컬럼의 크기를 변경하여 꽉차게 그림.
autoFit="lastColumn"인 경우 마지막 컬럼의 폭만 변경이 되고, "allColumn"이면 전체 컬럼을 폭을 균일하게 변경.

Parameter
name	type	required	description
options	Object	N	JSON형태로 저장된 그리드의 setAutoFit 옵션

Sample

var options = { type : "allColumn", minWidth : 480 } gridView1.setAutoFit( options ); gridView의 width가 480px보다 작아질 경우에는 각 컬럼의 width의 함은 480px로 고정되며, 480px에 맞게 각 컬럼 width가 변경. gridView의 width가 480px보다 큰 경우는 gridView의 width에 맞게 각 컬럼 width가 변경.

setBottomRowIndex( bottomRowIndex )

화면에 보여지는 gridView 영역에 bottomRowIndex 해당하는 row가 최하단에 위치하도록 조정.
세로 스크롤 위치를 이동.

Parameter
name	type	required	description
bottomRowIndex	Number	Y	최하단에 위치할 rowIndex

setCaption( htmlStr )

gridView의 HTML caption 속성의 값을 설정.(gridView는 table로 구성됨.)

Parameter
name	type	required	description
htmlStr	String	Y	caption의 값으로 순수 텍스트이외 HTML Tag을 조합 한 문자열도 가능

setCaptionAuto( captionTitle )

captionTitle 값을 표 제목으로 설정. (관련 속성) captionTitle captionAuto

Parameter
name	type	required	description
captionTitle	String	N	captionTitle 속성에 신규로 적용할 값

Sample

// 사용 예 gridView1.setCaptionAuto("new title");

setCellAllowChar( rowIndex , colIndex , allowChar )

특정 cell의 allowChar 속성을 변경. (inputType="custom"일 경우에만 동작.)

Parameter
name	type	required	description
rowIndex	Number	Y	변경하려는 셀의 index
colIndex	Number	Y	변경하려는 컬럼의 index
allowChar	String	Y	변경하려는 allowChar 속성

setCellBackgroundColor( rowIndex , colIndex , color )

rowIndex와 colIndex에 해당하는 셀의 배경색을 설정.

Parameter
name	type	required	description
rowIndex	Number	Y	배경색을 설정할 행 index
colIndex	Number\|\|String	Y	배경색을 설정할 열 index 또는 id
color	String	Y	배경색으로 설정할 색

setCellChecked( rowIndex , colIndex , flag )

inputType="checkbox" 혹은 "radio"인 경우, 해당 셀을 선택하거나 선택 해제.

Parameter
name	type	required	description
rowIndex	Number	Y	셀의 행의 index
colIndex	String\|\|Number	Y	셀의 열의 id 또는 index
flag	Boolean	Y	[true,false]셀의 체크 여부

setCellClass( rowIndex , colIndex , className )

grid 셀에 동적으로 사용자 class를 적용

Parameter
name	type	required	description
rowIndex	Number	Y	셀의 행번호
colIndex	Number	Y	셀의 열번호 혹은 컬럼 아이디
className	String	Y	td에 적용할 class의 이름

setCellColor( rowIndex , colIndex , color )

rowIndex와 colIndex에 해당하는 셀의 글자색을 설정.

Parameter
name	type	required	description
rowIndex	Number	Y	글자색을 설정할 행 index
colIndex	Number\|\|String	Y	글자색을 설정할 열 index 또는 id
color	String	Y	글자색으로 설정할 색

setCellCustomFormatter( rowIndex , colIndex , formatter )

특정 cell의 customFormatter 속성을 변경. (inputType="custom"일 경우에만 동작.)

Parameter
name	type	required	description
rowIndex	Number	Y	변경하려는 셀의 index
colIndex	Number	Y	변경하려는 컬럼의 index
formatter	String	Y	변경하려는 customFormatter 함수 이름

setCellDataType( rowIndex , colIndex , dataType )

특정 cell의 dataType 속성을 변경. (inputType="custom"일 경우에만 동작.)

Parameter
name	type	required	description
rowIndex	Number	Y	변경하려는 셀의 index
colIndex	Number	Y	변경하려는 컬럼의 index
dataType	String	Y	변경하려는 dataType 속성

setCellDisabled( rowIndex , colIndex , disabled )

colIndex와 rowIndex에 해당하는 셀의 disabled속성 값을 설정.

Parameter
name	type	required	description
rowIndex	Number	Y	disabled 속성을 설정할 행 번호
colIndex	Number\|\|String	Y	disabled 속성을 설정할 열 index 또는 id
disabled	Boolean	Y	[true,false]disabled 속성에 적용할 값

setCellDisableEdit( rowIndex , colIndex , onoff )

inputType이 custom인 셀이 autoComplete인 경우 disableEdit 속성을 변경. (inputType="custom"일 경우에만 동작.)

Parameter
name	type	required	description
rowIndex	Number	Y	변경하려는 셀의 index
colIndex	Number	Y	변경하려는 컬럼의 index
onoff	String	Y	disableEdit 속성

setCellDisplayFormat( rowIndex , colIndex , displayFormat )

특정 cell의 displayFormat 속성을 변경. (inputType="custom"일 경우에만 동작.)

Parameter
name	type	required	description
rowIndex	Number	Y	변경하려는 셀의 index
colIndex	Number	Y	변경하려는 컬럼의 index
displayFormat	String	Y	변경하려는 displayFormat 속성

setCellDisplayFormatter( rowIndex , colIndex , formatter )

특정 cell의 displayFormatter 속성을 변경. (inputType="custom"일 경우에만 동작.)

Parameter
name	type	required	description
rowIndex	Number	Y	변경하려는 셀의 index
colIndex	Number	Y	변경하려는 컬럼의 index
formatter	String	Y	변경하려는 displayFormatter 함수 이름

setCellInputType( rowIndex , colIndex , info )

rowIndex와 colIndex에 해당하는 셀의 inputType을 변경.
inputType="custom"일 경우 사용.
gridView 속성에 setCellInputTypeCustom="true" 설정을 추가해야 동작.

Parameter
name	type	required	description
rowIndex	Number	Y	셀의 행 번호
colIndex	String	Y	셀의 컬럼 번호 혹은 컬럼의 아이디
info	Object	Y	JSON형태로 저장된 inputType에 대한 정보

Sample

var info = { inputType : "select", options : { selectedData : false, viewType: "icon", chooseOption: true }, itemSet : { nodeset: "data:dataList1", label: "label", value: "value" } } gridView1.setCellInputType(0, "a", info); // 첫 번째 row, "a" column에 해당하는 cell의 inputType을 select로 변경.

setCellMaxLength( rowIndex , colIndex , maxLength )

특정 cell의 maxLength 속성을 변경. (inputType="custom"일 경우에만 동작.)

Parameter
name	type	required	description
rowIndex	Number	Y	변경하려는 셀의 index
colIndex	Number	Y	변경하려는 컬럼의 index
maxLength	Number\|\|String	Y	변경하려는 maxLength 속성

setCellReadOnly( rowIndex , colIndex , readOnly )

colIndex와 rowIndex에 해당하는 셀의 readonly속성 값을 설정.

Parameter
name	type	required	description
rowIndex	Number	Y	readonly 속성을 설정할 행 index
colIndex	Number\|\|String	Y	readonly 속성을 설정할 열 index 또는 id
readOnly	Boolean	Y	[true,false]readonly 속성에 적용할 값

setColumnBackgroundColor( colIndex , color )

colIndex에 해당하는 열의 배경색을 일괄 설정.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	배경색을 설정할 열 index 또는 id
color	String	Y	배경색으로 설정할 색

setColumnChooseOption( colIndex , chooseOptionValue , chooseOptionLabel )

gridView column의 inputType이 select인 경우, selectBox의 chooseOption 속성의 value 및 label 값을 변경.

Parameter
name	type	required	description
colIndex	Number	Y	gridView 컬럼의 인덱스
chooseOptionValue	String	Y	새로 지정할 chooseOption의 value 값
chooseOptionLabel	String	Y	새로 지정할 chooseOption의 label 값

Sample

gridView1.setColumnChooseOption(1,"","-선택-");

setColumnColor( colIndex , color )

colIndex에 해당하는 열의 글자색을 일괄 설정.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	글자색을 설정할 열 index 또는 id
color	String	Y	글자색으로 설정할 색

setColumnDisabled( colIndex , disabled )

colIndex에 해당하는 열에 disabled속성을 일괄 설정.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	disabled속성을 설정할 열 index 또는 id
disabled	Boolean	Y	[true, false]disabled속성에 적용할 값

setColumnDisableEdit( rowIndex , onoff )

inputType이 autoComplete인 경우 column의 disableEdit 속성을 변경.

Parameter
name	type	required	description
rowIndex	Number	Y	변경하려는 셀의 index
onoff	String	Y	disableEdit 속성

setColumnDisplayFormat( colIndex , displayFormat )

컬럼의 displayFormat속성을 설정한다. 기존의 setDisplayFormat을 대체한 API.
displayFormat의 경우 dataList에 정의 된 컬럼의 dataType 속성에 따라 적용 범위가 다르므로 확인하여 적용해야함.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	컬럼의 index 또는 id
displayFormat	String	Y	컬럼에 적용할 displayFormat

Sample

// 생년월일 컬럼의 id가 birthday로 정의된 gridView가 있고, // dataList의 birthday 컬럼의 dataType 속성은 date로 정의한 경우 // 생년월일 컬럼의 displayFormat을 dd-MM yyyy 변경. gridView1.setDisplayFormat("birthday","dd-MM yyyy"); // (표시 예) "19831231"의 데이터가 "31-12 1983"으로 표시됨.

setColumnDisplayFormatter( colIndex , displayFormatter )

컬럼의 displayFormatter 속성을 설정.
기존의 setDisplayFormatter를 대체한 API.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	컬럼의 index 또는 id
displayFormatter	String	Y	displayFormatter 속성에 적용할 Function 명

setColumnGridItemset( colIndex , obj )

inputType = "select"이고 gridViewItemset을 사용하는 경우 gridViewItemset을 동적으로 변경한다.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	column의 index 또는 id
obj	JSON\|\|XML	Y	새로 구성할 gridViewItemset에 대한 정보를 담은 객체. JSON객체 또는 XML객체여야 한다.

Sample

var obj = { "nodeset" : "data:dataList2", "label" : "col1", "value" : "col2", "width" : 400, "height" : 300, "item" : [{"ref" : "col1", "header" : "label"},{"ref" : "col2", "header" : "value"},{"ref" : "col3", "header" : "dummy"}] }; gridView1.setColumnGridItemset("col1", obj);

setColumnIoFormat( colIndex , ioFormat , dateMast )

컬럼의 ioFormat 속성을 설정.
dataType이 date인 경우에만 동작.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	컬럼의 index 또는 id
ioFormat	String	Y	새로 설정할 ioFormat
dateMast	String	N	새로 설정할 dateMask(displayFormat)

setColumnNodeSet( colIndex , nodeset , label , value )

itemset을 설정할 수 있는 컬럼의 nodeset을 설정.
(select, autoComplete, checkcombobox 세 개의 inputType만 지원)

Parameter
name	type	required	description
colIndex	Number	Y	nodeset을 설정할 column의 index 또는 id
nodeset	String	N	변경하려는 nodeset값으로 "data:"라는 prefix 뒤에 dataList id를 정의.
label	String	N	변경하려는 label로 dataList의 컬럼 id
value	String	N	변경하려는 value로 dataList의 컬럼 id

setColumnOrder( columnOrderArray )

주어진 array를 기준으로 컬럼 순서를 재설정하며 파라메터에 정의되지 않은 컬럼은 파라메터 컬럼 뒤쪽으로 위치함.

Parameter
name	type	required	description
columnOrderArray	Array	Y	컬럼의 순서를 차례로 담은 배열(컬럼 index와 id 모두 사용 가능)

Sample

//이름, 성별, 나이, 생년월일이 정의 된 gridView가 정의되어 있고, // 각 body 컬럼의 id가 name, gender, age, birthday 인 경우 //나이 컬럼과 성별 컬럼의 위치를 변경. gridView1.setColumnOrder(["age","gender"]); //API 실행 후의 컬럼 순서는 나이, 성별, 이름, 생년월일 이 된다.

setColumnReadOnly( colIndex , readOnly )

colIndex에 해당하는 열에 readonly 속성을 설정.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	readonly속성을 설정할 열 index 또는 id
readOnly	Boolean	Y	[true, false]readonly속성에 적용할 값

setColumnVisible( colIndex , colVisibleFlag )

column의 hidden 여부를 설정.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	hidden 여부를 설정한 column의 index 또는 id
colVisibleFlag	Boolean	Y	[true, flase]visible 여부

setColumnVisibleColumn( gridColumnId , 해당 , visibleColumnFalseValue )

지정한 GridView 컬럼이 선택 목록을 표시하는 경우, 일부 선택 목록을 숨길 수 있는 기능.
해당 GridView 컬럼의 inputType이 select, autoComplete, radio, checkbox 혹은 checkcombobox인 경우에만 해당.
Select, AutoComplete, Radio, CheckBox, CheckComboBox 컴포넌트의 setVisibleColumn 함수를 실행하는 것과 같은 효과.
(각 컴포넌트의 visibleColumn, visibleColumnFalseValue, setVisibleColumn API 참조.)

Parameter
name	type	required	description
gridColumnId	Number\|\|String	Y	gridView 컬럼의 인덱스 혹은 ID.
해당	String	Y	컬럼(visibleColumnId)과 바인딩된 데이터 리스트의 컬럼 ID. (숨기기 여부에 대한 데이터를 갖고 있는 컬럼.)
visibleColumnFalseValue	String	N	숨기기 조건에 해당하는 값.

Sample

// gridView1의 Status 컬럼의 inputType은 select, autoComplete, radio, checkbox 혹은 checkcombobox. // Status 컬럼은 DataList와 바인딩 되어 있고, DataList의 Type 컬럼은 숨기기 여부에 대한 정보를 담고 있음. // 아래를 실행. gridView1.setColumnVisibleColumn("Status", "Type", false); // 실행 결과: // Type 값이 false인 DataList의 항목은 gridView1의 Status 컬럼에 선택 목록으로 표시되지 않음.

setColumnWidth( colIndex , size )

컬럼의 width을 변경.

Parameter
name	type	required	description
colIndex	String\|\|Number	Y	폭을 변경할 column의 index 또는 id
size	Number	Y	변경할 컬럼의 폭으로 px단위로 계산됨.

setCustomFormatter( colIndex , customFormatter )

컬럼의 customFormatter 속성을 설정.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	컬럼의 index 또는 id
customFormatter	String	Y	customFormatter 속성에 적용할 Function명

setDataDragDrop( onoff )

그리드의 dataDragDrop 값을 변경.

Parameter
name	type	required	description
onoff	Boolean	Y	[true,false] dataDragDrop 허용 여부

Sample

gridView1.setDataDragDrop(false); // dataDragDrop 값을 false로 변경

setDataType( colIndex , dataType )

특정 column의 dataType 속성을 변경.
단, 컬럼의 dataType이 "text", "number", "float"인 경우만 가능. (gridView.column의 관련 속성) dataType="text" dataType="number" dataType="float"

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	컬럼의 index 또는 id
dataType	String	Y	변경하려는 컬럼의 dataType

setDisabled( type , rowIndex , colIndex , disableFlag )

type에 따라 disabled 속성 값을 설정한다.

Parameter
name	type	required	description
type	String	Y	[grid, row, column, cell]disabled 속성을 설정할 type
rowIndex	Number	Y	disabled 속성을 설정할 행 index
colIndex	Number\|\|String	Y	disabled 속성을 설정할 열 index 또는 id
disableFlag	Boolean	Y	disabled 속성에 적용할 값

Sample

//이름, 성별, 나이가 정의된 gridView가 있고 각 column의 id가 name, gender, age 인 경우 //gridView 전체에 disable을 적용 할 경우 gridView1.setDisabled("grid",true); //gridView의 1번째행에 disable을 적용 할 경우 gridView1.setDisabled("row",0,true); //gridView의 "이름"열에 disable을 적용 할 경우 gridView1.setDisabled("column","name",true); //gridView의 1번째행의 "나이"열에 disable을 적용 할 경우 gridView1.setDisabled("cell",0,"age",true);

setDrillDownDragDrop( value )

drillDown 컬럼에 드래그-앤-드롭을 설정.
drillDown컬럼이 포함된 GridView 에서 dataDragDrop="true" 설정하고,
setDrillDownDragDrop 함수에 파라미터로 true로 설정값을 넘겨주면,
드릴다운 드래그-앤-드롭이 동작.

Parameter
name	type	required	description
value	Boolean	Y	drilldown컬럼이 포함된 gridView에서 drilldown drag drop을 동작하게 하는 여부

Sample

gridView1.setDrillDownDragDrop(true); //실행 결과 : 데이터들이 드래그 앤 드랍으로 이동 가능하다.

setFixedColumn( fixedColNum )

세로 틀고정을 설정.

Parameter
name	type	required	description
fixedColNum	Number	Y	맨 왼쪽부터 시작해서 영역을 고정시킬 컬럼들의 수. 1번째 컬럼을 틀 고정 할 경우 1로 입력한다.

Sample

//1번째 컬럼의 세로 틀고정 설정 gridView1.setFixedColumn(1); //3번째 컬럼의 세로 틀고정 설정 gridView1.setFixedColumn(3);

setFixedRightColumn( count )

우측에 고정할 컬럼 수(fixedRightColun)를 동적으로 제어. (관련 속성) fixedRightColumn (오른쪽에 세로로 틀고정할 컬럼의 수)

Parameter
name	type	required	description
count	Number	Y	제일 우측에서부터 세로로 고정할 컬럼의 수. 2개의 컬럼을 고정할 경우 "2"를 지정.

Sample

// 오른쪽 2개의 컬럼을 동적으로 고정 gridView1.setFixedRightColumn(2); // 오른쪽 세로 틀고정을 해제 gridView1.setFixedRightColumn(0);

setFocusedCell( rowIndex , colIndex , editMode )

셀로 포커스(선택)를 주고 해당 셀로 이동.

Parameter
name	type	required	description
rowIndex	Number	Y	포커스를 이동할 셀의 행 index
colIndex	Number\|\|String	Y	포커스를 이동할 셀의 열 index 또는 id
editMode	Boolean	Y	[default:false, true]editMode로 전환할지 여부

setFocusedHeaderObj( headerId )

헤더에 text가 아닌 inputType이 selectbox, checkbox와 같은 Object일 경우 포커스를 설정.

Parameter
name	type	required	description
headerId	String	Y	header의 id

setFocusedMultiCell( startRow , startCol , endRow , endCol )

직사각형 영역만큼 cell에 focus를 줌.

Parameter
name	type	required	description
startRow	Number	Y	포커스영역 시작지점의 row값. 즉, 포커스 영역 왼쪽 최상단 셀의 rowIndex.
startCol	Number	Y	포커스영역 시작지점의 column값. 즉, 포커스 영역 왼쪽 최상단 셀의 colIndex
endRow	Number	Y	포커스영역 종료지점의 row값. 즉, 포커스 영역 우측 최하단 셀의 rowIndex
endCol	Number	Y	포커스영역 종료지점 column값. 즉, 포커스 영역 우측 최하단 셀의 colIndex

Sample

gridView1.setFocusedMultiCell(3,2,4,3); // 실행결과 : (3,2), (3,3), (4,2), (4,3)셀이 포커스 처리됨.

setFooterCaption( htmlStr )

그리드 footer 테이블의 caption의 innerHTML 값을 설정.

Parameter
name	type	required	description
htmlStr	String	Y	caption의 innerHTML 값으로 설정될 값

setFooterData( footerId , data )

footer의 inputType이 text인 경우 data를 footer에 설정.

Parameter
name	type	required	description
footerId	Number\|\|String	Y	footer의 index 또는 id
data	String	Y	footer에 넣을 값

setFooterDisplayFormat( footerId , displayFormat )

footer의 displayFormat을 설정.
displayFormat은 dataType속성값에 따라 동작이 변경됨에 주의.

Parameter
name	type	required	description
footerId	Number\|\|String	Y	컬럼의 index 또는 id
displayFormat	String	Y	컬럼에 적용할 displayFormat

setFooterStyle( footerId , style , value )

footer cell의 스타일 속성을 설정.

Parameter
name	type	required	description
footerId	String\|\|Number	Y	그리드 footer cell의 id 또는 index (rowNum 컬럼은 "$rowNum", rowStatus 컬럼은 "$rowStatus"로 지정)
style	String	Y	적용할 CSS 속성명
value	String	Y	적용할 CSS 속성값

setFooterSummary( str )

그리드 footer 테이블의 summary 값을 설정.

Parameter
name	type	required	description
str	String	Y	summary 값에 설정될 string

setFooterValue( footerId , data )

footer의 inputType이 text인 경우만 적용되며 data의 값을 footer에 설정.

Parameter
name	type	required	description
footerId	String\|\|Number	Y	footer의 id 또는 index
data	String	Y	footer에 넣을 값

setGridHeight( height )

gridView의 높이를 설정한다.

Parameter
name	type	required	description
height	Number	Y	변경할 height값. px로 계산된다.

setGridReadOnly( readOnly )

gridView 전체에 readOnly 속성을 설정한다.

Parameter
name	type	required	description
readOnly	Boolean	Y	[true, false]readOnly 적용여부

setGridSize( width , height )

gridView의 높이와 넓이을 설정한다.

Parameter
name	type	required	description
width	Number	Y	변경할 width값으로 px단위로 계산된다.
height	Number	Y	변경할 height값으로 px단위로 계산된다.

setGridWidth( width )

gridView의 넓이를 설정한다.

Parameter
name	type	required	description
width	Number	Y	변경할 width값. px로 계산된다.

setHeaderBackgroundColor( headerId , color )

header 셀의 배경 색상을 설정.

Parameter
name	type	required	description
headerId	String\|\|Number	Y	header cell의 id 또는 index
color	String	Y	background에 지정할 색상

setHeaderClass( headerId , className )

grid header 셀에 동적으로 사용자 class를 적용.

Parameter
name	type	required	description
headerId	Number	Y	header cell의 id
className	String	Y	td에 적용할 class의 이름

setHeaderColor( headerId , color )

header 셀의 글씨 색상을 설정.

Parameter
name	type	required	description
headerId	String\|\|Number	Y	header cell의 id 또는 index
color	String	Y	글씨 색상

setHeaderDisabled( headerId , disabled )

header의 disalbled를 설정.

Parameter
name	type	required	description
headerId	Number\|\|String	Y	header의 index 또는 id
disabled	Boolean	Y	[true, false]header의 disabled 여부

setHeaderHide( hide )

header의 hidden 여부를 설정.

Parameter
name	type	required	description
hide	Boolean	Y	[true, false]header의 hidden 여부

setHeaderNodeSet( headerId , nodeset , label , value )

header의 inputType이 select의 경우 적용되며 list의 nodeSet을 설정한다.

Parameter
name	type	required	description
headerId	String	Y	header의 id
nodeset	String	N	변경하려는 nodeset값으로 "data:"라는 prefix 뒤에 dataList id를 정의.
label	String	N	변경하려는 label로 dataList의 컬럼 id
value	String	N	변경하려는 value로 dataList의 컬럼 id

Sample

//아래와 같이 DataList와 gridView가 정의 된 경우 //DataList - id가 dc_genderCode이고 disp id를 가진 컬럼은 사용자가 보는 label 값이, code id를 가진 컬럼은 value가 되는 값이 정의. //gridView - header 컬럼의 inputType이 select이고 header의 id가 hGender 가 정의. //gridView의 hGender 헤더의 selectbox list를 변경 gridView1.setHeaderNodeSet("data:dc_genderCode","disp","code");

setHeaderSortImage( headerId , orderNum , sortOrd )

header의 sort 이미지를 설정하며 data의 sort는 dataList의 sort API를 이용해야 함.

Parameter
name	type	required	description
headerId	String	Y	header의 ID
orderNum	Number	N	[default:-1, 1, 0]sort 상태를 나타내는 숫자 값
sortOrd	Number	N	[default:0]multisort의 경우 sort의 우선순위를 나타내는 숫자 값. 하위호환성 유지용. [기본 값: 0]

setHeaderStyle( headerId , style , value )

그리드의 headerId에 해당하는 header cell의 스타일을 설정.

Parameter
name	type	required	description
headerId	String\|\|Number	Y	그리드 header cell의 id 또는 index(rowNum 컬럼은 "$rowNum", rowStatus 컬럼은 "$rowStatus"로 설정)
style	String	Y	적용할 CSS 속성명
value	String	Y	적용할 CSS 속성값

setHeaderValue( headerId , value , useFormat )

displayFormat에 따라 포맷된 값을 헤더에 설정.
inputType="text"인 경우, 화면에 표시되는 문자열이 변경됨.
관련 속성: displayFormat

Parameter
name	type	required	description
headerId	String	Y	헤더 ID
value	String	Y	헤더 value
useFormat	Boolean	N	displayFormat에 따라 포맷된 값을 헤더에 설정. (기본 값: false)

setImageSrc( colIndex , src )

inputType이 textimage인 image를 동적으로 변경하기 함수.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	컬럼의 index 또는 id
src	String	Y	colIndex에 해당하는 열에 적용할 image URL

setMaxLength( colIndex , len )

그리드의 컬럼의 maxLength 값을 설정.

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	컬럼의 index 또는 id
len	number	Y	컬럼에 적용할 maxLength

Sample

// 사용 예 gridView1.setMaxLength("a", 5); // id가 "a"인 컬럼에 maxLength를 5로 변경

setNoResultMessage( message )

gridView에 데이터가 없을 경우 표시할 문자열을 설정.

Parameter
name	type	required	description
message	String	Y	데이터 없을 때 표시할 문자열

setNoResultMessageVisible( visible )

noResultMessageVisible 값을 동적으로 설정.

Parameter
name	type	required	description
visible	Boolean	Y	[true,false] noResultMessageVisible에 설정될 값.

setReadOnly( type , rowIndex , colIndex , readOnlyFlag )

type에 따라 readOnly 속성값을 설정.

Parameter
name	type	required	description
type	String	Y	[grid, row, column, cell]readOnly 속성을 설정할 type
rowIndex	Number	Y	readOnly속성을 설정할 행 index
colIndex	Number\|\|String	Y	readOnly속성을 설정할 열 index 또는 id
readOnlyFlag	Boolean	Y	[true, false]readOnly 속성에 적용할 값

Sample

//이름, 성별, 나이가 정의된 gridView가 있고 각 column의 id가 name, gender, age 인 경우 //gridView 전체에 readOnly을 적용 할 경우 gridView1.setReadOnly("grid", true); //gridView의 1번째행에 readOnly을 적용 할 경우 gridView1.setReadOnly("row",0,true); //gridView의 "이름"열에 readOnly을 적용 할 경우 gridView1.setReadOnly("column","name",true); //gridView의 1번째행의 "나이"열에 readOnly을 적용 할 경우 gridView1.setReadOnly("cell",0,"age",true);

setRowBackgroundColor( rowIndex , color )

rowIndex에 해당하는 행의 배경색을 설정.

Parameter
name	type	required	description
rowIndex	Number	Y	행의 index
color	String	Y	배경색의 값

setRowColor( rowIndex , color )

rowIndex에 해당하는 행의 글자색을 설정.

Parameter
name	type	required	description
rowIndex	Number	Y	행의 index
color	String	Y	글자색의 값

setRowDisabled( rowIndex , disableFlag )

colIndex에 해당하는 행의 disabled속성을 설정.

Parameter
name	type	required	description
rowIndex	Number	Y	disabled속성을 설정할 행 index
disableFlag	Boolean	Y	[true, false]disabled 여부

setRowNumColumnWidth( size )

rowNum 컬럼의 폭을 변경한다.

Parameter
name	type	required	description
size	Number	Y	변경할 컬럼의 폭으로 px로 계산된다.

setRowReadOnly( rowIndex , readOnly )

rowIndex에 해당하는 행의 readonly 속성을 설정.

Parameter
name	type	required	description
rowIndex	Number	Y	readonly 속성을 설정할 행 index
readOnly	Boolean	Y	[true, false]readonly 속성의 값

setRowStatusColumnWidth( size )

rowStatus컬럼의 폭을 변경한다.

Parameter
name	type	required	description
size	Number	Y	변경할 컬럼의 폭으로 px로 계산된다

setRowVisible( rowIndex , flag )

특정 행의 표시/숨김 여부를 설정.
본 함수로 숨김 처리된 행은 clearRowVisible(); 함수를 사용하여 다시 표시 가능. (관련 함수) clearRowVisible();

Parameter
name	type	required	description
rowIndex	Number	Y	행 표시 여부를 설정할 row의 index.
flag	Boolean	Y	해당 행의 표시 여부.

Sample

// (예제) // 30번째 행 숨기기 gridView1.setRowVisible(30, false);

setScrollLeft( left )

그리드의 가로 스크롤의 위치를 입력받은 값만큼 이동. (단위: px)

Parameter
name	type	required	description
left	Number	Y	가로스크롤의 scrollLeft값

setScrollTop( top )

그리드의 세로 스크롤을 감싸는 div의 스타일의 top을 param으로 들어온 top으로 설정.

Parameter
name	type	required	description
top	Number	Y	새로 설정할 스타일의 top

setStartRowNumber( rowIndex )

rowNum 컬럼에 표현되는 행번호의 시작되는 숫자의 index를 설정.
index의 값이므로 10을 설정하면 화면에서는 11부터 시작.
rowNumVisible="true"인 경우에만 유효함.

Parameter
name	type	required	description
rowIndex	Number	Y	행의 번호의 시작 index

Sample

//gridView의 rowNumVisible 속성을 true로 적용 한 경우 gridView1.setStartRowNumber(10); // (표시 예) rowNum 컬럼에 1부터 표현됬던 rowNum값이 11부터 증가하여 표현된다.

setStyleAll( styleObj )

그리드의 스타일을 지정하는 함수.

Parameter
name	type	required	description
styleObj	JSON	Y	스타일을 설정할 세부 설정을 담은 객체

Sample

<w2:gridView id='gridView1' fixedColumn='4'/> column수는 8개라고 가정. var styleObj = {"styleName" : "background-color", "styleValue" : "red", "type" : "row", "target" : "data", "rowIndex" : 5} gridView1.setStyleAll(styleObj); // 실행결과 : 5번 row 중에서 고정되지 않은 영역, 즉 (5,4),(5,5),(5,6)(5,7) cell의 배경색이 red가 된다.

setSubtotalVisible( flag )

subtotal을 숨기거나 다시 표시.

Parameter
name	type	required	description
flag	Boolean	Y	subtotal 표시 여부.

Sample

// subtotal 숨기기 gridView1.setSubtotalVisible(false); // subtotal 다시 표시 gridView1.setSubtotalVisible(true);

setSummary( str )

gridView의 HTML summary 속성값을 설정.

Parameter
name	type	required	description
str	String	Y	summary 속성에 설정될 string

setTopRowIndex( topRowIndex , noEvent , autoFocus )

세로 스크롤의 위치를 옮겨 topRowIndex에 해당하는 row가 첫번째 row에 보여지도록 설정.

Parameter
name	type	required	description
topRowIndex	Number	Y	상단에 표현할 rowIndex
noEvent	Boolean	N	이 API 실행 과정에서 스크롤이 맨 끝으로 도달할 경우 onscrollend 이벤트를 발생시키지 않고자 할 때 true인자를 추가로 넘김.
autoFocus	Boolean	N	API 실행 후에 화면기준으로 포커스를 (0,0)위치에 설정.

setUseFilter( colId , flag )

gridView 특정 header의 useFilter 속성을 동적으로 변경.

Parameter
name	type	required	description
colId	String	Y	컬럼의 id (header 또는 body column의 id값)
flag	Boolean	Y	useFilter속성을 true로 변경할지 false로 변경할지에 대한 boolean 값

Return
type	description
Boolean	useFilter속성이 변경될 경우 true, 변경되지 않았을 경우 false 반환

setUseFilterList( flag )

gridView의 useFilterList속성을 동적으로 제어.

Parameter
name	type	required	description
flag	Boolean	Y	useFilterList속성을 true로 변경할지 false로 변경할지에 대한 boolean값

showChooseOption( colIndex , chooseOption )

gridView 컬럼의 inputType이 select일때 selectbox의 chooseOption 속성 설정.

Parameter
name	type	required	description
colIndex	Number	Y	gridView 컬럼의 인덱스
chooseOption	Boolean	Y	사용 여부 (true/false)

Sample

gridView1.showChooseOption(1,true);

showCustomFilter2( headerID )

사용자 필터를 지정할 수 있는 "사용자 지정 필터" 팝업 창을 표시.

Parameter
name	type	required	description
headerID	String	Y	사용자 필터를 적용할 컬럼의 헤더 ID

showCustomFilterReset( )

사용자 필터를 초기화시킬 수 있는 버튼을 출력.
true: 초기화 버튼을 출력.
false (기본 값): 초기화 버튼을 출력하지 않음.

showGroupbyZone( )

groupbyZone 영역을 (hideGroupbyZone에 의해 감춰진 경우) 다시 표시.

spanAll( openFlag )

drilldown을 사용하는 gridView에서 전체 데이터를 모두 펼치거나 모두 접는 기능.
인자로 숫자를 넣는 경우 해당 depth까지 데이터를 펼침.

Parameter
name	type	required	description
openFlag	Boolean\|\|Number	Y	[true, false]open 여부, 숫자를 넣는 경우 해당 depth까지 데이터를 펼침.

Sample

gridView1.spanAll(true); // 접혀 있는 데이터를 모두 펼침. gridView1.spanAll(2); // depth가 2까지인 데이터를 모두 펼침.

toggle( rowIndex )

drilldown을 적용 한 경우 rowIndex에 해당하는 행에 drilldown을 토글링.
행이 닫혀있으면 열리고, 열려있으면 닫힘.

Parameter
name	type	required	description
rowIndex	Number	Y	toggle하려는 행의 realRowIndex