PropertyEventMethod찾아보기
WebSquare.uiplugin.gridView - 5.0_5.5283A.20250313.190345

대량의 데이터를 그리드 형태로 표시하고 수정할 수 있는 컴포넌트.
데이터 정보를 가지고 있는 DataList와 바인딩하여 사용.
소계/합계, 동적 그룹핑, 엑셀 파일 업로드/다운로드, 정렬, 필터링 등을 지원.

Type

uiplugin

Property Summary

accessibility
웹 접근성 지원 기능을 사용할지에 대한 여부
adaptive
다양한 화면 크기와 디바이스에 맞게 레이아웃이 변경되는 적응형 웹 모드
adaptiveThreshold
[default: 480] adaptive 속성이 설정되어 있을 경우 레이아웃 변경을 하기 위한 임계 값
alwaysTriggerScrollStart
스크롤이 최상단에 위치할 때마다 onscrollstart 이벤트를 발생시킬지 여부
applyAllColumnStyle
컬럼에 지정된 모든 스타일 적용 여부
arrowMove
셀 내부에서 첫 번째 또는 마지막 문자에 있을 때, 좌우 방향키로의 셀 이동을 허용할지 여부
autoFit
[default: none, lastColumn, allColumn] 전체 화면 폭에 모든 컬럼의 폭을 균등하게 배분하는 기능으로, 이 기능을 사용하면 가로 스크롤이 나타나지 않음
autoFitCellMinWidth
[default: ""] autoFit="allColumn" 설정을 적용하기 위해 필요한 GridView 행의 최소 너비. (단위: px)
autoFitMinWidth
[default: ""] autoFit에 "allColumn" 설정을 적용하기 위해 필요한 GridView의 최소 너비 (단위: px)
autoResizeEmbeddedInput
[default: false, true] 센스리더 또는 embeddedInput가 "true"이며 inputType이 text 또는 secret일 때, Input의 크기를 자동으로 계산할지 여부
captionAuto
[default: false, true] 각 헤더의 제목을 조합해서 그리드의 요약 태그인 캡션 값을 구성할지 여부 (captionTitle 값은 캡션 값의 앞에 제목으로 포함하여 구성)
captionTitle
[default: ""] captionAuto를 사용하여 그리드의 요약 태그인 캡션 값을 구성할 때 가장 앞에 추가할 내용
CellClickFixScrollX
[default: false, true] 전체 가로 스크롤이 생겼을때 화면에서 일부가 가려진 셀을 클릭함으로써 가로 스크롤이 움직일지의 여부
cellStatusIconPosition
[default: right, left] 각 셀의 상태 아이콘 위치를 지정
cellStatusVisible
[default: false, true] 각 셀의 값에 변경이 생겼을때 좌측 또는 우측 상단에 아이콘 표시 여부
checkAllType
[default: include, exclude] 헤더의 inputType이 checkbox인 경우, 전체 셀을 선택할 때 disabled나 readOnly된 셀을 포함할지에 대한 여부
checkDisabledOnCut
[default: true, false] disabled가 "true"인 컬럼의 데이터를 Ctrl+X로 잘라내기를 허용할지 여부
checkEditableInputClass
[default: false, true] inputType이 text이고 셀의 상태가 readOnly 혹은 disabled인 경우, nobr 태그에 "w2grid_input" class의 적용여부
checkEditOnPaste
[default: false, true] 편집모드 상태에서 n*n 데이터를 Ctrl+V로 붙여넣기할 때, 편집 셀 기준으로 n*n 개의 셀에 데이터를 붙여넣기 할지에 대한 여부
checkReadOnlyOnCut
[default: true, false] readOnly가 "true"인 컬럼의 데이터를 Ctrl+X로 잘라내기를 허용할지에 대한 여부
checkReadOnlyOnPaste
[default: false, true] readOnly가 "true"인 모든 컬럼에 Ctrl+V로 데이터 붙여넣기를 허용할지에 대한 여부 (checkReadOnlyOnPasteEnable에서 컬럼 지정과 무관)
checkReadOnlyOnPasteEnable
[default: ""] readOnly="true"인 컬럼에 Ctrl +V를 통한 붙여넣기를 허용하는 컬럼을 지정
class
HTML의 클래스 속성과 동일한 기능을 제공
columnMove
[default: false, true] 헤더 부분을 드래깅으로 컬럼 이동 허용
columnMoveWithFooter
[default: false, true] 컬럼 이동 시 푸터를 함께 이동할지 여부 설정
contextMenu
[default: false, true] 컨텍스트 메뉴 사용 여부
contextMenuAltClick
[default: false, true] Alt 키 + 마우스 좌클릭 시, 컨텍스트 메뉴 표시 여부
copyOption
[default: dataList, display] 데이터를 복사할 때 DataList에 들어있는 값을 기준으로 복사할지(dataList), 또는 화면에 보이는 기준(display)으로 복사할지를 설정
copyType
[default: default, native] 데이터를 복사할 때 포커스된 셀을 전부 복사할지(default) 또는 드래그를 통해 선택한 텍스트를 복사할지(native)를 설정
ctrlShiftKey
[default: false, true] Ctrl 키와 Shift 키를 번갈아 사용 가능하게 요청
customFilterBox
[default: false, true] 필터가 설정된 상태에서 groupby() 함수를 실행할 경우, 해당 필터를 계속 표시할지 여부
dataDragDrop
[default: false, true] 동일한 GridView 또는 서로 다른 GridView 간의 데이터 드래그-앤-드롭을 허용
dataDragDropOther
[default: false, true] 서로 다른 GridView 간의 데이터를 드래그-앤-드롭만 허용할지 여부
dataDragDropSelf
동일 gridView 내에서만 데이터 드래그-앤-드롭만 허용할지 여부 [true, false]
dataDragDropStatus
[default: false, true] 변경이 일어난 데이터를 드래그-앤-드롭을 통해 이동시켰을 때 행 상태를 유지할지 여부
dataDragSelect
[default: false, true] 여러 개의 셀들을 드래그로 선택
dataDragSelectAutoScroll
[default: false, true] 드래그를 통해 복수의 셀을 선택할 경우(dataDragSelect="true"), 마우스가 화면 밖을 벗어나면 자동으로 스크롤이 되는 기능
dataDragSelectAutoScrollLevel
[default: 1300] dataDragSelectAutoScroll 기능 사용 시 현재의 스크롤링 속도가 2배로 빨라지기까지의 시간 (단위: ms)
dataDragSelectAutoScrollPeriod
[default: 70] dataDragSelectAutoScroll 기능 사용 시 스크롤링이 발생하는 주기 (단위: ms)
dataList
GridView의 데이터에 해당하는 데이터컬렉션의 DataList의 아이디
defaultCellHeight
[default: -1] 셀의 기본 높이
disabledBackgroundColor
disabled가 "true" 설정이 적용된 셀 혹은 행의 배경색
disabledFontColor
disabled가 "true" 설정이 적용된 셀 혹은 행의 글자색
disabledScrollHidden
[default: false, true] GridView가 disabled인 경우 스크롤도 함께 숨김
dragDisplayColumn
[default: ""] 데이터를 드래그(dataDragDrop="true")할 때 툴팁으로 표시할 컬럼의 아이디를 지정
dragEndFunction
드래그 종료시 실행될 함수
dragStartFunction
드래깅 시작 시 실행할 함수
drawType
[default: virtual, native] GridView를 그릴 때 화면에 보이는 부분만 그릴지 (virtual), 전체를 그릴지 (native)에 대한 여부
drilldownToggle
[default: ""] 드릴다운 컬럼에서 목록을 펼칠 때 사용되는 방식을 지정
drilldownToggleScrollFix
[default: false, true] 드릴다운 컬럼에서 +버튼을 클릭하여 목록을 펼칠 때 스크롤을 고정
dynamic
[default: false, true] 틀만 그려놓고 setGridStyle을 통해 동적으로 생성
editModeEvent
[default: ondblclick, onclick, onsecondclick] 셀 수정 모드로 진입하기 위한 마우스 동작 이벤트
editModeEventIcon
[default: onclick, ondblclick] viewType이 "icon"인 경우 수정 모드로 진입하기 위해 필요한 마우스 동작 이벤트
enterKeyMove
[default: down, right, none, edit, editRight, editDown] 셀에서 Enter 키를 입력할 경우 포커스 이동 방향
escape
[default: true, false] <>&"를 HTML escape 문자로 변환하여 화면에 표시
euroMask
[default: ""] dataType이 "euro"인 경우나 changeCurrency() 함수를 사용하는 경우 화폐 표현식
evenRowBackgroundColor
짝수 행의 배경색
excludeDeletedRows
[default: false, true] 부분합과 푸터 등에서 삭제된 행을 제외하고 계산을 실행
excludeModifiedRows
[default: false, true] 부분합과 푸터 등에서 변경(수정, 삭제, 추가)이 발생한 행을 제외하고 계산
fastScroll
[default: true, false] 세로 스크롤 이동 시 고속 스크롤링 효과를 추가
filterBoxvisibleRowNum
[default: 4] 필터링 조건 목록에 표시할 필터링 조건의 수
filterFocusMode
[default: ""] 정렬 이벤트 발생 시 이벤트 발생 전 바디의 셀/행에 선택되어있는 포커스를 제거할지에 대한 속성
filterShowAlways
[default: false, true] useFilter가 "true"인 컬럼에서 컬럼 너비가 좁을 때 필터의 아이콘을 최우선으로 표시
fixedColumn
[default: 0] 틀고정을 적용할 컬럼의 위치
fixedColumnLineDiv
틀고정 CSS를 Div에 표현할지 여부
fixedColumnLineDivStart
틀고정 Div 시작 위치 지정
fixedColumnNoMove
[default: false, true] 고정된 컬럼이 지정된 컬럼의 컬럼 이동 허용 여부
fixedColumnScrollHidden
[default: false, true] 틀고정을 할 경우, 고정된 영역의 스크롤을 숨김
fixedColumnWithHidden
[default: true, false] 고정된 컬럼의 위치 값에 숨겨진 컬럼을 포함하여 계산할지 여부
fixedRightColumn
[default: 0] 우측에 틀고정할 컬럼의 수
fixedRow
[default: 0] 틀고정을 시킬 행의 위치
focusDefaultColumn
[default: false, true] true 설정 시 행 번호 컬럼 및 행 상태 컬럼이 포커스를 받을 수 있는 상태로 바꿀지 여부
focusFlow
[default: default, linear] 포커스 이동 방향을 설정
focusImage
[default: false, true] senseReader 또는 embeddedInput이 true이며 inputType이 "image"인 경우, 이미지로 포커스 이동할지 여부
focusMode
[default: cell, row, both, none] 셀에 포커스 시 선택 영역 표현 방법
focusMove
[default: true, false, vertical, horizontal] 방향키를 통한 포커스 이동 허용
footerCaption
[default: ""] 푸터의 캡션에 들어갈 내용 설정
footerCaptionAuto
[default: false, true] captionAuto 설정에 상관 없이 푸터의 캡션 내용 자동 생성
footerSummary
[default: ""] 푸터의 내용 요약
footerSummaryAuto
[default: false, true] captionAuto 설정에 상관 없이 푸터의 요약 자동 생성
groupbyFilterBox
[default: false, true] 필터링 기능을 사용할 때 필터링 조건 목록의 표시 여부
groupbyFilterBoxFormatter
groupbyFilterBox에 출력되는 목록의 형식을 변경하는 속성
groupbyFilterBoxLocation
[default: bottom, top] groupbyFilterBox를 표시할 위치
groupbyMaxCount
groupby 가능한 최대 컬럼 개수를 지정
groupbyZone
[default: false, true] groupby 기능을 사용 여부 (groupby란 특정 컬럼들을 기준으로 컬럼 내의 같은 데이터들을 그룹핑하여 표시)
groupbyZoneHeight
[default: 50] groupbyZone의 높이를 설정
groupbyZoneMessage
groupbyZone이 초기 상태일 경우 출력할 메세지를 설정
hammerEnabled
[default: true, false] 모바일에서 더블클릭 이벤트를 Hammer
hammerPressTime
[default: 351] 키를 누른(press) 상태 이벤트가 발생하기까지 누르고 있어야 할 시간 (단위: ms)
hideDeletedRow
[default: false, true] 삭제된 행을 화면에서 보여지지 않게 할지 여부
hideFilterIconOnNoData
[default: true, false] 데이터가 존재하지 않을 경우 웹접근성용 head filter 아이콘을 보여줄지 여부
hideHeader
[default: false, true] 헤더 숨길지 여부
hideSortIconOnNoData
[default: true, false] 데이터가 존재하지 않을 경우 웹접근성용 head sort 아이콘을 보여줄지 여부
id
컴포넌트 아이디 (전역 객체로 할당)
ignoreCellClick
[default: false, true] 드릴다운 컬럼에서 하위 노드가 있는 경우 상위 노드 셀에 oncellclick 이벤트 발생 여부
ignoreNonEditableCell
셀 편집이 불가능할 경우, Tab 키나 Enter 키 입력을 무시
ignoreNonEditableCellTabEnter
[default: false, true] ignoreNonEditableCell이 "true"인 경우, readOnly="true" 셀에서 방향키를 통한 이동 허용
ignoreToggleOnDisabled
[default: false, true] 드릴다운 시 disabled이 "true"인 셀의 경우 토글 이미지를 클릭을 무시
initFixedHeightByRowNum
[default: -1] 최초 렌더링된 GridView의 행의 수를 기준으로 GridView의 높이를 초기화 (부분합의 행의 수도 포함)
keepDefaultColumnWidth
[default: false, true] autoFit이 설정되어 있는 경우, 행의 번호(rowNum)와 행의 상태(rowStatus) 컬럼의 너비를 고정
keyMoveEditMode
[default: false, true] Tab이나 Enter 키를 사용하여 이동 시 즉시 편집 모드로 진입 여부
labelDelimiter
GridView
loadCount
세로 스크롤이 하단에 닿은 후 발생되는 onscrollend() 이벤트를 한번만 발생시켜 줄 행을 지정
mergeCells
행 또는 컬럼 기준으로 연속적으로 같은 데이터들을 병합함
mergeCellsFixedCols
fixedColumn 영역 내에서 행 또는 컬럼 기준으로 연속적으로 같은 데이터들을 병합
mergeCellsFixedRows
fixedRow 영역 내에서 행 또는 컬럼 기준으로 연속적으로 같은 데이터들을 병합
mergeCol
mergeCells로 병합하는 경우 병합을 수행할 컬럼을 지정
mergeExcludeValue
병합하지 않을 값을 정의
minWidth
[default: 0] 컬럼의 최소 너비 (단위: px), 컬럼에 minWidth를 선언한 경우 우선 적용
moveKeyEditMode
[default: false, true] 상하 방향키를 사용하여 이동 시 즉시 편집 모드로 진입 여부
moveKeyEditModeAll
[default: false, true] 상하좌우 방향키를 사용하여 이동 시 즉시 편집 모드로 진입 여부
nextTabID
Tab 키로 이동할 경우, Tab 키를 누를 때 다음으로 선택될 컴포넌트의 아이디
noResultMessage
[default: "조회 결과가 없습니다
noResultMessageClass
조회 결과 없음 메시지에 별도의 스타일을 적용하기 위한 클래스
noResultMessageStyle
조회 결과 없음 메시지에 별도의 스타일을 적용
noResultMessageURL
gridview별로 noResultMessage를 변경할 수 있는 xml 파일 경로
noResultMessageVisible
[default: true, false] 조회 결과가 없을 때 메시지 표시 여부
noResultMessageVisibleAlways
[default: false, true] 데이터가 하나도 없을 때 메시지 표시 여부 (DataList 연동여부와 상관없음)
noSelect
다중으로 셀을 드래깅하거나 Ctrl 또는 Shirt 키를 통해 여러 셀 선택 허용 여부
numberMask
[default: ""] 숫자나 화폐 표시형태 변경을 위해 dataType="number" 설정이나 changeCurrency(); 함수를 사용할 경우 적용되는 숫자표시 형식 값
oddEvenColorDisplay
[default: true, false] 짝/홀수 행 마다 서로 다른 색의 사용 여부
oddRowBackgroundColor
홀수 행의 배경색
overflowX
[default: auto, hidden, scroll] 가로 스크롤 표시 여부
overflowY
[default: auto, hidden, scroll] 세로 스크롤 표시 여부
preventAddRowOnPaste
[default: false, true] Ctrl(또는 cmd)+V를 눌러 클립보드에서 그리드로 붙여넣기하는 경우 새로운 행의 추가 여부
preventCopy
[default: false, true] Ctrl(또는 cmd)+C 또는 Ctrl(또는 cmd)+X를 통해 데이터를 클립보드에 붙여넣는 동작을 방지 (셀이 편집모드인 경우에는 설정이 무시됨)
preventCopyColumn
[default: ""] Ctrl(또는 cmd)+C 또는 Ctrl(또는 cmd)+X를 통해 데이터를 클립보드에 복사하는 동작을 방지할 컬럼의 아이디를 지정 (셀이 편집모드인 경우에는 설정이 무시됨)
preventMultisort
다중 정렬을 방지
preventPaste
[default: false, true] Ctrl(또는 cmd)+V를 통해 클립보드의 정보를 붙여넣는 동작을 방지 (셀이 편집모드인 경우에는 설정이 무시됨)
preventPasteColumn
[default: ""] Ctrl(또는 cmd)+V를 통해 클립보드의 정보를 붙여넣는 동작을 방지할 컬럼의 아이디를 지정 (셀이 편집모드인 경우에는 설정이 무시됨)
readOnly
[default: false, true] 전체 셀을 읽기 전용으로 설정
readOnlyBackgroundColor
읽기전용 셀의 배경색
readOnlyBackgroundImg
읽기전용 셀의 배경 이미지 경로
readOnlyBackgroundImgCSS
읽기전용 셀의 배경 이미지의 스타일(CSS)
readOnlyPriority
[default: column, row] 읽기전용(readOnly)의 적용 우선 순위 설정
readOnlyTabIgnore
[default: false, true] Tab 키로 컬럼이동 시 읽기전용 컬럼를 무시할 지 여부
resize
[default:true, false] 마우스 드래깅을 통한 컬럼 너비 조절 허용
rowMouseOver
[default: true, false] 마우스커서가 위치(마우스-오버)할 때 행의 배경색을 표시할지 여부
rowMouseOverClass
마우스-오버된 행에 적용할 클래스
rowMouseOverColor
마우스커서가 위치(마우스-오버)할 때 표시할 행의 배경색
rowNumBackgroundColor
행 번호 컬럼의 배경색
rowNumHeaderValue
행 번호 헤더에 표시할 텍스트
rowNumLocaleRef
행의 번호표시(rowNum ) 컬럼에 설정할 다국어 키 값
rowNumRowMouseOverColor
rowNum 컬럼에 rowMouseOverColor 적용 여부
rowNumStatusResize
[default: false, true] 행 번호(rowNum) 및 행 상태(rowStatus) 표시 컬럼의 너비 조절 가능 여부
rowNumStatusUniqueId
[default: false, true] 행 번호(rowNum) 혹은 행 상태(rowStatus) 표시를 사용 시 각 행 별로 유일한 아이디를 사용 (웹표준검사(W3C Validator)를 위한 속성)
rowNumVisible
[default:false, true] 행 번호 표시 여부
rowNumWidth
행 번호를 표시하는 컬럼의 너비
rowStatusHeaderValue
헤더에 표시할 텍스트
rowStatusLocaleRef
행의 상태표시(rowStatus) 컬럼에 설정할 다국어 키 값
rowStatusVisible
[default: false, true] 각 행의 상태(추가/수정/삭제)를 별도의 컬럼에 아이콘으로 표시
rowStatusWidth
행 상태(rowStatus) 표시 컬럼의 너비
rupeeMask
[default: ""] dataType이 "rupee"인 경우나 changeCurrency() 함수를 사용하는 경우 화폐 표현식
scrollByColumn
[default: false, true] 가로 스크롤을 컬럼 단위로 이동
scrollByColumnAdaptive
[default: false, true] 적응형웹(Adaptive) 상태일 때 가로 스크롤을 컬럼 단위로 이동
scrollFocus
[default: false, true] 마지막 행에서 탭키이동시 세로스크롤(Y) 영역으로 포커스를 이동할지 여부
scrollXNative
[default: false, true] 가로 스크롤을 브라우저에서 제공하는 기본 스크롤을 사용할지에 대한 여부
scrollXNativeMobile
[default: "", false, true] 가로 스크롤을 브라우저에서 제공하는 기본 스크롤을 사용할지에 대한 여부
selectedCellColor
선택된 셀의 배경색
selectedCellOverColor
선택된 셀이 있는 행에 마우스커서가 위치(마우스-오버)할 때 표시할 셀의 배경색
selectedRowColor
선택된 행의 배경색
selectedRowOverColor
선택된 셀이 있는 행에 마우스커서가 위치(마우스-오버)할 때 표시할 행의 배경색
senseReader
[default: false, true] 웹 접근성을 지원하기 위한 모드
setCellInputTypeCustom
[default: false, true] inputType이 "custom"인 경우 inputType을 동적으로 변경하기 위한 옵션 (typeGetter와 동시에 사용 불가 및 drilldown 미지원)
showCustomFilterReset
사용자 필터를 초기화시킬 수 있는 버튼을 출력
showImageTooltip
[default: false, true] inputType이 "image"인 경우에도 툴팁을 표시 (이미지의 링크정보를 표시)
showSortableImage
[default: false, true] 정렬 가능한 컬럼의 헤더에 정렬 이미지를 출력
showSortableUseFilter
[default: false, true] useFilterList와 showSortableImage 를 동시에 사용할 때 정렬 아이콘과 사용자 정의 필터 아이콘 모두를 헤더에 표시
sortable
[default: false, true] 헤더 클릭으로 데이터 정렬 지원 여부
sortedIconPosition
[default: "right", "left"] 정렬 관련 이미지를 표시할 위치
sortEvent
[default: ondblclick, onclick] 정렬을 수행할 이벤트를 정의
sortHeaderDiv
[default: false, true] 헤더영역에 정렬 아이콘을 표시할지의 여부
sortOrderReverse
[default: false, true] 헤더 클릭을 통한 데이터 정렬 시 내림차순 정렬을 먼저 수행
subtotalStyleFormatter
부분합의 값에 따른 스타일의 적용을 해주는 사용자 함수를 지정
summary
HTML <table> 태그의 summary 속성과 동일 [웹접근성 준수를 위해 사용]
summaryAuto
웹접근성 지원 시, Summary 항목에 헤더 컬럼명을 자동으로 설정
summaryOnlyAuto
[default: false, true] 헤더 타이틀이 HTML 태그를 포함한 경우, 태그를 제외한 텍스트만 Summary 항목으로 지정
syncRowPositionOption
dataList의 rowPosition이 변경된 경우 해당 row를 선택할지 여부. [default: "none", "style"]
syncScroll
다수의 GridView에 대해 동시에 세로 스크롤 이동
syncScrollId
스크롤을 동기화할 GridView의 아이디 리스트
tengeMask
[default: ""] dataType이 "tenge"인 경우나 changeCurrency() 함수를 사용하는 경우 화폐 표현식
titleAuto
[default: false, true] 타이틀 자동 생성
titleFormatter
[default: false, true] 타이틀 내용을 변경할 사용자 함수 (웹 접근성 지원용)
tooltipDisplay
[default: false, true] 셀의 데이터가 모두 표시되지 않는 경우 툴팁 표시 여부
tooltipDisplayColumn
[default: false, true] 데이터가 모두 표시되지 않는 경우 특정 컬럼만 툴팁을 표시할 컬럼을 지정
tooltipFormatter
바디의 툴팁 내용을 변경할 사용자 함수
tooltipFormatterHeader
헤더의 툴팁 내용을 변경할 사용자 함수
tooltipHeader
[default: false, true] 헤더타이틀이 모두 표시되지 않는 경우 툴팁 표시 여부
tooltipHeaderShowAlways
[default: false, true] 헤더타이틀이 공백("")인 경우를 제외하고는 툴팁을 항상 표시할지의 여부
tooltipHideInputType
[default: ""] 툴팁을 표시하지 않을 컬럼의 inputType을 지정
tooltipPositionX
[default: 20] 셀의 좌측 끝점을 기점으로 툴팁이 표시될 Y(세로) 좌표 (단위: px)
tooltipPositionY
[default: 3+cellHeight] 셀의 좌측 상단을 기점으로 툴팁이 표시될 X(가로) 좌표 (단위: px)
tooltipShowAlways
[default: false, true] 데이터가 공백("")인 경우를 제외하고는 툴팁을 항상 표시할지의 여부
tooltipShowAlwaysColumns
[default: ""] tooltipDisplay가 true인 경우 데이터가 공백("")인 경우를 제외하고는 툴팁을 항상 표시할 컬럼을 지정
useCtrlKey
[default: true, false] Ctrl 키를 이용하여 복수 셀의 선택 허용 여부
useCtrlOnMultisort
[default: true, false] 다중 정렬을 위해 Ctrl 키를 통한 복수의 컬럼 선택을 허용
useDataDragDropGuideLine
[default: true, false] 데이터 드래그-앤-드롭시 가이드라인 보여줄지 여부 설정
useFilterList
[default: false, true] 필터링 대상 값을 목록으로 표시 (이 때 목록의 첫번째 항목에 "사용자 필터"를 표시)
useFilterListSync
[default: false, true] DataList의 함수를 통해 필터링한 경우, 필터 목록에 표시 여부
useFilterSearch
[default: false, true] 사용자 입력으로 필터 기능 사용 여부
useHeaderContextMenu
[default: false, true] 헤더 컨텍스트 메뉴 사용 여부
useLocale
[default: false, true] 라벨값을 다국어 키를 이용하여 표현하여 다국어의 사용이 가능하도록 설정 (세부 내용은 다국어 설정 가이드 - 클라이언트 편을 참고)
useNoResultMessageURL
gridview별로 noResultMessage를 변경할 수 있는 noResultMessageURL을 사용 할지 여부 [default: false, true]
userData1
사용자 정의 데이터 속성으로 API를 통해 설정한 값을 얻어올 수 있음
userData2
사용자 정의 데이터 속성으로 API를 통해 설정한 값을 얻어올 수 있음
userData3
사용자 정의 데이터 속성으로 API를 통해 설정한 값을 얻어올 수 있음
useShiftKey
[default: false, true] Shift 키를 이용하여 복수 셀의 선택 허용 여부
useShiftKeyCheck
shift 키를 누른 상태에서 첫번째 체크박스와 마지막 체크박스를 체크했을 때, 사이에 있는 체크박스들이 모두 체크상태로 변경 되는 기능 [default: false, true]
useStartEndDiv
[default: true, false] senseReader가 true인 경우 웹접근성용 Tag(start div, end div)를 사용할지 여부
viewChangeAfterEdit
[default: false, true] 이벤트의 순서를 항상 onviewchange() 이후에 onafteredit()가 발생하도록 지정하는 속성
visibleRowNum
화면에 표현할 행의 수 (부분합을 제외)
visibleRowNumFix
[default: false, true] 초기 로딩시점에 높이를 visibleRowNum 또는 initFixedHeightByRowNum의 설정 값에 해당하는 크기만큼 자동으로 늘려주는 설정
wheelRows
[default: 3] 마우스 휠을 이용하여 세로 스크롤이 이동 될 때 한번 이동하는 행의 수
wheelStop
[default: false, true] 브라우저에 스크롤이 있을 경우, GridView의 스크롤이 맨 아래로 내려가거나 스크롤이 없을 경우 GridView 위에서 마우스 휠을 해도 브라우저 스크롤을 움직이지 않음

Event Summary

onaftercolumnmove
컬럼의 이동이 발생한 직후 발생
onaftercolumnresize
[default: false, true] 컬럼 리사이즈 직후 발생
onafteredit
셀의 편집모드가 종료되어 포커스가 빠져나온 경우에 발생 (oneditend 이벤트 이후 발생)
onbeforecolumnmove
컬럼의 이동이 발생하기 직전에 발생
onbeforeedit
셀의 편집모드로 들어가기 전에 발생
onbeforesort
컬럼 정렬 직전에 발생하며, 정렬 여부 반환
onblankclick
GridView 영역 내의 빈 화면을 클릭할 때 발생
onbodymouseout
GridView 내의 바디에서 마우스가 벗어난 경우 발생
onbodymouseover
그리드의 바디에 마우스가 오버된 경우 발생
oncellclick
셀이 클릭된 경우 발생
oncelldblclick
셀이 더블 클릭된 경우 발생
oncellindexchange
방향키 또는 마우스를 이용해 선택한 셀이 변경되거나, API를 이용하여 셀에 포커스를 적용해 선택된 셀이 변경되었을 때 발생
oncolumnindexchange
방향키 또는 마우스를 이용해 선택한 셀의 컬럼이 변경되거나, API를 이용하여 셀에 포커스를 적용해 선택된 셀의 컬럼이 변경되었을 때 발생
oncolumnwidthchange
컬럼 너비가 변하는 경우 발생
oncontextclick
context menu를 click할 때 발생
oncontextopen
컨텍스트 메뉴가 표시될 때 발생
oncustomcopy
복사 이벤트를 대체할 이벤트 정의
oncustompaste
붙여넣기 이벤트를 대체할 이벤트 정의
ondatadragover
dataDragDrop 옵션이 true일 때, 데이터를 드래그해서 다른 그리드에 올려놓는 순간 발생
ondatadragstart
dataDragDrop 옵션이 true일때, 데이터를 드래그하면 발생
ondatadrop
dataDragDrop 옵션이 true일때, 데이터를 다른 그리드에 드랍하면 발생
ondateselect
inputType이 캘린더인 경우, 날짜 선택 시 발생
oneditdblclick
편집 중인 셀에 더블클릭 시 발생
oneditend
셀의 편집이 끝난 경우 발생하며, onafteredit보다 먼저 발생
oneditkeydown
셀 편집할 때 키를 누른 경우 발생
oneditkeyup
키보드에서 키를 눌렀다 놓았을 때 발생
onfilereadend
그리드에 엑셀 업로드가 끝난 뒤 발생
onfooterclick
푸터를 클릭한 경우 발생
ongroupby
groupby 영역으로 컬럼을 드래그했을 때 발생
onheaderclick
헤더가 클릭된 경우 발생
onheaderdblclick
헤더가 더블클릭된 경우 발생
onheadermouseout
그리드의 헤더에 마우스가 아웃된 경우 발생
onheadermouseover
그리드의 header에 마우스가 오버된 경우 발생
onheadertextimageclick
header의 inputType이 textImage인 경우 image가 클릭 된 경우 발생
onkeydown
키보드에서 키를 눌렀을 때 발생
onkeyup
키보드에서 키를 눌렀다 놓았을 때 발생
onmonthselect
inputType이 캘린더인 경우 사용자가 캘린더에서 월(Month)을 변경 시에 발생
onrightbuttonclick
바디 영역의 셀에서 마우스 오른쪽 버튼으로 클릭한 경우 발생
onrowindexchange
방향키 또는 마우스를 이용하여 선택한 셀의 행이 변경되거나, API를 이용하여 셀에 포커스를 적용한 셀의 행이 변경되었을 때 발생
onrownumclick
rowNum 컬럼이 클릭된 경우 발생
onrowstatusclick
rowStatus 컬럼이 클릭된 경우 발생
onscrollend
세로 스크롤이 하단에 닿을 때 발생
onscrollstart
세로 스크롤이 상단에 닿을 때 발생
onscrollx
가로 스크롤을 움직이는 경우 발생
onscrolly
세로 스크롤을 움직이는 경우 발생
onsort
sortable 속성이 적용된 헤더에서 클릭이나 더블클릭을 통하여 정렬방식이 변경되었을 경우 발생
onsubtotalclick
부분합이 클릭된 경우 발생하는 이벤트
onsubtotaldblclick
부분합이 더블클릭된 경우 발생하는 이벤트
ontextimageclick
inputType이 textImage인 경우 이미지가 클릭됐을 때 발생
ontoggleclick
inputType이 드릴다운일 때, 토글버튼 클릭 시 발생
onviewchange
키보드 또는 마우스 조작을 통해 값이 변경된 경우 발생
onyearselect
inputType이 캘린더인 경우 날짜 선택 시 발생

Method Summary

advancedExcelDownload( options , infoArr )
그리드의 데이터를 엑셀 파일로 저장 (JDK 1
advancedExcelUpload( options )
엑셀 파일을 읽어 GridView에 데이터를 표시 (JDK 1.5 이상에서 사용 가능)
changeCurrency( columnID , dataType , displayFormat , delimiter , decimalDelimiter )
컬럼 단위로 화면에 나타나는 셀 값들의 화폐 단위를 동적으로 변경
checkAll( colIndex , dataValue )
체크 박스로 이루어진 컬럼을 한번에 체크하거나 언체크하는 기능
clearAutoFit( )
autoFit 속성을 제거 (컬럼의 너비에 autoFit을 적용하기 이전으로 초기화)
clearGroupby( )
groupBy를 해제
clearRowVisible( )
setRowVisible() API를 이용하여 숨김 처리한 행을 모두 표시하도록 처리
drillTo( rowIndex )
드릴다운 사용 시 rowIndex에 해당하는 행을 표현하기 위해 모든 조상 행을 오픈
enableAllDate( colIndex )
disableAfterDate 및 disableBeforeDate API를 통해서 비활성화된 날짜들을 다시 활성화시켜 선택 가능하도록 변경
getAllDisplayData( )
필터링 여부나 정렬 상태와 무관하게 모든 데이터를 배열로 반환
getAllDisplayJSON( )
필터링 여부나 정렬 상태와 무관하게 모든 데이터를 JSON으로 반환
getAllDisplayXML( )
필터링 여부나 정렬 상태와 무관하게 모든 데이터를 XML로 반환
getAllFocusedIndex( )
포커스된 셀의 행 인덱스와 컬럼 인덱스를 선택된 순서대로 반환
getAllFocusedRowIndex( )
포커스된 셀의 행 인덱스를 반환
getAllVisibleData( )
현재 보이는 데이터를 1차원 배열로 반환
getAllVisibleJSON( )
화면에 출력된 데이터를 JSON으로 반환
getAllVisibleXML( )
현재 보이는 데이터를 XML로 반환
getAncestorRowIndexArray( rowIndex )
드릴다운 사용 시, 행 인덱스에 해당하는 행의 모든 조상 행의 행 인덱스를 반환
getBottomRowIndex( )
현재 화면에 보여지는 최하단 행의 인덱스를 반환 (데이터가 없으면 "-1"이 반환)
getCellBackgroundColor( rowIndex , colIndex )
행 인덱스와 컬럼 인덱스에 해당하는 셀의 배경색을 반환
getCellChecked( rowIndex , colIndex )
행 인덱스와 컬럼 인덱스에 해당하는 셀의 체크 여부를 반환
getCellClass( rowIndex , colIndex )
셀에 동적으로 적용한 사용자 클래스 이름을 반환
getCellColor( rowIndex , colIndex )
행 인덱스와 컬럼 인덱스에 해당하는 셀의 글자색을 반환
getCellDisabled( rowIndex , colIndex )
행 인덱스와 컬럼 인덱스에 해당하는 셀의 disabled 속성 값을 반환
getCellDisplayData( rowIndex , colIndex )
행 인덱스와 컬럼 인덱스에 해당하는 셀의 화면에 보이는 데이터를 반환
getCellPosition( row , colIndex , propertyName )
셀의 위치 정보(top 또는 left)를 반환
getCellReadOnly( rowIndex , colIndex )
행 인덱스와 컬럼 인덱스에 해당하는 셀의 readonly 속성 값을 반환
getCellSize( row , colIndex , sizeName )
셀의 크기 정보(너비나 높이)를 반환
getCheckedData( colIndex )
컬럼 인덱스에 해당하는 컬럼이 radio/checkbox일 경우 체크된 행의 데이터를 배열로 반환
getCheckedIndex( colIndex )
컬럼 인덱스에 해당하는 컬럼의 inputType이 "radio" 또는 "checkbox"인 경우 체크된 행의 인덱스를 배열로 반환
getCheckedJSON( colIndex )
컬럼 인덱스에 해당하는 컬럼이 radio/checkbox일 경우 체크된 행의 JSON 데이터를 배열에 담아 반환
getCheckedXML( colIndex )
컬럼 인덱스에 해당하는 컬럼이 radio/checkbox일 경우 체크된 행의 데이터를 XML로 반환
getChildrenRowIndexArray( rowIndex )
드릴다운 사용 시 행 인덱스에 해당하는 행의 자식(깊이 1의 하위)행들의 행 인덱스를 배열로 반환
getColIdByHeaderId( headerId )
헤더의 컬럼 아이디에 해당하는 바디의 컬럼 아이디를 반환
getColumnBackgroundColor( colIndex )
컬럼 인덱스에 해당하는 컬럼의 배경색을 반환
getColumnClass( colIndex )
컬럼에 동적으로 적용된 사용자 클래스를 반환
getColumnColor( colIndex )
컬럼 인덱스에 해당하는 컬럼의 글자색을 반환
getColumnDataListInfo( colIndex )
컬럼 인덱스에 해당하는 컬럼에 바인딩된 DataList 정보를 반환
getColumnDisabled( colIndex )
컬럼 인덱스에 해당하는 컬럼에 disabled 속성 값을 반환
getColumnID( colIndex )
컬럼의 인덱스를 입력받아 해당하는 컬럼의 아이디를 반환
getColumnIdListMultiRow( )
GridView 바디 영역의 모든 컬럼의 아이디를 배열 형태로 반환
getColumnIndex( colIndex )
컬럼 아이디를 입력 받아 해당하는 컬럼의 인덱스를 반환
getColumnNodeSet( colIndex )
inputType이 select 또는 autocomplete인 경우, 바인딩된 NodeSet 정보를 반환
getColumnOrder( byName )
현재 컬럼 순서를 배열로 반환 (단, byName이 true인 경우 아이디를 담은 배열을 반환)
getColumnReadOnly( colIndex )
컬럼 인덱스에 해당하는 컬럼에 적용된 readonly 속성 값을 반환
getColumnType( colIndex )
컬럼 인덱스에 해당하는 컬럼의 inputType 속성 값을 반환
getColumnVisible( colIndex )
컬럼 인덱스에 해당하는 컬럼의 visible 여부를 반환
getCurrentGridStyle( )
현재 그리드의 상태(컬럼 순서, 컬럼 너비, 숨겨진 컬럼, 고정 컬럼)를 JSON 문자열 형태로 반환
getDataDragDrop( )
그리드의 컬럼에 dataDragDrop 값을 반환
getDataLength( )
[deprecated] getRowCount()를 사용하며, 행의 수를 반환
getDataList( )
현재 바인딩된 DataList의 아이디를 반환
getDataListInfo( )
현재 바인딩된 DataList를 반환
getDataType( colID )
특정 컬럼의 데이터타입을 반환
getDescendantRowIndexArray( rowIndex )
드릴다운 사용 시 특정 행의 모든 자손 행의 행 인덱스를 반환
getDisabled( type , rowIndex , colIndex )
유형에 따라 세부적인 disabled 속성을 반환
getFixedColumnLastIndex( includeDefaultColumn )
fixedColumn이 설정되어 있을 경우, fixedColumn 중 맨 오른쪽 끝에 해당하는 컬럼의 인덱스를 반환
getFixedRightColumnLastIndex( )
FixedRightColumn이 설정되어 있을 경우 FixedRightColumn 중 맨 오른쪽 끝에 해당하는 컬럼의 인덱스를 반환
getFixedRow( )
행의 틀이 고정된 경우, 해당 행의 위치를 반환
getFocusedColumnID( )
포커스된 셀이 속한 컬럼의 아이디를 반환
getFocusedColumnIndex( )
포커스된 셀의 컬럼 인덱스 반환
getFocusedRowIndex( )
포커스된 셀의 행 인덱스를 반환
getFocusedRowStatus( )
포커스된 셀이 속한 행의 상태를 상태 문자로 반환
getFooterData( footerId , display )
특정 푸터 아이디에 해당하는 푸터의 데이터를 반환 (inputType이 "expression"인 경우 계산된 값을 반환)
getFooterStyle( footerId , style )
특정 푸터 아이디 또는 인덱스에 해당하는 푸터의 스타일 속성값 반환
getFormattedHeaderValue( headerId , value )
헤더에 설정된 dispalyFormat으로 인해 형식이 지정된 값 반환
getGridReadOnly( )
GridView 전체에 대한 읽기전용(Readonly) 속성 설정 여부 반환
getGroupbyData( [default: )
현재 그룹핑된 정보를 반환
getHeaderBackgroundColor( headerId )
헤더의 셀에 적용된 배경색을 반환
getHeaderClass( headerId )
헤더의 셀에 동적으로 적용한 사용자 클래스 이름 반환
getHeaderColor( headerId )
헤더의 셀에 적용된 폰트 색상을 반환
getHeaderID( header )
헤더의 인덱스로 헤더의 아이디를 반환
getHeaderIndex( header )
헤더의 아이디로 헤더의 인덱스 반환
getHeaderPosition( headerId , propertyName )
헤더 셀의 위치 정보(top이나 left)를 반환
getHeaderSize( headerId , sizeName )
헤더 셀의 크기 정보(width나 height)를 반환
getHeaderValue( headerId )
헤더의 아이디로 헤더의 값을 반환
getMaxLength( colIndex )
컬럼의 최대 길이값 반환
getMerged( rowIndex , colIndex )
특정 셀의 병합여부를 반환
getOpenStatus( rowIndex )
드릴다운을 적용한 경우 행 인덱스에 해당하는 행의 드릴다운이 열려있는지 여부 반환
getOverflowX( )
overflowX 속성의 설정값을 반환
getOverflowY( )
overflowY 속성의 설정값을 반환
getParentRowIndex( rowIndex )
드릴다운 사용 시 특정 행의 부모 행 인덱스를 반환
getReadOnly( type , rowIndex , colIndex )
타입에 따라 읽기전용(Readonly) 속성을 반환
getRealRowIndex( rowIndex )
드릴다운을 적용한 경우 화면에 표현된 행 인덱스를 기준으로 실제 데이터의 행 인덱스를 반환
getRowBackgroundColor( rowIndex )
행의 배경색을 반환
getRowClass( rowIndex )
grid Row에 동적으로 적용한 사용자 class 이름을 반환
getRowColor( rowIndex )
행의 글자색을 반환
getRowDisabled( rowIndex )
특정 행에 적용된 disabled 속성 값을 반환
getRowNumVisible( )
rowNumVisible 옵션 값을 반환
getRowReadOnly( rowIndex )
특정 행에 적용된 읽기전용(Readonly) 속성 값을 반환
getRowVisible( rowIndex )
행의 visible 속성 여부를 반환
getSortableArr( )
헤더의 각 컬럼의 정렬 여부를 배열로 반환
getSortableStatus( )
정렬된 컬럼의 순서대로 해당 컬럼의 헤더 정보를 담은 객체를 배열로 반환
getTopRowIndex( )
현재 화면에 보여지는 최상단 행의 행 인덱스를 반환
getTotalCol( )
전체 컬럼 개수를 반환 (행번호 및 행상태 컬럼 제외)
getTotalHeaderCol( options )
헤더 컬럼의 개수를 반환
getTotalRow( )
행의 총 개수를 반환
getUncheckedData( colIndex )
특정 컬럼의 inputType속성이 radio/checkbox인 경우, 체크되지 않은 행의 데이터를 배열로 반환
getUncheckedIndex( colIndex )
특정 컬럼의 inputType속성이 radio/checkbox인 경우, 체크되지 않은 행의 인덱스를 배열로 반환
getUncheckedJSON( colIndex )
특정 컬럼의 inputType 속성이 radio/checkbox인 경우, 체크되지 않은 행의 데이터를 JSON으로 변환하여 배열에 담아 반환
getUncheckedXML( colIndex )
특정 컬럼의 inputType 속성이 radio/checkbox인 경우, 체크되지 않은 행의 데이터를 XML로 변환하여 배열에 담아 반환
getVisibleColData( colIndex )
특정 컬럼의 화면에 보이는 데이터(필터나 정렬이 반영된)를 배열로 반환
getVisibleRowNum( )
현재 화면(눈에 보여지는 영역)에 그려진 행의 수를 반환 (부분합 및 푸터는 제외)
groupby( Options )
둘 이상의 컬럼의 데이터를 그룹핑하여 결과(통계)만 표시
hasChild( rowIndex )
드릴다운이 적용 된 경우 자식 행을 가지고 있는지의 여부를 반환
hideGroupbyZone( )
그룹핑 정보를 관리하는 GroupbyZone 영역을 숨김
initGrid( )
전체 데이터 삭제, 필터 삭제, 컬럼 기본정보(SelectBox의 노드셋 등)를 초기화하고, 가지고 있던 데이터를 1차원 배열로 반환
isEditing( )
현재 편집 상태를 반환
mergeByCol( options )
같은 컬럼 내에서 같은 데이터가 연속적으로 나타나는 경우 이들을 모두 병합 (세로 병합)
mergeByColRec( options )
컬럼을 기준으로 병합을 수행하고, 그 후에 병합되지 않은 셀을 대상으로 행을 기준으로 병합을 수행
mergeByRestricColmergeByRestricCol( options )
같은 컬럼 내에서 연속적으로 데이터가 같으면서 동시에 자신의 왼쪽에 위치한 컬럼이 병합된 경우 해당 행들을 병합
mergeByRestricRow( options )
같은 row 내에서 연속적으로 데이터가 같으면서 동시에 자신의 위쪽에 위치한 row가 merge된 경우 해당 row들을 병합.
mergeByRow( options )
같은 행 내에서 같은 데이터가 연속적으로 나타나는경우 이들을 모두 병합 (가로 병합)
mergeByRowRec( options )
행을 기준으로 병합을 수행하고, 그 후에 병합되지 않은 셀을 대상으로 컬럼을 기준으로 병합을 수행
mergeCell( mergeInfo )
동적으로 셀을 병합
mergeCells( mergeOptionStr , options )
행 또는 컬럼 기준으로 연속적으로 같은 데이터들을 아래의 5가지 방식 중 하나로 병합한다.
mergeCellsFixedCols( mergeOptionStr , options )
fixedColumn 영역 내에서 행 또는 컬럼 기준으로 연속적으로 같은 데이터들을 아래의 5가지 방식 중 하나로 병합한다.
mergeCellsFixedRows( mergeOptionStr , options )
fixedRow 영역 내에서 행 또는 컬럼 기준으로 연속적으로 같은 데이터들을 아래의 5가지 방식 중 하나로 병합한다.
mergeClear( )
동적으로 병합된 셀들의 병합을 모두 해제
mergeCol( colIndex , flag )
데이터를 통해 자동으로 병합하는 기능을 사용할 때, 특정 컬럼을 제외하기 위해 사용
mergeFocusedCell( )
현재 포커스된 셀만 병합
mergeRow( rowIndex , flag )
데이터를 통해 자동으로 병합하는 기능을 사용할 때 특정 행을 제외하기 위해 사용
mergeSplitFocusedCell( )
포커스가 위치한 셀의 병합을 해제
modifyCheckedStatus( colIndex , status )
inputType이 "checkbox"인 경우 체크가 되어있는 행의 상태코드 값을 일괄 변경
modifyUncheckStatus( col , status )
inputType이 "checkbox"인 경우 체크가 되지 않은 행의 상태코드 값을 일괄 변경
moveFooterColumn( fromIdx , toIdx )
푸터 컬럼의 위치 이동
readCSV( options )
CSV 파일을 읽어 GridView의 데이터로 설정 (JDK 1
redrawColumn( colIndex , valid )
컬럼을 다시 그려줌 (Reset)
refreshCell( rowIndex , colIndex )
특정 셀을 다시 렌더링 함
refreshColumn( colIndex )
컬럼을 다시 렌더링 함
refreshColumnItemset( col )
inputType이 "select"인 경우 컬럼의 itemset을 갱신
refreshRow( rowIndex )
행을 다시 렌더링 함
removeCellClass( rowIndex , colIndex )
셀에 적용된 Class를 삭제
removeColumnClass( colIndex , class )
컬럼에 적용된 사용자 Class를 삭제 (복수로 지정시 띄어쓰기(" ")를 구분자로 사용)
removeFocusedCell( )
선택되어진 셀 모두의 포커스를 해제
removeFocusedMultiCell( startRow , startCol , endRow , endCol )
설정 영역만큼의 셀에 포커스를 해제
removeHeaderClass( headerId , class )
헤더 컬럼에 적용된 사용자 Class를 삭제
removeRowClass( rowIndex )
grid Row에 적용된 사용자 class를 삭제
saveCSV( options )
데이터를 CSV 파일로 저장 (JDK 1
setAutoFit( options )
컬럼 너비 조절을 자동으로 해주는 autoFit 속성을 설정
setBlockSelect( colIndex , flag )
컬럼의 blockSelect 속성을 설정
setBottomRowIndex( bottomRowIndex )
bottomRowIndex에 해당하는 행이 가장 하단에 위치하도록 세로 스크롤의 위치를 옮겨줌
setCaption( htmlStr )
GridView의 <table> 태그의 caption의 속성 값 설정 [웹접근성 준수를 위해 사용]
setCaptionAuto( captionTitle )
GridView의 요약 태그인 캡션 값(CaptionTitle)을 설정
setCellAllowChar( rowIndex , colIndex , allowChar )
inputType이 "custom"인 경우 특정 셀의 allowChar 속성을 설정
setCellBackgroundColor( rowIndex , colIndex , color )
특정 셀의 사용자 배경색을 설정
setCellChecked( rowIndex , colIndex , flag )
inputType이 "checkbox" 혹은 "radio"인 경우 해당 셀을 선택하거나 선택 해제
setCellClass( rowIndex , colIndex , className )
특정 셀의 사용자 Class 설정
setCellColor( rowIndex , colIndex , color )
특정 셀의 글자색을 설정
setCellCustomFormatter( rowIndex , colIndex , formatter )
inputType이 "custom"인 경우 특정 셀의 데이터의 표현식을 조건에 맞추어 변경하기 위한 사용자 함수를 설정하는 customFormatter 속성 값을 변경
setCellDataType( rowIndex , colIndex , dataType )
inputType이 "custom"인 경우 특정 셀의 dataType 속성을 설정
setCellDisabled( rowIndex , colIndex , disabled )
특정 셀의 disabled 속성을 설정
setCellDisableEdit( rowIndex , colIndex , onoff )
inputType이 "custom"인 셀이 "autoComplete"으로 설정된 경우 특정 셀의 disableEdit 속성을 변경
setCellDisplayFormat( rowIndex , colIndex , displayFormat )
inputType이 "custom"인 경우 특정 셀에 데이터의 표현식을 설정하는 displayFormat 속성 값을 변경
setCellDisplayFormatter( rowIndex , colIndex , formatter )
inputType이 "custom"인 경우 특정 셀에 데이터의 표현식을 조건에 맞추어 변경하기 위한 사용자 함수를 설정하는 displayFormatter 속성 값을 변경
setCellInputType( rowIndex , colIndex , info )
inputType이 "custom"인 경우 특정 셀의 inputType을 변경
setCellMaxLength( rowIndex , colIndex , maxLength )
inputType이 "custom"인 경우 특정 셀의 maxLength 속성을 설정
setCellReadOnly( rowIndex , colIndex , readOnly )
특정 셀에 읽기전용(ReadOnly) 속성을 설정
setCellStyle( rowIndex , colIndex , styleName , styleValue )
특정 셀에 스타일을 설정
setColumnBackgroundColor( colIndex , color )
컬럼의 배경색 설정
setColumnChooseOption( colIndex , chooseOptionValue , chooseOptionLabel )
inputType이 "select"인 경우 SelectBox의 선택옵션(ChooseOption) 의 값과 라벨을 변경
setColumnClass( colIndex , className )
컬럼의 사용자 Class 설정
setColumnColor( colIndex , color )
컬럼의 글자색을 설정
setColumnDisabled( colIndex , disabled )
컬럼의 disabled 속성을 설정
setColumnDisableEdit( colIndex , onoff )
inputType이 "autoComplete"인 경우 컬럼의 disableEdit 속성을 변경
setColumnDisplayFormat( colIndex , displayFormat )
컬럼의 표시될 값의 형식을 설정 (기존의 setDisplayFormat을 대체)
setColumnDisplayFormatter( colIndex , displayFormatter )
데이터의 표현식을 조건에 맞추어 변경하기 위한 사용자 함수를 설정하는 displayFormatter 속성 값을 변경 (기존의 setDisplayFormatter를 대체)
setColumnEnableColumn( gridColumnId , enableColumnId , enableColumnFalseValue )
inputType이 "select", "autoComplete", "checkcombobox"인 경우 일부 선택 목록을 비활성화 처리
setColumnGridItemset( colIndex , obj )
inputType이 "select"인 경우 설정을 ItemSet이 아닌 GridViewItemset을 사용하는 경우 설정 값을 변경
setColumnIoFormat( colIndex , ioFormat , dateMask )
컬럼의 ioFormat 속성을 설정
setColumnNodeSet( colIndex , nodeset , label , value )
itemset을 설정할 수 있는 컬럼의 nodeset을 설정.
setColumnOrder( columnOrderArray )
컬럼의 정렬 순서를 columnOrderArray에 정의된 컬럼 리스트를 기준으로 재설정하며 정의되지 않은 컬럼은 그 뒤쪽으로 위치함
setColumnReadOnly( colIndex , readOnly )
컬럼의 읽기전용 설정
setColumnStyle( colIndex , styleName , styleValue )
컬럼의 스타일 설정
setColumnVisible( colIndex , colVisibleFlag )
컬럼의 표시여부 설정
setColumnVisibleColumn( gridColumnId , visibleColumnId , visibleColumnFalseValue )
inputType이 "select", "autoComplete", "checkcombobox"인 경우 일부 선택 목록을 숨김
setColumnWidth( colIndex , size )
컬럼의 너비를 변경
setCustomFormatter( colIndex , customFormatter )
데이터의 표현식을 조건에 맞추어 변경하기 위한 사용자 함수를 설정하는 customFormatter 속성 값을 변경
setDataDragDrop( onoff )
dataDragDrop 속성 값을 설정
setDataType( colIndex , dataType , options )
dataType이 "text", "number", "float"인 경우 컬럼의 dataType 속성을 변경
setDisabled( type , rowIndex , colIndex , disableFlag )
객체 타입에 따라 비활성화 설정
setDrillDownDragDrop( value )
inputType이 "drillDown" 컬럼에 드래그/드롭을 설정 (기본적으로는 GridView에 inputType이 drillDown 컬럼이 포함되면 드래그/드롭이 발생하지 않음)
setEditModeEvent( editModeEvent , bRefreshColumn )
editModeEvent를 동적으로 설정한다
setFixedColumn( fixedColNum )
세로 틀고정 설정 (좌측을 기준으로 고정시킬 컬럼의 수를 설정)
setFixedRightColumn( count )
세로 틀고정 설정 (우측을 기준으로 고정시킬 컬럼의 수를 설정)
setFixedRow( fixedRowNum )
가로 틀고정 설정 (상단을 기준으로 고정시킬 행의 수를 설정)
setFocusedCell( rowIndex , colIndex , editMode )
해당 셀에 포커스를 주고 이동
setFocusedHeaderObj( headerId )
inputType이 "selectbox", "checkbox"인 경우 포커스 설정
setFocusedMultiCell( startRow , startCol , endRow , endCol )
설정 영역만큼의 셀에 포커스를 줌
setFocusMode( focusMode )
focusMode를 동적으로 설정한다
setFooterCaption( htmlStr )
푸터의 <table> 태그의 caption의 속성 값 설정 [웹접근성 준수를 위해 사용]
setFooterData( footerId , data )
inputType이 "text"인 경우 data의 값을 footerId에 해당하는 푸터 컬럼에 설정
setFooterDisplayFormat( footerId , displayFormat )
푸터 컬럼의 표시될 값의 형식을 설정
setFooterStyle( footerId , style , value )
푸터 컬럼의 스타일 속성을 설정
setFooterSummary( str )
푸터의 <table> 태그의 summary의 속성 값 설정 [웹접근성 준수를 위해 사용]
setFooterValue( footerId , data )
inputType이 "text"인 경우 data의 값을 footerId에 해당하는 푸터 컬럼에 설정
setGridHeight( height )
GridView의 높이를 설정
setGridReadOnly( readOnly )
GridView의 읽기전용 설정
setGridSize( width , height )
GridView의 높이와 너비를 설정
setGridStyle( doc )
GridView를 다시 그려줌
setGridWidth( width )
GridView의 너비를 설정
setHeaderBackgroundColor( headerId , color )
헤더의 배경색 설정
setHeaderClass( headerId , className )
헤더의 사용자 Class 설정
setHeaderColor( headerId , color )
헤더의 글자색 설정
setHeaderDisabled( headerId , disabled )
헤더의 비활성화 설정
setHeaderHide( hide )
헤더의 숨김여부 설정
setHeaderNodeSet( headerId , nodeset , label , value )
inputType이 "select"인 경우 적용되며 바인드정보(BindItemSet)를 설정
setHeaderSortImage( headerId , orderNum , sortOrd )
headerId에 해당하는 컬럼의 정렬이미지를 설정 (데이터의 정렬은 DataList의 정렬을 사용해야 함)
setHeaderStyle( headerId , style , value )
헤더 컬럼의 스타일을 설정
setHeaderValue( headerId , value , useFormat )
inputType이 "text"인 경우 headerId에 해당하는 헤더에 value값을 설정
setImageSrc( colIndex , src )
inputType이 "textimage"인 경우 이미지 설정
setMaxLength( colIndex , len )
inputType이 "text", "textarea", "textImage", "secret", "autoComplete"인 경우 컬럼의 maxLength 값을 설정
setNoResultMessage( message )
데이터가 없을 경우 표시할 문자열을 설정
setNoResultMessageVisible( visible )
noResultMessageVisible 값을 설정
setReadOnly( type , rowIndex , colIndex , readOnlyFlag )
type에 따라 읽기전용(ReadOnly) 속성을 설정
setRowBackgroundColor( rowIndex , color )
행의 배경색을 설정
setRowClass( rowIndex , className )
grid Row에 동적으로 사용자 class를 적용
setRowColor( rowIndex , color )
행의 글자색을 설정
setRowDisabled( rowIndex , disableFlag )
행의 disabled 속성을 설정
setRowNumColumnWidth( size )
행번호 컬럼의 너비를 변경 (단위: px)
setRowNumVisible( visibleColumnFalseValue )
rowNumVisible이 "true"인 경우 행번호 컬럼 표시/숨김 여부를 설정
setRowReadOnly( rowIndex , readOnly )
행의 읽기전용(Readonly) 속성을 설정
setRowStatusColumnWidth( size )
행상태 컬럼의 너비를 변경 (단위: px)
setRowStatusVisible( visibleColumnFalseValue )
rowStatusVisible이 "true"인 경우 행상태 컬럼 표시/숨김 여부를 설정
setRowVisible( rowIndex , flag )
특정 행의 표시/숨김 여부를 설정
setScrollLeft( left )
가로 스크롤의 위치를 입력받은 값만큼 이동 (단위: px)
setScrollTop( top )
그리드의 세로 스크롤의 위치를 입력받은 값만큼 이동
setSortable( headerId , sortable )
컬럼의 sortable 속성을을 동적으로 설정
setStartRowNumber( rowIndex )
rowNum 컬럼에 표현되는 행번호의 시작되는 숫자 값를 설정
setStyleAll( styleObj )
스타일을 지정
setSubtotalVisible( flag )
부분합을 숨기거나 다시 표시
setSummary( str )
HTML <table> 태그의 summary의 속성 값 설정
setTopRowIndex( topRowIndex , noEvent , autoFocus )
topRowIndex에 해당하는 행이 가장 위에 보여지도록 세로 스크롤의 위치를 옮겨줌
setUseFilter( colId , falg )
필터의 사용 여부(useFilter)를 동적으로 설정
setUseFilterList( flag )
필터링 대상의 목록사용 여부(useFilterList)를 동적으로 설정
setVisibleRowNum( rowCount )
화면에 표현할 행의 수(visibleRowNum)을 동적으로 설정
showChooseOption( colIndex , chooseOption )
inputType이 "select"인 경우 SelectBox의 선택옵션(ChooseOption) 설정
showCustomFilter2( headerID )
사용자 필터를 지정할 수 있는 "사용자 지정 필터" 팝업 창을 표시
showGroupbyZone( )
그룹핑 정보를 관리하는 GroupbyZone 영역을 표시
spanAll( openFlag )
inputType이 "drilldown"인 경우 전체 데이터를 모두 펼치거나 접는 기능
toggle( rowIndex )
inputType이 "drilldown"인 경우 rowIndex에 해당하는 행의 하위를 토글링(열기/닫기)함

Property Detail

accessibility
웹 접근성 지원 기능을 사용할지에 대한 여부
GridView 전체에 웹 접근성 지원 기능을 일괄적으로 적용 (컬럼 단위로 설정 불가능하며, 모든 inputType에 대해 웹 접근성 기능 일괄 적용) (참고 사항) 정렬 기능 사용 시 (sortable="true") 헤더 영역의 데이터가 <button> 요소로 표현 정렬 기능을 사용하는 헤더는 탭키를 통해 포커스를 이동할 수 있으며 Space 또는 Enter 키를 누르면 정렬 상태가 오름차순 -> 내림차순 -> 원래대로 -> 오름차순 (순환) 순서로 변경됨 세로 스크롤은 브라우저 스크롤을 사용 (drawType="native") inputType이 "radio"인 경우 선택된 radio가 위치한 행만 포커스가 탭키로 이동할 수 있으며, 선택되지 않은 radio의 행은 탭키로 포커스 이동 시 포커스를 건너뛰게 되고 선택된 radio에서 위아래 방향키를 통해 선택 값을 변경함 모든 컬럼에 embeddedInput을 강제로 적용. 그리고 각 컬럼이 생성하는 내부 컴포넌트 또한 accessibility를 "true"로 강제로 적용
아래의 속성값이 강제로 적용 (GridView 속성) senseReader = "true" focusMove = "false" keyMoveEditMode = "true"; autoResizeEmbeddedInput = "true" scrollFocus = "true" titleAuto = "true" sortHeaderDiv = "true" drawType = "native" visibleRowNum = "all visibleRowNumFix = "true"
adaptive
다양한 화면 크기와 디바이스에 맞게 레이아웃이 변경되는 적응형 웹 모드
Chrome, Safari, Firefox, Opera, IE10+에서 호환되는 기능
adaptiveThreshold
[default: 480] adaptive 속성이 설정되어 있을 경우 레이아웃 변경을 하기 위한 임계 값 (관련 속성) adaptive="crosstab"
alwaysTriggerScrollStart
스크롤이 최상단에 위치할 때마다 onscrollstart 이벤트를 발생시킬지 여부 (옵션 설명) "true" : onscrollstart 이벤트가 매번 발생 "false" (기본 값) : onscrollstart 이벤트가 한 번만 발생
applyAllColumnStyle
컬럼에 지정된 모든 스타일 적용 여부 (옵션 설명) "true" : 컬럼에 지정된 모든 스타일을 적용 "false" (기본값) : 컬럼에 지정된 스타일 속성 중 첫 번째만 적용
arrowMove
셀 내부에서 첫 번째 또는 마지막 문자에 있을 때, 좌우 방향키로의 셀 이동을 허용할지 여부 (옵션 설명) "true" : 이동 가능 "false" (기본 값) : 이동 불가
(관련 속성) moveKeyEditMode="true"인 경우에만 유효
autoFit
[default: none, lastColumn, allColumn] 전체 화면 폭에 모든 컬럼의 폭을 균등하게 배분하는 기능으로, 이 기능을 사용하면 가로 스크롤이 나타나지 않음 (옵션 설명) "none" (기본 값) : autoFit 기능을 사용하지 않음 "allColumn" : 모든 열의 너비를 균등하게 조정 "lastColumn" : 마지막 열의 너비만 조정
autoFitCellMinWidth
[default: ""] autoFit="allColumn" 설정을 적용하기 위해 필요한 GridView 행의 최소 너비. (단위: px)
GridView에서 설정한 컬럼의 최소 너비(autoFitCellMinWidth)보다 좁아지면, 모든 열을 자동으로 맞추는 설정 (autoFit="allColumn")이 작동하지 않고 가로로 스크롤이 생성됨 (관련 속성) autoFit="allColumn"
autoFitMinWidth
[default: ""] autoFit에 "allColumn" 설정을 적용하기 위해 필요한 GridView의 최소 너비 (단위: px)
GridView에서 설정한 최소 너비(autoFitMinWidth)보다 좁아지면, 모든 열을 자동으로 맞추는 설정 (autoFit="allColumn")이 작동하지 않고 가로로 스크롤이 생성됨 (관련 속성) autoFit="allColumn"
autoResizeEmbeddedInput
[default: false, true] 센스리더 또는 embeddedInput가 "true"이며 inputType이 text 또는 secret일 때, Input의 크기를 자동으로 계산할지 여부
captionAuto
[default: false, true] 각 헤더의 제목을 조합해서 그리드의 요약 태그인 캡션 값을 구성할지 여부 (captionTitle 값은 캡션 값의 앞에 제목으로 포함하여 구성) (옵션 설명) "true" : captionTitle과 표의 헤더의 제목을 조합해서 표 제목으로 표시 "false" (기본 값) : 표시 안 함
(관련 속성) inputType="text" (헤더) captionTitle
(예제) 아래의 경우 "거래내역은(는) 항목 1, 항목 2, 항목 3을(를) 나타낸 표"가 제목으로 표시됨 (1) GridView 각 헤더의 제목이 "항목 1", "항목 2", "항목 3"이고 (2) captionTitle="거래내역" captionAuto="true" 설정이 적용됨
captionTitle
[default: ""] captionAuto를 사용하여 그리드의 요약 태그인 캡션 값을 구성할 때 가장 앞에 추가할 내용 (관련 속성) captionAuto="true"
CellClickFixScrollX
[default: false, true] 전체 가로 스크롤이 생겼을때 화면에서 일부가 가려진 셀을 클릭함으로써 가로 스크롤이 움직일지의 여부 (옵션 설명) "false" (기본 값) 가로 스크롤에 의해 일부가 가려진 셀을 클릭했을 때, 해당 셀이 완전히 보이도록 가로 스크롤이 자동으로 움직임 "true" 일부가 가려진 셀을 클릭했을 때, 가로 스크롤이 자동으로 움직이지 않음
cellStatusIconPosition
[default: right, left] 각 셀의 상태 아이콘 위치를 지정 (옵션 설명) "right" (기본 값) : 우측 상단에 위치 "left" : 좌측 상단에 위치
(관련 속성) cellStatusVisible="true"
cellStatusVisible
[default: false, true] 각 셀의 값에 변경이 생겼을때 좌측 또는 우측 상단에 아이콘 표시 여부 (관련 속성) cellStatusIconPosition="left"
checkAllType
[default: include, exclude] 헤더의 inputType이 checkbox인 경우, 전체 셀을 선택할 때 disabled나 readOnly된 셀을 포함할지에 대한 여부 (옵션 설명) "include" (기본 값) : disabled나 readOnly된 셀의 경우 헤더의 전체 선택을 표시할 때 포함해서 전체 셀에 대한 상태 판단을 결정함 "exclude" : disabled나 readOnly된 셀은 포함하지 않고 전체 셀에 대한 상태 판단을 결정함
checkDisabledOnCut
[default: true, false] disabled가 "true"인 컬럼의 데이터를 Ctrl+X로 잘라내기를 허용할지 여부 (옵션 설명) "true"(기본 값) : disabled="true"가 설정된 컬럼의 데이터를 '잘라내기'를 할 수 없음 "false" : disabled="true"가 설정된 컬럼의 데이터를 '잘라내기'를 할 수 있음
checkEditableInputClass
[default: false, true] inputType이 text이고 셀의 상태가 readOnly 혹은 disabled인 경우, nobr 태그에 "w2grid_input" class의 적용여부 (옵션 설명) "true" : readOnly 또는 disabled 시 nobr 태그에 "w2grid_input" class가 적용되지 않음 "false" (기본 값) : nobr 태그에 항상 "w2grid_input" class가 적용됨
checkEditOnPaste
[default: false, true] 편집모드 상태에서 n*n 데이터를 Ctrl+V로 붙여넣기할 때, 편집 셀 기준으로 n*n 개의 셀에 데이터를 붙여넣기 할지에 대한 여부 (옵션 설명) "true" : 기존 편집 중인 셀의 데이터는 사라지고, n*n 데이터가 n*n 셀에 각각 붙여넣어짐 (예시) 2*2 데이터 1 2 3 4를 (2,2) 셀에 붙여넣기하면, (2,2)(2,3)(3,2)(3,3) 셀 데이터가 각각 1 2 3 4가 됨 "false" (기본 값) : 기존 동작. 복사한 데이터가 현재 편집 중인 셀 하나에 1줄로 띄어쓰기로 합쳐서 붙여넣어짐
checkReadOnlyOnCut
[default: true, false] readOnly가 "true"인 컬럼의 데이터를 Ctrl+X로 잘라내기를 허용할지에 대한 여부 (옵션 설명) "true"(기본 값) : readOnly="true"가 설정된 컬럼은 '잘라내기'를 할 수 없음 "false": readOnly="true"가 설정된 컬럼은 '잘라내기'를 할 수 있음
checkReadOnlyOnPaste
[default: false, true] readOnly가 "true"인 모든 컬럼에 Ctrl+V로 데이터 붙여넣기를 허용할지에 대한 여부 (checkReadOnlyOnPasteEnable에서 컬럼 지정과 무관) (옵션 설명) "true" : readOnly="true"가 설정된 컬럼에 '붙여넣기'를 할 수 없음 "false" (기본 값): readOnly="true"가 설정된 컬럼에 '붙여넣기'를 할 수 있음
checkReadOnlyOnPasteEnable
[default: ""] readOnly="true"인 컬럼에 Ctrl +V를 통한 붙여넣기를 허용하는 컬럼을 지정 (사용 예) checkReadOnlyOnPasteEnable = "col1,col2"; //col1 및 col2 컬럼에서는 readOnly="true" 셀에도 '붙여넣기'를 할 수 있음
class
HTML의 클래스 속성과 동일한 기능을 제공
CSS 파일이나 스타일 블럭에 정의한 여러 개의 클래스를 공백으로 구분하여 적용 가능
columnMove
[default: false, true] 헤더 부분을 드래깅으로 컬럼 이동 허용
드래그 시 헤더의 값이 툴팁으로 표시됨
(참고사항) groupby(); 함수와 동시에 사용할 수 없음
(제약 사항) colSpan 설정 : 병합된 컬럼이 있을 경우, 병합된 컬럼은 이동이 되나 개별 컬럼 단위로 이동이 불가능 Header 2줄 설정 : 헤더가 2줄일 때, 첫 번째 헤더를 기준으로 컬럼 이동이 가능하나, 두 번째 헤더는 컬럼 이동이 불가능 subtotal 추가 : 부분합은 이동되지 않음(확인 작업) footer 추가 : 푸터 컬럼은 이동되지 않음
columnMoveWithFooter
[default: false, true] 컬럼 이동 시 푸터를 함께 이동할지 여부 설정
setColumnOrder 함수를 호출하여 컬럼을 이동하거나 columnMove="true" 설정을 한 경우 마우스 드래그를 통해 컬럼을 이동할 때 해당
(단, 푸터가 헤더 및 바디와 병합 구조가 다른 경우, 병합된 컬럼은 개별적으로 이동이 불가능) (옵션 설명) "true" : 푸터도 함께 이동 "false" (기본 값) : 푸터는 이동하지 않음
(관련 함수 및 속성) setColumnOrder(); columnMove="true"
contextMenu
[default: false, true] 컨텍스트 메뉴 사용 여부
contextMenuAltClick
[default: false, true] Alt 키 + 마우스 좌클릭 시, 컨텍스트 메뉴 표시 여부 (관련 속성) contextMenu="true"
copyOption
[default: dataList, display] 데이터를 복사할 때 DataList에 들어있는 값을 기준으로 복사할지(dataList), 또는 화면에 보이는 기준(display)으로 복사할지를 설정
copyOption은 컬럼마다 개별 설정도 가능하며 우선순위는 컬럼 개별 설정이 더 높음 (옵션 설명) "dataList" (기본 값) : 데이터 복사 시 dataList에 들어있는 값을 기준으로 복사 "display" : 데이터 복사 시 화면에 출력된 값을 기준으로 복사 (사용 예) gridView (1,1) 셀의 inputType이 "select" 이고 dataList에 들어있는 값(value)은 "1001", 화면에 출력된 값(label)은 "a1" 일 때 옵션이 "dataList"인 경우 해당 셀을 복사 시 클립보드에 "1001" 복사 옵션이 "display"인 경우 해당 셀을 복사 시 클립보드에 "a1" 복사
copyType
[default: default, native] 데이터를 복사할 때 포커스된 셀을 전부 복사할지(default) 또는 드래그를 통해 선택한 텍스트를 복사할지(native)를 설정 (옵션 설명) "default" (기본 값) : 데이터 복사 시 포커스된 셀 전체를 복사. 여러 셀을 복사한 경우 붙여넣을때도 여러 셀에 걸쳐 붙여넣기가 됨 "native" : 하나의 셀에서 일부의 데이터만 복사하고 싶을 때 사용. 여러 셀의 내용 일부를 복사할수 는 있으나, 붙여넣기는 항상 1개의 셀에만 붙여넣기 됨 (사용 예) (1,1)(1,2)(2,1)(2,2) 셀이 선택된 상태에서 (0,3) 셀에 붙여넣기를 하는경우 default인 경우 선택된 셀들의 값이 각각 (0,3),(0,4),(1,3)(1,4) 셀에 붙여넣기 됨 native인 경우 선택된 셀과 관계없이 마우스 드래그를 통해 선택된 영역의 텍스트가 (0,3) 셀 하나에 붙여넣기 됨. 복수의 셀이 선택된 경우 탭 문자(\t)가 추가됨
ctrlShiftKey
[default: false, true] Ctrl 키와 Shift 키를 번갈아 사용 가능하게 요청 (관련 속성) useShiftKey="true" (옵션 설명) "true" : Ctrl 키와 Shift 키를 번갈아 사용 가능 "false" : Shift 키를 이용하여 복수 셀의 선택에 적용 (useShiftKey="true" 동작과 동일)
customFilterBox
[default: false, true] 필터가 설정된 상태에서 groupby() 함수를 실행할 경우, 해당 필터를 계속 표시할지 여부
즉, 필터링과 그룹핑 동시 적용 가능
(옵션 설명) "true" : 필터 상자가 표시되고, groupby() 함수 실행 시 해당 필터를 유지 "false" (기본 값) : 필터 상자가 표시되지 않고, groupby() 함수 실행 시 필터가 초기화 됨
(관련 속성) groupbyZone="true" groupbyFilterBox="true" useFilterList="true" useFilter="true"
dataDragDrop
[default: false, true] 동일한 GridView 또는 서로 다른 GridView 간의 데이터 드래그-앤-드롭을 허용
기본적으로 2개의 GridView가 서로 다른 DataList와 연동되어 있고, 모두 본 속성을 사용해야 함 (단, dataDragSelect 기능은 같이 사용할 수 없음)
(주의: FireFox에서는 Ctrl 키를 누르고 사용 해야함)
dataDragDropOther
[default: false, true] 서로 다른 GridView 간의 데이터를 드래그-앤-드롭만 허용할지 여부
(즉, 동일한 GridView 내에서의 이동 방지) (관련 속성) dataDragDrop="true"
dataDragDropSelf
동일 gridView 내에서만 데이터 드래그-앤-드롭만 허용할지 여부 [true, false] (관련 속성) dataDragDrop="true"
dataDragDropStatus
[default: false, true] 변경이 일어난 데이터를 드래그-앤-드롭을 통해 이동시켰을 때 행 상태를 유지할지 여부
단, dragEndFunction을 사용하는 경우는 제외. 이 경우에는 dragEndFunction에서 직접 처리해야 함
변경된 데이터를 드래그-앤-드롭으로 이동시켰을 때 rowStatus가 C로 바뀌는 것이 기본 동작 (관련 속성) dataDragDrop="true" rowStatusVisible="true"
dataDragSelect
[default: false, true] 여러 개의 셀들을 드래그로 선택
useShiftKey 속성을 사용할 때 유효하며, dataDragDrop 속성과 함께 사용할 수 없음 (관련 속성) useShiftKey="true" dataDragDrop="false"
dataDragSelectAutoScroll
[default: false, true] 드래그를 통해 복수의 셀을 선택할 경우(dataDragSelect="true"), 마우스가 화면 밖을 벗어나면 자동으로 스크롤이 되는 기능 (옵션 설명) "true" : 마우스가 화면 밖을 벗어나면 자동으로 스크롤이 발생 "false" (기본 값) : 마우스가 화면 밖을 벗어나도 자동으로 스크롤이 발생하지 않음 (관련 속성) dataDragSelect="true" dataDragSelectAutoScrollLevel dataDragSelectAutoScrollPeriod
dataDragSelectAutoScrollLevel
[default: 1300] dataDragSelectAutoScroll 기능 사용 시 현재의 스크롤링 속도가 2배로 빨라지기까지의 시간 (단위: ms)
(즉, 드래깅 시간이 길어질수록 스크롤링 속도도 증가) (사용 예) dataDragSelectAutoScrollLevel="1300"인 경우, 1.3초 마다 현재 스크롤링 속도의 2배로 증가 (관련 속성) dataDragSelectAutoScroll="true" dataDragSelectAutoScrollPeriod
dataDragSelectAutoScrollPeriod
[default: 70] dataDragSelectAutoScroll 기능 사용 시 스크롤링이 발생하는 주기 (단위: ms)
값이 작을수록 스크롤링 속도가 빨라짐 (관련 속성) dataDragSelectAutoScroll="true" dataDragSelectAutoScrollLevel
dataList
GridView의 데이터에 해당하는 데이터컬렉션의 DataList의 아이디
defaultCellHeight
[default: -1] 셀의 기본 높이
disabledBackgroundColor
disabled가 "true" 설정이 적용된 셀 혹은 행의 배경색
disabledFontColor
disabled가 "true" 설정이 적용된 셀 혹은 행의 글자색
disabledScrollHidden
[default: false, true] GridView가 disabled인 경우 스크롤도 함께 숨김
IE를 제외한 다른 브라우저의 경우, GridView가 disabled되더라도 스크롤은 움직일 수 있는 현상을 원천적으로 차단하기 위한 속성
dragDisplayColumn
[default: ""] 데이터를 드래그(dataDragDrop="true")할 때 툴팁으로 표시할 컬럼의 아이디를 지정
해당 컬럼의 데이터가 툴팁으로 표시됨
여러 컬럼을 지정할 경우 컬럼 아이디를 ","로 구분하여 설정
본 속성을 정의하지 않을 경우, 클릭된 컬럼의 데이터가 툴팁에 표시됨
dragEndFunction
드래그 종료시 실행될 함수
드릴다운인 경우와 그렇지 않은 경우를 구분해서 해당 함수를 정의해야 함 (관련 속성) dragStartFunction
(예제 1) // 기본적으로 dragEndFunction을 정의할 때, // targetRowIndex, rowXml, infoObj가 각각 첫번째, 두번째, 세번째 인자로 넘어옴 // 두번째 인자인 rowXml은 dragStartFunction에서 리턴한 값이며, // 세번째 인자인 infoObj는 object // fromColumnId, fromColumnIndex, toColumnId, toColumnIndex, rowJSON 정보를 포함 // dragEndFunction에서 targetRowIndex에 삽입하고자 하는 행을 삽입하는 로직을 구현하면 되며, // 반환값이 true일 때 처음 dragdrop이 시작됐던 행 인덱스에 해당하는 행을 삭제 function end( targetRowIndex, rowXml, info ) { var fromColumnId = info.fromColumnId; var fromColumnIndex = info.fromColumnIndex; var toColumnId = info.toColumnId; var toColumnIndex = info.toColumnIndex; var rowJSON = info.rowJSON; . . . return true; // true인 경우만 처음 드래그 앤 드랍이 시작됐던 행 인덱스에 해당하는 행을 삭제 } (예제 2) // 그리드가 drilldown을 사용하는 경우, // setDrillDownDragDrop 함수의 첫번째 인자값으로 true를 줘야 하며, // 이 경우 dragStartFunction은 toIndex, rowXml, infoObj가 각각 첫번째, 두번째, 세번째 인자로 넘어옴 // 첫번째 인자값으로는 toIndex가 주어지는데 drilldown을 사용하였기 때문에, // targetIndex의 realRowIndex를 계산한 값이라고 보면 됨 // 세번째 인자값으로 object가 주어지며, // removedData, removedRowIndex, insertedData, insertedRowIndex, fromRowIndex, toRowIndex, rowJSON 정보를 포함 // 위의 경우와 달리 반환값은 아무 의미 없음 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; var rowJSONArray = info.rowJSON; //json Array . . . }
dragStartFunction
드래깅 시작 시 실행할 함수
드릴다운인 경우와 그렇지 않은 경우를 구분해서 해당 함수를 정의해야 함 (관련 속성) dragEndFunction

(예제 1) // 기본적으로 dragStartFunction을 정의할 때, // rowIndex, rowXml, infoObj가 각각 첫번째, 두번째, 세번째 인자로 넘어옴 // 세번째 인자인 infoObj는 객체이며 fromColumnId, fromColumnIndex 정보를 포함 // 반환값은 dragEndFunction이 정의되어 있는 경우, dragEndFunction이 실행될 때 두번째 인자로 이용할 수 있음 function start( rowIndex, rowXml, info ) { var fromColumnId = info.fromColumnId; var fromColumnIndex = info.fromColumnIndex; . . . return rowXml; // dragEndFunction의 두번째 인자로 이용됨 } (예제 2) // 그리드가 드릴다운을 사용하는 경우, // setDrillDownDragDrop 함수의 첫번째 인자값으로 true를 주고 실행시킨 이후의 상태여야 하며, // dragStartFunction을 실행했을 때는 반환값이 true인 경우에만 드릴다운의 dragDrop을 실행 // 이 경우 dragStartFunction은 첫번째 인자값으로 객체가 주어지며 parentRowIndex, parentRowData, beforeRemoveRowIndex, beforeRemveData 정보를 포함 function start( info ) { var parentRowIndex = info.parentRowIndex; var parentRowData = info.parentRowData; var beforeRemoveRowIndex = info.beforeRemoveRowIndex; var beforeRemoveData = info.beforeRemoveData; . . . return true; // true인 경우에만 드릴다운의 dragDrop을 실행 }
drawType
[default: virtual, native] GridView를 그릴 때 화면에 보이는 부분만 그릴지 (virtual), 전체를 그릴지 (native)에 대한 여부
drawType이 "native" 인 경우 GridView의 세로 스크롤 처리를 브라우저에 위임하므로 세로 스크롤의 움직임이 자연스러우며 데이터가 적은 경우 유리함
drawType이 "virtual" 인 경우 화면에 보이는 영역만 랜더링하므로 대용량 그리드에서 성능이 유리함
GridView의 각 행의 높이가 다른 경우 drawType을 "native"로 사용하는 것을 권장 (제약사항) drawType을 "native" 사용 시 확인이 필요한 사항 GridView의 높이는 필수로 지정해줘야 함 (visibleRowNum 속성 무시) fixedRow 속성은 사용할 수 없음 (fixedRow 속성 무시)
drilldownToggle
[default: ""] 드릴다운 컬럼에서 목록을 펼칠 때 사용되는 방식을 지정 (옵션 설명) enter : 포커스된 셀에서 Enter 키에 의한 토글링. 포커스된 셀이 하나일 경우 적용
drilldownToggleScrollFix
[default: false, true] 드릴다운 컬럼에서 +버튼을 클릭하여 목록을 펼칠 때 스크롤을 고정
dynamic
[default: false, true] 틀만 그려놓고 setGridStyle을 통해 동적으로 생성
dynamic이 true일 경우 GridView에 w2:header나 w2:body가 존재하지 않더라도 경고 메세지를 출력하지 않음
editModeEvent
[default: ondblclick, onclick, onsecondclick] 셀 수정 모드로 진입하기 위한 마우스 동작 이벤트 (옵션 설명) "onclick" : 셀을 클릭할 경우 셀 수정 모드로 진입 "ondblclick" (기본 값): 셀을 더블-클릭할 경우 셀 수정 모드로 진입 "onsecondclick": 셀 클릭 후 시차를 두고 다시 클릭하거나 키를 입력할 경우 수정 모드로 진입
editModeEventIcon
[default: onclick, ondblclick] viewType이 "icon"인 경우 수정 모드로 진입하기 위해 필요한 마우스 동작 이벤트 (옵션 설정) "onclick" (기본 값): 아이콘을 클릭할 경우 셀 수정 모드로 진입 "ondblclick": 아이콘을 더블-클릭할 경우 셀 수정 모드로 진입
(주의 사항) GridView.column과 GridView 모두 editModeEventIcon 설정을 정의한 경우 GridView.column의 설정이 우선함
enterKeyMove
[default: down, right, none, edit, editRight, editDown] 셀에서 Enter 키를 입력할 경우 포커스 이동 방향 (옵션 설명) "down" (기본 값) : Enter 키 입력 시 아래쪽 셀로 이동 "right" : Enter 키 입력 시 오른쪽 셀로 이동 "none" : Enter 키를 입력해도 포커스 이동이 없음 "edit" : Enter 키 입력 시 편집 모드로 이동 "editRight" : 편집 모드에서 Enter 키를 입력할 경우 오른쪽 셀로 이동 "editDown" : 편집 모드에서 Enter 키를 입력할 경우 아래쪽 셀로 이동
escape
[default: true, false] <>&"를 HTML escape 문자로 변환하여 화면에 표시 (옵션 설명) "true" (기본 값) : escape 문자로 변환하지 않음 "false" : escape 문자로 변환하여 화면에 표시
euroMask
[default: ""] dataType이 "euro"인 경우나 changeCurrency() 함수를 사용하는 경우 화폐 표현식 (사용 예시) euroMask = "#.###,00"
evenRowBackgroundColor
짝수 행의 배경색
excludeDeletedRows
[default: false, true] 부분합과 푸터 등에서 삭제된 행을 제외하고 계산을 실행 (관련 함수) deleteRow(); deleteRows();
excludeModifiedRows
[default: false, true] 부분합과 푸터 등에서 변경(수정, 삭제, 추가)이 발생한 행을 제외하고 계산 (관련 함수) modifyRowStatus(); : 본 함수를 사용하여 특정 행의 상태를 "D" 설정하는 경우에도 해당 행을 제외하고 계산
fastScroll
[default: true, false] 세로 스크롤 이동 시 고속 스크롤링 효과를 추가
시간 내에 그릴 수 있는 부분까지만 표현됨. 아직 그려지지 않은 영역은 "화면 갱신 중 입니다." 메세지를 표시
filterBoxvisibleRowNum
[default: 4] 필터링 조건 목록에 표시할 필터링 조건의 수 (관련 속성) groupbyFilterBox="true"
filterFocusMode
[default: ""] 정렬 이벤트 발생 시 이벤트 발생 전 바디의 셀/행에 선택되어있는 포커스를 제거할지에 대한 속성 (옵션 설명) "outfocus" : 바디의 포커스를 제거한 후 정렬을 수행 "infocus" : 기존 포커스의 위치 유지하여 정렬을 수행 "followfocus" : 기존 포커스된 항목을 정렬 후, 해당 항목의 위치로 포커스를 이동. 이 때 scrollend 이벤트는 발생하지 않음
filterShowAlways
[default: false, true] useFilter가 "true"인 컬럼에서 컬럼 너비가 좁을 때 필터의 아이콘을 최우선으로 표시
fixedColumn
[default: 0] 틀고정을 적용할 컬럼의 위치 (예제) 첫번째 컬럼일 경우 fixedColumn="1"을 설정
fixedColumnLineDiv
틀고정 CSS를 Div에 표현할지 여부
fixedColumnLineDivStart
틀고정 Div 시작 위치 지정 (관련 속성) fixedColumnLineDiv="true"
fixedColumnNoMove
[default: false, true] 고정된 컬럼이 지정된 컬럼의 컬럼 이동 허용 여부
fixedColumnScrollHidden
[default: false, true] 틀고정을 할 경우, 고정된 영역의 스크롤을 숨김
fixedColumnWithHidden
[default: true, false] 고정된 컬럼의 위치 값에 숨겨진 컬럼을 포함하여 계산할지 여부
fixedRightColumn
[default: 0] 우측에 틀고정할 컬럼의 수 (예제) fixedColumn이 "3"이고 fixedRightColumn이 "2"인 경우, 왼쪽은 3번째 컬럼까지 고정되고, 오른쪽은 2번째 컬럼까지 고정
(관련 함수) setFixedRightColumn();
fixedRow
[default: 0] 틀고정을 시킬 행의 위치
(예제) //첫번째 행에 틀고정할 경우 fixedRow="1"
focusDefaultColumn
[default: false, true] true 설정 시 행 번호 컬럼 및 행 상태 컬럼이 포커스를 받을 수 있는 상태로 바꿀지 여부 (참고) 행 번호 컬럼은 rowNumVisible가 "true"인 경우 표시되는 컬럼 행 상태 컬럼은 rowStatusVisible가 "true"인 경우 표시되는 컬럼
focusFlow
[default: default, linear] 포커스 이동 방향을 설정 (옵션 설명) "default" (기본 값): 맨 좌측, 맨 우즉, 상단, 하단에서 더 이상 이동하지 않음 "linear" : 맨 좌측, 맨 우즉, 상단, 하단 이후 위/아래 행 및 이전/이후 컬럼으로 이동
focusImage
[default: false, true] senseReader 또는 embeddedInput이 true이며 inputType이 "image"인 경우, 이미지로 포커스 이동할지 여부
focusMode
[default: cell, row, both, none] 셀에 포커스 시 선택 영역 표현 방법 (옵션 설명) "cell" (기본 값) : 셀을 선택 "row" : 행을 선택 "both" : 셀과 행을 모두 선택 "none" : 아무것도 선택하지 않음
focusMove
[default: true, false, vertical, horizontal] 방향키를 통한 포커스 이동 허용 (옵션 설명) "true" (기본 값) : 상/하/좌/우 방향키를 통한 포커스 이동 허용 "false" : 방향키를 통한 이동 금지 "vertical" : 상/하 방향키만 허용 "horizontal" : 좌/우 방향키만 허용
footerCaption
[default: ""] 푸터의 캡션에 들어갈 내용 설정
footerCaptionAuto
[default: false, true] captionAuto 설정에 상관 없이 푸터의 캡션 내용 자동 생성 (관련 속성) captionTitle footerCaption
(예제 1) captionTitle = "연도별 매출", footerCaptionAuto = "true" // footerCaption="연도별 매출의 합계를 나타낸 표" (예제 2) captionTitle = "연도별 매출", footerCaptionAuto = "" // "연도별 매출"이 바닥글로 생성
footerSummary
[default: ""] 푸터의 내용 요약
footerSummaryAuto
[default: false, true] captionAuto 설정에 상관 없이 푸터의 요약 자동 생성 (관련 속성) captionTitle footerSummary
(예제) captionTitle = "연도별 매출", footerSummaryAuto = "true" // summary="연도별 매출의 합계를 나타낸 표"
groupbyFilterBox
[default: false, true] 필터링 기능을 사용할 때 필터링 조건 목록의 표시 여부
사용자는 표시된 목록에서 조건을 선택하여 필터링 수행 가능 (옵션 설명) "true" : 표시 "false" (기본 값) : 표시하지 않음
(관련 속성) groupbyFilterBoxLocation : 필터링 조건 목록 표시 위치 filterBoxvisibleRowNum : 표시할 필터링 조건 수
groupbyFilterBoxFormatter
groupbyFilterBox에 출력되는 목록의 형식을 변경하는 속성
data, isGroupby 두 개의 파라미터를 전달받음 (파라미터 설명) data : groupbyFilterBox에 추가되는 필터 정보를 담은 객체. 하위 객체로 헤더와 필터 존재 data.header : 필터 대상이 되는 열의 헤더 라벨 data.filter : 필터 조건을 담은 객체 data.filter.labels : 필터 데이터의 라벨 data.filter.operator : 필터 연산자 data.filter.values : 필터 데이터의 값 (대상이 다수일 경우에는 배열 형태로 제공) data.filter.gate : 사용자 지정 필터 사용 시 접속어 [undefiend, and, or] isGroupby : 그룹핑 상태일 경우 true, 아닐 경우 false
groupbyFilterBoxLocation
[default: bottom, top] groupbyFilterBox를 표시할 위치 (옵션 설명) "top" : 상단에 표시 "bottom" (기본 값): 하단에 표시
(관련 속성) groupbyFilterBox="true"
groupbyMaxCount
groupby 가능한 최대 컬럼 개수를 지정
groupbyZone
[default: false, true] groupby 기능을 사용 여부 (groupby란 특정 컬럼들을 기준으로 컬럼 내의 같은 데이터들을 그룹핑하여 표시)
groupbyZoneHeight
[default: 50] groupbyZone의 높이를 설정
groupbyZoneMessage
groupbyZone이 초기 상태일 경우 출력할 메세지를 설정
hammerEnabled
[default: true, false] 모바일에서 더블클릭 이벤트를 Hammer.JS의 키를 누른(press) 상태 이벤트로 처리
hammerPressTime
[default: 351] 키를 누른(press) 상태 이벤트가 발생하기까지 누르고 있어야 할 시간 (단위: ms)
hideDeletedRow
[default: false, true] 삭제된 행을 화면에서 보여지지 않게 할지 여부
(단, groupby나 drilldown에서는 미지원) (관련 함수) deleteRow(); deleteRows();
hideFilterIconOnNoData
[default: true, false] 데이터가 존재하지 않을 경우 웹접근성용 head filter 아이콘을 보여줄지 여부
hideHeader
[default: false, true] 헤더 숨길지 여부
hideSortIconOnNoData
[default: true, false] 데이터가 존재하지 않을 경우 웹접근성용 head sort 아이콘을 보여줄지 여부
id
컴포넌트 아이디 (전역 객체로 할당)
각 컴포넌트 아이디를 통해 스크립트에서 해당 컴포넌트에 접근 가능
ignoreCellClick
[default: false, true] 드릴다운 컬럼에서 하위 노드가 있는 경우 상위 노드 셀에 oncellclick 이벤트 발생 여부 (옵션 설명) "true" : 셀 클릭을 무시. 상위 노드 셀을 클릭해도 oncellclick 이벤트가 발생하지 않음 "false" : 셀 클릭 시 oncellclick 이벤트가 발생
ignoreNonEditableCell
셀 편집이 불가능할 경우, Tab 키나 Enter 키 입력을 무시
ignoreNonEditableCellTabEnter
[default: false, true] ignoreNonEditableCell이 "true"인 경우, readOnly="true" 셀에서 방향키를 통한 이동 허용 (옵션 설정) "false" : 방향키를 사용 "true" : Tab 키나 Enter 키 사용
ignoreToggleOnDisabled
[default: false, true] 드릴다운 시 disabled이 "true"인 셀의 경우 토글 이미지를 클릭을 무시
initFixedHeightByRowNum
[default: -1] 최초 렌더링된 GridView의 행의 수를 기준으로 GridView의 높이를 초기화 (부분합의 행의 수도 포함)
즉, 화면에 표시할 행의 수를 고정할 수 있는 속성을 의미함
keepDefaultColumnWidth
[default: false, true] autoFit이 설정되어 있는 경우, 행의 번호(rowNum)와 행의 상태(rowStatus) 컬럼의 너비를 고정 (관련 속성) rowNumVisible = true rowStatusVisible = true autoFit = "lastColumn" 또는 "allColumn"
keyMoveEditMode
[default: false, true] Tab이나 Enter 키를 사용하여 이동 시 즉시 편집 모드로 진입 여부 (옵션 설명) "true" : Tab이나 Enter 키를 사용하여 이동과 함께 바로 수정 모드로 진입 "false" (기본 값) : Tab이나 Enter 키를 사용하여 포커스만 이동
labelDelimiter
GridView.column의 inputType이 CheckBox 혹은 Radio인 경우 항목의 라벨 조합 컬럼 아이디의 구분자 (관련 속성) GridView.column.radioLabelColumn, GridView.column.checkboxLabelColumn
loadCount
세로 스크롤이 하단에 닿은 후 발생되는 onscrollend() 이벤트를 한번만 발생시켜 줄 행을 지정
지정하지 않으면 세로 스크롤이 하단에 닿을 때마다 onscrollend() 이벤트가 발생함 (관련 이벤트) onscrollend
(사용 예시) loadCount = 2 이 경우 그리드의 마지막 3행에 스크롤이 도달하면 onscrollend() 이벤트가 발생
mergeCells
행 또는 컬럼 기준으로 연속적으로 같은 데이터들을 병합함 (옵션 설명) "never" : 병합하지 않음 "bycol" : 같은 컬럼에서 연속적으로 데이터가 같은 행들을 병합 "byrow" : 같은 행에서 연속적으로 데이터가 같은 컬럼들을 병합 "bycolrec" : bycol로 병합 후, 병합되지 않은 셀을 대상으로 byrow를 실행 "byrowrec" : byrow로 병합 후, 병합되지 않은 셀을 대상으로 bycol을 실행 "byrestriccol" : 같은 컬럼에서 연속적으로 같은 데이터가 있고 왼쪽의 컬럼이 병합된 경우, 해당 행들을 병합 (n+1 컬럼에서 n컬럼을 upperColumn으로 지정한 형태) "byrestricrow" : 같은 행에서 연속적으로 같은 데이터가 있고 위쪽의 행이 병합된 경우 해당 열들을 병합 (n+1 행에서 n행을 upperRow으로 지정한 형태)
mergeCellsFixedCols
fixedColumn 영역 내에서 행 또는 컬럼 기준으로 연속적으로 같은 데이터들을 병합 (옵션 설명) "never" : 병합하지 않음 "bycol" : 같은 컬럼에서 연속적으로 데이터가 같은 행들을 병합 "byrow" : 같은 행에서 연속적으로 데이터가 같은 컬럼들을 병합 "bycolrec" : bycol로 병합 후, 병합되지 않은 셀을 대상으로 byrow를 실행 "byrowrec" : byrow로 병합 후, 병합되지 않은 셀을 대상으로 bycol을 실행
mergeCellsFixedRows
fixedRow 영역 내에서 행 또는 컬럼 기준으로 연속적으로 같은 데이터들을 병합 (옵션 설명) "never" : 병합하지 않음 "bycol" : 같은 컬럼에서 연속적으로 데이터가 같은 행들을 병합 "byrow" : 같은 행에서 연속적으로 데이터가 같은 컬럼들을 병합 "bycolrec" : bycol로 병합 후, 병합되지 않은 셀을 대상으로 byrow를 실행 "byrowrec" : byrow로 병합 후, 병합되지 않은 셀을 대상으로 bycol을 실행
mergeCol
mergeCells로 병합하는 경우 병합을 수행할 컬럼을 지정
여러개일 경우 콤마(",")로 구분함 (사용 예제) // col1과 col3 컬럼의 값을 기준으로 병합 mergeCells = "byCol", mergeCol = "col1,col3"
mergeExcludeValue
병합하지 않을 값을 정의
여러개일 경우 콤마(",")로 구분함 (사용 예시) // 빈 값과 100은 병합에서 제외 mergeExcludeValue="$blank,100" //* 빈 값은 "$blank"를 사용
minWidth
[default: 0] 컬럼의 최소 너비 (단위: px), 컬럼에 minWidth를 선언한 경우 우선 적용
moveKeyEditMode
[default: false, true] 상하 방향키를 사용하여 이동 시 즉시 편집 모드로 진입 여부 (옵션 설명) "true" : 상하 방향키를 사용하여 이동과 함께 바로 수정 모드로 진입 "false" (기본 값) : 상하 방향키를 사용하여 포커스만 이동
moveKeyEditModeAll
[default: false, true] 상하좌우 방향키를 사용하여 이동 시 즉시 편집 모드로 진입 여부 (옵션 설명) "true" : 방향키를 사용하여 이동과 함께 바로 수정 모드로 진입 "false" (기본 값) : 방향키를 사용하여 포커스만 이동
(참고 사항) inputType은 text, select, calendar, checkcombobox, secret, textarea인 경우 지원됨 inputType이 text, calendar, secret, 혹은 textarea인 경우 좌우 방향키는 커서가 문자열의 첫번째 또는 마지막에서 입력될 경우 이동
nextTabID
Tab 키로 이동할 경우, Tab 키를 누를 때 다음으로 선택될 컴포넌트의 아이디
noResultMessage
[default: "조회 결과가 없습니다."] 조회 결과가 없을 경우 표시할 메세지
noResultMessageClass
조회 결과 없음 메시지에 별도의 스타일을 적용하기 위한 클래스. (참고 사항) 해당 메세지는 <div> 태그 내에 텍스트가 표현됨 (!주의!) 각 Style 항목이 Inline으로 존재하기 때문에, 클래스의 각 Style 속성에 !important를 사용해야 함
noResultMessageStyle
조회 결과 없음 메시지에 별도의 스타일을 적용 (사용 예시) 아래 속성을 필수로 정의해야 레이아웃이 유지되고 메시지가 정상 출력됨 position: absolute; display: block; left: 40%; width: 20%; top: 40%; text-align:center; (참고 사항) 해당 메세지는 <div> 태그 내에 텍스트가 표현됨 position과 display가 정의되지 않은 경우 엔진에서 absolute 및 block 값을 할당
noResultMessageURL
gridview별로 noResultMessage를 변경할 수 있는 xml 파일 경로
noResultMessageVisible
[default: true, false] 조회 결과가 없을 때 메시지 표시 여부
noResultMessageVisibleAlways
[default: false, true] 데이터가 하나도 없을 때 메시지 표시 여부 (DataList 연동여부와 상관없음) (관련 속성) noResultMessageVisible = true
noSelect
다중으로 셀을 드래깅하거나 Ctrl 또는 Shirt 키를 통해 여러 셀 선택 허용 여부 (옵션 설명) true : 다중 셀 선택을 방지 false (기본 값): 다중 셀 선택을 허용 (관련 속성) useCtrlKey = true 또는 useShiftKey = true
numberMask
[default: ""] 숫자나 화폐 표시형태 변경을 위해 dataType="number" 설정이나 changeCurrency(); 함수를 사용할 경우 적용되는 숫자표시 형식 값 (사용 예시) numberMask = "#,###.00" 또는 numberMask = "#,##0"
oddEvenColorDisplay
[default: true, false] 짝/홀수 행 마다 서로 다른 색의 사용 여부
oddRowBackgroundColor
홀수 행의 배경색 (관련 속성) oddEvenColorDisplay = true
overflowX
[default: auto, hidden, scroll] 가로 스크롤 표시 여부 (옵션 설명) auto (기본 값) : 데이터가 GridView 영역을 넘치는지 여부에 따라 스크롤을 자동으로 표시 hidden : 스크롤을 표시하지 않음 scroll : 스크롤을 항상 표시
overflowY
[default: auto, hidden, scroll] 세로 스크롤 표시 여부 (옵션 설명) auto (기본 값) : 데이터가 GridView 영역을 넘치는지 여부에 따라 스크롤을 자동으로 표시 hidden : 스크롤을 표시하지 않음 scroll : 스크롤을 항상 표시
preventAddRowOnPaste
[default: false, true] Ctrl(또는 cmd)+V를 눌러 클립보드에서 그리드로 붙여넣기하는 경우 새로운 행의 추가 여부 (옵션 설명) true : 붙여넣는 데이터가 마지막 행을 넘어서는 경우 이후 데이터는 붙여넣기를 하지 않음 false (기본 값) : 붙여넣는 데이터가 마지막 행을 넘어서는 경우 행이 자동으로 추가됨
preventCopy
[default: false, true] Ctrl(또는 cmd)+C 또는 Ctrl(또는 cmd)+X를 통해 데이터를 클립보드에 붙여넣는 동작을 방지 (셀이 편집모드인 경우에는 설정이 무시됨)
preventCopyColumn
[default: ""] Ctrl(또는 cmd)+C 또는 Ctrl(또는 cmd)+X를 통해 데이터를 클립보드에 복사하는 동작을 방지할 컬럼의 아이디를 지정 (셀이 편집모드인 경우에는 설정이 무시됨) (사용 예시) preventCopyColumn = "col1,col2";
preventMultisort
다중 정렬을 방지 (관련 속성) sortable = true
preventPaste
[default: false, true] Ctrl(또는 cmd)+V를 통해 클립보드의 정보를 붙여넣는 동작을 방지 (셀이 편집모드인 경우에는 설정이 무시됨)
preventPasteColumn
[default: ""] Ctrl(또는 cmd)+V를 통해 클립보드의 정보를 붙여넣는 동작을 방지할 컬럼의 아이디를 지정 (셀이 편집모드인 경우에는 설정이 무시됨) (사용 예시) preventPasteColumn = "col1,col2";
readOnly
[default: false, true] 전체 셀을 읽기 전용으로 설정
읽기전용 속성은 GridView, Column, Row, Cell 별로 속성이나 함수를 통해 설정 가능 (적용 우선 순위) GridView < Column < Row < Cell 이때 Column과 Row의 우선 순위를 readOnlyPriority의 설정으로 변경 가능
readOnlyBackgroundColor
읽기전용 셀의 배경색 (관련 속성) readOnly="true"
readOnlyBackgroundImg
읽기전용 셀의 배경 이미지 경로 (관련 속성) readOnly="true"
readOnlyBackgroundImgCSS
읽기전용 셀의 배경 이미지의 스타일(CSS)
readOnlyBackgroundImg 속성보다 우선 적용됨 (관련 속성) readOnly = true readOnlyBackgroundImg
(사용 예시) background: steelblue url("이미지경로") 10px 50% no-repeat;
readOnlyPriority
[default: column, row] 읽기전용(readOnly)의 적용 우선 순위 설정
읽기전용 속성은 GridView, Column, Row, Cell 별로 속성이나 함수를 통해 설정 가능 (적용 우선 순위) GridView < Column < Row < Cell 이때 Column과 Row의 우선 순위를 readOnlyPriority의 설정으로 변경 가능
readOnlyTabIgnore
[default: false, true] Tab 키로 컬럼이동 시 읽기전용 컬럼를 무시할 지 여부 (관련 속성) readOnly="true"
resize
[default:true, false] 마우스 드래깅을 통한 컬럼 너비 조절 허용
rowMouseOver
[default: true, false] 마우스커서가 위치(마우스-오버)할 때 행의 배경색을 표시할지 여부
rowMouseOverClass
마우스-오버된 행에 적용할 클래스
rowMouseOverColor
마우스커서가 위치(마우스-오버)할 때 표시할 행의 배경색
rowNumBackgroundColor
행 번호 컬럼의 배경색 (관련 속성) rowNumVisible = true 인 경우 유효함
rowNumHeaderValue
행 번호 헤더에 표시할 텍스트 (관련 속성) rowNumVisible = true 인 경우 유효함
rowNumLocaleRef
행의 번호표시(rowNum ) 컬럼에 설정할 다국어 키 값
rowNumRowMouseOverColor
rowNum 컬럼에 rowMouseOverColor 적용 여부 (관련 속성) rowNumVisible="true"
rowNumStatusResize
[default: false, true] 행 번호(rowNum) 및 행 상태(rowStatus) 표시 컬럼의 너비 조절 가능 여부
rowNumStatusUniqueId
[default: false, true] 행 번호(rowNum) 혹은 행 상태(rowStatus) 표시를 사용 시 각 행 별로 유일한 아이디를 사용 (웹표준검사(W3C Validator)를 위한 속성) (옵션 설명) "false" (기본 값) : 모든 행 번호에 해당하는 td의 아이디는 "_headerRowNumber"이고 행 상태에 해당하는 td의 아이디는 "_headerStatusNumber" "true" (권장) : 각 행 별로 유일한 아이디를 사용
rowNumVisible
[default:false, true] 행 번호 표시 여부
rowNumWidth
행 번호를 표시하는 컬럼의 너비 (관련 속성) rowNumVisible = true 인 경우 유효함
rowStatusHeaderValue
헤더에 표시할 텍스트 (관련 속성) rowStatusVisible = true 인 경우 유효함
rowStatusLocaleRef
행의 상태표시(rowStatus) 컬럼에 설정할 다국어 키 값
rowStatusVisible
[default: false, true] 각 행의 상태(추가/수정/삭제)를 별도의 컬럼에 아이콘으로 표시
rowStatusWidth
행 상태(rowStatus) 표시 컬럼의 너비 (관련 속성) rowStatusVisible = true 인 경우 유효함
rupeeMask
[default: ""] dataType이 "rupee"인 경우나 changeCurrency() 함수를 사용하는 경우 화폐 표현식 (사용 예시) rupeeMask = "##,##,###.00"
scrollByColumn
[default: false, true] 가로 스크롤을 컬럼 단위로 이동
scrollByColumnAdaptive
[default: false, true] 적응형웹(Adaptive) 상태일 때 가로 스크롤을 컬럼 단위로 이동 (관련 속성) adaptive
scrollFocus
[default: false, true] 마지막 행에서 탭키이동시 세로스크롤(Y) 영역으로 포커스를 이동할지 여부 (관련 속성) senseReader = "true"
scrollXNative
[default: false, true] 가로 스크롤을 브라우저에서 제공하는 기본 스크롤을 사용할지에 대한 여부 (옵션 설명) false (기본 값) : 가로 스크롤을 웹스퀘어에서 만든 가상 스크롤을 사용 (스크롤이 이동할 때 표의 가장 왼쪽의 컬럼 길이가 줄어듬) true : 가로 스크롤을 브라우저에서 제공하는 스크롤을 사용 (스크롤 이동 시 컬럼의 길이가 변하지 않음) (제약사항) fixedColumn과 함께 사용할 수 없음 (scrollXNative = true인 경우 fixedColumn의 설정을 무시함)
scrollXNativeMobile
[default: "", false, true] 가로 스크롤을 브라우저에서 제공하는 기본 스크롤을 사용할지에 대한 여부
모바일에서 실행될 때만 적용되는 속성으로 설정값이 없을 경우 scrollXNative 설정값을 따른다. (옵션 설명) "false" : 가로 스크롤을 웹스퀘어에서 만든 가상 스크롤을 사용 (스크롤이 이동할 때 표의 가장 왼쪽의 컬럼 길이가 줄어듬) "true" : 가로 스크롤을 브라우저에서 제공하는 스크롤을 사용 (스크롤 이동 시 컬럼의 길이가 변하지 않음)
(제약사항) fixedColumn과 함께 사용할 수 없음 (scrollXNative = true인 경우 fixedColumn의 설정을 무시함)
selectedCellColor
선택된 셀의 배경색 (관련 속성) focusMode = "cell"
selectedCellOverColor
선택된 셀이 있는 행에 마우스커서가 위치(마우스-오버)할 때 표시할 셀의 배경색
지정하지 않으면 rowMouseOverColor 값을 사용 (관련 속성) focusMode = "cell"
selectedRowColor
선택된 행의 배경색
selectedRowOverColor
선택된 셀이 있는 행에 마우스커서가 위치(마우스-오버)할 때 표시할 행의 배경색
지정하지 않으면 rowMouseOverColor 값을 사용
senseReader
[default: false, true] 웹 접근성을 지원하기 위한 모드 (옵션 설명) "false" (기본 값) "true" : Tab 키로 모든 셀을 순회 가능
(주의 사항) inputType = "text", "select", "radio", "checkbox"인 경우 embeddedInput = "true"를 적용하여 셀 내부에 InputBox, SelectBox, Radio, CheckBox 컴포넌트가 그려지며 이를 리더기에서 인식할 수 있음
(관련 속성) 아래 속성과 함께 사용할 것을 권장 focusMode = "none" focusMove = "false"
setCellInputTypeCustom
[default: false, true] inputType이 "custom"인 경우 inputType을 동적으로 변경하기 위한 옵션 (typeGetter와 동시에 사용 불가 및 drilldown 미지원)
showCustomFilterReset
사용자 필터를 초기화시킬 수 있는 버튼을 출력 (옵션 설명) "false" (기본 값): 초기화 버튼을 출력하지 않음 "true": 초기화 버튼을 출력
showImageTooltip
[default: false, true] inputType이 "image"인 경우에도 툴팁을 표시 (이미지의 링크정보를 표시) (옵션 설명) true : 툴팁을 표시 false (기본 값) : 툴팁을 표시하지 않음 (관련 속성) tooltipDisplay = true
showSortableImage
[default: false, true] 정렬 가능한 컬럼의 헤더에 정렬 이미지를 출력
showSortableUseFilter
[default: false, true] useFilterList와 showSortableImage 를 동시에 사용할 때 정렬 아이콘과 사용자 정의 필터 아이콘 모두를 헤더에 표시 (옵션 설명) "true" : 사용자 정의 필터 아이콘과 정렬 아이콘 모두를 헤더에 표시 "false" (기본 값): 정렬 아이콘만 표시
(관련 속성) showSortableImage = "true" sortable = "true" useFilterList = "true"
sortable
[default: false, true] 헤더 클릭으로 데이터 정렬 지원 여부
sortedIconPosition
[default: "right", "left"] 정렬 관련 이미지를 표시할 위치 (관련 속성) sortable="true" sortHeaderDiv="true"인 경우 무시되고 강제로 우측에 위치함
sortEvent
[default: ondblclick, onclick] 정렬을 수행할 이벤트를 정의 (옵션 설명) "ondblclick" (기본 값) : 헤더 더블클릭으로 정렬 수행 "onclick" : 헤더 클릭으로 정렬 수행
(관련 속성) sortable="true" sortHeaderDiv="true"인 경우 sortEvent="onclick"로 강제로 설정 됨 (웹 접근성을 위해 강제로 변경)
sortHeaderDiv
[default: false, true] 헤더영역에 정렬 아이콘을 표시할지의 여부 (관련 속성) sortable="true" sortEvent : 강제로 "onclick"으로 동작함 sortedIconPosition : 강제로 "right"로 동작함
sortOrderReverse
[default: false, true] 헤더 클릭을 통한 데이터 정렬 시 내림차순 정렬을 먼저 수행
subtotalStyleFormatter
부분합의 값에 따른 스타일의 적용을 해주는 사용자 함수를 지정 (함수 설명) 매개변수 value, formattedValue, subtotalColumnId value : 원본 데이터 formattedValue : 형태가 적용된 데이터 subtotalColumnId : 부분합 컬럼명
(사용 예시) //부분합 값이 음수일 때는 파란색, 양수일 때는 빨간색으로 표헌하고자 하는 경우 // 먼저 다음과 같이 css를 등록 : .cm_subtotalplus{color:red;} .cm_subtotalminus{color:blue;} scwin.gridView1_subtotalStyleFormatter = function(value, formattedValue, subtotalColumnId) { if (subtotalColumnId !== "column28" && subtotalColumnId !== "column23") { return; } if (isNaN(value) || value === 0) { return; } if (value > 0) { return "cm_subtotalplus"; } else if (value < 0) { return "cm_subtotalminus"; } }
summary
HTML 태그의 summary 속성과 동일 [웹접근성 준수를 위해 사용]
Summary 특성(Attribute)은 비표준이므로 문서의 종류(Document Type Declaration)가 HTLM5인 경우를 판단하여 특성을 제거하여 줌
summaryAuto
웹접근성 지원 시, Summary 항목에 헤더 컬럼명을 자동으로 설정 summary attribute는 docType이 html5인 경우 더이상 지원하지 않는 속성입니다. 따라서 html5에서는 summaryAuto도 지원하지 않습니다
summaryOnlyAuto
[default: false, true] 헤더 타이틀이 HTML 태그를 포함한 경우, 태그를 제외한 텍스트만 Summary 항목으로 지정 (옵션 설명) "true" : HTML 태그를 제외 "false" (기본 값): HTML 태그까지 포함 (관련 속성) summaryAuto = true
syncRowPositionOption
dataList의 rowPosition이 변경된 경우 해당 row를 선택할지 여부. [default: "none", "style"]
groupby 상태에서는 지원하지 않는다. (옵션 설명) "none" (기본 값) : dataList와 동기화되지 않음 "style" : focusMode가 "none"이 아닌 경우에 포커스 스타일만 적용할 뿐 dom element에 포커스를 이동시키지는 않음
syncScroll
다수의 GridView에 대해 동시에 세로 스크롤 이동
단, GridView의 행 수가 동일한 경우에만 동작 함 (관련 속성) syncScrollId
syncScrollId
스크롤을 동기화할 GridView의 아이디 리스트 (관련 속성) syncScroll = true (사용 예시) syncScrollId= "gridView1,gridView2" // "gridView1" 및 "gridView2"가 함께 스크롤 됨
tengeMask
[default: ""] dataType이 "tenge"인 경우나 changeCurrency() 함수를 사용하는 경우 화폐 표현식 (사용 예시) tengeMask = "# ###-00"
titleAuto
[default: false, true] 타이틀 자동 생성
헤더가 inputType = "text"이고,
셀의 inputType이 "text", "link", checkbox, button, radio, select(tableRender가 "ul"인 경우), secret)인 경우, 셀의 타이틀 자동 생성 (사용 예) 헤더의 타이틀이 "name1"이고 inputType="text"이고 (1) 셀 데이터가 "1"인 경우, 자동 생성되는 셀의 타이틀 속성 값: "name1 1" (2) 셀의 데이터가 ""인 경우, 자동 생성되는 셀의 타이틀 속성 값: "name1 text"
titleFormatter
[default: false, true] 타이틀 내용을 변경할 사용자 함수 (웹 접근성 지원용)
헤더가 inputType이 "text"이고,
셀의 inputType이 "text" 혹은 link, checkbox, button, radio, select(tableRender가 "ul"인 경우), secret)인 경우, 사용자 정의한 값을 타이틀 속성으로 사용
tooltipDisplay
[default: false, true] 셀의 데이터가 모두 표시되지 않는 경우 툴팁 표시 여부
tooltipDisplayColumn
[default: false, true] 데이터가 모두 표시되지 않는 경우 특정 컬럼만 툴팁을 표시할 컬럼을 지정 (관련 속성) tooltipDisplay = true
(사용 예시) tooltipDisplayColumn = "col1,col2"; // "col1" 및 "col2" 컬럼에서는 데이터가 모두 표시되지 않는 경우 툴립이 표시됨
tooltipFormatter
바디의 툴팁 내용을 변경할 사용자 함수 (함수 설명) 매개변수 : rowIndex, colIndex, label, isOverflow, type 반환값 : 툴팁에 표시할 문자열 (관련 속성) tooltipDisplay = true
tooltipFormatterHeader
헤더의 툴팁 내용을 변경할 사용자 함수 (함수 설명) 매개변수 : colId, label 반환값 : 툴팁에 표시할 문자열
(관련 속성) tooltipHeader = "true"
tooltipHeader
[default: false, true] 헤더타이틀이 모두 표시되지 않는 경우 툴팁 표시 여부
기존의 툴팁 관련 속성이 tooltipDisplay 및 tooltipDisplayTime 등과 기능이 일치 (관련 속성) tooltipDisplay = "true" (또는) tooltipShowAlways="true"
tooltipHeaderShowAlways
[default: false, true] 헤더타이틀이 공백("")인 경우를 제외하고는 툴팁을 항상 표시할지의 여부 (옵션 설명) "true": 데이터가 공백("")인 경우를 제외하고는 항상 툴팁을 표시 "false" (기본 값): 헤더 텍스트가 잘리지 않은 경우, 툴팁을 표시하지 않음 (관련 속성) tooltipHeader = "true" tooltipFormatterHeader
tooltipHideInputType
[default: ""] 툴팁을 표시하지 않을 컬럼의 inputType을 지정
여러 inputType을 지정할 경우 콤마(",")로 구분하여 정의 (관련 속성) tooltipDisplay (사용 예시) tooltipHideInputType="radio,checkbox" // inputType이 "radio" 또는 "checkbox"인 컬럼에서는 툴팁이 표시되지 않음
tooltipPositionX
[default: 20] 셀의 좌측 끝점을 기점으로 툴팁이 표시될 Y(세로) 좌표 (단위: px) (참고 사항) 수식과 정의어를 사용할 수 있음 cellWidth : 셀의 너비
(사용 예시) cellWidth+3: 셀의 우측의 3px 아래 위치
tooltipPositionY
[default: 3+cellHeight] 셀의 좌측 상단을 기점으로 툴팁이 표시될 X(가로) 좌표 (단위: px) (참고 사항) 수식과 정의어를 사용할 수 있음 cellHeight : 셀의 높이
(사용 예시) cellHeight+3: 셀의 하단의 3px 아래 위치
tooltipShowAlways
[default: false, true] 데이터가 공백("")인 경우를 제외하고는 툴팁을 항상 표시할지의 여부 (관련 속성) tooltipDisplay = true
tooltipShowAlwaysColumns
[default: ""] tooltipDisplay가 true인 경우 데이터가 공백("")인 경우를 제외하고는 툴팁을 항상 표시할 컬럼을 지정 (관련 속성) tooltipDisplay (사용 예시) tooltipShowAlwaysColumns = "col1,col2" // "col1" 및 "col2" 컬럼에서는 항상 툴립이 표시됨
useCtrlKey
[default: true, false] Ctrl 키를 이용하여 복수 셀의 선택 허용 여부
useCtrlOnMultisort
[default: true, false] 다중 정렬을 위해 Ctrl 키를 통한 복수의 컬럼 선택을 허용 (옵션 설명) true (기본 값) : Ctrl 키를 누른 상태로 복수의 컬럼 선택이 가능 false : Ctrl 키를 누르지 않아도 복수의 컬럼 선택이 가능
useDataDragDropGuideLine
[default: true, false] 데이터 드래그-앤-드롭시 가이드라인 보여줄지 여부 설정 (관련 속성) dataDragDrop="true"
useFilterList
[default: false, true] 필터링 대상 값을 목록으로 표시 (이 때 목록의 첫번째 항목에 "사용자 필터"를 표시)
사용자가 "사용자 필터"를 클릭하면 사용자 지정 필터 팝업 창이 표시됨 (옵션 설명) "true" : "사용자 필터"를 포함한 필터링 대상 값을 목록으로 표시 "false" (기본 값): 필터링 대상 값을 목록으로 표시하지 않음
(관련 속성) GridView 컬럼(gridView.column)의 useFilter="true"인 경우 적용 가능
useFilterListSync
[default: false, true] DataList의 함수를 통해 필터링한 경우, 필터 목록에 표시 여부 (옵션 설명) "true" : setFilter() 및 setColumnFilter() 등의 DataList 함수가 수행한 필터 정보를 표시 "false" (기본 값): DataList 함수가 수행한 필터 정보를 표시하지 않음
(관련 속성) useFilterList="true"인 경우 적용 가능
useFilterSearch
[default: false, true] 사용자 입력으로 필터 기능 사용 여부 (관련 속성) useFilterList="true"인 경우 적용 가능
useHeaderContextMenu
[default: false, true] 헤더 컨텍스트 메뉴 사용 여부
useLocale
[default: false, true] 라벨값을 다국어 키를 이용하여 표현하여 다국어의 사용이 가능하도록 설정 (세부 내용은 다국어 설정 가이드 - 클라이언트 편을 참고) (옵션 설명) "false" (기본 값) : 다국어 키를 이용하지 않음 "true" : 다국어 키를 이용하여 다국어 지원
useNoResultMessageURL
gridview별로 noResultMessage를 변경할 수 있는 noResultMessageURL을 사용 할지 여부 [default: false, true]
userData1
사용자 정의 데이터 속성으로 API를 통해 설정한 값을 얻어올 수 있음 (관련 함수) getUserData();
// 속성 값 얻어오기 예시 getUserData("userData1");
userData2
사용자 정의 데이터 속성으로 API를 통해 설정한 값을 얻어올 수 있음 (관련 함수) getUserData();
// 속성 값 얻어오기 예시 getUserData("userData2");
userData3
사용자 정의 데이터 속성으로 API를 통해 설정한 값을 얻어올 수 있음 (관련 함수) getUserData();
// 속성 값 얻어오기 예시 getUserData("userData3");
useShiftKey
[default: false, true] Shift 키를 이용하여 복수 셀의 선택 허용 여부
useShiftKeyCheck
shift 키를 누른 상태에서 첫번째 체크박스와 마지막 체크박스를 체크했을 때, 사이에 있는 체크박스들이 모두 체크상태로 변경 되는 기능 [default: false, true]
useStartEndDiv
[default: true, false] senseReader가 true인 경우 웹접근성용 Tag(start div, end div)를 사용할지 여부
viewChangeAfterEdit
[default: false, true] 이벤트의 순서를 항상 onviewchange() 이후에 onafteredit()가 발생하도록 지정하는 속성
visibleRowNum
화면에 표현할 행의 수 (부분합을 제외)
"all"로 설정 시 모든 행이 스크롤 없이 표시됨
visibleRowNumFix
[default: false, true] 초기 로딩시점에 높이를 visibleRowNum 또는 initFixedHeightByRowNum의 설정 값에 해당하는 크기만큼 자동으로 늘려주는 설정 (관련 속성) visibleRowNum initFixedHeightByRowNum
wheelRows
[default: 3] 마우스 휠을 이용하여 세로 스크롤이 이동 될 때 한번 이동하는 행의 수
wheelStop
[default: false, true] 브라우저에 스크롤이 있을 경우, GridView의 스크롤이 맨 아래로 내려가거나 스크롤이 없을 경우 GridView 위에서 마우스 휠을 해도 브라우저 스크롤을 움직이지 않음

Event Detail

onaftercolumnmove
컬럼의 이동이 발생한 직후 발생 (관련 속성) columnMove="true"
Parameter
nametypedescription
infoObject컬럼의 이동에 관한 데이터 정보 <Number> info.startColumnIndex : 컬럼의 이동을 시작한 컬럼의 인덱스(화면기준) <String> info.startColumnID : 컬럼의 이동을 시작한 컬럼의 아이디 <Number> info.endColumnID : 컬럼의 이동이 끝나는 지점(startColumn의 왼쪽 위치)에 있는 컬럼의 아이디 <Number> info.endColumnIndex : 컬럼의 이동이 끝나는 지점(startColumn의 왼쪽 위치)에 있는 컬럼의 인덱스
Sample
scwin.grd_gridView1_onaftercolumnmove = function(info) { console.log("[info.startColumnIndex]="+info.startColumnIndex); console.log("[info.startColumnID]="+info.startColumnID); console.log("[info.endColumnID]="+info.endColumnID ); console.log("[info.endColumnIndex]="+info.endColumnIndex); };
onaftercolumnresize
[default: false, true] 컬럼 리사이즈 직후 발생
Parameter
nametypedescription
colIndexNumber리사이즈 대상 컬럼의 인덱스
oldWidthNumber리사이즈 전의 컬럼 너비 (단위 px)
newWidthNumber리사이즈 후의 컬럼 너비 (단위 px)
Sample
scwin.grd_gridView1_onaftercolumnresize = function (colIndex, oldWidth, newWidth) { console.log("[colIndex]="+colIndex); console.log("[oldWidth]="+oldWidth); console.log("[newWidth]="+newWidth); };
onafteredit
셀의 편집모드가 종료되어 포커스가 빠져나온 경우에 발생 (oneditend 이벤트 이후 발생)
Parameter
nametypedescription
rowNumber셀의 행 인덱스
colNumber셀의 열 인덱스
valueString셀의 입력된 값
Sample
scwin.grd_gridView1_onafteredit = function (row, col, value) { console.log("[row]="+row); console.log("[col]="+col); console.log("[value]="+value); };
onbeforecolumnmove
컬럼의 이동이 발생하기 직전에 발생
Parameter
nametypedescription
infoObject컬럼의 이동에 관한 데이터 정보 <Number> info.startColumnIndex : 컬럼의 이동을 시작한 컬럼의 인덱스 (화면기준) <String> info.startColumnID : 컬럼의 이동을 시작한 컬럼의 아이디 <Number> info.endColumnID : 컬럼의 이동이 끝나는 지점에 있는 컬럼(startColumn의 왼쪽 위치)의 아이디 <Number> info.endColumnIndex : 컬럼의 이동이 끝나는 지점에 있는 컬럼(startColumn의 왼쪽 위치)의 인덱스
Sample
scwin.grd_gridView1_onbeforecolumnmove = function(info) { console.log("[info.startColumnIndex]="+info.startColumnIndex); console.log("[info.startColumnID]="+info.startColumnID); console.log("[info.endColumnID]="+info.endColumnID ); console.log("[info.endColumnIndex]="+info.endColumnIndex); };
onbeforeedit
셀의 편집모드로 들어가기 전에 발생
Parameter
nametypedescription
rowNumber셀의 행 인덱스
colNumber셀의 열 인덱스 (config.xml에서 colIdToColIndex 속성을 true로 설정해야 함)
valueString셀의 입력된 값
Sample
scwin.grd_gridView1_onbeforeedit = function (row, col, value) { console.log("[row]="+row); console.log("[col]="+col); console.log("[value]="+value); };
onbeforesort
컬럼 정렬 직전에 발생하며, 정렬 여부 반환
단, sortOrder가 1인 경우 오름차순, -1인 경우 내림차순, 0인 경우에는 정렬 여부 체크하지 않음
Parameter
nametypedescription
sortInfoObject컬럼의 정렬에 관한 데이터 정보 <Number> sortInfo.headerId : 정렬 대상 컬럼의 헤더의 아이디 <Number> sortInfo.bodyColId : 정렬 대상 컬럼의 바디의 아이디 <Number> sortInfo.sortOrder : 오름차순, 내림차순, 초기화여부
Sample
//컬럼의 정렬에 대한 데이터 정보 예시 headerId : "address1" (String 객체) bodyColId : "col2" (String 객체) sortOrder : 1 (오름차순)
onblankclick
GridView 영역 내의 빈 화면을 클릭할 때 발생
Parameter
nametypedescription
eObjectevent 객체
onbodymouseout
GridView 내의 바디에서 마우스가 벗어난 경우 발생
Parameter
nametypedescription
infoObject마우스 오버와 관련된 데이터 정보 <Number> info.rowIndex : 마지막으로 마우스가 오버된 셀의 행 인덱스로, displayRowIndex를 반환 (displayRowIndex란 화면에 현재 보이는 GridView를 기준으로 계산한 행의 인덱스를 의미함) <Number> info.colIndex : 마지막으로 마우스가 오버된 셀의 컬럼 인덱스
Sample
<script type="javascript" ev:event="onbodymouseout( info )"><![CDATA[ alert(info.rowIndex); alert(info.colIndex); ]]></script>
onbodymouseover
그리드의 바디에 마우스가 오버된 경우 발생
Parameter
nametypedescription
infoObject마우스 오버와 관련된 데이터 정보 반환 <Number> info.rowIndex : 마우스 오버가 일어난 셀의 행 인덱스로, displayRowIndex를 반환 (displayRowIndex란 화면에 현재 보이는 그리드뷰를 기준으로 계산한 행 인덱스를 의미함) <Number> info.colIndex : 마우스 오버가 일어난 셀의 컬럼 인덱스
Sample
<script type="javascript" ev:event="onbodymouseover( info )"><![CDATA[ alert(info.rowIndex); alert(info.colIndex); // 마우스가 오버된 셀의 행 인덱스와 컬럼 인덱스가 alert됨 ]]></script>
oncellclick
셀이 클릭된 경우 발생
oncelldblclick과 함께 사용하는 경우 oncellclick이 2회 발생한 이후에 oncelldblclick이 발생
더블클릭이 발생하려면 반드시 클릭이 2회 발생해야 하므로 더블클릭과 클릭을 별개의 동작으로 구분하여 이벤트를 처리할 수 없음
Parameter
nametypedescription
rowNumber클릭된 셀의 행 인덱스
colNumber클릭된 셀의 컬럼 인덱스
colIdString클릭된 셀의 컬럼 아이디
oncelldblclick
셀이 더블 클릭된 경우 발생
oncellclick과 함께 사용하는 경우 oncellclick이 2회 발생한 이후에 oncelldblclick이 발생
더블클릭이 발생하려면 반드시 클릭이 2회 발생해야 하므로 더블클릭과 클릭을 별개의 동작으로 구분하여 이벤트를 처리할 수 없음
Parameter
nametypedescription
rowNumber클릭된 셀의 행 인덱스
colNumber클릭된 셀의 컬럼 인덱스
colIdString클릭된 셀의 컬럼 아이디
oncellindexchange
방향키 또는 마우스를 이용해 선택한 셀이 변경되거나, API를 이용하여 셀에 포커스를 적용해 선택된 셀이 변경되었을 때 발생
Parameter
nametypedescription
rowNumber현재 선택된 셀의 행 인덱스
colNumber현재 선택된 셀의 컬럼 인덱스
oldRowNumber이전 셀의 행 인덱스
oldColNumber이전 셀의 컬럼 인덱스
oncolumnindexchange
방향키 또는 마우스를 이용해 선택한 셀의 컬럼이 변경되거나, API를 이용하여 셀에 포커스를 적용해 선택된 셀의 컬럼이 변경되었을 때 발생
Parameter
nametypedescription
colNumber현재 선택된 셀의 컬럼 인덱스
oldColNumber이전 컬럼 인덱스
oncolumnwidthchange
컬럼 너비가 변하는 경우 발생
Parameter
nametypedescription
infoObject컬럼의 변경에 관한 정보 <Number> info.columnIndex : 너비가 변한 컬럼의 인덱스 <String> info.columnID : 너비가 변한 컬럼의 아이디 <Number> info.oldWidth : 변경 전 컬럼 너비 <Number> info.newWidth : 변경 후 컬럼 너비
Sample
//컬럼의 너비가 변하는 경우 이벤트 발생하며 다음의 정보 반환 columnIndex : 3 columnId : "JOIN_DATE" (String 객체) oldWidth : 98 newWidth : 141
oncontextclick
context menu를 click할 때 발생.
Parameter
nametypedescription
rowIndexNumbercontext menu를 표시하기 위해 마우스 오른클릭한 셀의 행 index. 헤더인 경우 -1을 반환.
colIndexNumbercontext menu를 표시하기 위해 마우스 오른클릭한 셀의 열 index.
userMenuIdString클릭한 메뉴가 사용자 메뉴일 경우 이를 식별할 수 있는 ID.
isSystemMenuBoolean클릭한 메뉴가 시스템 메뉴인지 여부.
systemMenuString클릭한 메뉴가 시스템 메뉴일 경우 이를 식별할 수 있는 ID.
Sample
<w2:gridView id="gridView1" ev:oncontextclick="scwin.gridView1_oncontextclick" dataList="dataList1"> ... </w2:gridView> scwin.gridView1_oncontextclick = function(rowIndex, colIndex, userMenuId, isSystemMenu, systemMenu) { var logStr = "rowIndex=" + rowIndex + ", colIndex=" + colIndex + ", userMenuId=" + userMenuId + ", isSystemMenu=" + isSystemMenu + ", systemMenu=" + systemMenu; WebSquare.logger.printLog(logStr); console.log(logStr); }
oncontextopen
컨텍스트 메뉴가 표시될 때 발생
[SystemMenu 목록]
Group : 선택 컬럼 그룹
Ungroup : 선택 컬럼 그룹 해제
UngroupAll : 전체 그룹 해제
ColumnHide : 선택 컬럼 숨기기
ColumnShowAll : 전체 컬럼 숨기기 해제
ColumnFix : 선택 컬럼 틀고정
ColumnUnfixAll : 전체 컬럼 틀고정 취소
ColumnAdjustWidth : 선택 컬럼 크기 자동 맞추기
ColumnAdjustAuto : 전체 컬럼 크기 자동 맞추기
ColumnAdjustAutoNone : 컬럼 크기 자동 맞추기 해제
FoldAll : 전체 그룹 접기
UnfoldAll : 전체 그룹 펼치기
Parameter
nametypedescription
rowIndexNumber클릭된 셀의 행 인덱스. 헤더인 경우 -1을 반환
colIndexNumber클릭된 셀의 컬럼 인덱스
focusedCellArray바디의 포커스된 셀의 정보(행 인덱스, 컬럼 인덱스)를 담은 1차원 배열
infoJSON헤더인 경우 헤더 정보를 반환 <Boolean> info.isHeader : 클릭된 셀이 헤더인지 여부 <String> info.headerId : 클릭된 셀이 헤더인 경우 헤더의 아이디
Sample
<w2:gridView id="grd_gridView1" ev:oncontextopen="scwin.grd_gridView1_oncontextopen" dataList="dlt_dataList1"> ... </w2:gridView> scwin.grd_gridView1_oncontextopen = function(rowIndex, colIndex, focusedCell, info) { var logStr = "rowIndex=" + rowIndex + ", colIndex=" + colIndex + ", isHeader=" + info.isHeader + ", headerId=" + info.headerId; WebSquare.logger.printLog(logStr); console.log(logStr); }
oncustomcopy
복사 이벤트를 대체할 이벤트 정의
단, 기본 복사 이벤트를 대체하고 싶을 경우 해당 이벤트 함수가 false를 반환
Parameter
nametypedescription
eObjectEvent 객체
oncustompaste
붙여넣기 이벤트를 대체할 이벤트 정의
단, 기본 붙여넣기 이벤트를 대체하고 싶을 경우 해당 이벤트 함수가 false를 반환
Parameter
nametypedescription
eObjectEvent 객체
ondatadragover
dataDragDrop 옵션이 true일 때, 데이터를 드래그해서 다른 그리드에 올려놓는 순간 발생
데이터를 올려놓는 GridView에서 이벤트가 발생
Parameter
nametypedescription
fromIdString데이터의 드래그가 시작된 그리드의 아이디
fromRowIndexNumber데이터의 드래그가 시작된 행 인덱스
ondatadragstart
dataDragDrop 옵션이 true일때, 데이터를 드래그하면 발생
드래그를 시작하는 GridView에서 이벤트가 발생
Parameter
nametypedescription
rowIndexNumber드래그할 대상의 행 인덱스
ondatadrop
dataDragDrop 옵션이 true일때, 데이터를 다른 그리드에 드랍하면 발생
데이터가 드랍된 GridView에서 이벤트가 발생
Parameter
nametypedescription
infoObject드랍된 데이터 정보 <Number> info.fromId 데이터의 드래그가 시작된 그리드의 아이디 <Number> info.fromRowIndex 데이터의 드래그가 시작된 그리드의 행 인덱스 <Number> info.toRowIndex 데이터가 드랍된 그리드의 행 인덱스
Sample
//하나의 그리드에서 다른 그리드로 데이터를 드랍했을 때 이벤트가 발생하며 다음의 정보를 반환 fromId : "mf_grd_memberList" (String 객체) fromRowIndex : 3 toRowIndex : 2
ondateselect
inputType이 캘린더인 경우, 날짜 선택 시 발생
Parameter
nametypedescription
rowNumber수정되고 있는 셀의 행 인덱스
colNumber수정되고 있는 셀의 컬럼 인덱스
dateStrString선택한 날짜의 문자열
dateObjDate선택한 날짜의 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
nametypedescription
rowNumber셀의 행 인덱스
colNumber셀의 컬럼 인덱스
colIdString셀의 컬럼 아이디
Sample
//사용자가 (1,1)인 셀을 편집 중인 상태에서 더블클릭 시 발생 row : 1 col : 1 colId : "address"(String 객체)
oneditend
셀의 편집이 끝난 경우 발생하며, onafteredit보다 먼저 발생
Parameter
nametypedescription
rowNumber셀의 행 인덱스
colNumber셀의 컬럼 인덱스
valueString사용자가 입력한 값
Sample
//사용자가 (2,1)인 셀의 편집을 마친 후에 발생 row : 2 col : 1 value: "15000" (String 객체)
oneditkeydown
셀 편집할 때 키를 누른 경우 발생
Opera와 Firefox에서 2-byte짜리 문자(한글)를 입력할 때는 첫 입력시 또는 문자 조합이 완료된 후에만 발생
Parameter
nametypedescription
infoObject이벤트 발생한 셀의 정보 <Number> info.rowIndex : 셀의 행 인덱스로, displayRowIndex를 반환(displayRowIndex란 화면에 현재 보이는 그리드를 기준으로 계산한 행 인덱스를 의미함) <Number> info.colIndex : 셀의 컬럼 인덱스
Sample
<script ev:event="oneditkeydown( info )"><![CDATA[ alert(info.rowIndex + "," + info.colIndex); // 행의 값과 열의 값이 alert됨 ]]></script>
oneditkeyup
키보드에서 키를 눌렀다 놓았을 때 발생
inputType이 text, textArea, textImage, secret, calendar인 경우에만 지원하는 이벤트
Parameter
nametypedescription
infoJSON이벤트 발생 정보 <Number> info.rowIndex : 이벤트가 발생한 셀의 행 인덱스 <Number> info.colIndex : 이벤트가 발생한 셀의 컬럼 인덱스 <String> info.colID : 이벤트가 발생한 셀의 컬럼 아이디 <String> info.oldValue : 키가 입력되기 전의 값 <String> info.newValue : 키가 입력된 후의 값 <String> info.inputType : 이벤트가 발생한 셀의 inputType <Number> info.keyCode : 입력된 키의 코드값
Sample
<w2:gridView id="grd_gridView1" ev:oneditkeyup="scwin.grd_gridView1_oneditkeyup" dataList="dlt_dataList1"> ... </w2:gridView> scwin.grd_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; logger.printLog(logStr); console.log(logStr); }
onfilereadend
그리드에 엑셀 업로드가 끝난 뒤 발생
Parameter
nametypedescription
valueString사용자가 업로드한 파일명
Sample
<script ev:event="onfilereadend( value )"><![CDATA[ //test.xls을 이용하여 엑셀 업로드 시 //value 예시 ) test.xls ]]></script>
onfooterclick
푸터를 클릭한 경우 발생
Parameter
nametypedescription
footerIdString클릭된 푸터의 셀의 아이디
ongroupby
groupby 영역으로 컬럼을 드래그했을 때 발생
groupby 관련 설정이 담긴 객체가 인자로 넘어옴
넘어온 인자에 groupbyHeader, groupbyFooter 속성을 추가로 정의한 다음, groupby(options) API를 수동으로 호출해야 동작함 (관련 속성) groupbyZone="true"
Parameter
nametypedescription
optionsObjectgroupby 관련 설정이 담겨있는 객체 <Boolean:N> options.closeGroup : 그룹핑 결과물 숨김 상태 <Boolean:N> options.rowNumHeader : rowNumVisible="true"인 경우, 전체 건수를 헤더에 표시 <Boolean:N> options.rowNumFooter : rowNumVisible="true"인 경우, 전체 건수를 푸터에 표시 <Boolean:N> options.rowStatusHeader : rowStatusVisible="true"인 경우, 전체 건수를 헤더에 표시 <Boolean:N> options.rowStatusFooter : rowStatusVisible="true"인 경우, 전체 건수를 푸터에 표시 <Object:N> options.groupbyHeader : 전체 건수를 헤더에 표현하는 방식 설정 <Object:N> options.groupbyFooter : 전체 건수를 푸터에 표현하는 방식 설정 <Boolean:N> options.showDisplayData : depthStr()에 의해 깊이(Depth) 정보 표시할 경우 데이터를 displayFormatter로 바꾼 값으로 표시 <Boolean:N> options.showOnlyLastDepth : depthStr()에 의해 깊이(Depth) 정보 표시할 경우 마지막 깊이(Depth)만 표시 <Array:N> options.sortIndex : 그룹핑의 기준이 될 컬럼 인덱스 <Array:N> options.sortOrder : 1로 설정되면 오름차순 정렬, -1로 설정되면 내림차순 정렬 <Boolean:N> options.hideHeader : 결과물의 숨김 상태 <Boolean:N> options.hideFooter : 결과물의 숨김 상태
Sample
scwin.grd_gridView1_ongroupby = function(options) { options.groupbyHeader = [ {inputType:"expression", expression:"toggle()+depthStr()"} ]; options.hideFooter = true; grd_gridView1.groupby(options); }
onheaderclick
헤더가 클릭된 경우 발생
Parameter
nametypedescription
headerIdString헤더의 아이디
onheaderdblclick
헤더가 더블클릭된 경우 발생
Parameter
nametypedescription
headerIdString헤더의 아이디
onheadermouseout
그리드의 헤더에 마우스가 아웃된 경우 발생
Parameter
nametypedescription
infoObject마우스 아웃되기 전과 후의 헤더의 아이디 <String> oldHeaderId 마우스가 빠져 나가기 전 헤더의 아이디 <String> newHeaderId 마우스가 그리드의 헤더에서 빠져 나간 후 마우스가 이동한 새로운 헤더의 아이디
Sample
<script type="javascript" ev:event="onheadermouseout( info )"><![CDATA[ console.log(info.oldHeaderId); console.log(info.newHeaderId); ]]></script>
onheadermouseover
그리드의 header에 마우스가 오버된 경우 발생.
Parameter
nametypedescription
infoObject마우스 오버된 header의 cell id와 header_id를 포함한 오브젝트를 반환한다. <String> id 마우스 오버된 header의 cell id <String> header_id 마우스 오버된 header의 header_id
Sample
<script type="javascript" ev:event="onheadermouseover( info )"><![CDATA[ console.log(info.id); console.log(info.header_id); ]]></script>
onheadertextimageclick
header의 inputType이 textImage인 경우 image가 클릭 된 경우 발생.
Parameter
nametypedescription
headerIdString클릭된 header의 id
headerValueString클릭된 header의 value
Sample
<script type="text/javascript" lazy="false"><![CDATA[ scwin.gridView1_onheadertextimageclick = function (headerId, headerValue) { console.log(headerId, headerValue); }; ]]></script> <w2:gridView ev:onheadertextimageclick="scwin.gridView1_onheadertextimageclick">
onkeydown
키보드에서 키를 눌렀을 때 발생
Parameter
nametypedescription
eObjectEvent 객체
onkeyup
키보드에서 키를 눌렀다 놓았을 때 발생
Parameter
nametypedescription
eObjectEvent 객체
onmonthselect
inputType이 캘린더인 경우 사용자가 캘린더에서 월(Month)을 변경 시에 발생
Parameter
nametypedescription
rowNumber수정되고 있는 셀의 행 인덱스
colNumber수정되고 있는 셀의 컬럼 인덱스
infoJSONoldValue, newValue를 포함한 JSON을 반환
Sample
//사용자가 02월에서 03월로 월을 변경한 경우 엔진에서 넘겨주는 매개변수 예시 row : 2 col : 1 info : {"oldValue":"2","newValue":"3"}
onrightbuttonclick
바디 영역의 셀에서 마우스 오른쪽 버튼으로 클릭한 경우 발생
Parameter
nametypedescription
rowNumber클릭된 셀의 행 인덱스
colNumber클릭된 셀의 컬럼 인덱스
onrowindexchange
방향키 또는 마우스를 이용하여 선택한 셀의 행이 변경되거나, API를 이용하여 셀에 포커스를 적용한 셀의 행이 변경되었을 때 발생
Parameter
nametypedescription
rowNumber현재 선택된 셀의 행 인덱스
oldRowNumber이전 행의 인덱스
onrownumclick
rowNum 컬럼이 클릭된 경우 발생 (관련 속성) focusDefaultColumn="true"
Parameter
nametypedescription
rowNumber셀의 행 인덱스
onrowstatusclick
rowStatus 컬럼이 클릭된 경우 발생 (관련 속성) focusDefaultColumn="true"
Parameter
nametypedescription
rowNumber셀의 행 인덱스
onscrollend
세로 스크롤이 하단에 닿을 때 발생
onscrollstart
세로 스크롤이 상단에 닿을 때 발생 (관련 속성) alwaysTriggerScrollStart="true"
onscrollx
가로 스크롤을 움직이는 경우 발생
onscrolly
세로 스크롤을 움직이는 경우 발생
onsort
sortable 속성이 적용된 헤더에서 클릭이나 더블클릭을 통하여 정렬방식이 변경되었을 경우 발생
onsubtotalclick
부분합이 클릭된 경우 발생하는 이벤트
Parameter
nametypedescription
infoJSON클릭한 부분합의 정보 <String> info.colID : 부분합의 컬럼 아이디 <Number> info.startRowIndex : 계산 대상의 첫 번째 행 인덱스 <Number> info.endRowIndex : 계산 대상의 마지막 행 인덱스 <Object> info.element : DOM 객체
onsubtotaldblclick
부분합이 더블클릭된 경우 발생하는 이벤트
Parameter
nametypedescription
infoJSON클릭한 부분합의 정보 <String> info.colID : 부분합의 컬럼 아이디 <Number> info.startRowIndex : 계산 대상의 첫 번째 행 인덱스 <Number> info.endRowIndex : 계산 대상의 마지막 행 인덱스 <Object> info.element : DOM 객체
ontextimageclick
inputType이 textImage인 경우 이미지가 클릭됐을 때 발생
Parameter
nametypedescription
rowNumber셀의 행 인덱스
colNumber셀의 열 인덱스
ontoggleclick
inputType이 드릴다운일 때, 토글버튼 클릭 시 발생
Parameter
nametypedescription
isCollapsedBoolean펼쳤는지 접었는지의 여부
rowIndexNumber셀의 행 인덱스
onviewchange
키보드 또는 마우스 조작을 통해 값이 변경된 경우 발생
스크립트를 통해 값이 변경된 경우에는 발생하지 않음 (native onchange 이벤트와 유사함)
Parameter
nametypedescription
infoObject이벤트 발생 정보 <Number> info.rowIndex : 셀의 행 인덱스로, displayRowIndex를 반환 (displayRowIndex란 화면에 현재 보이는 GridView기준으로 계산한 행 인덱스를 의미) <Number> info.colIndex : 셀의 컬럼 인덱스 <String> info.oldValue : 셀의 변경되기 전의 값 <String> info.newValue : 셀의 변경된 값 <String> info.colId : 셀의 컬럼 아이디
Sample
<script ev:event="onviewchange( info )"><![CDATA[ var targetRow = info.rowIndex; var targetColumn = info.columnIndex; var oldValue = info.oldValue; var newValue = info.newValue; console.log("targetRow: " + targetRow + ", targetColumn: " + targetColumn + ", oldValue: " + oldValue + ", newValue: " + newValue); ]]></script>
onyearselect
inputType이 캘린더인 경우 날짜 선택 시 발생
Parameter
nametypedescription
rowNumber수정되고 있는 셀의 행 인덱스
colNumber수정되고 있는 셀의 컬럼 인덱스
infoJSONoldValue, newValue를 포함한 JSON을 반환
Sample
//사용자가 2002년을 선택한 경우 엔진에서 넘겨주는 매개변수 예시 row : 2 col : 1 info : {"oldValue":2020,"newValue":2002}

Method Detail

advancedExcelDownload( options , infoArr )
그리드의 데이터를 엑셀 파일로 저장 (JDK 1.5이상에서 사용 가능)
Parameter
nametyperequireddescription
optionsObjectYJSON 형태로 저장된 그리드의 엑셀 다운로드 옵션
파일 정보 관련 옵션 <String:Y> options.fileName : [default: excel.xls] 다운로드하려는 파일의 이름 <String:Y> options.extension : [default: ""] extension 설정. (xls, xlsx) fileName에 확장자를 포함하지 않을 경우 extension을 설정하여 다운로드 파일의 확장자를 지정할 수 있음 <String:N> options.sheetName : [default: sheet] 엑셀의 시트 이름 다운로드 요청 관련 옵션 <Number:N> options.timeout : [default: 없음] 요청 최대 대기시간 (단위: ms) 타임아웃 내에 응답이 없을 경우, 다운로드 요청을 실패 처리 <Number:N> options.checkInterval : [default: 1000] 응답 확인 간격 (단위: ms) <Function:N> options.onSuccessCallback : [default: 없음] 요청 성공 시 호출할 콜백 함수 <Function:N> options.onFailureCallback : [default: 없음] 요청 실패 시 호출할 콜백 함수 <String:N> options.lazyInfoArr : [default: false] infoArr 출력 작업의 순서 ("false"인 경우 가장 먼저 출력, "true"인 경우 가장 마지막에 출력) <String:N> options.decimal : [default: 없음] "auto"인 경우, 데이터 타입(dataType)이 "number" 혹은 "bigDecimal"인 데이터는 displayFormat을 적용하지 않고 엔진 내부에서 소수점자리를 계산하여 형식을 지정 <String:N> options.useXHR : [default: 없음] 다운로드 요청을 AJAX 방식으로 전송할지 여부 (true 설정 시 AJAX 방식으로 전송) 다운로드 데이터 관련 옵션 <String:N> options.type : [default: 1] 사용할 데이터. GridView 컬럼의 inputType이 "select", "autoComplete" 혹은 "checkcombobox"인 경우 해당. 0: 데이터 값 사용. 1: 라벨 값 사용. 2: inputType이 "select", "checkcombobox", "autoComplete"인 경우 데이터 값 사용 그 외 라벨 값 사용 <String:N> options.convertIndex : [default: 없음] 타입이 "0" 또는 "1"인 경우, 특정 컬럼만 타입이 "1" 또는 "0"인 데이터로 다운로드. 타입이 "1"인 상태에서 convertIndex이 "0, 2"인 경우, 인덱스가 0, 2인 컬럼은 타입이 "0"인 상태로 다운로드 <String:N> options.removeColumns : [default: 없음] 다운로드 시 엑셀에서 삭제하려는 컬럼의 인덱스(여러 개일 경우 ,로 구분) <String:N> options.removeHeaderRows : [default: 없음] 다운로드 시 엑셀에서 삭제하려는 헤더의 행 인덱스 (여러 개일 경우 ,로 구분) <String:N> options.foldColumns : [default: 없음] 다운로드 시 엑셀에서 접으려고 하는 컬럼의 인덱스 (여러 개일 경우 ,로 구분) <String:N> options.useHeaderCheckBoxLabel : [default: false] 다운로드 시 헤더가 "checkbox"인 경우 체크한 값(Value) 대신 라벨을 출력할지 여부 ("true"는 라벨을 출력, "false"는 체크한 값(Value) 출력) <String:N> options.separator : [default: ,] 다운로드 시 서버로 데이터 전송할 때, 데이터를 구분짓는 구분자 <Number:N> options.subTotalScale : [default: -1] 다운로드 시 부분합의 평균 계산할 때 소수점 자릿수를 지정 <String:N> options.subTotalRoundingMode : [default: 없음] 부분합의 평균 계산 시 반올림 방법을 지정 ("CEILING","FLOOR","HALF_UP") <String:N> options.useSubTotalData : [default: 없음] 기본은 서버에서 계산된 결과를 출력하지만, useSubTotalData이 "true" 시 브라우저에 출력된 부분합 데이터를 출력 <String:N> options.useDataFormat : [default: 없음] "true"인 경우 헤더의 데이터 타입(dataType)에 따라 엑셀 파일에 표시 형식을 출력. 데이터 타입(dataType)이 "text"인 셀은 엑셀의 표시 형식에 '텍스트' 출력, 데이터 타입(dataType)이 "number" 혹은 "bigDecimal" 셀은 "숫자" 출력 <String:N> options.useHeaderDataFormat : [default: 없음] "true"인 경우 헤더의 dataType에 따라 엑셀 파일에 표시 형식을 출력. dataType="text"인 셀은 엑셀의 표시형식에 '텍스트' 출력, dataType="number" 혹은 "bigDecimal" 셀은 "숫자" 출력 <String:N> options.customToDataType : [default: 없음] 해당 옵션이 "true"일 때, inputType이 "custom"인 경우 데이터 타입(dataType)에 따라 엑셀 파일에 표시 형식을 출력. 데이터 타입(dataType)이 "text"인 셀은 엑셀의 표시형식에 텍스트 출력, 데이터 타입(dataType)이 "number" 혹은 "bigDecimal" 셀은 "숫자" 출력 <String:N> options.indent : [default: 0] 데이터 타입(dataType)이 드릴다운인 경우, indent 표시를 위한 공백 삽입 개수 Excel 파일 관련 옵션 <String:N> options.rowHeight : [default: 없음] 엑셀 파일로 다운로드 할 때 엑셀의 셀 높이 (단위: pixel) <String:N> options.pwd : [default: 없음] 엑셀 파일로 다운로드할 때 비밀번호를 설정. 사용 조건: (1) 비밀번호는 BASE64로 인코딩후 전송해야 함. (2) websquare.xml에 을 설정해야 함. (3) POI 3.10으로 업그레이드 필요 <String:N> options.maxCellCount : [default: 없음] 엑셀 다운로드를 제한할 셀 개수 (예: "1000" : 셀의 갯수가 1000개를 초과할 경우 서버로 요청을 보내지 않음) <String:N> options.maxRowCount : [default: 없음] 엑셀 다운로드를 제한할 행 개수 (예: "1000" : 행의 갯수가 1000개를 초과할 경우 서버로 요청을 보내지 않음) Excel 파일 스타일 관련 옵션 <String:N> options.displayGridlines : [default: true] 엑셀 파일 전체 셀의 눈금선 제거 유무 <Number:N> options.startRowIndex : [default: 0] 엑셀 파일에서 그리드의 데이터가 시작되는 행의 인덱스 (헤더 포함) <Number:N> options.startColumnIndex : [default: 0] 엑셀 파일에서 그리드의 데이터가 시작되는 컬럼의 인덱스 (헤더 포함) <String:N> options.useStyle : [default: false] 다운로드 시 CSS를 제외한, 스타일을 엑셀에도 적용할지 여부 (배경색, 폰트) <String:N> options.setFontSize : [default: false] useStyle이 "true"인 경우 헤더, 바디, 부분합, 푸터의 fontSize 속성이 설정되어 있는 경우 설정 적용 유무 <String:N> options.freezePane : [default: ""] 틀 고정을 위한 좌표값 및 좌표값의 오픈셋 (예: freezePane="3, 4" X축 3, Y축 4에서 틀고정, freezePane="0, 1, 0, 5" X축 0, Y축 1에서 X축으로 0, Y축으로 5로 틀 고정) <String:N> options.autoSizeColumn : [default: false] 너비 자동 맞춤 설정 유무 <Boolean:N> options.useClass : [default: false] 클래스 설정 시 클래스 내용 엑셀 적용 유무 Excel 파일 스타일 관련 옵션 - 헤더 <String:N> options.headerColor : [default: #33CCCC] 엑셀 파일에서 그리드의 헤더 색상 <String:N> options.headerFontName : [default: 맑은 고딕] 엑셀 파일에서 그리드의 헤더의 폰트 이름 <String:N> options.headerFontSize : [default: 11] 엑셀 파일에서 그리드의 헤더의 폰트 크기 <String:N> options.headerFontColor : [default: 없음] 엑셀 파일에서 그리드의 헤더의 폰트 색상 <String:N> options.headerFontBold : [default: false] 엑셀 파일에서 그리드의 헤더의 진하게(Bold) 적용 Excel 파일 스타일 관련 옵션 - 바디 <String:N> options.bodyColor : [default: #FFFFFF] 엑셀 파일에서 바디의 색상 <String:N> options.bodyFontName : [default: 맑은 고딕] 엑셀 파일에서 바디의 폰트 이름 <String:N> options.bodyFontSize : [default: 11] 엑셀 파일에서 바디의 폰트 크기 <String:N> options.bodyFontColor : [default: 없음] 엑셀 파일에서 바디의 폰트 색상 <String:N> options.bodyFontBold : [default: 없음] 엑셀 파일에서 바디의 진하게(Bold) 적용 유무 Excel 파일 스타일 관련 옵션 - 부분합 <String:N> options.subTotalColor : [default: #CCFFCC] 엑셀 파일에서 부분합의 색상 <String:N> options.subTotalFontName : [default: 맑은 고딕] 엑셀 파일에서 부분합의 폰트 이름 <String:N> options.subTotalFontSize : [default: 11] 엑셀 파일에서 부분합의 폰트 사이즈 <String:N> options.subTotalFontColor : [default: 없음] 엑셀 파일에서 부분합의 폰트 색상 <String:N> options.subTotalFontBold : [default: 없음] 엑셀 파일에서 부분합의 진하게(Bold) 적용 유무 Excel 파일 스타일 관련 옵션 - Footer <String:N> options.footerColor : [default: #008000] 엑셀 파일에서 푸터의 색상 <String:N> options.footerFontName : [default: 맑은 고딕] 엑셀 파일에서 푸터의 폰트 이름 <String:N> options.footerFontSize : [default: 11] 엑셀 파일에서 푸터의 폰트 사이즈 <String:N> options.footerFontColor : [default: 없음] 엑셀 파일에서 푸터의 폰트 색상 <String:N> options.footerFontBold : [default: 없음] 엑셀 파일에서 푸터의 진하게(Bold) 적용 유무 Excel 파일 스타일 관련 옵션 - 홀/짝수 줄 <String:N> options.oddRowBackgroundColor : [default: 없음] 엑셀 파일에서 바디의 홀수 줄의 배경색 <String:N> options.evenRowBackgroundColor : [default: 없음] 엑셀 파일에서 바디의 짝수 줄의 배경색 Excel 파일 스타일 관련 옵션 - groupby의 헤더와 푸터 <String:N> options.groupbyColor : [default: 없음] 엑셀 파일에서 groupby의 헤더, 푸터의 배경색 (계층 표현시 콤마(,) 구분자로 생삭 지정) <String:N> options.groupbyFontName : [default: 없음] 엑셀 파일에서 groupby의 헤더, 푸터의 폰트 이름 <String:N> options.groupbyFontSize : [default: 없음] 엑셀 파일에서 groupby의 헤더, 푸터의 폰트 사이즈 <String:N> options.groupbyFontColor : [default: 없음] 엑셀 파일에서 groupby의 헤더, 푸터의 폰트 색상 행 번호 표시 컬럼 관련 옵션 <String:N> options.rowNumVisible : [default: false] 행 번호 표시 컬럼의 유무 <String:N> options.rowNumHeaderValue : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 헤더 출력값 행 번호 표시 컬럼 스타일 관련 옵션 - 헤더 <String:N> options.rowNumHeaderColor : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 헤더 배경색 <String:N> options.rowNumHeaderFontName : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 헤더 폰트 이름 <String:N> options.rowNumHeaderFontSize : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 헤더 폰트 크기 <String:N> options.rowNumHeaderFontColor : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 헤더 폰트 색상 행 번호 표시 컬럼 스타일 관련 옵션 - 바디 <String:N> options.rowNumBodyColor : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 바디 배경색 <String:N> options.rowNumBodyFontName : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 바디 폰트 이름 <String:N> options.rowNumBodyFontSize : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 바디 폰트 크기 <String:N> options.rowNumBodyFontColor : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 바디 폰트 색상 행 번호 표시 컬럼 스타일 관련 옵션 - 푸터 <String:N> options.rowNumFooterColor : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 푸터 배경색 <String:N> options.rowNumFooterFontName : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 푸터 폰트 이름 <String:N> options.rowNumFooterFontSize : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 푸터 폰트 크기 <String:N> options.rowNumFooterFontColor : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 푸터 폰트 색상 행 번호 표시 컬럼 스타일 관련 옵션 - 부분합 <String:N> options.rowNumSubTotalColor : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 부분합 배경색 <String:N> options.rowNumSubTotalFontName : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 부분합 폰트 이름 <String:N> options.rowNumSubTotalFontSize : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 부분합 폰트 크기 <String:N> options.rowNumSubTotalFontColor : [default: 없음] rowNumVisible이 "true"인 경우 행 번호 표시 컬럼의 부분합 폰트 색상 상태창 관련 옵션 <Boolean:N> options.showProcess : [default: true] 다운로드 시 프로세스 창을 보여줄지 여부 <Boolean:N> options.showConfirm : [default: false] 다운로드 확인창을 표시 여부 ("true"인 경우 사용자가 윈도우 버튼을 클릭해야 다운로드 시작. massStorage는 자동으로 "true"로 설정) <String:N> options.processMsg : [default: download...] 프로세스 창에 표시할 문자열 대용량 다운로드 관련 옵션 <Boolean:N> options.massStorage : [default: true] 대용량 다운로드 여부 (이 옵션을 "true"로 하고 showConfirm을 "false"인 경우, IE에서 신뢰할만한 사이트를 체크하는 옵션이 표시됨) <String:N> options.dataProvider : [default: 없음] 대량 데이터 처리 및 사용자 데이터를 가공할 수 있는 프로바이더(Provider) 패키지 <String:N> options.splitProvider : [default: 없음] 대량 데이터 처리를 위해 데이터를 분할해서 처리할 수 있는 프로바이더(Provider) 패키지 <Boolean:N> options.numberToText : [default: false] numberExtraction이 "true"이고 데이터 타입(dataType)이 "number"로 설정된 컬럼의 데이터를 엑셀 파일로 다운로드할 때, 콤마(,) 등 포맷에 포함된 기호를 유지 <String:N> options.providerRequestXml : [default: 없음] 프로바이더(Provider) 내부에서 사용할 XML 문자열 <String:N> options.userDataXml : [default: 없음] 사용자가 서버 모듈 개발 시 필요한 데이터를 전송 할 수 있는 변수 줄바꿈 관련 옵션 <Boolean:N> options.bodyWordwrap : [default: false] 다운로드 시 바디의 줄 바꿈 기능 <Boolean:N> options.subtotalWordwrap : [default: false] 다운로드 시 부분합의 줄 바꿈 기능 <Boolean:N> options.footerWordwrap : [default: false] 다운로드 시 푸터의 줄 바꿈 기능 출력 황목 관련 옵션 <String:N> options.useHeader : [default: true] 다운로드 시 헤더를 출력할지 여부 ("true"인 경우 출력, "false"인 경우 미출력) <String:N> options.useSubTotal : [default: false] 다운로드 시 부분합을 출력할지 여부 ("true"인 경우 출력, "false"인 경우 미출력) <String:N> options.useFooter : [default: true] 다운로드 시 푸터를 출력할지 여부 ("true"인 경우 출력, "false"인 경우 미출력) <String:N> options.footerTop : [default: 없음] 다운로드 시 푸터를 바디 영역 위에 출력할지 여부 ("true"인 경우 바디 영역에 출력, "false"인 경우 푸터 영역에 출력) 병합 상태 관련 옵션 <String:N> options.colMerge : [default: false] 컬럼 기준으로 병합된 컬럼을 병합해서 출력 할 지 여부 <String:N> options.colMergeValue : [default: false] 컬럼 기준으로 병합된 컬럼을 다운로드한 엑셀 파일에서 병합을 취소할 경우 모든 셀에 데이터를 채우는 기능, mergeCell 설정시 미지원 ("true"인 경우 병합 해제된 모든 셀에 데이터를 채움. "false"인 경우 첫 행이나 첫 열에만 데이터가 표시됨) <String:N> options.colMergeTextAlign : [default: center] 병합된 컬럼의 텍스트 정렬 설정 (bottom, center, top 설정) <String:N> options.mergeCell : [default: false] 셀 병합 시, 엑셀에도 동일하게 병합되어 다운로드 할지 여부 컬럼 이동 관련 옵션 <String:N> options.columnMove : [default: false] 컬럼 이동 시 이동된 상태로 다운로드 유무 ("true"인경우 컬럼이동 순서대로 출력) <String:N> options.columnOrder : [default: 없음] 엑셀 다운로드 시 다운로드되는 컬럼 순서를 지정할 수 있는 속성 (ex) "0, 3, 2, 1"로 지정 시 지정한 순서로 다운로드됨) <String:N> options.columnMoveWithFooter : [default: 없음] 컬럼 이동 시 푸터 영역이 이동된 상태로 다운로드 유무 필터 관련 옵션 <String:N> options.headerAutoFilter : [default: false] 헤더에 필터를 적용할지 여부 <String:N> options.filterRowIndex : [default: -1] 필터를 적용할 헤더의 행 인덱스 <String:N> options.trim : [default: false] gridView 데이터를 좌우 공백 적용 유무 (true 설정 시, 공백 제거) * 차트 관련 옵션 <Object:N> options.chart JSON 형태로 저장된 차트 관련 설정 <String:N> options.chart.chartName : [default: line] 차트 유형 ("bar", "line", "area", "pie") <String:N> options.chart.title : [default: ""] 차트 타이틀 <String:N> options.chart.xTitle : [default: ""] X축 타이틀 <String:N> options.chart.yTitle : [default: ""] Y축 타이틀 <Number:N> options.chart.startRowIndex : [default: 0] 차트 출력 시작 행 인덱스 <Number:N> options.chart.startColIndex : [default: 0] 차트 출력 시작 컬럼 인덱스 <Number:N> options.chart.endRowIndex : [default: 0] 차트 출력 끝 행 인덱스 <Number:N> options.chart.endColIndex : [default: 0] 차트 출력 끝 컬럼 인덱스 <Boolean:N> options.chart.catGridLines : [default: true] 카테고리 격자선 출력 유무 <Boolean:N> options.chart.serGridLines : [default: true] 시리즈 격자선 출력 유무 <Boolean:N> options.chart.legend : [default: true] 범례 출력 유무 <String:N> options.chart.legendPosition : [default: "bottom"] 범례 위치 ("top", "left", "right", "bottom") <String:N> options.chart.catAxisRange 카테고리 영역 <Number:N> options.chart.catAxisRange.startRowIndex : [default: 0] 카테고리 영역 시작 행 인덱스 <Number:N> options.chart.catAxisRange.startColIndex : [default: 0] 카테고리 영역 시작 컬럼 인덱스 <Number:N> options.chart.catAxisRange.endRowIndex : [default: 0] 카테고리 영역 끝 행 인덱스 (area 의 경우 설정 필요 없음) <Number:N> options.chart.catAxisRange.endColIndex : [default: 0] 카테고리 영역 끝 컬럼 인덱스 <String:N> options.chart.serAxisRange 시리즈 영역 <Number:N> options.chart.serAxisRange.startRowIndex : [default: 0] 시리즈 영역 시작 행 인덱스 <Number:N> options.chart.serAxisRange.startColIndex : [default: 0] 시리즈 영역 시작 컬럼 인덱스 <Number:N> options.chart.serAxisRange.endRowIndex : [default: 0] 시리즈 영역 끝 행 인덱스 <Number:N> options.chart.serAxisRange.endColIndex : [default: 0] 시리즈 영역 끝 컬럼 인덱스 (area 의 경우 설정 필요 없음) <String:N> options.chart.dataAxisRange 데이터 영역 <Number:N> options.chart.dataAxisRange.startRowIndex : [default: 0] 데이터 영역 시작 행 인덱스 <Number:N> options.chart.dataAxisRange.startColIndex : [default: 0] 데이터 영역 시작 컬럼 인덱스 <Number:N> options.chart.dataAxisRange.endRowIndex : [default: 0] 데이터 영역 끝 행 인덱스 <Number:N> options.chart.dataAxisRange.endColIndex : [default: 0] 데이터 영역 끝 컬럼 인덱스 인쇄 관련 옵션 <Object:N> options.printSet JSON 형태로 저장된 엑셀 프린터 관련 설정 <String:N> options.printSet.fitToPage : [default: false] 엑셀 프린터 출력 시 쪽맞춤 사용 유무 <String:N> options.printSet.landScape : [default: false] 엑셀 프린터 출력 시 가로 방향 출력 유무 <String:N> options.printSet.fitWidth : [default: 1] 엑셀 프린터 출력 시 용지너비 <String:N> options.printSet.fitHeight : [default: 1] 엑셀 프린터 출력 시 용지높이 <String:N> options.printSet.scale : [default: 100] 엑셀 프린터 출력 시 확대/축소 배율 (fitToPage는 false로 설정 해야 함) <String:N> options.printSet.pageSize : [default: A4] 엑셀 프린터 출력 시 인쇄 용지 크기 (예: "A3", "A4", "A5", "B4") 단, fitToPage가 true인 경우에만 유효 기타 <String:N> options.useEuroLocale : [default: false] 다운로드 시 유로화 처리 기능(','와 '.'이 반대인 경우 처리) <String:N> options.optionParam : [default: 없음] DRM 연계 시 사용자 정의 클래스에 HashMap 인자로 전달할 값. 키(Key)는 "optionParam"으로 참조
infoArrObjectN그리드에 대한 내용을 추가로 다른 셀에 표현하는 경우 사용하는 배열
<Number:N> infoArr.rowIndex : 내용을 표시할 행 인덱스 <Number:N> infoArr.colIndex : 내용을 표시할 컬럼 인덱스 <Number:N> infoArr.rowSpan : 병합할 행의 수 <Number:N> infoArr.colSpan : 병합할 열의 수 <String:N> infoArr.text : 표시할 내용 <String:N> infoArr.textAlign : 표시할 내용의 정렬 방법 (left, center, right) <String:N> infoArr.fontSize : 폰트 사이즈 설정 (예: "20px") <String:N> infoArr.fontName : 폰트 이름 설정 <String:N> infoArr.color : 폰트 색상 설정 (예: "red") <String:N> infoArr.fontWeight : 폰트 두께 설정 (예: "bold") <String:N> infoArr.drawBorder : 셀의 테두리 지정 (예: true) <String:N> infoArr.borderColor : 셀의 테두리 색상 지정 (예: "#FF0000", "red") <String:N> infoArr.borderWidth : 셀의 테두리 너비 지정 ( "thin", "medium", "thick") <String:N> infoArr.wordWrap : 셀의 줄 바꿈 기능 (예: "true") <String:N> infoArr.bgColor : 셀의 배경색 설정 (예: "red") <String:N> infoArray.excelExpression : 엑셀 수식 (예: A1+B1)
Sample
// 별도의 옵션 없이 엑셀을 다운로드할 경우 var excelOpt = {}; // 엑셀 다운로드 옵션 excelOpt.fileName = "excelData.xls"; // xls 또는 xlsx 확장자 사용 grd_gridView1.advancedExcelDownload(excelOpt);
advancedExcelUpload( options )
엑셀 파일을 읽어 GridView에 데이터를 표시 (JDK 1.5 이상에서 사용 가능)
업로드하는 엑셀 파일이 Excel 97 이상인 경우 지원 (Excel 5.0/7.0 미지원)
Parameter
nametyperequireddescription
optionsObjectYJSON 형태로 저장된 그리드의 엑셀 업로드 옵션
업로드 정보 관련 옵션 <String:N> options.popupUrl : 업로드 시 호출할 팝업의 경로(URL) <String:N> options.delim : [default: ','] 업로드 시 데이터를 구분하는 구분자 <String:N> options.status : [default: R] 업로드된 데이터의 초기 상태값, 설정하지 않으면 "R"로 설정되며 "C"값을 설정 가능 <String:N> options.pwd : 엑셀 파일에 암호가 걸려 있는 경우, 비밀번호 설정 업로드 데이터 관련 옵션 <String:N> options.type : [default: 0] 컬럼의 inputType이 "select", "autoComplete", 혹은 "checkcombobox"인 경우 해당. 0: 데이터 값 사용. 1: 라벨 값 사용. 2: 해당 컬럼의 displayMode 설정에 따라 "value delim label" 혹은 "label delim value" 값을 사용, selectbox는 데이터 값(Value) 사용 <Number:N> options.sheetNo : [default: 0] 엑셀 파일에서 데이터가 있는 시트 번호 <String:N> options.sheetName : [default: 없음] 엑셀 파일에서 데이터가 있는 시트 명 (시트 번호보다 시트 명이 우선순위가 높음) <Boolean:N> options.activeSheet : [default: false] WGear연계 속성. 활성화 되어 있었던 시트를 업로드 <Number:N> options.startRowIndex : [default: 0] 엑셀 파일에서 데이터가 시작되는 행의 번호 (헤더 포함) <Number:N> options.startColumnIndex: [default: 0] 엑셀 파일에서 데이터가 시작되는 컬럼의 번호 <Number:N> options.endColumnIndex : [default: 0] 엑셀 파일에서 데이터가 끝나는 컬럼의 인덱스 ( 엑셀 파일의 컬럼 수가 그리드의 컬럼 수 보다 작은 경우 그리드의 컬럼 수를 설정) <String:N> options.append : [default: 0] 엑셀 파일에서 가져온 데이터를 그리드에 추가시킬지 여부 (1이면 현재 그리드에 데이터를 추가로 넣어주고, 0이면 현재 그리드의 데이터를 삭제하고 넣음) <String:N> options.hidden : [default: 0] 읽어들이려는 엑셀 파일에 숨겨진 컬럼이 저장되어 있는지 여부를 설정 (0이면 엑셀 파일에 숨겨진 데이터가 없으므로 그리드 숨겨진 컬럼에 빈 데이터를 삽입. 1 : 엑셀 파일에 숨겨진 데이터가 있으므로 엑셀 파일로부터 숨겨진 데이터를 삽입) <String:N> options.fillHidden : [default: 0] 그리드에 숨겨진 컬럼에 빈 값을 넣을지를 설정 (1이면 숨겨진 컬럼에 빈 값을 저장하지 않음. 0이면 숨겨진 컬림이 저장되어 있지 않은 엑셀 파일이라 간주하고, 숨겨진 컬럼에 빈 값을 넣어줌)(hidden이 0인 경우에는 fillhidden에 영향을 끼치지 않음) <String:N> options.skipSpace : [default: 0] 공백 무시 여부(1이면 무시 0이면 포함) <String:N> options.readUntilEmptyRow : [default: 0] 한줄의 모든 컬럼 데이터가 비어있는 경우, 빈줄까지 업로드 할지 여부 (0이면 전체 데이터 읽음, 1이면 비어 있는 줄 이전 까지 읽음) <String:N> options.useMaxByteLength : [default: false] ignoreChar 속성으로 설정한 문자를 제외하고, maxByteLength 속성으로 설정한 길이만큼의 데이터만 업로드 <String:N> options.byteCheckEncoding : [default: EUC-KR] useMaxByteLength 설정되어 있는 경우, byte 처리 시 지정할 인코딩. EUC-KR인 경우 2byte처리하고, UTF-8일 경우 3byte 처리 <String:N> options.dateFormat : [default: yyyy-MM-dd] 엑셀의 셀의 형식이 날짜로 되어 있는 경우 형식 설정 <String:N> options.decimal : [default: 4] 셀의 데이터가 소수인 경우, 최종 소수점 자리수 (예: 3인경우 4자리에서 반올림해서 3자리를 최종 표시) 업로드 항목 관련 옵션 <String:N> options.headerExist : [default: 0] 엑셀 파일에서 그리드의 데이터에 헤더가 있는지 여부(1이면 헤더 존재, 0이면 없음) <String:N> options.footerExist : [default: 1] 엑셀 파일에서 그리드의 데이터에 푸터가 있는지 여부(1이면 푸터 존재, 0이면 없음. 그리드에 푸터가 없으면 적용되지 않음) 컬럼 설정 관련 옵션 <String:N> options.trim : [default: 0] 엑셀 각각의 셀 데이터 좌, 우에 공백이 있는 경우 제거할지 여부 (1이면 제거, 0이면 유지) <Array:N> options.insertColumns : "radio", "checkbox"와 같은 컬럼을 엑셀에서 받아 오지 않고, 사용자 컬럼 설정으로 업로드 ( 데이터 구조 : [ { columnIndex: 1, columnValue: "1" } ] ) <String:N> options.removeColumns : [default: 없음] 저장 하지 않을 컬럼 인덱스, 여러 컬럼인 경우 콤마(,)로 구분해서 정의 업로드 팝업창 <String:N> options.useModalDisable : [default: false] 업로드 팝업창이 활성화 될 때 부모창의 컴포넌트 disabled 처리 유무 <String:N> options.features : 업로드 화면이 뜰 때 String 형식의 스타일 정보. 지정되지 않은 경우 업로드 창이 기본 스타일로 생성 상태창 관련 옵션 <String:N> options.processMsg : [default: upload...] 프로세스 창에 표시할 문자열 기타 <String:N> options.optionParam : [default: 없음] DRM 연계시 사용자 정의 클래스에 HashMap 인자로 전달할 값. key는 "optionParam"으로 참조 <String:N> options.cellDataConvertor : [default: ""] 컬럼값을 사용자가 수정할수 있는 연계 클래스의 전체 패키지명. (AbstractCellDataProvider 클래스를 상속 후 convertValue 메소드를 구현해야 함
Sample
// 별도의 옵션을 지정하지 않는 경우 빈 객체를 넘겨야 함 grd_gridView1.advancedExcelUpload( {} );
changeCurrency( columnID , dataType , displayFormat , delimiter , decimalDelimiter )
컬럼 단위로 화면에 나타나는 셀 값들의 화폐 단위를 동적으로 변경
단, 컬럼의 dataType이 "number", "tenge", "rupee", "euro"인 경우만 지원 (gridView.column의 관련 속성) dataType="number" dataType="tenge" dataType="rupee" dataType="euro"
Parameter
nametyperequireddescription
columnIDStringY화폐단위를 적용할 컬럼 아이디
dataTypeStringY적용할 화폐단위(number, euro, rupee, tenge)
displayFormatStringN컬럼에 적용할 displayFormat
delimiterStringN통화 구분자
decimalDelimiterStringN통화 소수 구분자
Sample
grd_gridView1.changeCurrency("standardAmt", "euro", "#.###,00");를 호출하면, 컬럼 아이디가 "standardAmt"인 컬럼의 셀의 값이 "1234"인 경우, GridView에 나타나는 값은 "1.234,00" 이 됨 또한 grd_gridView1에 옵션으로 다음과 같이 설정되어 있다면, euroMask="#.###,00" grd_gridView1.changeCurrency("standardAmt", "euro");를 호출하면, 컬럼 아이디가 "standardAmt"인 컬럼의 셀의 값이 "1234"인 경우, GridView에 나타나는 값은 동일하게 "1.234,00" 이 됨
checkAll( colIndex , dataValue )
체크 박스로 이루어진 컬럼을 한번에 체크하거나 언체크하는 기능
Parameter
nametyperequireddescription
colIndexStringY체크 박스의 컬럼 아이디 또는 인덱스
dataValueStringY컬럼의 체크박스의 true 또는 false
check 되는 경우 : true, 1, 혹은 trueValue속성에 정의된 값 uncheck 되는 경우 : false, 0, 혹은 falseValue속성에 정의된 값
Sample
// 'a' 컬럼의 체크박스가 모두 선택 grd_gridView1.checkAll('a', true);
clearAutoFit( )
autoFit 속성을 제거 (컬럼의 너비에 autoFit을 적용하기 이전으로 초기화)
Sample
//(사용 예) grd_gridView1.clearAutoFit();
clearGroupby( )
groupBy를 해제
clearRowVisible( )
setRowVisible() API를 이용하여 숨김 처리한 행을 모두 표시하도록 처리 (관련 함수) setRowVisible();
Sample
//(예제) //setRowVisible로 숨김 처리한 행을 모두 표시 grd_gridView1.clearRowVisible();
drillTo( rowIndex )
드릴다운 사용 시 rowIndex에 해당하는 행을 표현하기 위해 모든 조상 행을 오픈
Parameter
nametyperequireddescription
rowIndexNumberY화면에 표현하려는 행의 인덱스
enableAllDate( colIndex )
disableAfterDate 및 disableBeforeDate API를 통해서 비활성화된 날짜들을 다시 활성화시켜 선택 가능하도록 변경
Parameter
nametyperequireddescription
colIndexString|NumberY컬럼 아이디 혹은 인덱스
Sample
//사용 예 grd_gridView1.enableAllDate('col2');
getAllDisplayData( )
필터링 여부나 정렬 상태와 무관하게 모든 데이터를 배열로 반환
특정 컬럼에 displayFormat을 적용한 경우, 속성이 반영된 상태의 데이터가 반환 (관련 함수) getAllVisibleXML (필터링된 결과를 XML로 반환할 경우) getAllVisibleJSON (필터링된 결과를 JSON로 반환할 경우)
Return
typedescription
Array데이터가 담긴 1차원 배열
Sample
grd_gridView1.getAllDisplayJData();
getAllDisplayJSON( )
필터링 여부나 정렬 상태와 무관하게 모든 데이터를 JSON으로 반환
특정 컬럼에 displayFormat을 적용한 경우, 속성이 반영된 상태의 데이터가 반환 (관련 함수) getAllVisibleData (필터링된 결과를 배열로 반환할 경우) getAllVisibleXML (필터링된 결과를 XML로 반환할 경우)
Return
typedescription
JSONJSON 데이터
Sample
grd_gridView1.getAllDisplayJSON(); //(반환 예) [{"col1":"아이유","col2":"1993-05-16"},{"col1":"정형돈","col2":"1978-02-07"},{"col1":"유승호","col2":"1993-08-17"},{"col1":"김민희","col2":"1982-03-01"}]
getAllDisplayXML( )
필터링 여부나 정렬 상태와 무관하게 모든 데이터를 XML로 반환
특정 컬럼에 displayFormat을 적용한 경우, 속성이 반영된 상태의 데이터가 반환 (관련 함수) getAllVisibleData (필터링된 결과를 배열로 반환할 경우) getAllVisibleJSON (필터링된 결과를 JSON로 반환할 경우)
Return
typedescription
XMLXML 데이터
Sample
grd_gridView1.getAllDisplayXML(); //(반환 예) <list> <map status="0" statusValue="R" id="0"> <col1>아이유</col1> <col2>1993-05-16</col2> </map> <map status="0" statusValue="R" id="1"> <col1>정형돈</col1> <col2>1978-02-07</col2> </map> <map status="0" statusValue="R" id="2"> <col1>유승호</col1> <col2>1993-08-17</col2> </map> <map status="0" statusValue="R" id="3"> <col1>김민희</col1> <col2>1982-03-01</col2> </map> </list>
getAllFocusedIndex( )
포커스된 셀의 행 인덱스와 컬럼 인덱스를 선택된 순서대로 반환
Ctrl 키를 이용하여 다중 셀이 선택된 경우 사용
Return
typedescription
Array선택된 셀의 행 인덱스와 컬럼 인덱스의 정보가 담긴 JSON을 담은 배열
Sample
//Ctrl 키를 이용하여 다중 셀을 선택하였을 경우 grd_gridView1.getAllFocusedIndex(); //(반환 예) [ {col: 1, row: 2}, {col: 0, row: 4} ]
getAllFocusedRowIndex( )
포커스된 셀의 행 인덱스를 반환
Ctrl 키를 이용하여 다중 셀을 선택한 경우 사용
Return
typedescription
Array포커스된 셀의 행 인덱스를 담은 배열
Sample
//Ctrl 키를 이용하여 다중 셀을 선택하였을 경우 grd_gridView1.getAllFocusedRowIndex(); //(반환 예) [ 0, 1 ]
getAllVisibleData( )
현재 보이는 데이터를 1차원 배열로 반환
필터링이 된 경우 필터링된 상태의 데이터를 1차원 배열로 반환
Return
typedescription
Array데이터가 담긴 1차원 배열
Sample
//DataList에 2개의 컬럼이 정의되고 4행의 데이터가 설정된 경우 grd_gridView1.getAllVisibleData(); //(반환 예) ["아이유", "19930516", "정형돈", "19780207", "유승호", "19930817", "김민희", "19820301"]
getAllVisibleJSON( )
화면에 출력된 데이터를 JSON으로 반환
특정 컬럼에 displayFormat을 적용한 경우, 속성이 반영된 상태의 데이터가 반환
데이터가 필터링된 경우, 필터링이 적용된 데이터를 JSON으로 반환
Return
typedescription
JSONJSON 데이터
Sample
grd_gridView1.getAllVisibleJSON(); //(반환 예) [{"col1":"아이유","col2":"1993-05-16"},{"col1":"정형돈","col2":"1978-02-07"},{"col1":"유승호","col2":"1993-08-17"},{"col1":"김민희","col2":"1982-03-01"}]
getAllVisibleXML( )
현재 보이는 데이터를 XML로 반환
데이터가 필터링된 경우, 필터링이 적용된 데이터를 XML로 반환
Return
typedescription
XMLXML 데이터
Sample
grd_gridView1.getAllVisibleXML(); //(반환 예) <list> <map status="0" statusValue="R" id="0"> <col1>아이유</col1> <col2>1993-05-16</col2> </map> <map status="0" statusValue="R" id="1"> <col1>정형돈</col1> <col2>1978-02-07</col2> </map> <map status="0" statusValue="R" id="2"> <col1>유승호</col1> <col2>1993-08-17</col2> </map> <map status="0" statusValue="R" id="3"> <col1>김민희</col1> <col2>1982-03-01</col2> </map> </list>
getAncestorRowIndexArray( rowIndex )
드릴다운 사용 시, 행 인덱스에 해당하는 행의 모든 조상 행의 행 인덱스를 반환
Parameter
nametyperequireddescription
rowIndexNumberY조상을 찾으려는 행 인덱스
Return
typedescription
Array행 인덱스가 담긴 1차원 배열
getBottomRowIndex( )
현재 화면에 보여지는 최하단 행의 인덱스를 반환 (데이터가 없으면 "-1"이 반환)
Return
typedescription
Number화면상의 최하단 행의 인덱스
Sample
// 총 10건의 데이터가 있고 화면에는 4건의 데이터가 보여지는 경우 // GridView의 높이가 작아 데이터를 다 표현하지 못하고 스크롤이 생겨 4건의 데이터만 화면에 보여질 때 grd_gridView1.getBottomRowIndex(); // (반환 예) 3
getCellBackgroundColor( rowIndex , colIndex )
행 인덱스와 컬럼 인덱스에 해당하는 셀의 배경색을 반환
API로 별도의 배경색을 지정하지 않은 경우 ""(empty string) 이 반환
Parameter
nametyperequireddescription
rowIndexNumberY행 인덱스
colIndexString||NumberY컬럼의 인덱스 또는 아이디
Return
typedescription
String해당 행에 지정된 배경색
Sample
//행 인덱스가 2이고, 컬럼 인덱스가 1인 셀의 배경색 반환 grd_gridView1.getCellBackgroundColor(2, 1) //(반환 예) pink //해당 셀에 별도의 배경색이 지정되지 않은 경우, ""(string 타입의 빈 값)이 반환
getCellChecked( rowIndex , colIndex )
행 인덱스와 컬럼 인덱스에 해당하는 셀의 체크 여부를 반환
Parameter
nametyperequireddescription
rowIndexNumberY셀의 행 인덱스
colIndexNumber||StringY셀의 컬럼 인덱스 또는 아이디
Return
typedescription
Boolean셀의 체크 여부
getCellClass( rowIndex , colIndex )
셀에 동적으로 적용한 사용자 클래스 이름을 반환
Parameter
nametyperequireddescription
rowIndexNumberY셀의 행 인덱스
colIndexNumberY셀의 열 인덱스 혹은 컬럼 아이디
Return
typedescription
String:Y셀에 적용된 사용자 클래스 이름
getCellColor( rowIndex , colIndex )
행 인덱스와 컬럼 인덱스에 해당하는 셀의 글자색을 반환
API로 별도의 글자색을 지정하지 않은 경우 ""(empty string)이 반환됨
Parameter
nametyperequireddescription
rowIndexNumberY행 인덱스
colIndexString||NumberY컬럼 인덱스 또는 아이디
Return
typedescription
String해당 셀의 글자색
getCellDisabled( rowIndex , colIndex )
행 인덱스와 컬럼 인덱스에 해당하는 셀의 disabled 속성 값을 반환
disabled 속성을 별도로 지정하지 않은 경우 ""(empty string)이 반환
Parameter
nametyperequireddescription
rowIndexNumberY행 인덱스
colIndexString||NumberY컬럼 인덱스 또는 아이디
Return
typedescription
Boolean해당 셀에 적용된 disabled속성값으로 별도로 지정하지 않은 경우 ""(empty string)이 반환
getCellDisplayData( rowIndex , colIndex )
행 인덱스와 컬럼 인덱스에 해당하는 셀의 화면에 보이는 데이터를 반환
displayFormat등이 적용된 데이터를 반환
Parameter
nametyperequireddescription
rowIndexNumberY셀의 행 인덱스
colIndexString||NumberY셀의 컬럼 인덱스 또는 아이디
Return
typedescription
String행 인덱스와 컬럼 인덱스에 해당하는 셀의 화면에 보이는 데이터
getCellPosition( row , colIndex , propertyName )
셀의 위치 정보(top 또는 left)를 반환
Parameter
nametyperequireddescription
rowNumberY셀의 행 인덱스 (세로 스크롤 위치와는 무관하게 현재 그리드에서 최상단 행에 위치한 셀의 행 인덱스를 0으로 보고 계산)
colIndexString||NumberY셀의 컬럼 인덱스 또는 아이디
propertyNameStringY[top, left] 반환할 위치 정보명
Return
typedescription
Number셀의 위치 정보(top이나 left)의 값
Sample
//행 인덱스가 1이고, 컬럼 인덱스가 2인 셀의 top 값을 반환 grd_gridView1.getCellPosition(1, 2, "top") //(반환 예) 51
getCellReadOnly( rowIndex , colIndex )
행 인덱스와 컬럼 인덱스에 해당하는 셀의 readonly 속성 값을 반환
별도로 readonly 속성을 지정하지 않은 경우 ""(empty string)을 반환
Parameter
nametyperequireddescription
rowIndexNumberY행 인덱스
colIndexString||NumberY컬럼 인덱스 또는 아이디
Return
typedescription
Boolean해당 셀에 적용된 readonly속성값
Sample
//행 인덱스가 2이고 컬럼 인덱스가 1인 셀의 readOnly 설정 여부 반환 grd_gridView1.getCellReadOnly(2, 1)); //(반환 예) true
getCellSize( row , colIndex , sizeName )
셀의 크기 정보(너비나 높이)를 반환
Parameter
nametyperequireddescription
rowNumberY셀의 행 인덱스
colIndexString||NumberY셀의 컬럼 인덱스 또는 아이디
sizeNameStringY[너비, 높이] 반환할 크기 정보명
Return
typedescription
Number셀의 크기 정보(너비, 높이)의 값
Sample
//GridView에 3개의 컬럼과 2개의 행에 데이터가 셋팅 된 경우 //1번째 행과 name 컬럼에 해당하는 셀의 너비를 가져올 때 var tmpCellWidth = grd_gridView1.getCellSize(0,"name","width"); //(반환 예) 154 //1번째 행과 2번째 컬럼에 해당하는 셀의 높이를 가져올 때 var tmpCellHeight = grd_gridView1.getCellSize(0,1,"height"); //(반환 예) 20
getCheckedData( colIndex )
컬럼 인덱스에 해당하는 컬럼이 radio/checkbox일 경우 체크된 행의 데이터를 배열로 반환. 해당 컬럼이 checkbox가 아닐 경우 비어있는 배열을 반환
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼 인덱스 또는 아이디
Return
typedescription
Array데이터가 담긴 2차원 배열
Sample
//checkbox, 이름, 생년월일로 구성된 GridView가 정의되어 있고 checkbox의 컬럼의 아이디가 "chk"인 경우 var tmpRs = grd_gridView1.getCheckedData("chk"); //(반환 예) [["1","정형돈","19780207"],["1","유승호","19930817"],["1","김민희","19820301"]]
getCheckedIndex( colIndex )
컬럼 인덱스에 해당하는 컬럼의 inputType이 "radio" 또는 "checkbox"인 경우 체크된 행의 인덱스를 배열로 반환
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼 인덱스 또는 아이디
Return
typedescription
Array행 인덱스가 담긴 1차원 배열
Sample
//CheckBox, 이름, 생년월일이 구성된 GridView가 정의되어 있고, checkbox의 컬럼 아이디가 "chk"인 경우 var tmpRs = grd_gridView1.getCheckedIndex("chk"); //(반환 예) [1,2,3]
getCheckedJSON( colIndex )
컬럼 인덱스에 해당하는 컬럼이 radio/checkbox일 경우 체크된 행의 JSON 데이터를 배열에 담아 반환
해당 컬럼이 checkbox가 아닐 경우 비어있는 배열을 반환
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼 인덱스 또는 아이디
Return
typedescription
ArrayJSON 데이터를 담은 1차원 배열
Sample
//checkbox, 이름, 생년월일로 구성된 GridView가 정의되어 있고, checkbox의 컬럼의 아이디가 "chk" 인 경우 var tmpRs = grd_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 )
컬럼 인덱스에 해당하는 컬럼이 radio/checkbox일 경우 체크된 행의 데이터를 XML로 반환
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼 인덱스 또는 아이디
Return
typedescription
XMLXML 데이터
Sample
//checkbox, 이름, 생년월일로 구성된 GridView가 정의되어 있고, checkbox의 컬럼 아이디가 "chk"인 경우 var tmpRs = grd_gridView1.getCheckedData("chk"); //(반환 예) <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 )
드릴다운 사용 시 행 인덱스에 해당하는 행의 자식(깊이 1의 하위)행들의 행 인덱스를 배열로 반환
Parameter
nametyperequireddescription
rowIndexNumberY자식을 찾으려는 행 인덱스
Return
typedescription
Array행 인덱스가 담긴 1차원 배열
Sample
//checkbox, 이름, 생년월일로 구성된 GridView가 정의되어 있고, checkbox 컬럼의 아이디가 "chk"인 경우 var tmpRs = grd_gridView1.getCheckedData("chk"); //(반환 예) <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>
getColIdByHeaderId( headerId )
헤더의 컬럼 아이디에 해당하는 바디의 컬럼 아이디를 반환
Parameter
nametyperequireddescription
headerIdStringY헤더의 아이디
Return
typedescription
String바디의 컬럼 아이디
Sample
//헤더의 아이디가 "price"인 바디의 컬럼 아이디 grd_gridView1.getColIdByHeaderId("price") //(반환 예) col2
getColumnBackgroundColor( colIndex )
컬럼 인덱스에 해당하는 컬럼의 배경색을 반환
API로 컬럼에 별도의 배경색을 지정하지 않은 경우 ""(empty string)을 반환
Parameter
nametyperequireddescription
colIndexString||NumberY배경색을 반환할 컬럼 인덱스 또는 아이디
Return
typedescription
String해당 열에 지정된 배경색
getColumnClass( colIndex )
컬럼에 동적으로 적용된 사용자 클래스를 반환
Parameter
nametyperequireddescription
colIndexNumberY컬럼 인덱스 또는 아이디
Return
typedescription
String:Y컬럼에 적용된 사용자 클래스 이름
Sample
//컬럼 아이디가 "col1"인 컬럼에 적용된 클래스 이름을 반환 grd_gridView1.getColumnClass("col1"); //적용된 클래스가 없으면 undefined를 반환
getColumnColor( colIndex )
컬럼 인덱스에 해당하는 컬럼의 글자색을 반환
API로 컬럼에 별도의 글자색을 지정하지 않은 경우 ""(empty string)을 반환
Parameter
nametyperequireddescription
colIndexString||NumberY컬럼 인덱스 또는 아이디
Return
typedescription
String해당 컬럼의 글자색
Sample
//컬럼 인덱스가 2인 컬럼의 글자색 반환 grd_gridView1.getColumnColor(2) //(반환 예) red //별도의 글자색을 지정하지 않은 경우 ""(empty string)을 반환
getColumnDataListInfo( colIndex )
컬럼 인덱스에 해당하는 컬럼에 바인딩된 DataList 정보를 반환
inputType이 selectbox, autocomplete, 혹은 checkcomboBox 컬럼만 지원
Parameter
nametyperequireddescription
colIndexNumberY컬럼의 인덱스
Return
typedescription
Object:YDataList의 정보
Sample
//컬럼의 inputType이 selectbox일 때, 해당 컬럼의 인덱스를 이용하여 컬럼의 정보 확인 가능 grd_gridView1.getColumnDataListInfo(1) //(반환 예) {nodeset: 'data:dlt_dataList1', id: 'dlt_dataList1', value: 'address2', label: 'address2'}
getColumnDisabled( colIndex )
컬럼 인덱스에 해당하는 컬럼에 disabled 속성 값을 반환
컬럼에 별도로 disabled 속성을 지정하지 않은 경우 ""(empty string)을 반환
Parameter
nametyperequireddescription
colIndexString||NumberYdisabled 속성을 가져올 컬럼 인덱스 또는 아이디
Return
typedescription
Boolean해당 컬럼에 적용된 disabled 속성 값
Sample
//컬럼 인덱스가 1인 컬럼에 적용된 disabled 속성 값을 반환 grd_gridView1.getColumnDisabled(1) //(반환 예) true //컬럼에 별도로 disabled 속성을 지정하지 않은 경우 ""(empty string)을 반환
getColumnID( colIndex )
컬럼의 인덱스를 입력받아 해당하는 컬럼의 아이디를 반환
Parameter
nametyperequireddescription
colIndexNumberY컬럼 인덱스
Return
typedescription
String컬럼의 아이디
Sample
//컬럼의 인덱스가 1인 컬럼의 아이디를 반환 //grd_gridView1.getColumnID(1) //(반환 예) col2
getColumnIdListMultiRow( )
GridView 바디 영역의 모든 컬럼의 아이디를 배열 형태로 반환
다중 행의 경우 다중 배열을 반환
Return
typedescription
Array그리드의 모든 컬럼의 아이디 값을 담은 배열
Sample
//case1 : 두 개의 다중 행으로 이루어져 있고, 첫번째 행은 col1, col2 두번째 행은 col3, col4로 이루어진 경우 grd_gridView1.getColumnIdListMultiRow(); // (반환예) // [Array(2), Array(2)] // 0 : ['col1', 'col2'] // 1 : ['col3', 'col4']
getColumnIndex( colIndex )
컬럼 아이디를 입력 받아 해당하는 컬럼의 인덱스를 반환
Parameter
nametyperequireddescription
colIndexStringY컬럼 아이디
Return
typedescription
Number컬럼의 인덱스
getColumnNodeSet( colIndex )
inputType이 select 또는 autocomplete인 경우, 바인딩된 NodeSet 정보를 반환
Parameter
nametyperequireddescription
colIndexString||NumberY컬럼 아이디 혹은 인덱스
Return
typedescription
Object컬럼 인덱스에 해당하는 컬럼의 NodeSet 정보를 담은 객체 (NodeSet, Label, Value 등 포함)
Sample
var itemsetObj = grd_gridView1.getColumnNodeSet("col1"); var nodeset = itemsetObj.nodeset; var label = itemsetObj.label; var value = itemsetObj.value;
getColumnOrder( byName )
현재 컬럼 순서를 배열로 반환 (단, byName이 true인 경우 아이디를 담은 배열을 반환)
Parameter
nametyperequireddescription
byNameBooleanN반환할 컬럼의 배열에서 컬럼 인덱스 대신 컬럼 아이디를 사용할지 여부
Return
typedescription
Array현재 컬럼 순서를 차례대로 담고 있는 배열
getColumnReadOnly( colIndex )
컬럼 인덱스에 해당하는 컬럼에 적용된 readonly 속성 값을 반환
별도의 readonly가 지정되지 않은 경우 ""(empty string)을 반환
Parameter
nametyperequireddescription
colIndexString||NumberY컬럼 인덱스 또는 아이디
Return
typedescription
Boolean해당 컬럼에 적용된 readonly 속성 값
getColumnType( colIndex )
컬럼 인덱스에 해당하는 컬럼의 inputType 속성 값을 반환
Parameter
nametyperequireddescription
colIndexString||NumberY컬럼 아이디 또는 인덱스
Return
typedescription
String컬럼 인덱스에 해당하는 컬럼의 타입
getColumnVisible( colIndex )
컬럼 인덱스에 해당하는 컬럼의 visible 여부를 반환
Parameter
nametyperequireddescription
colIndexNumber||StringYvisible 여부를 반환할 컬럼 인덱스 또는 아이디
Return
typedescription
Boolean컬럼의 visible여부
getCurrentGridStyle( )
현재 그리드의 상태(컬럼 순서, 컬럼 너비, 숨겨진 컬럼, 고정 컬럼)를 JSON 문자열 형태로 반환 (관련 함수) setGridStyle();
Return
typedescription
String그리드를 구성하는 JSON 문자열
Sample
//getCurrentGridStyle()에서 반환받은 string 저장 var gridStr = gridView1.getCurrentGridStyle()); //setGridStyle을 사용해 그리드 복원 gridView1.setGridStyle(gridStr);
getDataDragDrop( )
그리드의 컬럼에 dataDragDrop 값을 반환
Return
typedescription
BooleandataDragDrop
Sample
// 현재 설정된 dataDragDrop 값을 반환 grd_gridView1.getDataDragDrop();
getDataLength( )
[deprecated] getRowCount()를 사용하며, 행의 수를 반환
Return
typedescription
Number행의 수
getDataList( )
현재 바인딩된 DataList의 아이디를 반환
Return
typedescription
String데이터의 아이디
getDataListInfo( )
현재 바인딩된 DataList를 반환
Return
typedescription
Object노드셋(nodeset), 라벨, 값, 아이디를 객체로 반환
Sample
// 사용 예 grd_gridView1.getDataListInfo();
getDataType( colID )
특정 컬럼의 데이터타입을 반환
Parameter
nametyperequireddescription
colIDStringY컬럼 아이디
Return
typedescription
String해당 컬럼의 데이터타입
getDescendantRowIndexArray( rowIndex )
드릴다운 사용 시 특정 행의 모든 자손 행의 행 인덱스를 반환
Parameter
nametyperequireddescription
rowIndexNumberY자손을 찾으려는 행 인덱스
Return
typedescription
Array행 인덱스가 담긴 1차원 배열
getDisabled( type , rowIndex , colIndex )
유형에 따라 세부적인 disabled 속성을 반환 (유형에 따른 세부 내용) "all" : GridView 전체, 행, 컬럼, 셀에 지정된 disabled 속성값을 전부 체크하여 해당 셀에 적용된 실제 disabled 속성값을 반환 "grid" : GridView 전체에 disabled 속성의 적용 여부를 반환 "row" : 해당 열에 disabled 속성의 적용 여부를 반환하며 getRowDisabled API와 동일 GridView 전체에 disabled속성을 넣더라도 해당 행에 disabled속성을 직접 넣은 경우가 아닌 경우 false를 반환 "column" : 해당 컬럼에 disabled 속성의 적용 여부를 반환하며 getColumnDisabled API와 동일 GridView 전체에 disabled속성을 넣더라도 해당 컬럼에 disabled속성을 직접 넣은 경우가 아닌 경우 false를 반환 "cell" : 해당 셀에 disabled 속성의 적용 여부를 반환하며 getCellDisabled API와 동일 GridView 전체 또는 해당 셀을 포함하는 행이나 컬럼에 disabled속성을 넣더라도, 해당 셀에 disabled속성을 직접 넣은 경우가 아닌 경우 false를 반환
Parameter
nametyperequireddescription
typeStringY[default:grid, row, column, cell, all] disabled 속성을 가져올 유형
rowIndexNumberYdisabled 속성을 가져올 행 인덱스
colIndexNumber||StringYdisabled 속성을 가져올 컬럼 인덱스 또는 아이디
Return
typedescription
Boolean해당 유형에 적용된 disabled 속성값
getFixedColumnLastIndex( includeDefaultColumn )
fixedColumn이 설정되어 있을 경우, fixedColumn 중 맨 오른쪽 끝에 해당하는 컬럼의 인덱스를 반환
Parameter
nametyperequireddescription
includeDefaultColumnbooleanY행 번호 컬럼 및 행 상태 컬럼 개수 포함 여부 (기본 포함)
Return
typedescription
Number맨 오른쪽에 위치한 fixedColumn의 인덱스
getFixedRightColumnLastIndex( )
FixedRightColumn이 설정되어 있을 경우 FixedRightColumn 중 맨 오른쪽 끝에 해당하는 컬럼의 인덱스를 반환
Return
typedescription
Number맨 오른쪽에 위치한 FixedRightColumn의 인덱스
getFixedRow( )
행의 틀이 고정된 경우, 해당 행의 위치를 반환. 첫번째 행일 경우 "1"을 반환
getFocusedColumnID( )
포커스된 셀이 속한 컬럼의 아이디를 반환
Return
typedescription
String포커스된 셀이 속한 컬럼의 아이디
getFocusedColumnIndex( )
포커스된 셀의 컬럼 인덱스 반환
Return
typedescription
Number포커스된 셀의 컬럼 인덱스
getFocusedRowIndex( )
포커스된 셀의 행 인덱스를 반환
Return
typedescription
Number포커스된 셀의 행 인덱스
getFocusedRowStatus( )
포커스된 셀이 속한 행의 상태를 상태 문자로 반환 (상태값의 세부 내용) 초기상태 : "R" 갱신 : "U" 삽입 : "C" 삭제 : "D" 삽입 후 삭제 : "V"
Return
typedescription
String포커스된 셀이 속한 행의 상태를 나타내는 문자
초기상태 : "R" 갱신 : "U" 삽입 : "C" 삭제 : "D" 삽입 후 삭제 : "V"
getFooterData( footerId , display )
특정 푸터 아이디에 해당하는 푸터의 데이터를 반환 (inputType이 "expression"인 경우 계산된 값을 반환)
Parameter
nametyperequireddescription
footerIdString||NumberY푸터의 아이디 혹은 인덱스
displayStringN값이 "displayData"인 경우 형식이 지정된 값이 반환
Return
typedescription
string특정 푸터 아이디에 해당하는 푸터의 데이터
Sample
// 특정 푸터의 아이디가 "total"이며 inputType이 "expression"이고, expression은 sum('c')인 경우 // dataType은 number, displayFormat은 #,###으로 적용되었을 때, var returnValue = grd_gridView1.getFooterData('total', 'displayData')); //반환값은 아이디가 "total"인 푸터의 값(아이디가 "c"인 컬럼의 합)에 #,###이 적용되어 반환 //예: 23,456
getFooterStyle( footerId , style )
특정 푸터 아이디 또는 인덱스에 해당하는 푸터의 스타일 속성값 반환
Parameter
nametyperequireddescription
footerIdNumber||StringY푸터의 인덱스 또는 아이디
styleStringY스타일 속성
Sample
// 아이디가 "a"인 푸터의 배경색 반환 grd_gridView1.getFooterStyle("a", "background-color");
getFormattedHeaderValue( headerId , value )
헤더에 설정된 dispalyFormat으로 인해 형식이 지정된 값 반환
Parameter
nametyperequireddescription
headerIdStringY헤더의 아이디
valueStringY형식이 지정될 값
Return
typedescription
String헤더에 설정된 형식이 적용된 값
getGridReadOnly( )
GridView 전체에 대한 읽기전용(Readonly) 속성 설정 여부 반환
Return
typedescription
Boolean읽기전용(Readonly) 속성
Sample
// 그리드 전체에 대해 읽기전용(Readonly) 속성 설정했는지 여부 확인 grd_gridView1.getGridReadOnly() // (반환 예) true
getGroupbyData( [default: )
현재 그룹핑된 정보를 반환
Parameter
nametyperequireddescription
[default:BooleanNtrue, false] isJSON 반환 데이터 구조. false일 경우 String 형태로 반환
Return
typedescription
JSON||String:yJSON 데이터 혹은 String 객체
Sample
// JSON 형태로 반환. groupby()의 옵션 형태와 동일 var data = grd_gridView1.getGroupbyData(true); // String으로 반환 var data = grd_gridView1.getGroupbyData(false);
getHeaderBackgroundColor( headerId )
헤더의 셀에 적용된 배경색을 반환 (관련 함수) setHeaderBackgroundColor()
Parameter
nametyperequireddescription
headerIdStringY헤더 셀의 아이디 또는 인덱스
Return
typedescription
String헤더 셀의 배경색
Sample
//헤더 아이디가 "column2"인 셀의 배경색 반환 var headerBackgroundColor = grd_gridView1.getHeaderBackgroundColor("column2");
getHeaderClass( headerId )
헤더의 셀에 동적으로 적용한 사용자 클래스 이름 반환 (관련 함수) setHeaderClass()
Parameter
nametyperequireddescription
headerIdNumberY헤더 셀의 아이디 또는 인덱스
Return
typedescription
String:Y셀에 적용된 사용자 클래스 이름
Sample
//헤더 아이디가 "column2"인 셀의 사용자 클래스 이름 반환 var headerClass = grd_gridView1.getHeaderClass("column2");
getHeaderColor( headerId )
헤더의 셀에 적용된 폰트 색상을 반환
Parameter
nametyperequireddescription
headerIdStringY헤더 셀의 아이디 또는 인덱스
Return
typedescription
String헤더 셀의 폰트 색상
Sample
//헤더 아이디가 "column2"인 셀의 폰트 색상 반환 var headerColor = grd_gridView1.getHeaderColor("column2");
getHeaderID( header )
헤더의 인덱스로 헤더의 아이디를 반환
Parameter
nametyperequireddescription
headerNumberY헤더의 인덱스
Return
typedescription
String헤더의 아이디
Sample
//헤더의 인덱스가 3인 헤더의 아이디 반환 var headerID = grd_gridView1.getHeaderID(3);
getHeaderIndex( header )
헤더의 아이디로 헤더의 인덱스 반환
Parameter
nametyperequireddescription
headerStringY헤더의 아이디
Return
typedescription
Number헤더의 인덱스
Sample
//헤더의 아이디가 "column2"인 헤더의 인덱스 반환 var headerIdx = grd_gridView1.getHeaderIndex("column2");
getHeaderPosition( headerId , propertyName )
헤더 셀의 위치 정보(top이나 left)를 반환
Parameter
nametyperequireddescription
headerIdStringY헤더의 아이디
propertyNameStringY[top, left] 반환할 위치 정보의 이름
Return
typedescription
Number헤더의 위치 값
Sample
// 헤더의 아이디가 "column2"인 셀의 top 위치 반환 grd_gridView1.getHeaderPosition("column2", "top")
getHeaderSize( headerId , sizeName )
헤더 셀의 크기 정보(width나 height)를 반환
Parameter
nametyperequireddescription
headerIdStringY헤더의 아이디
sizeNameStringY[width, height] 반환할 크기 정보의 이름
Return
typedescription
Number헤더의 크기 값
Sample
// 헤더의 아이디가 "column2"인 셀의 height 반환 grd_gridView1.getHeaderSize("column2", "height")
getHeaderValue( headerId )
헤더의 아이디로 헤더의 값을 반환
Parameter
nametyperequireddescription
headerIdStringY헤더의 아이디
Return
typedescription
String헤더의 값
Sample
// "column2"가 아이디인 헤더의 값 grd_gridView1.getHeaderValue("column2")
getMaxLength( colIndex )
컬럼의 최대 길이값 반환 (관련 함수) setMaxLength()
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 인덱스 또는 아이디
Return
typedescription
Number컬럼의 최대 길이값
Sample
// 컬럼의 아이디가 "a"인 컬럼의 최대 길이를 반환 grd_gridView1.getMaxLength("a");
getMerged( rowIndex , colIndex )
특정 셀의 병합여부를 반환
Parameter
nametyperequireddescription
rowIndexNumberY병합 여부를 알고 싶은 셀의 행 인덱스
colIndexNumberY병합 여부를 알고 싶은 셀의 컬럼 인덱스
Sample
// (0, 0)의 병합 여부를 반환 grd_gridView1.getMerged(0, 0);
getOpenStatus( rowIndex )
드릴다운을 적용한 경우 행 인덱스에 해당하는 행의 드릴다운이 열려있는지 여부 반환
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
Return
typedescription
Boolean[true, false] 드릴다운의 오픈 여부
Sample
// 드릴다운 컬럼에서 특정 행이 오픈되어있는지 여부를 반환 grd_gridView1.getOpenStatus(3);
getOverflowX( )
overflowX 속성의 설정값을 반환
Return
typedescription
String[default: auto, hidden, scroll] overflowX 속성의 설정값
getOverflowY( )
overflowY 속성의 설정값을 반환
Return
typedescription
String[default: auto, hidden, scroll] overflowY 속성의 설정값
getParentRowIndex( rowIndex )
드릴다운 사용 시 특정 행의 부모 행 인덱스를 반환
Parameter
nametyperequireddescription
rowIndexNumberY부모를 찾으려는 행의 인덱스
Return
typedescription
Number부모 행의 인덱스
getReadOnly( type , rowIndex , colIndex )
타입에 따라 읽기전용(Readonly) 속성을 반환 (타입에 따른 세부 내용) "grid" : 그리드 전체에 읽기전용(Readonly) 속성의 적용 여부를 반환 "row" : 해당 행의 읽기전용(Readonly) 속성의 적용 여부를 반환하며 getRowReadOnly API와 동일 그리드 전체에 읽기전용(Readonly) 속성을 넣더라도 해당 행에 읽기전용(Readonly) 속성을 직접 넣은 경우가 아니면 false를 반환 "column" : 해당 컬럼의 읽기전용(Readonly) 속성의 적용 여부를 반환하며 getColumnReadOnly API와 동일 그리드 전체에 읽기전용(Readonly) 속성을 넣더라도 해당 컬럼에 읽기전용(Readonly) 속성을 직접 넣은 경우가 아니면 false를 반환 "cell" : 해당 셀의 읽기전용(Readonly) 속성의 적용 여부를 반환하며 getCellReadOnly API와 동일 그리드 전체 또는 해당 셀을 포함하는 행이나 컬럼에 읽기전용(Readonly) 속성을 넣더라도 해당 셀에 읽기전용(Readonly) 속성을 직접 넣은 경우가 아니면 false를 반환 "all" : 그리드 전체, 행, 컬럼, 셀에 지정된 읽기전용(Readonly) 속성값들을 전부 계산하여 해당 셀에 적용된 실제 읽기전용(Readonly) 속성값을 반환
Parameter
nametyperequireddescription
typeStringY[default: grid, row, column, cell, all] 읽기전용(Readonly) 속성을 가져올 타입
rowIndexNumberY읽기전용(Readonly) 속성을 가져올 행 인덱스
colIndexNumber||StringY읽기전용(Readonly) 속성을 가져올 컬럼 인덱스 또는 아이디
Return
typedescription
Boolean해당 타입에 적용된 읽기전용(Readonly) 속성값
Sample
var returnValue = grd_gridView1.getReadOnly("grid"); // 그리드 전체에 적용된 읽기전용(Readonly) 값 var returnValue = grd_gridView1.getReadOnly("row", 0); // 첫번째 행에 적용된 읽기전용(Readonly) 값 var returnValue = grd_gridView1.getReadOnly("cell", 0, 4); // 첫번째 행의 다섯번째 컬럼의 셀에 적용된 읽기전용(Readonly) 값 var returnValue = grd_gridView1.getReadOnly("all", 0, 4); // 첫번째 행의 다섯번째 컬럼의 셀에 최종적으로 적용된 읽기전용(Readonly) 값
getRealRowIndex( rowIndex )
드릴다운을 적용한 경우 화면에 표현된 행 인덱스를 기준으로 실제 데이터의 행 인덱스를 반환
Parameter
nametyperequireddescription
rowIndexNumberY현재 표시되고 있는 행의 인덱스
Return
typedescription
Number행의 실제 인덱스
Sample
// 드릴다운 적용한 경우 화면에 보이는 행 인덱스가 3인 실제 데이터의 행 인덱스 반환 grd_gridView1.getRealRowIndex(3)
getRowBackgroundColor( rowIndex )
행의 배경색을 반환 (관련 함수) setRowBackgroundColor()
Parameter
nametyperequireddescription
rowIndexNumberY배경색을 반환할 행 인덱스
Return
typedescription
String행의 배경색
Sample
// 인덱스가 3인 행의 배경색 반환 grd_gridView1.getRowBackgroundColor(3);
getRowClass( rowIndex )
grid Row에 동적으로 적용한 사용자 class 이름을 반환
Parameter
nametyperequireddescription
rowIndexNumberYrow의 행번호
Return
typedescription
String:Y셀에 적용된 사용자 class이름
getRowColor( rowIndex )
행의 글자색을 반환 (관련 함수) setRowColor()
Parameter
nametyperequireddescription
rowIndexNumberY글자색을 반환할 행 인덱스
Return
typedescription
String행의 글자색
Sample
// 인덱스가 3인 행의 글자색 반환 grd_gridView1.getRowColor(3);
getRowDisabled( rowIndex )
특정 행에 적용된 disabled 속성 값을 반환
Parameter
nametyperequireddescription
rowIndexNumberYdisabled 속성을 가져올 행 인덱스
Return
typedescription
Boolean해당 행에 적용된 disabled 속성 값
Sample
// 첫 번째 행에 적용된 disabled 속성값 반환 var returnValue = grd_gridView1.getRowDisabled(0);
getRowNumVisible( )
rowNumVisible 옵션 값을 반환 (관련 함수) setRowNumVisible()
Return
typedescription
BooleanrowNumVisible 설정 값
Sample
grd_gridView1.getRowNumVisible(); // true 또는 false
getRowReadOnly( rowIndex )
특정 행에 적용된 읽기전용(Readonly) 속성 값을 반환 (관련 함수) setRowReadOnly()
Parameter
nametyperequireddescription
rowIndexNumberY읽기전용(Readonly) 속성을 가져올 행 인덱스
Return
typedescription
Boolean해당 행에 적용된 읽기전용(Readonly) 속성값으로, 별도로 속성을 지정하지 않은 경우 ""(빈 값)을 반환
getRowVisible( rowIndex )
행의 visible 속성 여부를 반환 (관련 함수) setRowVisible()
Parameter
nametyperequireddescription
rowIndexNumberYvisible 속성 여부를 가져올 행의 인덱스
Return
typedescription
Boolean해당 행의 visible 속성 여부. 감춰진 상태면 false, 보이는 상태면 true 반환
Sample
// 30번째 행의 visible 속성 여부를 반환 grd_gridView1.getRowVisible(30);
getSortableArr( )
헤더의 각 컬럼의 정렬 여부를 배열로 반환
Return
typedescription
Array각 컬럼의 정렬 여부를 배열 형태로 반환
Sample
// 헤더의 각 컬럼의 정렬 여부를 배열로 반환 grd_gridView1.getSortableArr() // (반환 예) [true, true, true, false]
getSortableStatus( )
정렬된 컬럼의 순서대로 해당 컬럼의 헤더 정보를 담은 객체를 배열로 반환
정렬된 컬럼이 없을 경우 빈 배열 반환
반환된 배열의 각 객체는 colID, dataType, sortOrder를 포함
sortOrder이 1인 경우 오름차순이고, sortOrder이 -1인 경우 내림차순
Return
typedescription
Object정렬된 헤더의 정보
//이름, 생년월일, 성별이 순서대로 컬럼에 정의된 그리드가 있고 모든 컬럼이 정렬되어 있으며, 생년월일과 이름 순서로 다중 정렬된 경우 var tmpArr = grd_gridView1.getSortableStatus(); // (반환 예) [{colID:"birthDate", dataType:"text", sortOrder:"1"}, {colID:"name", dataType:"text", sortOrder:"-1"}]
getTopRowIndex( )
현재 화면에 보여지는 최상단 행의 행 인덱스를 반환
GridView에 표현된 데이터가 없으면 "-1"을 반환
Return
typedescription
Number최상단 행의 행 인덱스
Sample
// 현재 화면에 보여지는 최상단 행의 행 인덱스 반환 (표현된 데이터가 없으면 -1 반환) grd_gridView1.getTopRowIndex();
getTotalCol( )
전체 컬럼 개수를 반환 (행번호 및 행상태 컬럼 제외)
Return
typedescription
Number(행번호 및 행상태 컬럼을 제외한) 전체 컬럼 개수를 반환
Sample
// 그리드의 전체 컬럼 개수 반환 (행번호 및 행상태 컬럼 제외) grd_gridView1.getTotalCol();
getTotalHeaderCol( options )
헤더 컬럼의 개수를 반환
Parameter
nametyperequireddescription
optionsObjectN헤더 컬럼의 개수를 가져올 때 설정할 옵션
<Boolean:N> options.defaultColumn : [default: false] 행번호, 행상태 컬럼의 개수를 포함해서 컬럼 개수를 반환할지 여부
Return
typedescription
Number헤더의 컬럼 개수
Sample
// 헤더의 전체 컬럼의 개수 반환 grd_gridView1.getTotalHeaderCol(true);
getTotalRow( )
행의 총 개수를 반환
Return
typedescription
Number행의 총 개수
Sample
// 그리드 전체 행의 개수를 반환 grd_gridView1.getTotalRow();
getUncheckedData( colIndex )
특정 컬럼의 inputType속성이 radio/checkbox인 경우, 체크되지 않은 행의 데이터를 배열로 반환
Parameter
nametyperequireddescription
colIndexNumber||StringY체크박스의 컬럼 인덱스 또는 아이디
Return
typedescription
Array행 데이터를 2차원 배열로 저장
Sample
//체크박스, 이름, 생년월일이 순서대로 컬럼에 정의된 그리드가 있고 inputType 속성이 "checkbox"인 컬럼의 아이디가 "chk"인 경우 var tmpRs = grd_gridView1.getUncheckedData("chk"); // (반환 예) [["0","아이유","19930516"],["0","정형돈","19780207"],["0","유승호","19930817"]]
getUncheckedIndex( colIndex )
특정 컬럼의 inputType속성이 radio/checkbox인 경우, 체크되지 않은 행의 인덱스를 배열로 반환
Parameter
nametyperequireddescription
colIndexNumber||StringY체크박스의 컬럼 인덱스 또는 아이디
Return
typedescription
Array행 인덱스가 담긴 1차원 배열
Sample
// 체크박스, 이름, 생년월일이 순서대로 컬럼에 정의된 그리드가 있고 inputType속성이 "checkbox"인 컬럼의 아이디가 "chk"인 경우 grd_gridView1.getUncheckedIndex("chk"); // (반환 예) [0, 2, 3]
getUncheckedJSON( colIndex )
특정 컬럼의 inputType 속성이 radio/checkbox인 경우, 체크되지 않은 행의 데이터를 JSON으로 변환하여 배열에 담아 반환
Parameter
nametyperequireddescription
colIndexNumber||StringY체크박스의 컬럼 인덱스 또는 아이디
Return
typedescription
Array행의 JSON 데이터를 담은 1차원 배열
//체크박스, 이름, 생년월일이 순서대로 컬럼에 정의된 그리드가 있고 inputType속성이 "checkbox"인 컬럼의 아이디가 "chk"인 경우 var tmpRs = grd_gridView1.getUncheckedJSON("chk"); // (반환 예) [{"name":"아이유","birthday":"19930516","chk":"0","rowStatus":"R"},{"name":"정형돈","birthday":"19780207","chk":"0","rowStatus":"R"}]
getUncheckedXML( colIndex )
특정 컬럼의 inputType 속성이 radio/checkbox인 경우, 체크되지 않은 행의 데이터를 XML로 변환하여 배열에 담아 반환
Parameter
nametyperequireddescription
colIndexNumber||StringY체크박스의 컬럼 인덱스 또는 아이디
Return
typedescription
XMLXML 데이터
Sample
//체크박스, 이름, 생년월일이 순서대로 컬럼에 정의된 그리드가 있고, inputType 속성이 "checkbox"인 컬럼의 아이디가 "chk"인 경우 var tmpRs = grd_gridView1.getUncheckedXML("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 )
특정 컬럼의 화면에 보이는 데이터(필터나 정렬이 반영된)를 배열로 반환
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼 인덱스 또는 아이디
Return
typedescription
Array특정 컬럼의 데이터가 담긴 배열
Sample
// 'a' 컬럼의 데이터 배열로 필터나 정렬 처리가 되어 있을 경우, 'a' 컬럼의 getColData('a') 데이터와 차이가 있을 수 있음 var returnArr = grd_gridView1.getVisibleColData('a');
getVisibleRowNum( )
현재 화면(눈에 보여지는 영역)에 그려진 행의 수를 반환 (부분합 및 푸터는 제외)
총 10건의 행의 데이터가 설정된 경우, 화면에는 4건이 표시되고 넘치는 영역은 스크롤로 표현 될 때 반환값은 "4"
Return
typedescription
Number현재 화면 보이는 행의 수
Sample
// 현재 그리드에 그려진(보이는) 행의 수를 반환 var returnValue = grd_gridView1.getVisibleRowNum();
groupby( Options )
둘 이상의 컬럼의 데이터를 그룹핑하여 결과(통계)만 표시 (!주의!) columnMove 속성과 동시에 사용할 수 없음
Parameter
nametyperequireddescription
OptionsObjectN그룹핑 옵션
<Boolean:N> options.closeGroup : 그룹핑 결과물 숨김 상태 <Boolean:N> options.rowNumHeader : rowNumVisible이 "true"인 경우, 전체 건수를 헤더에 표시 <Boolean:N> options.rowNumFooter : rowNumVisible이 "true"인 경우, 전체 건수를 푸터에 표시 <Boolean:N> options.rowStatusHeader : rowStatusVisible이 "true"인 경우, 전체 건수를 헤더에 표시 <Boolean:N> options.rowStatusFooter : rowStatusVisible이 "true"인 경우, 전체 건수를 푸터에 표시 <Object:N> options.groupbyHeader : 전체 건수를 헤더에 표현하는 방식 설정 <Object:N> options.groupbyFooter : 전체 건수를 푸터에 표현하는 방식 설정 <Boolean:N> options.showOnlyLastDepth : depthStr()에 의해 깊이 정보 표시할 경우 마지막 깊이만 표시 <Array:N> options.sortIndex : 정렬될 컬럼 인덱스 <Array:N> options.sortOrder : 1로 설정되면 오름차순 정렬, -1로 설정되면 내림차순 정렬 <Boolean:N> options.hideHeader : 결과물의 숨김 상태 <Boolean:N> options.hideFooter : 결과물의 숨김 상태
Sample
var options = { sortIndex: [2], sortOrder: [1], hideHeader: false, hideFooter: true, groupbyHeader: { depth_0: [{colSpan:"3", value: "일자별 합계"}, {inputType: "expression", expression: " SUM('complete')", className:"aaa"}] } }; grd_gridView1.groupby(options);
hasChild( rowIndex )
드릴다운이 적용 된 경우 자식 행을 가지고 있는지의 여부를 반환
Parameter
nametyperequireddescription
rowIndexNumberY자식 행을 가지고 있는지 확인할 행 인덱스
Return
typedescription
Boolean자식 행을 가지고 있는지 여부
Sample
// 첫번째 행이 leaf가 아닌 경우 true를, leaf이면 false를 반환 // 컬럼의 inputType이 드릴다운일 경우 사용 가능한 API로, 드릴다운이 아닐 경우, 에러 발생 var returnValue = grd_gridView1.hasChild(0);
hideGroupbyZone( )
그룹핑 정보를 관리하는 GroupbyZone 영역을 숨김
Sample
grd_gridView1.hideGroupbyZone();
initGrid( )
전체 데이터 삭제, 필터 삭제, 컬럼 기본정보(SelectBox의 노드셋 등)를 초기화하고, 가지고 있던 데이터를 1차원 배열로 반환
Return
typedescription
array전체 데이터를 담은 1차원 배열
isEditing( )
현재 편집 상태를 반환
Return
typedescription
Boolean편집 상태인지의 여부
mergeByCol( options )
같은 컬럼 내에서 같은 데이터가 연속적으로 나타나는 경우 이들을 모두 병합 (세로 병합)
Parameter
nametyperequireddescription
optionsObjectN병합 세부 설정
<Boolean:N> options.noDraw 그리드를 갱신하지 않음 (병합을 여러번 실행할 때 성능 개선을 위해 사용됨) <Boolean:N> options.keepMerge 이전에 병합된 내용을 유지 <Boolean:N> options.fixedRows fixedRow 영역으로 제한 <Boolean:N> options.fixedCols fixedColumn 영역으로 제한
Sample
// 같은 컬럼 내에서 같은 데이터가 연속적으로 나타는 경우 모두 병합 grd_gridView1.mergeByCol();
mergeByColRec( options )
컬럼을 기준으로 병합을 수행하고, 그 후에 병합되지 않은 셀을 대상으로 행을 기준으로 병합을 수행
(단, 세로 병합이 더 우선순위가 높음)
Parameter
nametyperequireddescription
optionsJSONN병합 세부 설정
<Boolean:N> options.noDraw 그리드를 갱신하지 않음 (병합을 여러번 실행할 때 성능 개선을 위해 사용됨) <Boolean:N> options.keepMerge 이전에 병합된 내용을 유지 <Boolean:N> options.fixedRows fixedRow 영역으로 제한 <Boolean:N> options.fixedCols fixedColumn 영역으로 제한
Sample
// 컬럼을 기준으로 병합을 수행하고, 그 후에 병합되지 않은 셀을 대상으로 행을 기준으로 병합 grd_gridView1.mergeByColRec();
mergeByRestricColmergeByRestricCol( options )
같은 컬럼 내에서 연속적으로 데이터가 같으면서 동시에 자신의 왼쪽에 위치한 컬럼이 병합된 경우 해당 행들을 병합
n+1컬럼에서 n컬럼을 상위 컬럼으로 지정한 형태
Parameter
nametyperequireddescription
optionsJSONN병합 세부 설정
<Boolean:N> options.noDraw 그리드를 갱신하지 않음 (병합을 여러 번 실행할 때 성능 개선을 위해 사용됨) <Boolean:N> options.keepMerge 이전에 병합된 내용을 유지
Sample
grd_gridView1.mergeByRestricCol();
mergeByRestricRow( options )
같은 row 내에서 연속적으로 데이터가 같으면서 동시에 자신의 위쪽에 위치한 row가 merge된 경우 해당 row들을 병합.
n+1행에서 n행을 upperRow으로 지정한 형태.
Parameter
nametyperequireddescription
optionsJSONN병합 세부 설정.
<Boolean:N> options.noDraw 그리드를 갱신하지 않음. (병합을 여러번 실행할 때 성능 개선을 위해 사용됨.) <Boolean:N> options.keepMerge 이전에 병합된 내용을 유지.
mergeByRow( options )
같은 행 내에서 같은 데이터가 연속적으로 나타나는경우 이들을 모두 병합 (가로 병합)
Parameter
nametyperequireddescription
optionsJSONN병합 세부 설정
<Boolean:N> options.noDraw 그리드를 갱신하지 않음 (병합을 여러번 실행할 때 성능 개선을 위해 사용됨) <Boolean:N> options.keepMerge 이전에 병합된 내용을 유지 <Boolean:N> options.fixedRows fixedRow 영역으로 제한 <Boolean:N> options.fixedCols fixedColumn 영역으로 제한
Sample
grd_gridView1.mergeByRow();
mergeByRowRec( options )
행을 기준으로 병합을 수행하고, 그 후에 병합되지 않은 셀을 대상으로 컬럼을 기준으로 병합을 수행
(단, 가로 병합이 더 우선순위가 높음)
Parameter
nametyperequireddescription
optionsJSONN병합 세부 설정
<Boolean:N> options.noDraw 그리드를 갱신하지 않음 (병합을 여러번 실행할 때 성능 개선을 위해 사용됨) <Boolean:N> options.keepMerge 이전에 병합된 내용을 유지 <Boolean:N> options.fixedRows fixedRow 영역으로 제한 <Boolean:N> options.fixedCols fixedColumn 영역으로 제한
Sample
grd_gridView1.mergeByRowRec();
mergeCell( mergeInfo )
동적으로 셀을 병합
Parameter
nametyperequireddescription
mergeInfoJSONY병합 대상 셀의 정보를 포함한 객체 (rowIndex, colIndex, colSpan, rowSpan)
<Number:Y> mergeInfo.rowIndex 병합 시작 지점 좌표값 (행 인덱스) (여러 셀 병합 시 왼쪽 최상단 셀의 인덱스를 입력) <Number:Y> mergeInfo.colIndex 병합 시작 지점 좌표값 (컬럼 인덱스) <Number:Y> mergeInfo.colSpan 병합할 컬럼의 수 <Number:Y> mergeInfo.rowSpan 병합할 행의 수
Sample
// 실행결과 : (3, 2) 좌표에 위치한 셀이 2 2 크기로 병합 // 즉 (3, 2), (3, 3), (4, 2), (4, 3)셀이 병합되며, 병합된 셀은 모두 (3, 2)의 데이터를 가짐 grd_gridView1.mergeCell({"rowIndex" : 3, "colIndex" : 2, "colSpan" : 2, "rowSpan" : 2});
mergeCells( mergeOptionStr , options )
행 또는 컬럼 기준으로 연속적으로 같은 데이터들을 아래의 5가지 방식 중 하나로 병합한다.
never : 병합을 해제한다.
bycol : 같은 컬럼에서 연속적으로 데이터가 같은 행들을 병합
byrow : 같은 행에서 연속적으로 데이터가 같은 컬럼들을 병합
bycolrec : bycol로 병합 후, 병합되지 않은 셀을 대상으로 byrow를 실행
byrowrec : byrow로 병합 후, 병합되지 않은 셀을 대상으로 bycol을 실행
Parameter
nametyperequireddescription
mergeOptionStrStringY병합 방식을 지정한다. ["never", "bycol", "byrow", "bycolrec", "byrowrec"] 값 중 하나를 지정해야 한다.
optionsJSONN병합 세부 설정
<Boolean:N> options.noDraw 그리드를 갱신하지 않음 (병합을 여러번 실행할 때 성능 개선을 위해 사용됨) <Boolean:N> options.keepMerge 이전에 병합된 내용을 유지 <Boolean:N> options.fixedRows fixedRow 영역으로 제한 <Boolean:N> options.fixedCols fixedColumn 영역으로 제한
Sample
// mergeOptionStr의 값을 "bycol"로 설정한 경우, 컬럼을 기준으로 연속적으로 같은 데이터들을 병합 grd_gridView1.mergeCells("bycol");
mergeCellsFixedCols( mergeOptionStr , options )
fixedColumn 영역 내에서 행 또는 컬럼 기준으로 연속적으로 같은 데이터들을 아래의 5가지 방식 중 하나로 병합한다.
never : 병합을 해제한다.
bycol : 같은 컬럼에서 연속적으로 데이터가 같은 행들을 병합
byrow : 같은 행에서 연속적으로 데이터가 같은 컬럼들을 병합
bycolrec : bycol로 병합 후, 병합되지 않은 셀을 대상으로 byrow를 실행
byrowrec : byrow로 병합 후, 병합되지 않은 셀을 대상으로 bycol을 실행
Parameter
nametyperequireddescription
mergeOptionStrStringY병합 방식을 지정한다. ["never", "bycol", "byrow", "bycolrec", "byrowrec"] 값 중 하나를 지정해야 한다.
optionsJSONN병합 세부 설정
<Boolean:N> options.noDraw 그리드를 갱신하지 않음 (병합을 여러번 실행할 때 성능 개선을 위해 사용됨) <Boolean:N> options.keepMerge 이전에 병합된 내용을 유지. 이 API를 호출할 경우 keepMerge 속성이 강제로 "true"로 설정 <Boolean:N> options.fixedRows fixedRow 영역으로 제한 <Boolean:N> options.fixedCols fixedColumn 영역으로 제한. 이 API를 호출할 경우 fixedCols 속성이 강제로 "true"로 설정
Sample
// mergeOptionStr의 값을 "bycol"로 설정한 경우, fixedColumn 영역 내에서 컬럼을 기준으로연속적으로 같은 데이터들을 병합 grd_gridView1.mergeCellsFixedCols("bycol");
mergeCellsFixedRows( mergeOptionStr , options )
fixedRow 영역 내에서 행 또는 컬럼 기준으로 연속적으로 같은 데이터들을 아래의 5가지 방식 중 하나로 병합한다.
never : 병합을 해제한다.
bycol : 같은 컬럼에서 연속적으로 데이터가 같은 행들을 병합
byrow : 같은 행에서 연속적으로 데이터가 같은 컬럼들을 병합
bycolrec : bycol로 병합 후, 병합되지 않은 셀을 대상으로 byrow를 실행
byrowrec : byrow로 병합 후, 병합되지 않은 셀을 대상으로 bycol을 실행
Parameter
nametyperequireddescription
mergeOptionStrStringY병합 방식을 지정한다. ["never", "bycol", "byrow", "bycolrec", "byrowrec"] 값 중 하나를 지정해야 한다.
optionsJSONN병합 세부 설정
<Boolean:N> options.noDraw 그리드를 갱신하지 않음 (병합을 여러번 실행할 때 성능 개선을 위해 사용됨) <Boolean:N> options.keepMerge 이전에 병합된 내용을 유지. 이 API를 호출할 경우 keepMerge 속성이 강제로 "true"로 설정 <Boolean:N> options.fixedRows fixedRow 영역으로 제한. 이 API를 호출할 경우 fixedRows 속성이 강제로 "true"로 설정 <Boolean:N> options.fixedCols fixedColumn 영역으로 제한
Sample
// mergeOptionStr의 값을 "bycol"로 설정한 경우, fixedRow 영역 내에서 컬럼을 기준으로연속적으로 같은 데이터들을 병합 grd_gridView1.mergeCellsFixedRows("bycol");
mergeClear( )
동적으로 병합된 셀들의 병합을 모두 해제
mergeCell 또는 mergeCells 등의 API에 의해 동적으로 병합된 셀들의 병합만 해제
mergeCol( colIndex , flag )
데이터를 통해 자동으로 병합하는 기능을 사용할 때, 특정 컬럼을 제외하기 위해 사용
Parameter
nametyperequireddescription
colIndexNumberY자동으로 병합하는 기능을 사용할지를 지정할 대상 컬럼
flagBooleanY[default: true, false] 적용 여부
Sample
// 특정 컬럼을 제외한 병합을 할 때 다음 순서대로 진행 grd_gridView1.mergeCol(1, false); // 2번째 컬럼을 데이터를 통한 병합 기능에서 제외 grd_gridView1.mergeByCol(); // 2번째 컬럼을 제외하고 컬럼을 기준으로 한 병합
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 )
데이터를 통해 자동으로 병합하는 기능을 사용할 때 특정 행을 제외하기 위해 사용
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
flagBooleanY[defalut: false, true] 제외 여부
Sample
// 2번째 row를 data를 통한 merge기능에서 제외 grd_grid1.mergeRow(1, false); // 2번째 row를 제외하고 mergeByRow가 수행됨 |grd_grid1.mergeByRow();
mergeSplitFocusedCell( )
포커스가 위치한 셀의 병합을 해제
Sample
// (6,6),(6,7),(7,6),(7,7)이 병합된 셀에 포커스를 둔 채로 아래를 실행 grd_gridView1.mergeFocusedCell(); // 실행결과 : (6,6), (6,7), (7,6), (7,7) 셀로 각각 분할
modifyCheckedStatus( colIndex , status )
inputType이 "checkbox"인 경우 체크가 되어있는 행의 상태코드 값을 일괄 변경
Parameter
nametyperequireddescription
colIndexString|NumberY컬럼의 인덱스 또는 아이디
statusStringY[R,C,U,D,V]변경할 상태코드 값
Sample
//첫번째, 네번째 행의 CheckBox는 체크가 되어있고 두번째, 세번째 행의 CheckBox는 체크가 되어있지 않을 경우 //첫번째, 네번째 행의 상태 값을 C 상태로 변경 grd_gridView1.modifyCheckedStatus("chk_col","C");
modifyUncheckStatus( col , status )
inputType이 "checkbox"인 경우 체크가 되지 않은 행의 상태코드 값을 일괄 변경
Parameter
nametyperequireddescription
colString|NumberY컬럼의 인덱스 또는 아이디
statusStringY[R,C,U,D,V]변경할 상태코드값
Sample
//첫번째, 네번째 행의 CheckBox는 체크가 되어있고 두번째, 세번째 행의 CheckBox는 체크가 되어있지 않을 경우 //두번째, 세번째 행의 상태 값을 일괄 D 상태로 변경 grd_gridView1.modifyUncheckedStatus("chk_col","D");
moveFooterColumn( fromIdx , toIdx )
푸터 컬럼의 위치 이동
Parameter
nametyperequireddescription
fromIdxStringY푸터의 이동 대상 컬럼의 아이디 혹은 인덱스
toIdxStringY푸터의 이동 목적지 오른쪽에 위치할 컬럼의 아이디 혹은 인덱스
Sample
// 실행결과: column5가 column2의 바로 왼쪽, 혹은 column2 이전의 위치로 이동 grd_gridView1.moveFooterColumn("column5, "column2");
readCSV( options )
CSV 파일을 읽어 GridView의 데이터로 설정 (JDK 1.5이상에서 사용 가능)
Parameter
nametyperequireddescription
optionsJSONYCSV 정보 (JSON 형태)
기본 옵션 <String:N> options.popupUrl 업로드시에 호출할 팝업의 경로(URL) <String:N> options.status [default: R] 업로드된 데이터의 초기 상태 값 데이터 옵션 <String:N> options.type [default: 1, 0] inputType이 "select", "autoComplete", "checkComboBox"인 경우 사용할 데이터 (0 : value 값 사용, 1 : label 값 사용, 2 : displayMode 설정에 따라 "value delim label" 혹은 "label delim value" 값을 사용) <String:N> options.header [default: 1, 0] [default: 1, 0] 헤더의 존재 여부 (0 : 헤더 행의 수 무시하고 전부 업로드, 1 : 헤더 행의 수 만큼 건너 뜀) <String:N> options.delim [default: ","] CSV 파일에서 데이터 구분자 <String:N> options.escapeChar CSV 데이터에서 제거해야 되는 문자셋 ( ex> '\'' ) <Number:N> options.startRowIndex [default: 0] GridView의 데이터가 시작되는 행의 번호 (startRowIndex가 설정되면 헤더 설정은 무시됨) <String:N> options.append [default: 0, 1] 데이터를 GridView에 추가 시킬지 여부 (1 : 현재 GridView의 데이터에 추가로 넣어줌, 0 : 현재 GridView의 데이터를 삭제하고 넣어줌) <String:N> options.skipSpace [default: 0, 1] expression 컬럼 데이터를 포함하고 있는지 여부 (1 : 미포함, 0 : 포함) <String:N> options.ignoreSpan [default: 0, 1] 병합되어 있는 경우 병합을 무시하고 데이터를 읽을지 여부 (0 : 병합되어 있는 컬럼을 하나로 읽음, 1 : 병합되어 있는 컬럼을 각각 읽음) 숨김 컬럼 옵션 <Number:N> options.hidden [default: 0, 1] 숨김 컬럼에 대한 사용 여부 (0 : 사용하지 않음, 1 : 사용) <String:N> options.fillHidden [default: 0, 1] 숨김 컬럼에 빈 값을 넣을지 여부 (1 : 빈 값을 사용하지 않음, 0 : 숨김 컬럼이 저장되어있지 않은 파일이라 간주하고 숨김 컬럼에 빈 값을 넣어줌) options.hidden이 0인 경우에는 영향을 끼치지 않음 업로드 창 옵션 <String:N> options.useModalDisable [default: false, true] 팝업창이 활성화 될때 부모창의 컴포넌트 비활성화 처리 유무 기타 옵션 <String:N> options.optionParam [default: ""] 파일암호와(DRM) 연계시 사용자 정의 Class에 HashMap 인자로 전달할 값 (key는 "optionParam"으로 참조) <String:N> options.trim : [default: 0] 엑셀 각각의 셀데이터 좌, 우에 공백이 있는 경우 제거할지 여부 (1이면 제거, 0이면 유지)
Sample
var options = { type: "1", delim: ",", escapeChar: "'", startRowIndex: 1, append: "0", hidden: "0", fillHidden: "0", skipSpace: "1" }; grd_gridView1.readCSV(options); //별도의 옵션이 없을 경우 빈 객체를 파라메터로 넘겨줘야 한다 grd_gridView1.readCSV({});
redrawColumn( colIndex , valid )
컬럼을 다시 그려줌 (Reset)
Parameter
nametyperequireddescription
colIndexString||NumberY컬럼 아이디 또는 인덱스
validBooleanN[default: true, false] inputType이 "select"인 경우 SelectBox와 셀의 값의 적합성에 따라 데이터를 처리 유무
Sample
grd_gridView1.redrawColumn("col1");
refreshCell( rowIndex , colIndex )
특정 셀을 다시 렌더링 함
Parameter
nametyperequireddescription
rowIndexNumberY행 인덱스
colIndexNumberY컬럼 아이디 또는 인덱스
Sample
grd_gridView1.refreshCell(0, "col1");
refreshColumn( colIndex )
컬럼을 다시 렌더링 함
Parameter
nametyperequireddescription
colIndexNumberY컬럼 아이디 또는 인덱스
Sample
grd_gridView1.refreshColumn("col1");
refreshColumnItemset( col )
inputType이 "select"인 경우 컬럼의 itemset을 갱신
Parameter
nametyperequireddescription
colStringY컬럼 아이디 또는 인덱스
Sample
grd_gridView1.refreshColumnItemset("col1");
refreshRow( rowIndex )
행을 다시 렌더링 함
Parameter
nametyperequireddescription
rowIndexNumberY행 인덱스
Sample
grd_gridView1.refreshRow(0);
removeCellClass( rowIndex , colIndex )
셀에 적용된 Class를 삭제
Parameter
nametyperequireddescription
rowIndexNumberY행 인덱스
colIndexNumberY컬럼 아이디 또는 인덱스
Sample
grd_gridView1.removeCellClass(0, "col1");
removeColumnClass( colIndex , class )
컬럼에 적용된 사용자 Class를 삭제 (복수로 지정시 띄어쓰기(" ")를 구분자로 사용)
Parameter
nametyperequireddescription
colIndexNumberY컬럼 아이디 또는 인덱스
classStringY삭제할 Class 명
Sample
grd_gridView1.removeColumnClass("col1", "CRed CBlue");
removeFocusedCell( )
선택되어진 셀 모두의 포커스를 해제
Sample
grd_gridView1.removeFocusedCell();
removeFocusedMultiCell( startRow , startCol , endRow , endCol )
설정 영역만큼의 셀에 포커스를 해제
Parameter
nametyperequireddescription
startRowNumberY영역의 시작 행의 인덱스
startColNumberY영역의 시작 컬럼의 인덱스
endRowNumberY영역의 종료 행의 인덱스
endColNumberY영역의 종료 컬럼의 인덱스
Sample
// 실행결과 : (3,2), (3,3), (4,2), (4,3)셀의 포커스가 해제됨 // 포커스가 걸려있지 않았던 셀은 아무 동작을 하지 않음 grd_gridView1.removeFocusedMultiCell(3,2,4,3);
removeHeaderClass( headerId , class )
헤더 컬럼에 적용된 사용자 Class를 삭제
Parameter
nametyperequireddescription
headerIdNumberY헤더 컬럼 아이디 혹은 인덱스
classStringY삭제할 Class 명
Sample
grd_gridView1.removeHeaderClass("column1", "CRed");
removeRowClass( rowIndex )
grid Row에 적용된 사용자 class를 삭제
Parameter
nametyperequireddescription
rowIndexNumberYrow의 행번호
saveCSV( options )
데이터를 CSV 파일로 저장 (JDK 1.5이상에서 사용 가능)
Parameter
nametyperequireddescription
optionsJSONYCSV 정보 (JSON 형태)
기본 옵션 <String:N> options.fileName [default: "csvfile.csv"] 저장파일 명 <String:N> options.delim [default: ';'] 데이터 구분자 다운로드 데이터 옵션 <String:N> options.type [default: 1, 0] inputType이 "select", "autoComplete", "checkComboBox"인 경우 사용할 데이터 (0 : value 값 사용, 1 : label 값 사용, 2 : displayMode 설정에 따라 "value delim label" 혹은 "label delim value" 값을 사용) <String:N> options.removeColumns [default: ""] 저장에서 제외할 컬럼의 인덱스 (콤마(,)로 구분) <String:N> options.header [default: 1, 0] 헤더의 저장 여부 (0 : 저장 하지 않음, 1 : 저장) <Number:N> options.hidden [default: 0, 1] 숨겨진 컬럼의 저장 여부 (0 : 저장 하지 않음, 1 : 저장) <String:N> options.checkButton [default: 1, 0] inputType이 "checkBox", "radio", "button"인 경우 감춤 여부 (0 : 감춤, 1 : 보여줌) <Array:N> options.saveList [default: ""] 숨김에 관계없이 최우선 순위로 저장할 컬럼 아이디들의 배열 <String:N> options.aposPrefixOnNum [default: 0, 1] dataType이 "number"이고 "length"가 12자리 이상인 경우 숫자처리(apos) 여부 (0 : 숫자처리 안함, 1 : 숫자처리) <String:N> options.removeQuotation [default: 0, 1] 값에 ", ' 가 들어있는 경우 ", '를 지울지 여부 (0 : 안 지움, 1 : 지움) <String:N> options.removeNewLine [default: 1, 0] 값에 \r\n이 있을 경우 삭제 유무 (0 : 안 지움, 1 : 지움) 컬럼 이동 옵션 <String:N> options.columnMove [default: false, true] 컬럼 이동된 상태로 다운로드 유무 (false : 이동되지 않은 상태로 출력, true : 이동된 순서대로 출력 ) <String:N> options.columnOrder [default: ""] 다운로드되는 컬럼 순서를 지정 할 수 있는 속성 ( 예시> "0,3,2,1".) 드릴다운 및 병합 옵션 <String:N> options.spanAll [default: false, true] inputType이 "drilldown"이 있는 경우 전체 목록을 펼쳐서 다운로드 할 수 있는 속성 (false : 보여지는 목록만 출력, true : 전체 목록 출력) <String:N> options.ignoreSpan [default: 0, 1] 병합되어 있는 경우 병합을 무시하고 데이터를 채울지 여부 (0 : 병합을 유지, 1 : 병합을 무시) 기타 옵션 <String:N> options.optionParam [default: ""] 파일암호와(DRM) 연계시 사용자 정의 Class에 HashMap 인자로 전달할 값 (key는 "optionParam"으로 참조) <String:N> options.trim [default: 0, 1] gridView 데이터를 좌우 공백 적용유무 ("0"이면 공백 제거 하지 않음, 1".이면 공백 제거후 적용)
Sample
//저장 할 컬럼 정의 var colArr = []; colArr[0] = "name"; colArr[1] = "corp"; //저장 옵션 var options = { fileName: "saveCSV.csv", type: "1", delim: ";", saveList: colArr }; grd_gridView1.saveCSV(options); //별도의 옵션이 없을 경우 빈 객체를 파라메터로 넘겨줘야 한다. grd_gridView1.saveCSV({});
setAutoFit( options )
컬럼 너비 조절을 자동으로 해주는 autoFit 속성을 설정
Parameter
nametyperequireddescription
optionsObjectNautoFit 설정 정보 (JSON 형태)
<String:N> options.type : [default: none, lastColumn, allColumn] 자동설정 유형 <Number:N> options.minWidth : GridView의 최소 넓이 (단위: px). lastColumn인 경우는 적용되지 않음
Sample
var options = { type : "allColumn", minWidth : 480 } grd_gridView1.setAutoFit( options ); GridView의 너비가 480px보다 작아질 경우에는 각 컬럼의 너비의 함은 480px로 고정되며, 480px에 맞게 각 컬럼 너비가 변경 GridView의 너비가 480px보다 큰 경우는 GridView의 너비에 맞게 각 컬럼 너비가 변경
setBlockSelect( colIndex , flag )
컬럼의 blockSelect 속성을 설정 (관련 속성) [GridView.column] blockSelect
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
flagnumberY[false, true] 선택 차단 여부
Sample
grd_gridView1.setBlockSelect("col1", true);
setBottomRowIndex( bottomRowIndex )
bottomRowIndex에 해당하는 행이 가장 하단에 위치하도록 세로 스크롤의 위치를 옮겨줌
Parameter
nametyperequireddescription
bottomRowIndexNumberY최하단에 위치할 행의 인덱스
Sample
grd_gridView1.setBottomRowIndex(20);
setCaption( htmlStr )
GridView의 태그의 caption의 속성 값 설정 [웹접근성 준수를 위해 사용]
Parameter
nametyperequireddescription
htmlStrStringYcaption 속성에 설정될 문자열
Sample
grd_gridView1.setCaption("Project Caption");
setCaptionAuto( captionTitle )
GridView의 요약 태그인 캡션 값(CaptionTitle)을 설정 (관련 속성) captionTitle captionAuto
Parameter
nametyperequireddescription
captionTitleStringN캡션 값(CaptionTitle)
Sample
grd_gridView1.setCaptionAuto("New Title");
setCellAllowChar( rowIndex , colIndex , allowChar )
inputType이 "custom"인 경우 특정 셀의 allowChar 속성을 설정 (관련 속성) setCellInputTypeCustom = "true"
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexNumberY컬럼의 아이디 혹은 인덱스
allowCharStringY입력제한 정보
Sample
grd_gridView1.setCellAllowChar(0, "col1", "a-z");
setCellBackgroundColor( rowIndex , colIndex , color )
특정 셀의 사용자 배경색을 설정
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
colorStringY배경색
Sample
grd_gridView1.setCellBackgroundColor(0, "col1", "red");
setCellChecked( rowIndex , colIndex , flag )
inputType이 "checkbox" 혹은 "radio"인 경우 해당 셀을 선택하거나 선택 해제
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexString||NumberY컬럼의 아이디 혹은 인덱스
flagBooleanY[false, true] 체크 여부
Sample
grd_gridView1.setCellChecked(0, "col1", true);
setCellClass( rowIndex , colIndex , className )
특정 셀의 사용자 Class 설정
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexNumberY컬럼의 아이디 혹은 인덱스
classNameStringYClass명
Sample
// 0번째 행의 "col1" 컬럼에 "cRed" 클래스를 적용 grd_gridView1.setCellClass(0, "col1", "cRed"); // 0번째 행의 "col1" 컬럼에 "cRed" 및 "cBlue" 클래스를 적용 grd_gridView1.setCellClass(0, "col1", "cRed cBlue");
setCellColor( rowIndex , colIndex , color )
특정 셀의 글자색을 설정
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
colorStringY글자색
Sample
grd_gridView1.setCellColor(0, "col1", "red");
setCellCustomFormatter( rowIndex , colIndex , formatter )
inputType이 "custom"인 경우 특정 셀의 데이터의 표현식을 조건에 맞추어 변경하기 위한 사용자 함수를 설정하는 customFormatter 속성 값을 변경 (관련 속성) setCellInputTypeCustom = "true"
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexNumberY컬럼의 아이디 혹은 인덱스
formatterStringY사용자 함수
Sample
grd_gridView1.setCellCustomFormatter("col1", "scwin.setCellCustomFormatter");
setCellDataType( rowIndex , colIndex , dataType )
inputType이 "custom"인 경우 특정 셀의 dataType 속성을 설정 (관련 속성) setCellInputTypeCustom = "true"
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexNumberY컬럼의 아이디 혹은 인덱스
dataTypeStringY셀의 dataType
Sample
grd_gridView1.setCellDataType(0, "col1", "number");
setCellDisabled( rowIndex , colIndex , disabled )
특정 셀의 disabled 속성을 설정
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
disabledBooleanY[default: false, true] 비활성화 여부
Sample
grd_gridView1.setCellDisabled(0, "col1", true);
setCellDisableEdit( rowIndex , colIndex , onoff )
inputType이 "custom"인 셀이 "autoComplete"으로 설정된 경우 특정 셀의 disableEdit 속성을 변경 (관련 속성) setCellInputTypeCustom = "true"
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexNumberY컬럼의 아이디 혹은 인덱스
onoffStringY[default: false, true] 편집 가능 여부
Sample
grd_gridView1.setCellDisableEdit(0, "col1", true);
setCellDisplayFormat( rowIndex , colIndex , displayFormat )
inputType이 "custom"인 경우 특정 셀에 데이터의 표현식을 설정하는 displayFormat 속성 값을 변경 (관련 속성) setCellInputTypeCustom = "true"
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexNumberY컬럼의 아이디 혹은 인덱스
displayFormatStringY데이터의 표현식
Sample
grd_gridView1.setCellDisplayFormat(0, "col1", "#,##0.00");
setCellDisplayFormatter( rowIndex , colIndex , formatter )
inputType이 "custom"인 경우 특정 셀에 데이터의 표현식을 조건에 맞추어 변경하기 위한 사용자 함수를 설정하는 displayFormatter 속성 값을 변경 (관련 속성) setCellInputTypeCustom = "true"
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexNumberY컬럼의 아이디 혹은 인덱스
formatterStringY사용자 함수
Sample
grd_gridView1.setCellDisplayFormatter(0, "col1", "scwin.setCellDisplayFormatter");
setCellInputType( rowIndex , colIndex , info )
inputType이 "custom"인 경우 특정 셀의 inputType을 변경 (관련 속성) setCellInputTypeCustom = "true"
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexStringY컬럼의 아이디 혹은 인덱스
infoObjectYinputType에 대한 JSON형태의 정보
<String:N> info.id : 셀의 아이디 <String:Y> info.inputType : 지정할 inputType <String:N> info.options : inputType에 대한 옵션 <String:N> info.itemSet : nodeset정보를 담은 객체 <String:N> info.itemSet.nodeset : DataList의 아이디. "data:"로 시작해야 함 <String:N> info.itemSet.label : 라벨로 지정할 컬럼의 아이디 <String:N> info.itemSet.value : 값으로 지정할 컬럼의 아이디
Sample
var info = { inputType : "select", options : { selectedData : false, viewType: "icon", chooseOption: true }, itemSet : { nodeset: "data:dlrt_dataList1", label: "label", value: "value" } } // 첫 번째 행, "a" 컬럼에 해당하는 셀의 inputType을 select로 변경 grd_gridView1.setCellInputType(0, "a", info);
setCellMaxLength( rowIndex , colIndex , maxLength )
inputType이 "custom"인 경우 특정 셀의 maxLength 속성을 설정 (관련 속성) setCellInputTypeCustom = "true"
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexString|NumberY컬럼의 아이디 혹은 인덱스
maxLengthString|NumberY입력 허용 최대 값
setCellReadOnly( rowIndex , colIndex , readOnly )
특정 셀에 읽기전용(ReadOnly) 속성을 설정
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
readOnlyBooleanY[default: false, true] 읽기전용 여부
Sample
//1번째 행에 "col1" 컬럼에 읽기전용(ReadOnly) 속성을 적용 할 경우 grd_gridView1.setCellReadOnly(0, "col1", true);
setCellStyle( rowIndex , colIndex , styleName , styleValue )
특정 셀에 스타일을 설정
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colIndexStringY컬럼의 아이디 혹은 인덱스
styleNameStringY적용할 CSS 속성명
styleValueStringY적용할 CSS 속성값
Sample
// 0번째 행의 컬럼 아이디가 "col1"인 글자색을 "Red"로 설정 grd_gridView1.setCellStyle(0, "col1", "color", "red"); // 0번째 행의 컬럼 아이디가 "col1"인 배경색을 "Blue"로 설정 grd_gridView1.setCellStyle(0, "col1", "background-color", "blue");
setColumnBackgroundColor( colIndex , color )
컬럼의 배경색 설정
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
colorStringY배경색
Sample
grd_gridView1.setColumnBackgroundColor("col1", "red");
setColumnChooseOption( colIndex , chooseOptionValue , chooseOptionLabel )
inputType이 "select"인 경우 SelectBox의 선택옵션(ChooseOption) 의 값과 라벨을 변경
Parameter
nametyperequireddescription
colIndexNumberY컬럼의 인덱스
chooseOptionValueStringY새롭게 지정할 옵션의 값
chooseOptionLabelStringY새롭게 지정할 옵션의 라벨
Sample
grd_gridView1.setColumnChooseOption(1,"","- Select -");
setColumnClass( colIndex , className )
컬럼의 사용자 Class 설정
Parameter
nametyperequireddescription
colIndexNumberY컬럼의 아이디 혹은 인덱스
classNameStringYClass명
Sample
// col1 열에 cRed 클래스를 적용 grd_gridView1.setColumnClass("col1", "cRed"); // col1 열에 cRed 및 cBlue 클래스를 적용 grd_gridView1.setColumnClass("col1", "cRed cBlue");
setColumnColor( colIndex , color )
컬럼의 글자색을 설정
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
colorStringY글자색 값
Sample
grd_gridView1.setColumnColor("col1", "red");
setColumnDisabled( colIndex , disabled )
컬럼의 disabled 속성을 설정
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
disabledBooleanY[default: false, true] 비활성화 여부
Sample
grd_gridView1.setColumnDisabled("col1", true);
setColumnDisableEdit( colIndex , onoff )
inputType이 "autoComplete"인 경우 컬럼의 disableEdit 속성을 변경
Parameter
nametyperequireddescription
colIndexString|NumberY컬럼의 아이디 혹은 인덱스
onoffBooleanY[default: false, true] 편집 가능 여부
Sample
grd_gridView1.setColumnDisableEdit("col1", true);
setColumnDisplayFormat( colIndex , displayFormat )
컬럼의 표시될 값의 형식을 설정 (기존의 setDisplayFormat을 대체) (관련 속성) [GridView.column] displayFormat
(주의 사항) 표시 형식은 dataType속성값에 따라 동작이 변경됨
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 아이디 혹인 인덱스
displayFormatStringY표시될 값의 형식
Sample
// 생년월일 컬럼의 아이디가 birthday로 정의된 GridView가 있고, // DataList의 birthday 컬럼의 dataType 속성은 date로 정의한 경우 // 생년월일 컬럼의 displayFormat을 "dd-MM yyyy"로 변경 grd_gridView1.setColumnDisplayFormat("birthday","dd-MM yyyy"); // (표시 예) "19831231"의 데이터가 "31-12 1983"으로 표시됨
setColumnDisplayFormatter( colIndex , displayFormatter )
데이터의 표현식을 조건에 맞추어 변경하기 위한 사용자 함수를 설정하는 displayFormatter 속성 값을 변경 (기존의 setDisplayFormatter를 대체) (관련 속성) [GridView.column] displayFormatter
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
displayFormatterStringY사용자 함수
Sample
grd_gridView1.setColumnDisplayFormatter("col1", "scwin.setDisplayFormatter");
setColumnEnableColumn( gridColumnId , enableColumnId , enableColumnFalseValue )
inputType이 "select", "autoComplete", "checkcombobox"인 경우 일부 선택 목록을 비활성화 처리
SelectBox, AutoComplete, CheckComboBox 컴포넌트의 setEnableColumn() 함수를 실행하는 것과 같은 효과 (관련 속성) [SelectBox, AutoComplete, CheckComboBox 컴포넌트] enableColumn, enableColumnFalseValue (관련 함수) [SelectBox, AutoComplete, CheckComboBox 컴포넌트] setEnableColumn
Parameter
nametyperequireddescription
gridColumnIdString|NumberY컬럼의 아이디 혹은 인덱스
enableColumnIdStringY바인딩된 DataList의 비활성화 여부에 대한 정보를 가지고 있는 컬럼의 아이디
enableColumnFalseValueStringN비활성화 조건 값
Sample
// column1의 inputType은 "select", "autoComplete", "checkcombobox" 중 하나 // column1의 목록 데이터는 DataList와 바인딩 되어 있고, DataList은 "label, value, type" 3개의 컬럼으로 이루어짐 // label, value는 column1의 목록 label, value와 대응되며, type 컬럼이 비활성화 여부 정보를 담고 있음 // 아래를 실행 gridView1.setColumnEnableColumn("column1", "Type", "false"); // 실행 결과: DataList의 type값이 false에 해당하는 목록은 비활성화 되어서 보여짐
setColumnGridItemset( colIndex , obj )
inputType이 "select"인 경우 설정을 ItemSet이 아닌 GridViewItemset을 사용하는 경우 설정 값을 변경
Parameter
nametyperequireddescription
colIndexString|NumberY컬럼의 아이디 혹은 인덱스
objObjectYGridViewItemset에 대한 정보 (JSON/XML)
<String> obj.nodeset : NodeSet 정보 (접두어(Prefix) "data:"를 사용) <String> obj.label : 라벨로 사용할 DataList 컬럼 아이디 <String> obj.value : 값으로 사용할 DataList 컬럼 아이디 <Number> obj.width : GridViewItemset의 너비 <Number> obj.height : GridViewItemset의 높이 <Array> obj.item : 컬럼별 설정정보 (JSON Array)
Sample
var obj = { "nodeset" : "data:dlt_dataList1", "label" : "col1", "value" : "col2", "width" : 400, "height" : 300, "item" : [{"ref" : "col1", "header" : "label"},{"ref" : "col2", "header" : "value"},{"ref" : "col3", "header" : "dummy"}] }; grd_gridView1.setColumnGridItemset("col1", obj);
setColumnIoFormat( colIndex , ioFormat , dateMask )
컬럼의 ioFormat 속성을 설정 (관련 속성) [GridView.column] dataType = "date"인 경우
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
ioFormatStringY새로 설정할 ioFormat
dateMaskStringN새로 설정할 날짜 표시형식 (displayFormat)
Sample
grd_gridView1.setColumnIoFormat("col1", "ddMMyyyy", "yyyy-MM-dd");
setColumnNodeSet( colIndex , nodeset , label , value )
itemset을 설정할 수 있는 컬럼의 nodeset을 설정.
(select, autoComplete, checkcombobox 세 개의 inputType만 지원)
Parameter
nametyperequireddescription
colIndexNumberYnodeset을 설정할 column의 index 또는 id
nodesetStringN변경하려는 nodeset값으로 "data:"라는 prefix 뒤에 dataList id를 정의.
labelStringN변경하려는 label로 dataList의 컬럼 id
valueStringN변경하려는 value로 dataList의 컬럼 id
setColumnOrder( columnOrderArray )
컬럼의 정렬 순서를 columnOrderArray에 정의된 컬럼 리스트를 기준으로 재설정하며 정의되지 않은 컬럼은 그 뒤쪽으로 위치함
Parameter
nametyperequireddescription
columnOrderArrayArrayY컬럼의 정렬 순서에 맞춘 컬럼 리스트 (컬럼의 아이디 혹은 인덱스)
Sample
//이름, 성별, 나이, 생년월일이 정의 된 GridView가 정의되어 있고 // 각 바디 컬럼의 아이디가 name, gender, age, birthday 인 경우 //나이 컬럼과 성별 컬럼의 위치를 변경. grd_gridView1.setColumnOrder(["age","gender"]); //API 실행 후의 컬럼 순서는 나이, 성별, 이름, 생년월일 이 됨
setColumnReadOnly( colIndex , readOnly )
컬럼의 읽기전용 설정
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
readOnlyBooleanY[default: false, true] 사용 여부
Sample
grd_gridView1.setColumnReadOnly("col1", true);
setColumnStyle( colIndex , styleName , styleValue )
컬럼의 스타일 설정
Parameter
nametyperequireddescription
colIndexStringY컬럼의 아이디 혹은 인덱스
styleNameStringY스타일 명
styleValueStringY스타일 값
Sample
// 컬럼 아이디가 "col1"인 글자색을 "Red"로 설정 grd_gridView1.setColumnStyle("col1", "color", "red"); // 컬럼 아이디가 "col1"인 배경색을 "Blue"로 설정 grd_gridView1.setColumnStyle("col1", "background-color", "blue");
setColumnVisible( colIndex , colVisibleFlag )
컬럼의 표시여부 설정
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
colVisibleFlagBooleanY[default: false, true] 표시 여부
"true" : 해당 컬럼을 표시 "false" : 숨김
Sample
grd_gridView1.setColumnVisible("col1", true);
setColumnVisibleColumn( gridColumnId , visibleColumnId , visibleColumnFalseValue )
inputType이 "select", "autoComplete", "checkcombobox"인 경우 일부 선택 목록을 숨김 (관련 함수) [Select, AutoComplete, CheckComboBox] setVisibleColumn (관련 속성) [Select, AutoComplete, CheckComboBox] visibleColumn, visibleColumnFalseValue
Parameter
nametyperequireddescription
gridColumnIdString|NumberY컬럼의 아이디 혹은 인덱스
visibleColumnIdStringY바인딩된 DataList의 표시 여부에 대한 정보를 가지고 있는 컬럼의 아이디
visibleColumnFalseValueStringN표시 조건 값
Sample
// column1의 inputType은 "select", "autoComplete", "checkcombobox" 중 하나 // column1의 목록 데이터는 DataList와 바인딩 되어 있고, DataList은 "label, value, type" 3개의 컬럼으로 이루어짐 // label, value는 column1의 목록 label, value와 대응되며, type 컬럼이 표시여부 정보를 담고 있음 // 아래를 실행 gridView1.setColumnVisibleColumn("column1", "Type", "false"); // 실행 결과: DataList의 type값이 false에 해당하는 목록은 화면에 보이지 않게 됨
setColumnWidth( colIndex , size )
컬럼의 너비를 변경
Parameter
nametyperequireddescription
colIndexString||NumberY컬럼의 아이디 혹은 인덱스
sizeNumberY컬럼의 너비 (단위: px)
Sample
grd_gridView1.setColumnWidth("col1", 150);
setCustomFormatter( colIndex , customFormatter )
데이터의 표현식을 조건에 맞추어 변경하기 위한 사용자 함수를 설정하는 customFormatter 속성 값을 변경 (관련 속성) [GridView.column] customFormatter
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
customFormatterStringY사용자 함수
Sample
grd_gridView1.setCustomFormatter("col1", "scwin.setCustomFormatter");
setDataDragDrop( onoff )
dataDragDrop 속성 값을 설정
Parameter
nametyperequireddescription
onoffBooleanYdataDragDrop 허용 여부
Sample
grd_gridView1.setDataDragDrop(true);
setDataType( colIndex , dataType , options )
dataType이 "text", "number", "float"인 경우 컬럼의 dataType 속성을 변경 (관련 속성) [GridView.column] dataType
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
dataTypeStringY컬럼의 dataType
optionsObjectN컬럼의 displayFormat을 설정할 수 있는 옵션
Sample
// 사용 예 var options = { displayFormat : "yyyy-.MM" } grd_gridview1.setDataType("Region", "date", options);
setDisabled( type , rowIndex , colIndex , disableFlag )
객체 타입에 따라 비활성화 설정
Parameter
nametyperequireddescription
typeStringY[type: grid, row, column, cell] 비활성화를 적용시킬 객체 타입
rowIndexNumberY행의 인덱스
colIndexNumber||StringY컬럼의 아이디 혹은 인덱스
disableFlagBooleanY[defalut: false, true] 비활성화 여부
Sample
//이름, 성별, 나이가 정의된 GridView가 있고 각 컬럼의 아이디가 name, gender, age 인 경우 //GridView 전체에 비활성을 적용 할 경우 grd_gridView1.setDisabled("grid",true); //GridView의 1번째 행에 비활성을 적용 할 경우 grd_gridView1.setDisabled("row",0,true); //GridView의 "이름" 컬럼에 비활성을 적용 할 경우 grd_gridView1.setDisabled("column","name",true); //GridView의 1번째행의 "나이" 셀에 비활성을 적용 할 경우 grd_gridView1.setDisabled("cell",0,"age",true);
setDrillDownDragDrop( value )
inputType이 "drillDown" 컬럼에 드래그/드롭을 설정 (기본적으로는 GridView에 inputType이 drillDown 컬럼이 포함되면 드래그/드롭이 발생하지 않음) (관련 속성) dataDragDrop = "true"
Parameter
nametyperequireddescription
valueBooleanY[default: false, true] inputType이 "drilldown" 컬럼이 포함된 GridView에서 드래그/드롭 동작 여부
Sample
grd_gridView1.setDrillDownDragDrop(true);
setEditModeEvent( editModeEvent , bRefreshColumn )
editModeEvent를 동적으로 설정한다.
Parameter
nametyperequireddescription
editModeEventStringY동적으로 설정할 editModeEvent값
bRefreshColumnBooleanNcolumn에서 설정한 editModeEvent값도 변경할 경우에는 true로 설정
Sample
// 사용 예 gridView1.setEditModeEvent("ondblclick"); // editModeEvent 값을 동적으로 'ondblclick'으로 변경
setFixedColumn( fixedColNum )
세로 틀고정 설정 (좌측을 기준으로 고정시킬 컬럼의 수를 설정)
Parameter
nametyperequireddescription
fixedColNumNumberY고정시킬 컬럼의 수
Sample
// 2번째 컬럼까지 고정 grd_gridView1.setFixedColumn(2);
setFixedRightColumn( count )
세로 틀고정 설정 (우측을 기준으로 고정시킬 컬럼의 수를 설정) (관련 속성) fixedRightColumn
Parameter
nametyperequireddescription
countNumberY고정시킬 컬럼의 수
Sample
// 우측 2번째 컬럼까지 고정 grd_gridView1.setFixedRightColumn(2);
setFixedRow( fixedRowNum )
가로 틀고정 설정 (상단을 기준으로 고정시킬 행의 수를 설정) (관련 속성) fixedRow
Parameter
nametyperequireddescription
fixedRowNumNumberY고정시킬 행의 수
Sample
// 3행까지 고정 grd_gridView1.setFixedRow(3);
setFocusedCell( rowIndex , colIndex , editMode )
해당 셀에 포커스를 주고 이동
Parameter
nametyperequireddescription
rowIndexNumberY이동할 행의 인덱스
colIndexNumber||StringY이동할 컬럼의 인덱스 혹은 아이디
editModeBooleanY[default: false, true] 편집모드로의 전환 여부
Sample
grd_gridView1.setFocusedCell(0, "col1", true);
setFocusedHeaderObj( headerId )
inputType이 "selectbox", "checkbox"인 경우 포커스 설정
Parameter
nametyperequireddescription
headerIdStringY헤더의 아이디
Sample
grd_gridView1.setFocusedHeaderObj("column1");
setFocusedMultiCell( startRow , startCol , endRow , endCol )
설정 영역만큼의 셀에 포커스를 줌
Parameter
nametyperequireddescription
startRowNumberY영역의 시작 행의 인덱스
startColNumberY영역의 시작 컬럼의 인덱스
endRowNumberY영역의 종료 행의 인덱스
endColNumberY영역의 종료 컬럼의 인덱스
Sample
// 실행결과 : (3,2), (3,3), (4,2), (4,3)셀이 포커스 처리됨 grd_gridView1.setFocusedMultiCell(3,2,4,3);
setFocusMode( focusMode )
focusMode를 동적으로 설정한다. both, row, cell으로 설정된 경우에만 변경 가능. none인 경우 지원하지 않음
Parameter
nametyperequireddescription
focusModeStringYfocusMode를 동적으로 설정할 focusMode값
Sample
// 사용 예 gridView1.setFocusMode("cell"); // setFocusMode 값을 동적으로 'cell'으로 변경
setFooterCaption( htmlStr )
푸터의 태그의 caption의 속성 값 설정 [웹접근성 준수를 위해 사용]
Parameter
nametyperequireddescription
htmlStrStringY푸터 caption 속성에 설정될 문자열
Sample
grd_gridView1.setFooterSummary("Footer Caption");
setFooterData( footerId , data )
inputType이 "text"인 경우 data의 값을 footerId에 해당하는 푸터 컬럼에 설정
Parameter
nametyperequireddescription
footerIdNumber||StringY푸터 컬럼의 아이디 또는 인덱스
dataStringY푸터에 반영할 값
Sample
grd_gridView1.setFooterData("column1", "Footer Data~");
setFooterDisplayFormat( footerId , displayFormat )
푸터 컬럼의 표시될 값의 형식을 설정 (관련 속성) [GridView.column] displayFormat : useFormat이 "true"인 경우 표시될 값의 형식이 적용된 값을 푸터 컬럼에 설정 (주의 사항) 표시 형식은 dataType속성값에 따라 동작이 변경됨
Parameter
nametyperequireddescription
footerIdNumber||StringY푸터 컬럼의 아이디 혹인 인덱스
displayFormatStringY표시될 값의 형식
Sample
grd_gridView1.setFooterDisplayFormat("column18", "#,##0.00");
setFooterStyle( footerId , style , value )
푸터 컬럼의 스타일 속성을 설정
Parameter
nametyperequireddescription
footerIdString||NumberY푸터 컬럼의 아이디 혹인 인덱스 (행번호 컬럼은 "$rowNum", 행상태 컬럼은 "$rowStatus"로 설정)
styleStringY적용할 CSS 속성명
valueStringY적용할 CSS 속성값
Sample
// 푸터 컬럼 아이디가 "column18"인 글자색을 "Red"로 설정 grd_gridView1.setFooterStyle("column18", "color", "red"); // 푸터 컬럼 아이디가 "column18"인 배경색을 "Blue"로 설정 grd_gridView1.setFooterStyle("column18", "background-color", "blue");
setFooterSummary( str )
푸터의 태그의 summary의 속성 값 설정 [웹접근성 준수를 위해 사용]
Summary 특성(Attribute)은 비표준이므로 문서의 종류(Document Type Declaration)가 HTLM5인 경우를 판단하여 특성을 제거하여 줌
Parameter
nametyperequireddescription
strStringY푸터 summary 속성에 설정될 문자열
Sample
grd_gridView1.setFooterSummary("Footer Summary!!");
setFooterValue( footerId , data )
inputType이 "text"인 경우 data의 값을 footerId에 해당하는 푸터 컬럼에 설정
Parameter
nametyperequireddescription
footerIdString||NumberY푸터 컬럼의 아이디
dataStringY푸터에 반영할 값
Sample
grd_gridView1.setFooterValue("column1", "Footer Data~");
setGridHeight( height )
GridView의 높이를 설정
Parameter
nametyperequireddescription
heightNumberY높이 값 (단위: px)
Sample
grd_gridView1.setGridHeight(500);
setGridReadOnly( readOnly )
GridView의 읽기전용 설정
Parameter
nametyperequireddescription
readOnlyBooleanY[default: false, true] 사용 여부
Sample
grd_gridView1.setGridReadOnly(true);
setGridSize( width , height )
GridView의 높이와 너비를 설정
Parameter
nametyperequireddescription
widthNumberY너비 값 (단위: px)
heightNumberY높이 값 (단위: px)
Sample
grd_gridView1.setGridWidth(900, 500);
setGridStyle( doc )
GridView를 다시 그려줌
Parameter
nametyperequireddescription
docStringYGridView를 다시 그려줄때 필요한 문자열 (JSON 또는 XML)
setGridWidth( width )
GridView의 너비를 설정
Parameter
nametyperequireddescription
widthNumberY너비 값 (단위: px)
Sample
grd_gridView1.setGridWidth(900);
setHeaderBackgroundColor( headerId , color )
헤더의 배경색 설정
Parameter
nametyperequireddescription
headerIdString||NumberY헤더의 아이디 혹은 인덱스
colorStringY배경색
Sample
grd_gridView1.setHeaderBackgroundColor("column1", "red");
setHeaderClass( headerId , className )
헤더의 사용자 Class 설정
Parameter
nametyperequireddescription
headerIdNumberY헤더의 아이디 혹은 인덱스
classNameStringYClass명
Sample
grd_gridView1.setHeaderClass("column1", "header_cell");
setHeaderColor( headerId , color )
헤더의 글자색 설정
Parameter
nametyperequireddescription
headerIdString||NumberY헤더의 아이디 혹은 인덱스
colorStringY글자색
Sample
grd_gridView1.setHeaderColor("column1", "red");
setHeaderDisabled( headerId , disabled )
헤더의 비활성화 설정
Parameter
nametyperequireddescription
headerIdNumber||StringY헤더의 아이디 혹은 인덱스
disabledBooleanY[default: false, true] 활성/비활성 여부 (false : 활성, true : 비활성)
Sample
grd_gridView1.setHeaderDisabled("column1", true);
setHeaderHide( hide )
헤더의 숨김여부 설정
Parameter
nametyperequireddescription
hideBooleanY[default: false, true] 감춤/표시 여부 (false : 표시, true : 감춤)
Sample
grd_gridView1.setHeaderHide(true);
setHeaderNodeSet( headerId , nodeset , label , value )
inputType이 "select"인 경우 적용되며 바인드정보(BindItemSet)를 설정
Parameter
nametyperequireddescription
headerIdStringY헤더의 아이디
nodesetStringNNodeSet 정보 (접두어(Prefix) "data:"를 사용)
labelStringN라벨로 사용할 DataList 컬럼 아이디
valueStringN값으로 사용할 DataList 컬럼 아이디
Sample
//아래와 같이 DataList와 GridView가 정의 된 경우 //DataList - 아이디가 dlt_genderCode이고 disp 아이디를 가진 컬럼은 사용자가 보는 라벨 값이, code 아이디를 가진 컬럼은 값으로 정의 //GridView- 헤더 컬럼의 inputType이 "select"이고 헤더의 아이디가 hGender 로 정의 //GridView의 hGender 헤더의 SelectBox 항목을 변경 grd_gridView1.setHeaderNodeSet("data:dlt_genderCode","disp","code");
setHeaderSortImage( headerId , orderNum , sortOrd )
headerId에 해당하는 컬럼의 정렬이미지를 설정 (데이터의 정렬은 DataList의 정렬을 사용해야 함)
Parameter
nametyperequireddescription
headerIdStringY헤더의 아이디
orderNumNumberN[default:-1, 1, 0] 정렬이미지 값
"1" : 오름 차순 "-1" : 내림 차순 "0" : sort를 하지 않는 상태
sortOrdNumberN[default: 0] 다중정렬(MultiSort)의 경우 정렬의 우선순위를 나타내는 숫자 값 (하위호환성 유지용)
Sample
grd_gridView1.setHeaderSortImage("column18", 1);
setHeaderStyle( headerId , style , value )
헤더 컬럼의 스타일을 설정
Parameter
nametyperequireddescription
headerIdString||NumberY헤더 컬럼의 아이디 혹인 셀의 인덱스 (행번호 컬럼은 "$rowNum", 행상태 컬럼은 "$rowStatus"로 설정)
styleStringY적용할 CSS 속성명
valueStringY적용할 CSS 속성값
Sample
// 헤더 컬럼 아이디가 "column18"인 글자색을 "Red"로 설정 grd_gridView1.setHeaderStyle("column18", "color", "red"); // 헤더 컬럼 아이디가 "column18"인 배경색을 "Blue"로 설정 grd_gridView1.setHeaderStyle("column18", "background-color", "blue");
setHeaderValue( headerId , value , useFormat )
inputType이 "text"인 경우 headerId에 해당하는 헤더에 value값을 설정 (관련 속성) [GridView.column] displayFormat : useFormat이 "true"인 경우 표시될 값의 형식이 적용된 값을 헤더에 설정
Parameter
nametyperequireddescription
headerIdStringY헤더의 아이디
valueStringY헤더의 값
useFormatBooleanN[default: false, true] displayFormat의 사용여부
Sample
grd_gridView1.setHeaderValue("column1", "Title");
setImageSrc( colIndex , src )
inputType이 "textimage"인 경우 이미지 설정
Parameter
nametyperequireddescription
colIndexNumber||StringY컬럼의 인덱스 또는 아이디
srcStringY컬럼에 적용할 이미지 경로
setMaxLength( colIndex , len )
inputType이 "text", "textarea", "textImage", "secret", "autoComplete"인 경우 컬럼의 maxLength 값을 설정
Parameter
nametyperequireddescription
colIndexString|NumberY컬럼의 인덱스 또는 아이디
lennumberY컬럼에 적용할 maxLength 값
Sample
// 컬럼 아이디가 "a"인 컬럼에 maxLength를 5로 변경 grd_gridView1.setMaxLength("a", 5);
setNoResultMessage( message )
데이터가 없을 경우 표시할 문자열을 설정
Parameter
nametyperequireddescription
messageStringY데이터 없을 때 표시할 문자열
Sample
grd_gridView1.setNoResultMessage("No Data~");
setNoResultMessageVisible( visible )
noResultMessageVisible 값을 설정
Parameter
nametyperequireddescription
visibleBooleanY[default: false, true] noResultMessageVisible에 설정될 값
Sample
grd_gridView1.setNoResultMessageVisible(true);
setReadOnly( type , rowIndex , colIndex , readOnlyFlag )
type에 따라 읽기전용(ReadOnly) 속성을 설정
Parameter
nametyperequireddescription
typeStringY[grid, row, column, cell] 읽기전용 속성을 설정할 항목 값
rowIndexNumberY행의 인덱스
colIndexNumber||StringY컬럼의 인덱스 또는 아이디
readOnlyFlagBooleanY[default: false, true] 읽기전용 여부
Sample
//이름, 성별, 나이가 정의된 gridView가 있고 각 column의 id가 name, gender, age 인 경우 //GridView 전체에 읽기전용(ReadOnly) 속성을 적용 할 경우 grd_gridView1.setReadOnly("grid", true); //GridView 의 1번째 행에 읽기전용(ReadOnly) 속성을 적용 할 경우 grd_gridView1.setReadOnly("row",0,true); //GridView 의 "이름" 컬럼에 읽기전용(ReadOnly) 속성을 적용 할 경우 grd_gridView1.setReadOnly("column","name",true); //GridView 의 1번째행의 "나이" 컬럼에 읽기전용(ReadOnly) 속성을 적용 할 경우 grd_gridView1.setReadOnly("cell",0,"age",true);
setRowBackgroundColor( rowIndex , color )
행의 배경색을 설정
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colorStringY배경색 값
Sample
// 3번째 행의 배경색을 "Yellow" 로 설정 grd_gridView1.setRowBackgroundColor(2, "yellow");
setRowClass( rowIndex , className )
grid Row에 동적으로 사용자 class를 적용
Parameter
nametyperequireddescription
rowIndexNumberYrow의 행번호
classNameStringYtr에 적용할 class의 이름
setRowColor( rowIndex , color )
행의 글자색을 설정
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
colorStringY글자색 값
Sample
// 3번째 행의 글자색을 "Red" 로 설정 grd_gridView1.setRowColor(2, "red");
setRowDisabled( rowIndex , disableFlag )
행의 disabled 속성을 설정
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
disableFlagBooleanY[defalut: false, true] 비활성화 여부
Sample
// 3번째 행을 비활성화 grd_gridView1.setRowDisabled(2, true); // 3번째 행을 활성화 grd_gridView1.setRowDisabled(2, false);
setRowNumColumnWidth( size )
행번호 컬럼의 너비를 변경 (단위: px)
Parameter
nametyperequireddescription
sizeNumberY변경할 컬럼의 너비 값
Sample
// GridView 속성 rowNumVisible="true" 설정하고, 아래와 같이 실행할 경우 행번호 컬럼 너비 조정 grd_gridView1.setRowNumColumnWidth(50);
setRowNumVisible( visibleColumnFalseValue )
rowNumVisible이 "true"인 경우 행번호 컬럼 표시/숨김 여부를 설정
Parameter
nametyperequireddescription
visibleColumnFalseValueStringN[default: false, true] 숨기기 조건에 해당하는 값
Sample
// GridView 속성 rowNumVisible="true" 설정하고, 아래와 같이 실행할 경우 number 컬럼 숨기기 grd_gridView1.setRowNumVisible(false); // GridView 속성 rowNumVisible="true" 설정하고, 아래와 같이 실행할 경우 number 컬럼 보여주기 grd_gridView1.setRowNumVisible(true);
setRowReadOnly( rowIndex , readOnly )
행의 읽기전용(Readonly) 속성을 설정
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
readOnlyBooleanY[defalut: false, true] 읽기전용 여부
Sample
// 5번째 행의 읽기전용 을 해제 grd_gridView1.setRowReadOnly(5, false); // 5번째 행의 읽기전용 을 설정 grd_gridView1.setRowReadOnly(5,true);
setRowStatusColumnWidth( size )
행상태 컬럼의 너비를 변경 (단위: px)
Parameter
nametyperequireddescription
sizeNumberY변경할 컬럼의 너비 값
Sample
// GridView 속성 rowStatusVisible="true" 설정하고, 아래와 같이 실행할 경우 행상태 컬럼 너비 조정 grd_gridView1.setRowStatusColumnWidth(50);
setRowStatusVisible( visibleColumnFalseValue )
rowStatusVisible이 "true"인 경우 행상태 컬럼 표시/숨김 여부를 설정
Parameter
nametyperequireddescription
visibleColumnFalseValueStringN숨기기 조건에 해당하는 값
Sample
// GridView 속성 rowStatusVisible="true" 설정하고, 아래와 같이 실행할 경우 행상태 컬럼 숨김 grd_gridView1.setRowStatusVisible(false); // GridView 속성 rowStatusVisible="true" 설정하고, 아래와 같이 실행할 경우 행상태 컬럼 표시 grd_gridView1.setRowStatusVisible(true);
setRowVisible( rowIndex , flag )
특정 행의 표시/숨김 여부를 설정 (관련 함수) clearRowVisible();
Parameter
nametyperequireddescription
rowIndexNumberY행의 인덱스
flagBooleanY[defalut: false, true] 숨김 여부
"true" 해당 행을 표시 "false" 해당 행을 감춤
Sample
// 30번째 행 숨기기 grd_gridView1.setRowVisible(30, false);
setScrollLeft( left )
가로 스크롤의 위치를 입력받은 값만큼 이동 (단위: px)
Parameter
nametyperequireddescription
leftNumberY가로스크롤의 스크롤 위치 값
Sample
grd_gridView1.setScrollLeft(30);
setScrollTop( top )
그리드의 세로 스크롤의 위치를 입력받은 값만큼 이동
Parameter
nametyperequireddescription
topNumberY세로스크롤의 scrollTop값
Sample
grd_gridView1.setScrollTop(30);
setSortable( headerId , sortable )
컬럼의 sortable 속성을을 동적으로 설정
Parameter
nametyperequireddescription
headerIdStringY동적으로 설정할 헤더의 아이디
sortableBooleanYsortable 여부
Sample
grd_gridView1.setSortable("col1", true);
setStartRowNumber( rowIndex )
rowNum 컬럼에 표현되는 행번호의 시작되는 숫자 값를 설정
인덱스 값이므로 0부터 시작되어 10으로 설정하면 화면에서는 11부터 시작되어 보여짐 (관련 속성) rowNumVisible = "true"인 경우에만 유효함
Parameter
nametyperequireddescription
rowIndexNumberY행번호의 시작번호
Sample
//GridView의 rowNumVisible 속성을 true로 적용 한 경우 grd_gridView1.setStartRowNumber(10); // (표시 예) rowNum 컬럼에 1부터 표현됬던 rowNum값이 11부터 증가하여 표현됨
setStyleAll( styleObj )
스타일을 지정
Parameter
nametyperequireddescription
styleObjJSONY스타일 설정 세부 정보를 담은 JSON 객체
<String:Y> styleObj.styleName 스타일명 ("background-color" 와 같은 표기법을 사용) <String:Y> styleObj.styleValue 스타일 값 <String:Y> styleObj.type ["row", "column", "cell"] 스타일 설정 영역 <String:N> styleObj.target [default:: "all", "fixed", "data"] 스타일 설정 영역을 제한 (fixed : 고정된 영역, data : 고정되지 않은 영역) <Number:N> styleObj.rowIndex 스타일 설정 영역에 해당하는 행 인덱스 (type 이 "row" 또는 "cell"인 경우 필수) <Number:N> styleObj.colIndex 스타일 설정 영역에 해당하는 컬럼 인덱스 (type 이 "column" 또는 "cell"인 경우 필수)
Sample
// 실행결과 : 5번 행 중에서 고정되지 않은 영역, 즉 (5,4),(5,5),(5,6)(5,7) cell의 배경색이 red가 된다. //<w2:gridView id='grd_gridView1' fixedColumn='4'/> column수는 8개라고 가정. var styleObj = {"styleName" : "background-color", "styleValue" : "red", "type" : "row", "target" : "data", "rowIndex" : 5} grd_gridView1.setStyleAll(styleObj);
setSubtotalVisible( flag )
부분합을 숨기거나 다시 표시
Parameter
nametyperequireddescription
flagBooleanY부분합 표시 여부
false : 부분합을 숨김 true : 숨겨진 부분합을 다시 표시
Sample
// 부분합 숨기기 grd_gridView1.setSubtotalVisible(false); // 부분합 표시 grd_gridView1.setSubtotalVisible(true);
setSummary( str )
HTML 태그의 summary의 속성 값 설정
Parameter
nametyperequireddescription
strStringYsummary 속성에 설정될 문자열
Sample
grd_gridView1.setSummary("Summary!!");
setTopRowIndex( topRowIndex , noEvent , autoFocus )
topRowIndex에 해당하는 행이 가장 위에 보여지도록 세로 스크롤의 위치를 옮겨줌
Parameter
nametyperequireddescription
topRowIndexNumberY상단에 표현할 행의 인덱스
noEventBooleanN[default: flase, true] 스크롤이 맨 끝으로 도달할 경우 onscrollend() 이벤트를 발생 여부 (false : 이벤트 발생, true : 이벤트 발생하지 않음)
autoFocusBooleanN[default: false, true] 스크롤 이동 후 화면기준으로 포커스를 (0,0)위치에 설정 (false : 포커스 이동하지 않음, true : 포커스 이동)
Sample
// 3번째행을 가장 위에 보여지도록 함 grd_gridView1.setTopRowIndex(3);
setUseFilter( colId , falg )
필터의 사용 여부(useFilter)를 동적으로 설정
Parameter
nametyperequireddescription
colIdStringY컬럼의 아이디
falgBooleanY[default: false, true] useFilter 속성의 설정 값
Return
typedescription
BooleanuseFilter 속성의 반영 여부
Sample
// "col5" 컬럼의 필터를 사용하도록 함 grd_gridView1.setUseFilter("col5", true);
setUseFilterList( flag )
필터링 대상의 목록사용 여부(useFilterList)를 동적으로 설정
Parameter
nametyperequireddescription
flagBooleanY[default: false, true] useFilterList 속성의 설정 값
Sample
// "col5" 컬럼의 필터를 사용하도록 함 grd_gridView1.setUseFilterList(false);
setVisibleRowNum( rowCount )
화면에 표현할 행의 수(visibleRowNum)을 동적으로 설정
rowCount가 숫자가 아니거나 0이하의 값일 경우 아무 동작도 하지 않음
데이터 크기(전체 행 또는 필터 처리가 되었을 경우 필터링된 행)보다 큰 값을 입력한 경우 데이터 크기와 동일한 값이 입력된 것으로 처리
Parameter
nametyperequireddescription
rowCountNumberY동적으로 설정할 행 갯수(visibleRowNum)
Sample
// visibleRowNum 값을 동적으로 10으로 설정하여 화면에 10개의 행이 보임 grd_gridView1.setVisibleRowNum(10);
showChooseOption( colIndex , chooseOption )
inputType이 "select"인 경우 SelectBox의 선택옵션(ChooseOption) 설정
Parameter
nametyperequireddescription
colIndexNumberY컬럼의 인덱스
chooseOptionBooleanY사용 여부
Sample
grd_gridView1.showChooseOption(1,true);
showCustomFilter2( headerID )
사용자 필터를 지정할 수 있는 "사용자 지정 필터" 팝업 창을 표시
Parameter
nametyperequireddescription
headerIDStringY사용자 필터를 적용할 헤더 아이디
Sample
grd_gridView1.showCustomFilter2("column1",);
showGroupbyZone( )
그룹핑 정보를 관리하는 GroupbyZone 영역을 표시 (관련 함수) hideGroupbyZone()
Sample
grd_gridView1.showGroupbyZone();
spanAll( openFlag )
inputType이 "drilldown"인 경우 전체 데이터를 모두 펼치거나 접는 기능
openFlag에 숫자를 넣는 경우 해당 깊이까지 데이터를 펼침
Parameter
nametyperequireddescription
openFlagBoolean||NumberY펼침 여부 / 펼치고자하는 깊이 값
Sample
// 접혀 있는 데이터를 모두 펼침 grd_gridView1.spanAll(true); // 깊이가 2까지인 데이터를 모두 펼침 grd_gridView1.spanAll(2);
toggle( rowIndex )
inputType이 "drilldown"인 경우 rowIndex에 해당하는 행의 하위를 토글링(열기/닫기)함
Parameter
nametyperequireddescription
rowIndexNumberY토글링 하려는 행의 인덱스
Sample
grd_gridView1.toggle(3);