WebSquare.uiplugin.gridView

대량 데이터를 표현 및 수정 할 수 있는 컴포넌트로 Data를 담당하는 DataCollection의 DataList와 연결하여 사용된다.
데이터의 소계/합계 및 컬럼 그룹핑(사용자 제어를 통한 동적 소계), 데이터의 엑셀 업/다운로드, 데이터 정렬, 필터 등의 다양한 기능을 제공하고 있다.
본 컴포넌트는 최상위에는 div Tag로 이루어져있으며 전체적인 data는 table Tag로 구성되어있다. 그외 각 영역별로 복합 Tag들로 구성되어있다.
gridView의 주요 API들의 파라메터 중 컬럼(열)의 id는 body의 column id를 지칭하며 header의 id가 필요한 경우 header id와 같이 표현하고 있다.

Type

uiplugin

Property Summary

adaptive: 적응형 웹(다양한 화면크기와 디바이스에 맞게 레이아웃을 변경) 모드
adaptiveThreshold: adaptive가 설정되어 있을 경우 레이아웃 변경을 하기 위한 breakpoint(기본값 : 480)
arrowMove: 셀 내부의 첫번째 혹은 마지막 문자열에서 좌우 방향키를 이용한 셀 이동 허용.
autoFit: [lastColumn, allColumn] gridVeiw에 정의 된 width에 맞춰 여백이 없이 가득 채워주는 기능으로 가로 스크롤이 생기지 않는다.
autoFitMinWidth: gridView의 최소 width(px단위)를 지정하는 기능으로 autoFit속성의 값이 allColumn일 때 적용된다
captionAuto: [default:false] captionTitle이 정의된 경우 captionTitle과 표의 Header Title을 조합해서 표 제목으로 표시.
captionTitle: [default:""] captionAuto="true"인 경우, 표의 각 Header Title 앞에 표시할 내용
checkEditableInputClass: [default: false, true] inputType = "text" 이고 cell의 상태가 readOnly이거나 disable인 경우,
checkReadOnlyOnPaste: [default:false, true] Ctrl(또는 cmd)+V를 눌러 클립보드에서 그리드로 붙여넣기하는 경우 readOnly 되어있는 컬럼에 데이터를 세팅할지 여부
checkReadOnlyOnPasteEnable: [default:""]checkReadOnlyOnPaste="true"로 적용된 컬럼에서도 '붙여넣기' 기능을 컬럼 단위로 동작되도록 컬럼ID를 설정함.
class: HTML의 class속성과 동일한 기능을 제공하며 css파일 또는 style블럭에 정의한 class를 1개 또는 공백(space)를 이용하여 다중 적용이 가능하다.
columnMove: gridView 헤더를 마우스로 drag하여 컬럼을 이동할 수 있는 기능으로 drag시에 이동 될 컬럼의 header value속성에 명시 된 값이 tooltip형태로 표현된다.
columnMoveWithFooter: [default: false, true] setColumnOrder 함수를 호출하여 컬럼을 이동하거나 columnMove="true" 설정인 경우 마우스 드래깅을 통해 칼럼을 이동할 때 footer도 함께 이동. (단, footer가 header 및 body와 병합 구조가 다른 경우에는 미지원.)
contextMenu: [default: false, true] context menu 사용 여부
customFilterBox: [default: false, true] groupbyZone="true" groupbyFilterBox="true"을 통해서 groupby를
customPasteFormatter: [default: ""] Ctrl(또는 cmd) + V를 눌러 클립보드에 복사된 컬럼 단위의 데이터를 붙여넣을 때
dataDragDrop: [true, false] gridView간의 데이터를 drag&drop을 이용하여 주고받을지의 사용 여부로 FireFox에서는 Ctrl 키를 누르고 사용해야한다.
dataList: gridView의 data에 해당하는 DataCollection의 DataList id
disabledBackgroundColor: disabled이 적용 된 cell 또는 행의 배경색
disabledFontColor: disabled이 적용 된 cell 또는 행의 글자색
dragDisplayColumn: 사용자가 마우스를 이용하여 drag시(dataDragDrop속성 적용 시) 화면에 tooltip으로 표현 될 data로 표현하고자하는 컬럼의 id를 ","로 구분하여 설정한다.
dragEndFunction: 드래그 종료시 실행될 함수. dragStartFunction과 쌍으로 사용하며, drilldown인 경우와 아닌 경우 두가지로 구분해서 dragEndFunction을 정의해야 한다.
dragStartFunction: 드래그 시작시 실행될 함수
editModeEvent: 수정모드로 변환하기 위한 이벤트
enterKeyMove: [default:down, right, none, edit] cell에서 enter key 입력 시 포커스 이동방향에 대한 설정
escape: <>&"를 HTML Escape 문자로 변환하여 화면에 표시한다
euroMask: [default: ""] 화폐단위 변경을 위해 dataType = "euro" 로 설정한 경우나 changeCurrency API를 사용했을 때 적용되는 마스킹 값
evenRowBackgroundColor: 짝수 행의 배경색
excludeDeletedRows: [default:false, true] subtotal(소계)과 footer(합계)등에 사용되는 expression속성에서 deleted된 row를 제외하고 계산
excludeModifiedRows: [default:false, true] subtotal(소계)과 footer(합계)등에 사용되는 expression속성에서 modifyRowStatus API로 "D"상태가 적용된 row를 제외하고 계산한다.( modifyRowStatus API를 사용한 경우)
fastScroll: 세로 스크롤 이동시 빠르게 스크롤되는 효과를 주는 기능으로 시간내에 그릴수 있는 부분까지만 표현한다.
filterBoxvisibleRowNum: 필터링 조건 목록에 표시할 필터링 조건의 수
filterFocusMode: sort이벤트 발생 시 이벤트 발생 전 body의 cell/row에 선택되어있는 focus를 제거 할지에 대한 속성.
filterShowAlways: [default: false, true] useFilter=true 인 컬럼에서 컬럼 너비가 좁을 때 filter 아이콘을 최우선으로 보여줄지에 대한 여부
fixedColumn: 세로 틀고정을 시킬 컬럼의 위치로 첫번째 컬럼일 경우 "1"로 입력 설정
fixedColumnWithHidden: [default:true, false] fixedColumn속성의 위치값에 hiddenColumn을 포함하여 계산할지 여부
focusAutoRemove: [default:false, true] gridView에 포커스가 있는 상태에서 다른 객체로 mousedown을 통해 포커스가 이동한 경우 기존 gridView에 남아있던 포커스를 제거할 것인지에 대한 여부.
focusFlow: gridView의 포커스 흐름을 선형 혹은 2차원(기본값)으로 설정하는 옵션
focusMode: [default:cell, row, both, none] cell 선택(포커스)시 선택 영역의 표현 방법
focusMove: [default:true, false, vertical, horizontal] key를 통한 focus이동을 허용할지 여부
foldAll: [default: false, true] 각 컬럼을 그룹핑할 때 모든 행을 접는 기능. foldAll API기능과 동일함. (5.0_1.2701A.20170714.211228 버전에서 추가.)
footerCaption: [default: ""(빈 값)] 바닥글(footer)의 내용
footerCaptionAuto: [default: false, true] captionAuto 설정에 상관 없이 footerCaption 속성에 바닥글을 자동 생성.
footerSummary: [default: ""(빈 값)] 바닥글(footer)의 내용 요약
footerSummaryAuto: [default: ""(빈 값)] captionAuto 설정에 상관 없이 footer의 summary 속성에 바닥글을 자동 생성.
groupbyFilterBox: 필터링 기능(groupby)을 사용할 때 필터링 조건 목록의 표시 여부. 사용자는 표시된 목록에서 조건을 선택하여 필터링 수행 가능.
groupbyFilterBoxFormatter: groupby FilterBox에 추가될 목록의 label을 변경한다(format을 지정). data, isGroupby 두 개의 인자를 전달받는다.
groupbyFilterBoxLocation: 필터링 조건 목록(groupbyFilterBox)을 표시할 위치.
hideHeader: [default:false, true] header 숨김 여부
id: 컴포넌트의 ID로 전역객체로 할당되며 script에서 본 id로 컴포넌트에 접근이 가능하다
ignoreCellClick: drilldown사용할때 toggle 이미지 클릭시 gridView에 oncellclick 이벤트를 발생시키지않음
ignoreNonEditableCell: cell이 편집 불가능할 경우 tab이나 enter로 인한 이동시 무시 여부
ignoreNonEditableCellTabEnter: ignoreNonEditableCell 옵션값이 true인 경우,readonly셀에서 방향키로 인한 이동 가능합니다
ignoreToggleOnDisabled: drilldown사용할때 toggle 이미지 클릭시 해당 셀에 disabled가 적용되어 있을 경우 toggle시키지 않음
keepDefaultColumnWidth: [default:false, true] autoFit속성을 true로 설정할 경우 rowNum컬럼(rowNumVisible속성)과 rowStatus컬럼(rowStatusVisible속성)의 width를 고정한다
keyMoveEditMode: [default:false, true] key(tab,enter)를 통한 포커스 이동 시 바로 수정모드로 변경할지의 여부
loadCount: 세로 scroll이 마지막에 닿고 잔여 행이 본 속성에 설정 된 값과 동일 한 경우 onscrollend이벤트를 발생시킨다.
moveKeyEditMode: 방향키로 원하는 방향에 위치한 셀의 editMode 상태에 바로 진입한다
noResultMessage: [default:조회 결과가 없습니다
noResultMessageClass: 조회 결과 없음(DataList의 데이터가 0건일 때) 메시지에 별도의 style을 적용하기 위한 class명으로 해당 메세지의 HTML구조는 div Tag로 구현되어있으며 하위로 text가 표현된다.
noResultMessageStyle: 조회 결과 없음(DataList의 데이터가 0건일 때) 메시지에 별도의 style을 작성하는 속성으로 기본적으로 적용되는 style 대신 본 속성에 정의 된 style이 지정 된다.
noResultMessageVisible: [default:true, false] 조회 결과가 없을 때(DataList의 데이터가 0건일 때) 메시지를 표시 할지의 여부
numberMask: [default: ""] 화폐단위 변경을 위해 dataType = "number" 로 설정한 경우나 changeCurrency API를 사용했을 때 적용되는 마스킹 값
oddEvenColorDisplay: [default:true, false] 행의 짝,홀수의 반복색을 사용할지의 여부
oddRowBackgroundColor: 홀수 행의 배경색
overflowX: [default:auto, hidden, scroll] 가로 스크롤 표시 여부
overflowY: [default:auto, hidden, scroll] 세로 스크롤 표시 여부
preventAddRowOnPaste: [default: false, true] Ctrl(또는 cmd)+V를 눌러 클립보드에서 그리드로 붙여넣을 때 GridView에 있는 행보다 붙여넣을 행이 많은 경우에도 새로운 행을 추가하는 것을 방지.
preventCopy: [default: false, true] Ctrl(또는 cmd)+C를 눌러 그리드 전체의 데이터를 클립보드에 복사하는 동작을 방지
preventCopyColumn: [default: ""] Ctrl(또는 cmd) + C를 눌러 컬럼 단위의 데이터를 클립보드에 복사하는 동작을 방지. (5.0_1.2701A.20170714.211228 버전에서 추가.)
preventMultisort: [default:true, false] multisort 기능을 막을지 여부
preventPaste: [default: false, true] Ctrl(또는 cmd)+V를 눌러 클립보드에 복사된 컬럼 단위의 데이터를 붙여넣는 동작을 방지
preventPasteColumn: [default: ""] Ctrl(또는 cmd) + V를 눌러 클립보드에 복사된 컬럼 단위의 데이터를 붙여넣는 동작을 방지. (5.0_1.2701A.20170714.211228 버전에서 추가.)
readOnly: [default:false, true] gridView전체의 각 cell을 readOnly로 적용하며 body 컬럼의 readOnly속성이 설정된 경우 해당 컬럼의 속성이 우선시 된다.
readOnlyBackgroundColor: readOnly속성이 true인 cell의 배경색
readOnlyBackgroundImg: readOnly속성이 true인 cell의 배경이미지의 경로
readOnlyBackgroundImgCSS: readOnly속성이 true인 cell의 배경이미지의 CSS 구문으로 readOnlyBackgroundImg속성보다 우선된다.
readOnlyClass: readOnly 일때 추가할 class이름
readOnlyPriority: [default:column, row] readOnly속성 적용의 우선 순위.
readOnlyTabIgnore: [default:false, true] cell에 readOnly가 적용 된 경우 tab key를 눌렀을 때 해당 cell을 건너 뛸지의 여부
resize: [default:true, false] header의 컬럼 경계선에서 마우스 drag를 이용하여 컬럼의 폭 크기를 조절 할지의 여부
rowMouseOver: [default:true, false] 마우스 over시에 over된 행의 배경색을 표시할지의 여부
rowMouseOverColor: 마우스 over시의 행 배경색
rowNumBackgroundColor: rowNumVisiblue속성이 true인 경우 해당 body 컬럼의 배경색
rowNumHeaderValue: rowNumVisiblue속성이 true인 경우 header의 텍스트(value)
rowNumLocaleRef: rowNum 컬럼에 설정할 localeRef 키.
rowNumStatusResize: [default:false, true]그리드 행 번호 및 상태 컬럼 폭 크기 조절 여부
rowNumStatusUniqueId: [default:false, true] rowNumVisible 또는 rowNumStatus 사용 시 각 row별로 unique한 id를 사용할지에 대한 여부.
rowNumVisible: [default:false, true] gridView와 연동 된 DataList의 데이터를 기준으로 행 번호를 표시 할지의 여부
rowNumWidth: rowNumVisiblue속성이 true인 경우 해당 컬럼의 width
rowStatusHeaderValue: rowStatusVisible속성이 true인 경우 header에 표시 할 텍스트(value)
rowStatusLocaleRef: rowStatus 컬럼에 설정할 localeRef 키.
rowStatusVisible: [default:false, true] 각 행의 상태(추가,수정,삭제)를 별도의 컬럼을 통해 아이콘으로 표시 할지의 여부
rowStatusWidth: rowStatusVisible속성이 true인 경우 해당 컬럼의 width
rupeeMask: [default: ""] 화폐단위 변경을 위해 dataType = "rupee" 로 설정한 경우나 changeCurrency API를 사용했을 때 적용되는 마스킹 값
scrollByColumn: [default:false, true] 가로 스크롤이 컬럼 단위로 이동할지의 여부
scrollByColumnAdaptive: [default:false, true] adaptive상태일 때 가로 스크롤이 컬럼 단위로 이동할지의 여부
selectedCellColor: 선택 된 cell의 배경색
selectedCellOverColor: 선택 된 cell에 마우스 over시의 배경색
selectedRowColor: 선택 된 행의 배경색
selectedRowOverColor: 선택 된 행에 마우스 over시의 배경색
senseReader: [default:false, true] 웹 접근성을 지원하기 위한 모드. 이 모드를 true로 설정하면 tab키로 gridView의 모든 cell을 순회할 수 있다.
showImageTooltip: [default: false, true] inputType = "image"인 경우, tooltip이 나오도록 설정함.
showSortableImage: [default:false, true] sort가 가능 한 컬럼의 header에 sort 관련 이미지를 출력할지에 대한 여부
showSortableUseFilter: [default: false, true] useFilterList와 showSortableImage 속성을 동시에 사용할 때 정렬 아이콘(sortable)과 사용자 정의 필터 아이콘(useFilterList) 모두를 헤더에 표시.
sortable: gridView의 헤더 클릭을 통한 데이터 정렬 지원 여부
sortEvent: [default:ondblclick, onclick] sortable이 true인 컬럼 header의 sort 기능을 적용 할 이벤트
sortOrderReverse: 그리드의 헤더 클릭을 통한 데이터 정렬시 내림차순 정렬을 먼저 할지 여부
summary: HTML의 table Tag의 summary 속성과 동일한 기능을 제공한다
summaryAuto: 웹접근성 지원시, gridView table 속성중 summary항목에 헤더 컬럼명을 자동으로 설정할지 여부
summaryOnlyAuto: [default: false, true] 헤더 타이틀이 HTML 태그를 포함한 경우, 태그를 제외한 텍스트만 summary 항목으로 지정.
tengeMask: [default: ""] 화폐단위 변경을 위해 dataType = "tenge" 로 설정한 경우나 changeCurrency API를 사용했을 때 적용되는 마스킹 값
titleAuto: [default: false, true] cell의 header inputType = "text"이고 cell의 inputType이 "text, link, checkbox, button, radio, select(tableRender = "ul"인 경우), secret"일 때,
tooltipDisplay: [default:false, true] cell의 데이터가 width보다 긴 경우 해당 데이터를 마우스 over시 툴팁으로 표현할지의 여부
tooltipDisplayColumn: 툴팁을 표시할 컬럼을 지정.
tooltipFormatter: tooltipDisplay속성이 true일 때 tooltip 내용을 변경할 사용자 함수명.
tooltipHeader: [default:false, true] gridView의 header에 tooltip을 나타내는 설정.tooltipDisplay = "true"(또는 tooltipShowAlways="true")로 설정 후 동작함.
tooltipPositionX: [defulat:20] tooltipDisplay가 true일 경우 표현 될 tooltip의 x좌표로 body cell의 왼쪽 끝이 원점이며 px단위로 계산된다.
tooltipPositionY: [defulat:cellHeight+3] tooltipDisplay가 true일 경우 표현 될 tooltip의 y좌표로 body cell의 왼쪽 상단이 원점이며 px단위로 계산된다.
tooltipShowAlways: [default:false, true] 데이터에 대한 tooltip을 마우스 over 시 항상 보여줄지에 대한 여부로 데이터가 공백("")인 경우를 제외하고는 항상 보여준다
useCtrlKey: [default:true, false] ctrl키를 누르고 여러 개의 셀을 선택할지 여부
useCtrlOnMultisort: [default:true, false] 여러 개의 컬럼에 소팅을 하고자 할 때 ctrl키를 누르고 컬럼들을 선택할지 여부
useFilterList: [default: false, true] 필터링 대상 값을 목록으로 표시. 이 때 목록 첫번째에는 "사용자 필터"를 표시. 사용자가 "사용자 필터"를 클릭하면 사용자 지정 필터 팝업 창이 표시됨.
useFilterListSync: [default: false, true] useFilterList="true"일 때 dataList의 setFilter API를 이용하여 필터링이 된 경우에도 필터를 펼쳤을 때 나오는 항목(필터목록)에 반영할지에 대한 여부
userData1: 사용자 정의 데이터 속성
userData2: 사용자 정의 데이터 속성
userData3: 사용자 정의 데이터 속성
useShiftKey: shift key를 이용하여 복수 셀의 선택에 대한 적용 여부
visibleRowNum: 화면에 표현 될 행 수
wheelRows: [default:3] 마우스 휠을 이용하여 세로 스크롤이 이동 될 때 한번 이동하는 row의 개수
wheelStop: [default:false] 그리드 스크롤이 맨 아래로 내려갔을 때 wheel을 한 경우 브라우저 스크롤을 막을지에 대한 여부

Event Summary

onafteredit: 셀의 수정이 끝나서 포커스가 빠져나온 경우 발생하며, oneditend후에 발생한다
onbeforeedit: 셀 수정모드로 들어가기 전에 발생한다
onbodymouseover: 그리드의 body에 마우스가 오버된 경우 발생
oncellclick: 셀이 클릭 된 경우 발생한다
oncelldblclick: 셀이 더블 클릭된 경우 발생한다
oncellindexchange: 방향키 또는 마우스를 이용하여 셀을 선택하여 선택 된 셀이 변경되거나 API를 이용하여 cell의 focus를 적용하여 선택 된 셀이 변경되었을 때 발생한다
oncolumnindexchange: 방향키 또는 마우스를 이용하여 셀을 선택하여 선택 된 셀의 열이 변경되거나 API를 이용하여 cell의 focus를 적용하여 선택 된 셀의 열이 변경되었을 때 발생한다
oneditend: 셀의 에디트가 끝난 경우 발생하며, onafteredit보다 먼저 발생
oneditkeydown: 셀의 에디트시 키를 누른 경우 발생하며, opera와 firefox에서 2byte짜리 문자(한글)를 입력할 때는 첫 입력시 또는 문자 조합이 완료된 후에만 발생한다
oneditkeyup: 셀의 에디트시 키를 누른 경우 발생하며, opera와 firefox에서 2byte짜리 문자(한글)를 입력할 때는 첫 입력시 또는 문자 조합이 완료된 후에만 발생한다
onfilereadend: gridView에 엑셀 업로드가 끝난 뒤 발생한다
onfooterclick: footer가 클릭된 경우 발생한다
onheaderclick: header가 클릭된 경우 발생한다
onheaderdblclick: header가 더블클릭된 경우 발생한다
onkeydown: 키보드에서 키를 눌렀을 때 발생한다
onkeyup: 키보드에서 키를 눌렀다 놓았을 때 발생한다
onrightbuttonclick: body영역의 셀에서 마우스 오른쪽 버튼이 클릭된 경우 발생한다
onrowindexchange: 방향키 또는 마우스를 이용하여 셀을 선택하여 선택 된 셀의 행이 변경되거나 API를 이용하여 cell의 focus를 적용하여 선택 된 셀의 행이 변경되었을 때 발생한다
onscrollend: 세로 스크롤이 하단에 닿을 때 발생한다
onscrollx: 가로 스크롤을 움직이는 경우 발생한다
onscrolly: 세로 스크롤을 움직이는 경우 발생한다
ontextimageclick: inputType 이 textImage 인 경우 image가 클릭 된 경우 발생
onviewchange: 셀의 데이터가 키보드나 마우스 조작을 통해 변경된 경우에만 발생한다.

Method Summary

advancedExcelDownload( options , infoArr ): 그리드의 데이터를 엑셀 파일로 저장한다
advancedExcelUpload( options ): 엑셀 파일을 읽어 그리드의 데이터를 설정. (JDK 1.5 이상에서 사용 가능)
changeCurrency( columnID , dataType , displayFormat , delimiter , decimalDelimiter ): 컬럼 단위로 화면에 나타나는 셀 값들의 화폐단위를 동적으로 변경할 수 있다.
checkAll( colIndex , dataValue ): 체크 박스로 이루어진 열을 한번에 체크하거나 언체크한다
clearGroupby( ): groupBy를 해제한다
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로 반환한다
getBottomRowIndex( ): 현재 눈에 보여지는 gridVeiw의 최하단 row의 rowIndex를 반환한다
getCellBackgroundColor( rowIndex , colIndex ): rowIndex와 colIndex에 해당하는 셀의 배경색을 반환한다
getCellChecked( rowIndex , colIndex ): rowIndex와 colIndex로 해당하는 셀의 check여부를 반환한다
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에 해당하는 열의 글자색을 반환한다
getColumnDisabled( colIndex ): colIndex에 해당하는 열에 disabled속성 값을 반환한다
getColumnID( colIndex ): 컬럼의 index를 입력받아 해당하는 컬럼의 id를 반환한다
getColumnIndex( colIndex ): 컬럼 id를 입력받아 해당하는 컬럼의 index를 반환한다
getColumnNodeSet( colIndex ): inputType = "select" 또는 "autoComplete"인 경우, 연결된 NodeSet 정보를 반환한다.
getColumnOrder( byName ): 현재 컬럼 순서를 배열로 반환한다
getColumnReadOnly( colIndex ): colIndex에 해당하는 열에 적용된 readonly속성 값을 반환한다
getColumnType( colIndex ): colIndex에 해당하는 열의 inputType속성값을 반환한다
getColumnVisible( colIndex ): colIndex에 해당하는 열의 visible여부를 반환한다
getDataLength( ): [deprecated]getRowCount()를 사용한다
getDataList( ): 현재 binding된 dataList의 Id를 반환한다
getDisabled( type , rowIndex , colIndex ): type에 따라 세부 disabled 속성을 반환한다.
getFixedColumnLastIndex( ): 그리드에 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 속성을 반환한다
getGridStructure( ): 웹스퀘어 화면 xml에서 생성된 gridView의 node 구조를 반환한다
getHeaderBackgroundColor( headerId ): header 셀에 적용된 배경색 값을 가져온다
getHeaderColor( headerId ): header 셀에 적용 된 글씨 색상값을 가져온다
getHeaderColumnVisible( colIndex ): colIndex에 해당하는 열의 visible여부를 반환한다
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의 값을 반환한다
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속성값을 반환한다
getRowReadOnly( rowIndex ): rowIndex에 해당하는 행에 적용된 readonly속성 값을 반환한다
getSortableArr( ): header의 각 컬럼이 sortable한지 여부를 array로 반환한다
getSortableStatus( ): sorting된 컬럼의 순서대로 해당 컬럼의 header 정보를 담은 object를 array로 반환한다. sorting된 컬럼이 없을 경우 빈 array를 반환한다.
getTopRowIndex( ): 현재 화면에 보여지는 최상단 row의 rowIndex를 반환한다
getTotalCol( ): 전체 컬럼 개수를 반환
getTotalHeaderCol( options ): 헤더 컬럼의 전체 개수를 반환. 병합된 헤더 컬럼을 모두 전체 개수에 포함할 것인지의 여부 및 rowNum과 rowStatus 칼럼 포함 여부를 지정 가능.
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의 수를 반환한다. (subtotal, footer 제외)
groupby( Options ): 둘 이상의 컬럼의 데이터를 그룹핑하여 그룹핑 결과(통계)만 표시
hasChild( rowIndex ): drilldown이 적용 된 경우 rowIndex에 해당하는 행이 child row를 가지고 있는지의 여부를 반환한다
initGrid( ): 전체 데이터 삭제, 필터 삭제, 컬럼 기본정보(selectbox의 nodeset 등)를 초기화하고 가지고 있던 데이터를 1차원 배열로 반환한다
isEditing( ): gridView가 현재 편집중 인지의 여부를 반환한다
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에 해당하는 열을 다시 그려(reset)준다
refreshColumnItemset( col ): inputType이 select인 경우에만 동작하며 col에 해당하는 컬럼의 itemset을 갱신한다
removeFocusedCell( ): 셀에 적용 된 모든 포커스(선택되어있는 셀)를 제거한다
removeFocusedMultiCell( startRow , startCol , endRow , endCol ): 지정한 직사각형 영역에 속하는 셀의 포커싱을 해제
saveCSV( options ): 데이터를 CSV 파일로 저장한다
setAutoFit( options ): 그리드의 사이즈에 맞게 컬럼의 크기를 변경하여 꽉차게 그려줍니다
setBottomRowIndex( bottomRowIndex ): 화면에 보여지는 gridView 영역에 bottomRowIndex 해당하는 row가 최하단에 위치하도록 조정한다
setCaption( htmlStr ): gridView의 HTML caption 속성의 값을 설정한다
setCaptionAuto( captionTitle ): captionTitle 값을 표 제목으로 설정
setCellBackgroundColor( rowIndex , colIndex , color ): rowIndex와 colIndex에 해당하는 셀의 배경색을 설정한다
setCellChecked( rowIndex , colIndex , flag ): rowIndex와 colIndex에 해당하는 셀의 inputType이 checkbox/radio인 경우 flag에 따라 true이면 check, false이면 uncheck해 줍니다
setCellColor( rowIndex , colIndex , color ): rowIndex와 colIndex에 해당하는 셀의 글자색을 설정한다
setCellDisabled( rowIndex , colIndex , disabled ): colIndex와 rowIndex에 해당하는 셀의 disabled속성 값을 설정한다
setCellReadOnly( rowIndex , colIndex , readOnly ): colIndex와 rowIndex에 해당하는 셀의 readonly속성 값을 설정한다
setColumnBackgroundColor( colIndex , color ): colIndex에 해당하는 열의 배경색을 일괄 설정한다
setColumnChooseOption( gridView의 , chooseOptionValue , chooseOptionLabel ): gridView에 column의 inputtype이 select일때 selectbox에 chooseOption의 label, value값을 변경함
setColumnColor( colIndex , color ): colIndex에 해당하는 열의 글자색을 일괄 설정한다
setColumnDisabled( colIndex , disabled ): colIndex에 해당하는 열에 disabled속성을 일괄 설정한다
setColumnNodeSet( colIndex , nodeset , label , value ): inputType = "select" 또는 "autoComplete", "checkcombobox" 인 경우, 새로운 nodeset을 설정한다.
setColumnOrder( columnOrderArray ): 주어진 array를 기준으로 컬럼 순서를 재설정하며 파라메터에 정의되지 않은 컬럼은 파라메터 컬럼 뒤쪽으로 위치된다
setColumnReadOnly( colIndex , readOnly ): colIndex에 해당하는 열에 readonly속성을 설정한다
setColumnVisible( colIndex , colVisibleFlag ): column의 hidden 여부를 설정한다
setColumnWidth( colIndex , size ): 컬럼의 width을 변경한다
setDisabled( type , rowIndex , colIndex , disableFlag ): type에 따라 disabled 속성 값을 설정한다
setDisplayFormat( colIndex , displayFormat ): 컬럼의 displayFormat속성을 설정한다.
setDisplayFormatter( colIndex , displayFormatter ): 컬럼의 displayFormatter 속성을 설정한다
setDrillDownDragDrop( value ): drillDown컬럼이 포함된 gridView 에서 dataDragDrop="true" 설정하고 setDrillDownDragDrop함수에 파라미터로
setFixedColumn( fixedColNum ): 세로 틀고정을 설정한다
setFixedRightColumn( count ): 우측에 고정할 컬럼 수(fixedRightColun)를 동적으로 제어.
setFocusedCell( rowIndex , colIndex , editMode ): 셀로 포커스(선택)를 주고 해당 셀로 이동한다
setFocusedHeaderObj( headerId ): 헤더에 text가 아닌 inputType이 selectbox, checkbox와 같은 Object일 경우 포커스를 준다
setFocusedMultiCell( startRow , startCol , endRow , endCol ): 지정한 직사각형 영역에 속하는 셀을 포커싱
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 셀의 배경 색상을 설정한다
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에 따라 포맷된 값을 헤더에 설정. inputType=text인 경우, 화면에 표시되는 문자열이 변경됨.
setNoResultMessage( message ): gridView에 데이터가 없을 경우 표시할 문자열을 설정한다
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컬럼의 폭을 변경한다
setStartRowNumber( rowIndex ): rowNum 컬럼에 표현되는 행번호의 시작되는 숫자의 index를 설정한다.
setSummary( str ): gridView의 HTML summary 속성값을 설정한다
setTopRowIndex( topRowIndex ): 세로 스크롤의 위치를 옮겨 topRowIndex에 해당하는 row가 첫번째 row에 보여지도록 설정한다
showChooseOption( gridView의 , chooseOption ): gridView에 column의 inputtype이 select일때 selectbox에 chooseOption을 설정함
showCustomFilter2( headerID: ): 사용자 필터를 지정할 수 있는 "사용자 지정 필터" 팝업 창을 표시
showCustomFilterReset( ): 사용자 필터를 초기화시킬 수 있는 버튼을 출력.
spanAll( openFlag ): drilldown을 사용하는 gridView에서 전체 데이터를 모두 펼치거나 모두 접는다
toggle( rowIndex ): drilldown을 적용 한 경우 rowIndex에 해당하는 행에 drilldown을 toggle한다

Property Detail

adaptive: 적응형 웹(다양한 화면크기와 디바이스에 맞게 레이아웃을 변경) 모드. Chrome, Safari, Firefox, Opera, IE10+에서 지원되는 기능입니다.
adaptiveThreshold: adaptive가 설정되어 있을 경우 레이아웃 변경을 하기 위한 breakpoint(기본값 : 480)
arrowMove: 셀 내부의 첫번째 혹은 마지막 문자열에서 좌우 방향키를 이용한 셀 이동 허용.
true: 이동 가능.
false (기본 값): 이동 불가.
관련 속성: moveKeyEditMode="true"인 경우에만 유효.
autoFit: [lastColumn, allColumn] gridVeiw에 정의 된 width에 맞춰 여백이 없이 가득 채워주는 기능으로 가로 스크롤이 생기지 않는다.
allColumn은 여백을 모든 컬럼에 분배하여 조절하며 lastColumn은 마지막 컬럼을 allColumn은 모든 컬럼의 너비를 조정한다.
autoFitMinWidth: gridView의 최소 width(px단위)를 지정하는 기능으로 autoFit속성의 값이 allColumn일 때 적용된다.
captionAuto: [default:false] captionTitle이 정의된 경우 captionTitle과 표의 Header Title을 조합해서 표 제목으로 표시.
단, 헤더에 대해 inputType="text"가 설정된 경우에만 동작.
tableLayout 컴포넌트에서 본 기능을 사용할 경우, tagName="table"로 지정해야 함.
true: CaptionTitle과 표의 Header Title을 조합해서 표 제목으로 표시. false: (기본 값) 표시 안 함.
GridView가 항목 1, 항목 2, 항목 3을 Header Title로 갖는 경우 아래 예제를 적용하면 다음이 제목으로 표시.
"거래내역 은(는) 항목 1, 항목 2, 항목 3 을(를) 나타낸 표"
captionTitle: [default:""] captionAuto="true"인 경우, 표의 각 Header Title 앞에 표시할 내용.
checkEditableInputClass: [default: false, true] inputType = "text" 이고 cell의 상태가 readOnly이거나 disable인 경우,
nobr 태그에 "w2grid_input" class를 삭제하도록 설정.
적용 버전: 5.0_1.2705B.20170721.164120 버전부터 지원.
true: readOnly 또는 disable시 nobr 태그에서 "w2grid_input" class를 삭제.
false (기본 값): nobr 태그에 "w2grid_input" class가 항상 포함됨.
checkReadOnlyOnPaste: [default:false, true] Ctrl(또는 cmd)+V를 눌러 클립보드에서 그리드로 붙여넣기하는 경우 readOnly 되어있는 컬럼에 데이터를 세팅할지 여부
true : readOnly가 적용된 컬럼에 '붙여넣기' 기능이 동작하지 않는다.
false: readOnly가 적용된 컬럼에 '붙여넣기' 기능이 동작한다.
checkReadOnlyOnPasteEnable: [default:""]checkReadOnlyOnPaste="true"로 적용된 컬럼에서도 '붙여넣기' 기능을 컬럼 단위로 동작되도록 컬럼ID를 설정함.
(5.0_1.2701A.20170714.211228 버전에서 추가.)
(사용 예) checkReadOnlyOnPasteEnable = "col1,col2";
col1,col2 컬럼은 readOnly 및 checkReadOnlyOnPaste 옵션이 "true"로 설정되어도 '붙여넣기' 기능이 동작.
class: HTML의 class속성과 동일한 기능을 제공하며 css파일 또는 style블럭에 정의한 class를 1개 또는 공백(space)를 이용하여 다중 적용이 가능하다.
gridView컴포넌트는 매우 복잡한 구조를 가진 컴포넌트로 css의 selector를 이용하여 하위 항목에 접근해야한다.
기본적으로 엔진 내부에서 컴포넌트별로 class를 적용하고 있으며 해당 class를 이용하여 컴포넌트의 css를 공통으로 적용할 수 있다.
columnMove: gridView 헤더를 마우스로 drag하여 컬럼을 이동할 수 있는 기능으로 drag시에 이동 될 컬럼의 header value속성에 명시 된 값이 tooltip형태로 표현된다.
colSpan, header 2줄, subtotal, footer 등은 columnMove 기능에 대한 다음의 제약 사항이 발생될 수 있다.
colSpan : 컬럼에 colSpan이 있을 경우, 컬럼 이동이 되지 않는다.
header 2줄 : header가 2줄인 경우,컬럼 이동이 되지 않는다.
subtotal : subtotal부분은 컬럼 이동이 되지 않는다.
footer : footer부분은 컬럼 이동이 되지 않는다.
columnMoveWithFooter: [default: false, true] setColumnOrder 함수를 호출하여 컬럼을 이동하거나 columnMove="true" 설정인 경우 마우스 드래깅을 통해 칼럼을 이동할 때 footer도 함께 이동. (단, footer가 header 및 body와 병합 구조가 다른 경우에는 미지원.)
true: footer도 함께 이동.
false (기본 값): footer는 이동하지 않음.
관련 함수 및 속성: setColumnOrder, columnMove="true"
contextMenu: [default: false, true] context menu 사용 여부
customFilterBox: [default: false, true] groupbyZone="true" groupbyFilterBox="true"을 통해서 groupby를
설정한 상태에서 useFilterList와 useFilter 속성 "true"로 설정 후 헤더에 필터링을 걸면 filterBox에 필터링된 조건문이 나타남.
filterBox에 조건문이 나타난 상태에서 groupby API를 실행하면 해당 조건문이 groupby가 적용된 후에도 유지됨. 즉, 필터링과 그룹핑 동시 적용 가능.
(5.0_1.2701A.20170714.211228 버전에서 추가.)
true: groupby 전 filterBox에 필터링 조건문 나타나고 groupby API 실행 시 해당 조건문 유지.
false: 기본 값. filterBox에 필터링 조건문 나타나지 않고 groupby API 실행 시 해당 조건문 유지되지 않고 초기화 됨.
customPasteFormatter: [default: ""] Ctrl(또는 cmd) + V를 눌러 클립보드에 복사된 컬럼 단위의 데이터를 붙여넣을 때
데이터의 모양과 값을 변경할 수 있는 포메터 함수를 지정. (단, 포메터 함수는 데이터를 반환해야 한다)
(버전 정보: 5.0_1.2783B.20170908.145609 버전에서 추가.)
dataDragDrop: [true, false] gridView간의 데이터를 drag&drop을 이용하여 주고받을지의 사용 여부로 FireFox에서는 Ctrl 키를 누르고 사용해야한다.
기본적으로 2개의 gridView가 각기 다른 dataList에 연동되어있어야하며 본 속성이 동일하게 적용되어 있어야한다.
dataList: gridView의 data에 해당하는 DataCollection의 DataList id.
disabledBackgroundColor: disabled이 적용 된 cell 또는 행의 배경색.
disabledFontColor: disabled이 적용 된 cell 또는 행의 글자색.
dragDisplayColumn: 사용자가 마우스를 이용하여 drag시(dataDragDrop속성 적용 시) 화면에 tooltip으로 표현 될 data로 표현하고자하는 컬럼의 id를 ","로 구분하여 설정한다.
별도 속성을 정의하지 않은 경우 click 된 컬럼의 data가 tooltip에 표현된다.
dragEndFunction: 드래그 종료시 실행될 함수. dragStartFunction과 쌍으로 사용하며, drilldown인 경우와 아닌 경우 두가지로 구분해서 dragEndFunction을 정의해야 한다.
1) 기본적으로 dragEndFunction을 정의할 때, targetRowIndex, rowXml, infoObj가 각각 첫번째, 두번째, 세번째 인자로 넘어온다. 두번째 인자인 rowXml은 dragStartFunction에서 리턴한 값이며, 세번째 인자인 infoObj는 object이며 fromColumnId, fromColumnIndex, toColumnId, toColumnIndex 정보를 포함하고 있다.
dragEndFunction에서 targetRowIndex에 삽입하고자 하는 row를 삽입하는 로직을 구현하면 되며, 리턴값이 true일 때 처음 dragdrop이 시작됐던 rowIndex에 해당하는 row를 삭제한다.
function end( targetRowIndex, rowXml, info ) {
var fromColumnId = info.fromColumnId;
var fromColumnIndex = info.fromColumnIndex;
var toColumnId = info.toColumnId;
var toColumnIndex = info.toColumnIndex;
.
.
.
return true; // true인 경우만 처음 dragdrop이 시작됐던 rowIndex에 해당하는 row를 삭제한다.
}
2) 그리드가 drilldown을 사용하는 경우 setDrillDownDragDrop 함수의 첫번째 인자값으로 true를 줘야 하며, 이 경우 dragStartFunction은 toIndex, rowXml, infoObj가 각각 첫번째, 두번째, 세번째 인자로 넘어온다.
첫번째 인자값으로는 toIndex가 주어지는데 drilldown을 사용하였기 때문에 targetIndex의 realRowIndex를 계산한 값이라고 보면 된다.
세번째 인자값으로 object가 주어지며 removedData, removedRowIndex, insertedData, insertedRowIndex, fromRowIndex, toRowIndex 정보를 포함하고 있다. 위의 경우와 달리 리턴값은 아무 의미 없다.
function end( toIndex, rowXml, info ) {
var removedData = info.removedData;
var removedRowIndex = info.removedRowIndex;
var insertedData = info.insertedData;
var insertedRowIndex = info.insertedRowIndex;
var fromRowIndex = info.fromRowIndex;
var toRowIndex = info.toRowIndex;
.
.
.
}
dragStartFunction: 드래그 시작시 실행될 함수. dragEndFunction과 쌍으로 사용하며, drilldown인 경우와 아닌 경우 두가지로 구분해서 dragStartFunction을 정의해야 한다.
editModeEvent: 수정모드로 변환하기 위한 이벤트
enterKeyMove: [default:down, right, none, edit] cell에서 enter key 입력 시 포커스 이동방향에 대한 설정
escape: <>&"를 HTML Escape 문자로 변환하여 화면에 표시한다.
euroMask: [default: ""] 화폐단위 변경을 위해 dataType = "euro" 로 설정한 경우나 changeCurrency API를 사용했을 때 적용되는 마스킹 값.
evenRowBackgroundColor: 짝수 행의 배경색
excludeDeletedRows: [default:false, true] subtotal(소계)과 footer(합계)등에 사용되는 expression속성에서 deleted된 row를 제외하고 계산.(deleteRow, deleteRows API를 사용한 경우 해당.)
excludeModifiedRows: [default:false, true] subtotal(소계)과 footer(합계)등에 사용되는 expression속성에서 modifyRowStatus API로 "D"상태가 적용된 row를 제외하고 계산한다.( modifyRowStatus API를 사용한 경우)
(5.0_1.2701A.20170714.211228 버전에서 추가.)
fastScroll: 세로 스크롤 이동시 빠르게 스크롤되는 효과를 주는 기능으로 시간내에 그릴수 있는 부분까지만 표현한다.
그려지지 못하는 영역에는 "화면 갱신 중 입니다." 라는 메세지가 표현된다.
filterBoxvisibleRowNum: 필터링 조건 목록에 표시할 필터링 조건의 수
관련 속성: groupbyFilterBox="true"일 때 유효.
filterFocusMode: sort이벤트 발생 시 이벤트 발생 전 body의 cell/row에 선택되어있는 focus를 제거 할지에 대한 속성.
outfoucs : body의 focus를 제거.
infocus (기본 값): 기존 focus의 위치 유지.
filterShowAlways: [default: false, true] useFilter=true 인 컬럼에서 컬럼 너비가 좁을 때 filter 아이콘을 최우선으로 보여줄지에 대한 여부
fixedColumn: 세로 틀고정을 시킬 컬럼의 위치로 첫번째 컬럼일 경우 "1"로 입력 설정
fixedColumnWithHidden: [default:true, false] fixedColumn속성의 위치값에 hiddenColumn을 포함하여 계산할지 여부
focusAutoRemove: [default:false, true] gridView에 포커스가 있는 상태에서 다른 객체로 mousedown을 통해 포커스가 이동한 경우 기존 gridView에 남아있던 포커스를 제거할 것인지에 대한 여부.
버전 정보: 5.0_1.2759B.20170828.094718 버전에서 추가.
focusFlow: gridView의 포커스 흐름을 선형 혹은 2차원(기본값)으로 설정하는 옵션
focusMode: [default:cell, row, both, none] cell 선택(포커스)시 선택 영역의 표현 방법.
focusMove: [default:true, false, vertical, horizontal] key를 통한 focus이동을 허용할지 여부
true : 상하좌우 모두 허용.
false : key를 통한 이동 금지.
vertical : 상하만 허용.
horizontal : 좌우만 허용.
foldAll: [default: false, true] 각 컬럼을 그룹핑할 때 모든 행을 접는 기능. foldAll API기능과 동일함. (5.0_1.2701A.20170714.211228 버전에서 추가.)
true : 모든 행을 접어서 표시.
false (기본 값) : 모든 행을 펼쳐서 표시.
footerCaption: [default: ""(빈 값)] 바닥글(footer)의 내용.
footerCaptionAuto: [default: false, true] captionAuto 설정에 상관 없이 footerCaption 속성에 바닥글을 자동 생성.
관련 속성: captionTitle, footerCaption
footerSummary: [default: ""(빈 값)] 바닥글(footer)의 내용 요약.
footerSummaryAuto: [default: ""(빈 값)] captionAuto 설정에 상관 없이 footer의 summary 속성에 바닥글을 자동 생성.
관련 속성: captionTitle, footerSummary
버전 정보: 5.0_1.2738B.20170818.202622 버전부터 지원.
groupbyFilterBox: 필터링 기능(groupby)을 사용할 때 필터링 조건 목록의 표시 여부. 사용자는 표시된 목록에서 조건을 선택하여 필터링 수행 가능.
true: 표시.
false (기본 값): 표시하지 않음.
관련 속성: groupbyFilterBoxLocation (필터링 조건 목록 표시 위치), filterBoxvisibleRowNum (표시할 필터링 조건 수)
groupbyFilterBoxFormatter: groupby FilterBox에 추가될 목록의 label을 변경한다(format을 지정). data, isGroupby 두 개의 인자를 전달받는다.
data : groupby filterbox에 추가되는 filter 정보를 담은 객체. 하위 객체로 header와 filter가 존재.
data.header : filter 대상이 되는 열의 헤더 label
data.filter : filter 조건을 포함하는 object
data.filter.operator filter 연산자
data.filter.values filter 비교값 (대상이 다수일 경우에는 array 형태로 제공)
data.filter.gate filter 접속어 [undefiend, and, or]
isGroupby : groupby상태일 경우 true, 아닐 경우 false
groupbyFilterBoxLocation: 필터링 조건 목록(groupbyFilterBox)을 표시할 위치.
top: 상단에 표시.
bottom (기본 값): 하단에 표시.
관련 속성: groupbyFilterBox (필터링 조건 목록 표시 여부)
hideHeader: [default:false, true] header 숨김 여부.
id: 컴포넌트의 ID로 전역객체로 할당되며 script에서 본 id로 컴포넌트에 접근이 가능하다.
ignoreCellClick: drilldown사용할때 toggle 이미지 클릭시 gridView에 oncellclick 이벤트를 발생시키지않음
ignoreNonEditableCell: cell이 편집 불가능할 경우 tab이나 enter로 인한 이동시 무시 여부
ignoreNonEditableCellTabEnter: ignoreNonEditableCell 옵션값이 true인 경우,readonly셀에서 방향키로 인한 이동 가능합니다
ignoreToggleOnDisabled: drilldown사용할때 toggle 이미지 클릭시 해당 셀에 disabled가 적용되어 있을 경우 toggle시키지 않음.
keepDefaultColumnWidth: [default:false, true] autoFit속성을 true로 설정할 경우 rowNum컬럼(rowNumVisible속성)과 rowStatus컬럼(rowStatusVisible속성)의 width를 고정한다.
keyMoveEditMode: [default:false, true] key(tab,enter)를 통한 포커스 이동 시 바로 수정모드로 변경할지의 여부.
loadCount: 세로 scroll이 마지막에 닿고 잔여 행이 본 속성에 설정 된 값과 동일 한 경우 onscrollend이벤트를 발생시킨다.
본 속성을 지정하지 않으면 세로 scroll이 하단에 닿을 때 마다 onscrollend 이벤트가 발생된다.
moveKeyEditMode: 방향키로 원하는 방향에 위치한 셀의 editMode 상태에 바로 진입한다.
noResultMessage: [default:조회 결과가 없습니다.] 조회 결과가 없을 시(DataList의 데이터가 0건일 때) 표시되는 메세지.
noResultMessageClass: 조회 결과 없음(DataList의 데이터가 0건일 때) 메시지에 별도의 style을 적용하기 위한 class명으로 해당 메세지의 HTML구조는 div Tag로 구현되어있으며 하위로 text가 표현된다.
주의사항으로 기본적으로 각 style을 항목이 inline으로 적용되어있음으로 class에서는 각 style 속성에 !important를 함께 써줘야 적용된다.
noResultMessageStyle: 조회 결과 없음(DataList의 데이터가 0건일 때) 메시지에 별도의 style을 작성하는 속성으로 기본적으로 적용되는 style 대신 본 속성에 정의 된 style이 지정 된다.
메세지의 HTML구조는 div Tag로 구현되어있으며 하위로 text가 표현된다. position과 display가 정의되지 않은 경우 엔진에서 absolute, block의 값을 할당한다.
아래는 엔진에서 적용하는 메세지의 기본 스타일로 필요한 부분만 명시했으며 아래의 속성들을 필수로 정의해야 layout이 틀어지지 않는 메세지가 출력된다.
기본 style 예시 ) position: absolute; display: block; left: 40%; width: 20%; top: 40%; text-align:center;
noResultMessageVisible: [default:true, false] 조회 결과가 없을 때(DataList의 데이터가 0건일 때) 메시지를 표시 할지의 여부.
numberMask: [default: ""] 화폐단위 변경을 위해 dataType = "number" 로 설정한 경우나 changeCurrency API를 사용했을 때 적용되는 마스킹 값.
oddEvenColorDisplay: [default:true, false] 행의 짝,홀수의 반복색을 사용할지의 여부.
oddRowBackgroundColor: 홀수 행의 배경색
overflowX: [default:auto, hidden, scroll] 가로 스크롤 표시 여부.
overflowY: [default:auto, hidden, scroll] 세로 스크롤 표시 여부.
preventAddRowOnPaste: [default: false, true] Ctrl(또는 cmd)+V를 눌러 클립보드에서 그리드로 붙여넣을 때 GridView에 있는 행보다 붙여넣을 행이 많은 경우에도 새로운 행을 추가하는 것을 방지.
(5.0_1.2701A.20170714.211228 버전에서 추가.)
true: 행 추가를 방지.
false (기본 값): 붙여넣기 하는 행이 더 많을 경우 행을 추가.
preventCopy: [default: false, true] Ctrl(또는 cmd)+C를 눌러 그리드 전체의 데이터를 클립보드에 복사하는 동작을 방지.
preventCopyColumn: [default: ""] Ctrl(또는 cmd) + C를 눌러 컬럼 단위의 데이터를 클립보드에 복사하는 동작을 방지. (5.0_1.2701A.20170714.211228 버전에서 추가.)
preventCopyColumn속성을 적용할 컬럼 ID를 string형태로 적용한다.
(사용 예) preventCopyColumn = "col1,col2";
preventMultisort: [default:true, false] multisort 기능을 막을지 여부.
preventPaste: [default: false, true] Ctrl(또는 cmd)+V를 눌러 클립보드에 복사된 컬럼 단위의 데이터를 붙여넣는 동작을 방지.
preventPasteColumn: [default: ""] Ctrl(또는 cmd) + V를 눌러 클립보드에 복사된 컬럼 단위의 데이터를 붙여넣는 동작을 방지. (5.0_1.2701A.20170714.211228 버전에서 추가.)
preventPasteColumn속성을 적용할 컬럼 ID를 string형태로 적용한다.
(사용 예) preventPasteColumn = "col1,col2";
readOnly: [default:false, true] gridView전체의 각 cell을 readOnly로 적용하며 body 컬럼의 readOnly속성이 설정된 경우 해당 컬럼의 속성이 우선시 된다.
readOnly 속성은 gridView,column,row,cell 별로 속성 또는 API로 조절이 가능하며 우선 순위에 따라 적용된다. 우선 순위는 아래와 같다.
gridView < column < row < cell (column과 row의 우선 순위는 gridView의 readOnlyPriority속성에 의해 변경 가능)
readOnlyBackgroundColor: readOnly속성이 true인 cell의 배경색.
readOnlyBackgroundImg: readOnly속성이 true인 cell의 배경이미지의 경로.
readOnlyBackgroundImgCSS: readOnly속성이 true인 cell의 배경이미지의 CSS 구문으로 readOnlyBackgroundImg속성보다 우선된다.
예시 ) background: steelblue url("이미지경로") 10px 50% no-repeat;
readOnlyClass: readOnly 일때 추가할 class이름
버전 정보: 5.0_1.2727B.20170804.130646 버전부터 지원.
readOnlyPriority: [default:column, row] readOnly속성 적용의 우선 순위.
readOnly 속성은 gridView,column,row,cell 별로 속성 또는 API로 조절이 가능하며 우선 순위에 따라 적용된다. 우선 순위는 아래와 같다.
gridView < column < row < cell (column과 row의 우선 순위는 gridView의 readOnlyPriority속성에 의해 변경 가능)
readOnlyTabIgnore: [default:false, true] cell에 readOnly가 적용 된 경우 tab key를 눌렀을 때 해당 cell을 건너 뛸지의 여부.
resize: [default:true, false] header의 컬럼 경계선에서 마우스 drag를 이용하여 컬럼의 폭 크기를 조절 할지의 여부.
rowMouseOver: [default:true, false] 마우스 over시에 over된 행의 배경색을 표시할지의 여부.
rowMouseOverColor: 마우스 over시의 행 배경색.
rowNumBackgroundColor: rowNumVisiblue속성이 true인 경우 해당 body 컬럼의 배경색.
rowNumHeaderValue: rowNumVisiblue속성이 true인 경우 header의 텍스트(value).
rowNumLocaleRef: rowNum 컬럼에 설정할 localeRef 키.
(버전 정보: 5.0_1.2801B.20170922.172627 버전에서 추가.)
rowNumStatusResize: [default:false, true]그리드 행 번호 및 상태 컬럼 폭 크기 조절 여부
rowNumStatusUniqueId: [default:false, true] rowNumVisible 또는 rowNumStatus 사용 시 각 row별로 unique한 id를 사용할지에 대한 여부.
기본값은 false로 이 경우 모든 rowNum td들의 id는 _headerRowNumber이고 rowStatus td들의 id는 _headerStatusNumber가 된다.
W3C validator를 통과하기 위해서는 이 속성값이 true여야 한다. 즉 이 속성값을 true로 사용할 것을 권장한다.
(5.0_1.2701A.20170714.211228 버전에서 추가.)
rowNumVisible: [default:false, true] gridView와 연동 된 DataList의 데이터를 기준으로 행 번호를 표시 할지의 여부.
rowNumWidth: rowNumVisiblue속성이 true인 경우 해당 컬럼의 width.
rowStatusHeaderValue: rowStatusVisible속성이 true인 경우 header에 표시 할 텍스트(value).
rowStatusLocaleRef: rowStatus 컬럼에 설정할 localeRef 키.
(버전 정보: 5.0_1.2801B.20170922.172627 버전에서 추가.)
rowStatusVisible: [default:false, true] 각 행의 상태(추가,수정,삭제)를 별도의 컬럼을 통해 아이콘으로 표시 할지의 여부.
rowStatusWidth: rowStatusVisible속성이 true인 경우 해당 컬럼의 width.
rupeeMask: [default: ""] 화폐단위 변경을 위해 dataType = "rupee" 로 설정한 경우나 changeCurrency API를 사용했을 때 적용되는 마스킹 값.
scrollByColumn: [default:false, true] 가로 스크롤이 컬럼 단위로 이동할지의 여부.
scrollByColumnAdaptive: [default:false, true] adaptive상태일 때 가로 스크롤이 컬럼 단위로 이동할지의 여부.
selectedCellColor: 선택 된 cell의 배경색.
selectedCellOverColor: 선택 된 cell에 마우스 over시의 배경색.(지정하지 않으면 rowMouseOverColor속성의 값을 사용)
selectedRowColor: 선택 된 행의 배경색.
selectedRowOverColor: 선택 된 행에 마우스 over시의 배경색.(지정하지 않으면 rowMouseOverColor속성의 값을 사용)
senseReader: [default:false, true] 웹 접근성을 지원하기 위한 모드. 이 모드를 true로 설정하면 tab키로 gridView의 모든 cell을 순회할 수 있다.
또한 inputType="text", "select", "radio", "checkbox"인 경우 embeddedInput="true"를 적용하여 cell내부에 직접 input(또는 select,radio,checkbox)가 포함되어 그려지게 되어 이를 리더기에서 인식할 수 있게 된다.
focusMode="none", focusMove="false" 속성과 함께 사용할 것을 권장한다.
showImageTooltip: [default: false, true] inputType = "image"인 경우, tooltip이 나오도록 설정함.
true: inputType = "image"인 경우, tooltip 기능이 동작함.
false (기본 값): inputType = "image"인 경우, tooltip 기능이 동작 안 함.
(버전 정보: 5.0_1.2799B.20170918.104858 버전에서 추가.)
showSortableImage: [default:false, true] sort가 가능 한 컬럼의 header에 sort 관련 이미지를 출력할지에 대한 여부.
showSortableUseFilter: [default: false, true] useFilterList와 showSortableImage 속성을 동시에 사용할 때 정렬 아이콘(sortable)과 사용자 정의 필터 아이콘(useFilterList) 모두를 헤더에 표시.
관련 속성: showSortableImage="true", sortable="true", useFilterList="true"인 경우 적용 가능.
true: 사용자 정의 필터 아이콘과 정렬 아이콘 모두를 헤더에 표시.
false (기본 값): 정렬 아이콘만 표시.
sortable: gridView의 헤더 클릭을 통한 데이터 정렬 지원 여부
sortEvent: [default:ondblclick, onclick] sortable이 true인 컬럼 header의 sort 기능을 적용 할 이벤트.
sortOrderReverse: 그리드의 헤더 클릭을 통한 데이터 정렬시 내림차순 정렬을 먼저 할지 여부
summary: HTML의 table Tag의 summary 속성과 동일한 기능을 제공한다. 일반적으로 웹접근성 화면 구현시 사용된다.
summaryAuto: 웹접근성 지원시, gridView table 속성중 summary항목에 헤더 컬럼명을 자동으로 설정할지 여부.
summaryOnlyAuto: [default: false, true] 헤더 타이틀이 HTML 태그를 포함한 경우, 태그를 제외한 텍스트만 summary 항목으로 지정.
true: HTML 태그를 제외한 텍스트만 summary로 설정.
false (기본 값): HTML 태그까지 포함하여 summary로 설정.
관련 속성: summaryAuto="true"인 경우에만 유효.
tengeMask: [default: ""] 화폐단위 변경을 위해 dataType = "tenge" 로 설정한 경우나 changeCurrency API를 사용했을 때 적용되는 마스킹 값.
titleAuto: [default: false, true] cell의 header inputType = "text"이고 cell의 inputType이 "text, link, checkbox, button, radio, select(tableRender = "ul"인 경우), secret"일 때,
cell의 title속성에 자동으로 다음과 같은 값이 나타나도록 설정함.
예를들어서 cell의 header Tiltle 값이 "name1" 이고 cell의 data값이 "1"이며 inputType = "text" 인 경우, 해당 cell의 title속성 값은 title = "name1 1" 으로 나타남.
만약 cell의 data값이 ""인 경우에는 해당 cell의 title속성 값은 title = "name text"으로 나타남.
(버전 정보: 5.0_1.2783B.20170908.145609 버전에서 추가.)
tooltipDisplay: [default:false, true] cell의 데이터가 width보다 긴 경우 해당 데이터를 마우스 over시 툴팁으로 표현할지의 여부.
tooltipDisplayColumn: 툴팁을 표시할 컬럼을 지정.
버전 정보: 5.0_1.2705B.20170721.164120 버전부터 지원.
tooltipFormatter: tooltipDisplay속성이 true일 때 tooltip 내용을 변경할 사용자 함수명.
사용자 함수는 rowIndex, colIndex, label, isOverflow를 인자로 받아 string을 반환.
tooltipHeader: [default:false, true] gridView의 header에 tooltip을 나타내는 설정.tooltipDisplay = "true"(또는 tooltipShowAlways="true")로 설정 후 동작함.
기존에 tooltip 관련 옵션인 tooltipDisplay 및 tooltipDisplayTime등과 기능이 일치한다.
tooltipPositionX: [defulat:20] tooltipDisplay가 true일 경우 표현 될 tooltip의 x좌표로 body cell의 왼쪽 끝이 원점이며 px단위로 계산된다.
좌표를 계산 할 수식도 넣을 수 있으며 cellWidth(cell의 width)와 cellHeight(cell의 height)를 이용하여 수식을 넣을 수 있다.
예시 ) cellWidth/2 : body cell의 중앙이 툴팁의 x축 시작점이 된다.
tooltipPositionY: [defulat:cellHeight+3] tooltipDisplay가 true일 경우 표현 될 tooltip의 y좌표로 body cell의 왼쪽 상단이 원점이며 px단위로 계산된다.
좌표를 계산 할 수식도 넣을 수 있으며 cellWidth(cell의 width)와 cellHeight(cell의 height)를 이용하여 수식을 넣을 수 있다.
예시 ) cellHeight : bocy cell이 끝나는 바로 하위가 y축 시작점이 된다.
주의 사항으로 gridView의 style에 margin-top이 적용 된 경우 y축에 영향을 미친다.
tooltipShowAlways: [default:false, true] 데이터에 대한 tooltip을 마우스 over 시 항상 보여줄지에 대한 여부로 데이터가 공백("")인 경우를 제외하고는 항상 보여준다.
useCtrlKey: [default:true, false] ctrl키를 누르고 여러 개의 셀을 선택할지 여부.
useCtrlOnMultisort: [default:true, false] 여러 개의 컬럼에 소팅을 하고자 할 때 ctrl키를 누르고 컬럼들을 선택할지 여부.
useFilterList: [default: false, true] 필터링 대상 값을 목록으로 표시. 이 때 목록 첫번째에는 "사용자 필터"를 표시. 사용자가 "사용자 필터"를 클릭하면 사용자 지정 필터 팝업 창이 표시됨.
GridView 전체에 설정.
true: "사용자 필터"를 포함한 필터링 대상 값을 목록으로 표시.
false (기본 값): 필터링 대상 값을 목록으로 표시하지 않고 "사용자 필터만" 상위에 표시.
관련 속성: GridView 컬럼(gridView.column)의 설정이 useFilter="true"인 경우 적용 가능.
useFilterListSync: [default: false, true] useFilterList="true"일 때 dataList의 setFilter API를 이용하여 필터링이 된 경우에도 필터를 펼쳤을 때 나오는 항목(필터목록)에 반영할지에 대한 여부
GridView 전체에 설정.
true: 필터 목록을 선택했을 때 뿐만 아니라 setFilter, setColumnFilter등의 dataList API에 의해 필터링이 된 경우에도 필터 목록이 줄어들지 않고 그에 맞춰서 나타남.
false (기본 값): dataList의 API에 의해 필터링이 된 경우에는 필터 목록이 데이터가 줄어든 영역은 감춰진다.
관련 속성: useFilterList="true"인 경우 적용 가능.
userData1: 사용자 정의 데이터 속성. getUserData("userData1") API를 통해 설정한 값을 얻어올 수 있다.
userData2: 사용자 정의 데이터 속성. getUserData("userData2") API를 통해 설정한 값을 얻어올 수 있다.
userData3: 사용자 정의 데이터 속성. getUserData("userData3") API를 통해 설정한 값을 얻어올 수 있다.
useShiftKey: shift key를 이용하여 복수 셀의 선택에 대한 적용 여부.
visibleRowNum: 화면에 표현 될 행 수. "all"로 설정 시 모든 row가 스크롤 없이 표현된다.
wheelRows: [default:3] 마우스 휠을 이용하여 세로 스크롤이 이동 될 때 한번 이동하는 row의 개수
wheelStop: [default:false] 그리드 스크롤이 맨 아래로 내려갔을 때 wheel을 한 경우 브라우저 스크롤을 막을지에 대한 여부

Event Detail

onafteredit

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

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

onbeforeedit

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

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

onbodymouseover

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

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

Sample

oncellclick

셀이 클릭 된 경우 발생한다.

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

oncelldblclick

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

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

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

oneditend

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

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

oneditkeydown

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

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

Sample

oneditkeyup

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

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

Sample

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 객체

Sample

/**

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

onscrollend

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

onscrollx

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

onscrolly

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

ontextimageclick

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

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

onviewchange

셀의 데이터가 키보드나 마우스 조작을 통해 변경된 경우에만 발생한다.
API(스크립트)를 통해 값이 변경된 경우에는 해당 이벤트가 발생하지 않는다. (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형태로 저장된 그리드의 엑셀 다운로드 옵션
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 , delimiter , decimalDelimiter )

컬럼 단위로 화면에 나타나는 셀 값들의 화폐단위를 동적으로 변경할 수 있다.
(버전 정보: 5.0_1.2820B.20171020.190849 버전에서 추가.)

Parameter
name	type	required	description
columnID	String	Y	화폐단위를 적용할 컬럼 id
dataType	String	Y	적용할 화폐단위
displayFormat	String	N	컬럼에 적용할 displayFormat
delimiter	String	N	통화 구분자
decimalDelimiter	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으로 설정 된다). check 되는 경우 : true , 1 , trueValue속성에 정의 된 값 uncheck 되는 경우 : false , 0 , falseValue속성에 정의 된 값

clearGroupby( )

groupBy를 해제한다.

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(); //return 예시 ) [ {col: 1, row: 2}, {col: 0, row: 4} ]

getAllFocusedRowIndex( )

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

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

Sample

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

getAllVisibleData( )

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

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

Sample

//DataList에 2개의 컬럼이 정의 되고 4행의 데이터가 set 된 경우 gridView1.getAllVisibleData(); //return 예시 ) ["아이유", "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 데이터

getBottomRowIndex( )

현재 눈에 보여지는 gridVeiw의 최하단 row의 rowIndex를 반환한다. 그려진 row가 없으면 -1을 반환한다.

Return
type	description
Number	최하단 row의 rowIndex

Sample

//총 10건의 row의 데이터가 셋팅되고 화면에는 4건의 데이터가 보여지는 경우 - gridView의 height가 작아 10건의 데이터를 다 표현하지 못하고 스크롤이 생겨 4건의 데이터만 눈에 보여질 때 gridView1.getBottomRowIndex(); //return 예시 ) 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여부

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"); //return 예시 ) 154 //1번째 row의 2 컬럼의 height를 가져올 때 var tmpCellHeight = gridView1.getCellSize(0,1,"height"); //return 예시 ) 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"); //return 예시 ) [["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"); //return 예시 ) [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"); //return 예시 ) [{"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	해당 열에 글자색

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

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여부

getDataLength( )

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

Return
type	description
number	행의 수

getDataList( )

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

Return
type	description
String	data의 Id

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( )

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

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의 상태를 나타내는 문자 (초기상태:"R", 갱신:"U", 삽입:"C", 삭제:"D", 삽입 후 삭제:"V")

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	그리드의 읽기 전용 속성

getGridStructure( )

웹스퀘어 화면 xml에서 생성된 gridView의 node 구조를 반환한다.

Return
type	description
Object	gridView의 node 구조

Sample

var node = gridView1.getGridStructure();

getHeaderBackgroundColor( headerId )

header 셀에 적용된 배경색 값을 가져온다.

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

Return
type	description
String	header 셀의 배경색 값

getHeaderColor( headerId )

header 셀에 적용 된 글씨 색상값을 가져온다.

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

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

getHeaderColumnVisible( colIndex )

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

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

Return
type	description
Boolean	column의 visible여부

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

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속성값

getRowReadOnly( rowIndex )

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

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

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

getSortableArr( )

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

Return
type	description
Boolean	각 컬럼의 sortable 여부

getSortableStatus( )

sorting된 컬럼의 순서대로 해당 컬럼의 header 정보를 담은 object를 array로 반환한다. sorting된 컬럼이 없을 경우 빈 array를 반환한다.
반환된 array의 각 object는 colID, dataType, sortOrder를 담고 있으며 sortOrder가 1인 경우 오름정렬이고, -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 )

헤더 컬럼의 전체 개수를 반환. 병합된 헤더 컬럼을 모두 전체 개수에 포함할 것인지의 여부 및 rowNum과 rowStatus 칼럼 포함 여부를 지정 가능.
(버전 정보: 5.0_1.2820B.20171020.190849 버전에서 추가.)

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. //return 예시 ) [["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. //return 예시 ) [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. //return 예시 ) <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의 데이터가 셋팅 된 gridView가 화면에는 4건이 보여지고 넘치는 영역은 스크롤로 표현 될 때 반환 값은 4이다.

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

groupby( Options )

둘 이상의 컬럼의 데이터를 그룹핑하여 그룹핑 결과(통계)만 표시.

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를 가지고 있는지 여부

initGrid( )

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

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

isEditing( )

gridView가 현재 편집중 인지의 여부를 반환한다.

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

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); //return 예시 ) "D" //2번째 row의 Status를 가져온다.(checkbox가 uncheck 된 경우) var tmpRs2 = gridView1.getRowStatus(1); //return 예시 ) "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); //return 예시 ) "R" // row에 별도의 수정 작업을 하지 않은 경우 //2번째 row의 Status를 가져온다.(checkbox가 uncheck 된 경우) var tmpRs2 = gridView1.getRowStatus(1); //return 예시 ) "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 업로드 옵션

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	[defulat:true, false]cell의 inputType이 select인 경우 selectbox와 cell의 value의 적합성에 따라 데이터를 처리 유무.

refreshColumnItemset( col )

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

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

removeFocusedCell( )

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

removeFocusedMultiCell( startRow , startCol , endRow , endCol )

지정한 직사각형 영역에 속하는 셀의 포커싱을 해제. 여러 셀의 포커싱 해제. (5.0_1.2701A.20170714.211228 버전에서 추가.)

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) 셀들의 포커싱이 해제됨. // 포커싱되지 않은 셀은 영향받지 않음.

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옵션이 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");

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 )

rowIndex와 colIndex에 해당하는 셀의 inputType이 checkbox/radio인 경우 flag에 따라 true이면 check, false이면 uncheck해 줍니다.

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

setCellColor( rowIndex , colIndex , color )

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

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

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 속성에 적용할 값

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( gridView의 , chooseOptionValue , chooseOptionLabel )

gridView에 column의 inputtype이 select일때 selectbox에 chooseOption의 label, value값을 변경함

Parameter
name	type	required	description
gridView의	Number	Y	colindex
chooseOptionValue	String	Y	변경값
chooseOptionLabel	String	Y	변경값

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속성에 적용할 값

setColumnNodeSet( colIndex , nodeset , label , value )

inputType = "select" 또는 "autoComplete", "checkcombobox" 인 경우, 새로운 nodeset을 설정한다.
getColumnNodeSet API와 대응한다.

Parameter
name	type	required	description
colIndex	String\|\|Number	Y	폭을 변경할 column의 index 또는 id
nodeset	String	Y	연결할 nodeset 정보
label	String	Y	연결할 nodeset의 label 정보
value	String	Y	연결할 nodeset의 value 정보

Sample

gridView1.setColumnNodeSet("col3","data:dataList2","label","value");

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 여부(true인 경우 해당 column을 표시하고 false인 경우는 숨김)

setColumnWidth( colIndex , size )

컬럼의 width을 변경한다.

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

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);

setDisplayFormat( colIndex , displayFormat )

컬럼의 displayFormat속성을 설정한다.
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"); //display 예시 ) "19831231"의 데이터가 "31-12 1983"으로 표현된다.

setDisplayFormatter( colIndex , displayFormatter )

컬럼의 displayFormatter 속성을 설정한다.

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

setDrillDownDragDrop( value )

drillDown컬럼이 포함된 gridView 에서 dataDragDrop="true" 설정하고 setDrillDownDragDrop함수에 파라미터로
true로 설정값을 넘겨주고 실행 drilldown drag drop이 동작한다.

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 )

지정한 직사각형 영역에 속하는 셀을 포커싱. 여러 셀의 포커싱. (5.0_1.2701A.20170714.211228 버전에서 추가.)

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에 지정할 색상

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 상태를 나타내는 숫자 값 (오름차순이면 1, 내림차순이면 -1, sort를 하지 않는 상태이면 0)
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)

setNoResultMessage( message )

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

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

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로 계산된다

setStartRowNumber( rowIndex )

rowNum 컬럼에 표현되는 행번호의 시작되는 숫자의 index를 설정한다.
index의 값이므로 10을 설정하면 화면에는 11부터 시작된다. gridView의 rowNumVisible 속성의 값의 true일 경우에만 정상 표현된다.

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

Sample

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

setSummary( str )

gridView의 HTML summary 속성값을 설정한다.

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

setTopRowIndex( topRowIndex )

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

Parameter
name	type	required	description
topRowIndex	Number	Y	상단에 표현할 rowIndex

showChooseOption( gridView의 , chooseOption )

gridView에 column의 inputtype이 select일때 selectbox에 chooseOption을 설정함

Parameter
name	type	required	description
gridView의	Number	Y	colindex
chooseOption	Boolean	Y	on/off

Sample

gridView1.showChooseOption(1,true);

showCustomFilter2( headerID: )

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

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

showCustomFilterReset( )

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

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을 toggle한다.(행이 닫혀있으면 열리고 열려있으면 닫힌다)

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