QCell

QCELL. QCell

new QCell()

Since:
  • QCELL v1.0.0

QCELL 객체 생성을 위한 클래스

Methods

rebuild(true:) → {boolean}

Since:
  • QCELL v1.0.0

QCELL의 모든 설정을 초기화하고 UI를 재생성합니다.

Example
QCell1.rebuild();
Returns:
Type
boolean

resize() → {boolean}

Since:
  • QCELL v2.1.156
Author:
  • jklee

QCELL 의 크기 변경된 정보로 UI를 재구성 합니다.

Example
QCell1.resize();
Returns:
Type
boolean

setResizeAction(false) → {boolean}

Since:
  • QCELL v2.1.177
Author:
  • jklee

QCELL의 resize 이벤트 시 QCELL을 다시 그리는 Action을 막도록 설정합니다.

Example
QCell1.setResizeAction(false);
Returns:
Type
boolean

refresh() → {boolean}

Since:
  • QCELL v2.1.7

QCELL의 현재 화면을 갱신합니다.

Example
QCell1.refresh();
Returns:
Type
boolean

initGrid() → {boolean}

Since:
  • QCELL v2.1.147
Author:
  • jklee

그리드를 초기화 한다..

Example
QCell1.initGrid();
Returns:
Type
boolean

getID() → {string}

Since:
  • QCELL v1.0.0

QCELL의 ID를 반환합니다.

Example
var strID = QCell1.getID();
Returns:
Type
string

getIdx(axis, typeopt, point_of_timeopt) → {number}

Since:
  • QCELL v1.0.0

입력받은 조건에 해당하는 행(또는 열) 인덱스를 반환합니다.

Example
QCell1.getIdx("row");	//포커스 셀의 행 인덱스 반환
QCell1.getIdx("col");	//포커스 셀의 열 인덱스 반환
QCell1.getIdx("row", "cursor");	//커서가 위치한 셀의 행 인덱스 반환
QCell1.getIdx("col", "click");	//마우스 왼쪽 클릭이 발생한 열 인덱스 반환
QCell1.getIdx("row", "valuechanged");	//valuechanged 이벤트 발생 시 행 인덱스 반환
Parameters:
Name Type Attributes Default Description
axis string

인덱스 종류 ("row" | "col")
type string <optional>
 "focus"

인덱스 타입 ("cursor" | "drag" | "click" | "focus" | "valuechanged")
point_of_time string <optional>
 "current"

인덱스 시점 ("previous" | "current")
Returns:
Type
number

getRows(typeopt) → {number}

Since:
  • QCELL v1.0.0

입력받은 영역에 해당하는 행의 개수를 반환합니다.

Example
QCell1.getRows();		//전체 행의 개수 반환
QCell1.getRows("data");		//헤더영역을 제외한 데이터를 표시하는 전체 행의 개수 반환
QCell1.getRows("frozen");	//틀고정 된 행(FrozenRows)의 개수 반환
Parameters:
Name Type Attributes Default Description
type string <optional>
 "all"

영역 구분 ("all" | "header" | "data" | "frozen" | "frozenbottom")
Returns:
Type
number

getCols(typeopt) → {number}

Since:
  • QCELL v1.0.0

입력받은 영역에 해당하는 열의 개수를 반환합니다.

Example
QCell1.getCols();		//전체 열의 개수 반환
QCell1.getCols("data");		//헤더영역을 제외한 데이터를 표시하는 전체 열의 개수 반환
QCell1.getCols("frozen");	//틀고정 된 열(FrozenRows)의 개수 반환
QCell1.getCols("hidden");	//화면에 표현 안된 컬럼 개수
QCell1.getCols("all");		//모든 컬럼 개수
Parameters:
Name Type Attributes Default Description
type string <optional>
 "all"

영역 구분 ("all" | "header" | "data" | "frozen")
Returns:
Type
number

getRowHeight(type) → {number}

Since:
  • QCELL v1.0.0

지정한 영역의 행 높이를 반환합니다.

Example
QCell1.getRowHeight("header");
Parameters:
Name Type Description
type string

영역 구분 ("header" | "data")
Returns:
Type
number

getColWidths() → {Array}

Since:
  • QCELL v1.0.0

전체 열의 너비값을 배열로 반환합니다.

Example
QCell1.getColWidths();
Returns:
Type
Array

getColsOfKey(key) → {Array}

Since:
  • QCELL v1.1.0

입력받은 "key" 속성값이 설정된 열들의 인덱스를 배열로 반환합니다.

Example
QCell1.getColsOfKey("name");
Parameters:
Name Type Description
key string

"key" 속성값
Returns:
Type
Array

getColOfKey(key) → {Number}

Since:
  • QCELL v2.1.77

입력받은 "key" 속성값이 설정된 열들의 인덱스를 넘버로 반환합니다.

Example
QCell1.getColOfKey("name");
Parameters:
Name Type Description
key string

"key" 속성값
Returns:
Type
Number

getKeyOfCol(col) → {string}

Since:
  • QCELL v1.0.0

입력받은 열 인덱스에 해당하는 열에 설정된 "key" 속성값을 반환합니다.

Example
QCell1.getKeyOfCol(3);
Parameters:
Name Type Description
col number

열 인덱스
Returns:
Type
string

setKeyOfCol(col, key) → {string}

Since:
  • QCELL v2.1.176

입력받은 열 인덱스에 해당하는 열에 설정된 "key" 값을 변경 합니다.

Example
QCell1.setKeyOfCol(3, 'newKey');
Parameters:
Name Type Description
col number

열 인덱스
key string

새로운 key 값
Returns:
Type
string

getColID(col) → {string}

Since:
  • QCELL v1.0.0

입력받은 열 인덱스의 열 ID를 반환합니다.

Example
QCell1.getColID(3);
Parameters:
Name Type Description
col number

열 인덱스
Returns:
Type
string

getColOfID(id) → {number}

Since:
  • QCELL v1.0.0

입력받은 열 ID에 해당하는 열 인덱스를 반환합니다.

Example
QCell1.getColOfID("col_3");
Parameters:
Name Type Description
id string

열 ID
Returns:
Type
number

getColWidth(col) → {number}

Since:
  • QCELL v1.0.0

입력한 열 인덱스에 해당하는 열의 너비를 반환합니다.(단위: pixel)

Example
QCell1.getColWidth(3);
Parameters:
Name Type Description
col number

너비를 반환할 열 인덱스
Returns:
Type
number

setColWidth(col, colwidth) → {boolean}

Since:
  • QCELL v2.1.1

입력받은 열 인덱스에 해당하는 컬럼의 넓이를 변경합니다.(단위: pixel)

Example
QCell1.setColWidth(3, 200);
Parameters:
Name Type Description
col number

열 인덱스
colwidth number

컬럼의 넓이 설정(최소값: 15)
Returns:
Type
boolean

getColType(col) → {String}

Since:
  • QCELL v1.0.0

입력한 열 인덱스에 해당하는 열의 타입을 반환합니다.

Example
QCell1.getColType(3);
Parameters:
Name Type Description
col Number

타입을 반환할 열 인덱스
Returns:
Type
String

getColAttribute(col, attribute) → {String}

Since:
  • QCELL v2.1.84

입력한 열 인덱스에 해당하는 열의 속성을 반환한다..

Example
QCell1.getColAttribute(3, "width");
Parameters:
Name Type Description
col number

타입을 반환할 열 인덱스
attribute string

가져올 속성 명칭
Returns:
Type
String

getFrozenRows() → {Number}

Since:
  • QCELL v2.1.97

고정열 인텍스를 반환한다.

Example
QCell1.getFrozenRows();
Returns:
Type
Number

setFrozenRows(nIndex) → {boolean}

Since:
  • QCELL v2.1.97

고정행을 새로 설정 한다.

Example
QCell1.setFrozenRows(3);
Parameters:
Name Type Description
nIndex number

타입을 반환할 열 인덱스
Returns:
Type
boolean

getFrozenCols() → {Number}

Since:
  • QCELL v2.1.97

고정행 인텍스를 반환한다.

Example
QCell1.getFrozenCols();
Returns:
Type
Number

setFrozenCols(nIndex) → {boolean}

Since:
  • QCELL v2.1.97
Author:
  • jklee

고정열을 새로 설정 한다.

Example
QCell1.setFrozenCols(2);
Parameters:
Name Type Description
nIndex number

타입을 반환할 열 인덱스
Returns:
Type
boolean

getFrozenBottomRows() → {Number}

Since:
  • QCELL v2.1.97

하단 고정행 인텍스를 반환한다.

Example
QCell1.getFrozenBottomRows();
Returns:
Type
Number

setFrozenBottomRows(nIndex) → {boolean}

Since:
  • QCELL v2.1.97

하단 고정행을 새로 설정 한다.

Example
QCell1.setFrozenBottomRows(5);
Parameters:
Name Type Description
nIndex number

타입을 반환할 행 인덱스
Returns:
Type
Number

removeColumn(nCol) → {boolean}

Since:
  • QCELL v2.1.147
Author:
  • jklee

컬럼을 삭제 한다.

Example
QCell1.removeColumn(3);
Parameters:
Name Type Description
nCol number

삭제할 컬럼 정보
Returns:
Type
boolean

insertColumn(nCol, objCol) → {boolean}

Since:
  • QCELL v2.1.147
Author:
  • jklee

컬럼을 추가 한다.

Example
QCell1.insertColumn(3,{width : 150, title : ['시군구'],		key : 'cdwNm'});
Parameters:
Name Type Description
nCol number

추가할 컬럼 위치
objCol object

추가할 컬럼 정보
Returns:
Type
boolean

resetColumns() → {boolean}

Since:
  • QCELL v2.1.158
Author:
  • jklee

컬럼을 생성 시점으로 초기화 한다.

Example
QCell1.resetColumns();
Returns:
Type
boolean

getColumnInfo(nCol) → {object}

Since:
  • QCELL v2.1.147
Author:
  • jklee

현재 컬럼의 정보를 얻는다.

Example
QCell1.getColumnInfo(3);
Parameters:
Name Type Description
nCol number

정보를 얻을 컬럼 정보
Returns:
Type
object

getCurrentColumnsInfo() → {Array}

Since:
  • QCELL v2.1.155
Author:
  • jklee

현재 컬럼들의 최신 정보를 얻는다.

Example
QCell1.getCurrentColumnsInfo();
Returns:
Type
Array

getHighlightRepeat() → {number}

Since:
  • QCELL v1.0.0

행 스타일을 반복하여 적용하는 "highlightrepeat" 속성의 값을 반환합니다.

Example
var nHighlightRepeat = QCell1.getHighlightRepeat();
Returns:
Type
number

setHighlightRepeat(cycle) → {boolean}

Since:
  • QCELL v1.0.0

행 스타일을 반복하여 적용하는 "highlightrepeat" 속성의 주기를 설정합니다.

Example
QCell1.setHighlightRepeat(3);
Parameters:
Name Type Description
cycle number

스타일 반복 주기
Returns:
Type
boolean

setColStyle(col, style, typeopt) → {boolean}

Since:
  • QCELL v1.0.0

동적으로 필요한 시점에 지정한 컬럼에 "컬럼 단위 스타일"을 설정합니다.

Example
QCell1.setColStyle(3, {"background-color" : "red", "border-color" : "red"});
QCell1.setColStyle(3, {"font-weight" : "bold"}, "data");
Parameters:
Name Type Attributes Default Description
col number

열 인덱스
style Object

CSS 스타일
type string <optional>
 "all"

영역 구분 ("all" | "header" | "data")
Returns:
Type
boolean

removeColStyle(col, typeopt) → {boolean}

Since:
  • QCELL v1.0.0

동적으로 지정한 컬럼에 "컬럼 단위 스타일"을 제거합니다.

Example
QCell1.removeColStyle(3);
QCell1.removeColStyle(3, "header");
Parameters:
Name Type Attributes Default Description
col number

열 인덱스
type string <optional>
 "all"

영역 구분 ("all" | "header" | "data")
Returns:
Type
boolean

setRowStyle(row, style, typeopt) → {boolean}

Since:
  • QCELL v1.0.0

동적으로 필요한 시점에 지정한 로우에 "로우 단위 스타일"을 설정합니다.

Example
QCell1.setRowStyle(3, {"background-color" : "red", "border-color" : "red"});
QCell1.setRowStyle(3, {"font-weight" : "bold"}, "header");
Parameters:
Name Type Attributes Default Description
row number

행 인덱스
style Object

CSS 스타일
type string <optional>
 "all"

영역 구분 ("all" | "header" | "data")
Returns:
Type
boolean

removeRowStyle(row, typeopt) → {boolean}

Since:
  • QCELL v1.0.0

동적으로 필요한 시점에 지정한 로우에 "로우 단위 스타일"을 제거합니다.

Example
QCell1.removeRowStyle(3);
QCell1.removeRowStyle(3, "header");
Parameters:
Name Type Attributes Default Description
row number

행 인덱스
type string <optional>
 "all"

영역 구분 ("all" | "header" | "data")
Returns:
Type
boolean

getCellStyle(row, col) → {Object}

Since:
  • QCELL v1.0.0

지정한 인덱스의 셀에 설정된 "셀 단위 스타일" 정보를 반환합니다. ("열 단위 스타일"이 함께 설정된 경우라도 "셀 단위 스타일" 정보만을 반환합니다.)

Example
QCell1.getCellStyle(3, 5);
Parameters:
Name Type Description
row number

행 인덱스
col number

열 인덱스
Returns:
Type
Object

setCellStyle(row, col, style) → {boolean}

Since:
  • QCELL v1.0.0

지정한 셀에 "셀 단위 스타일"을 설정합니다.

Example
QCell1.setCellStyle(3, 5, {"background-color" : "red", "border-color" : "red !important"});
Parameters:
Name Type Description
row number

행 인덱스
col number

열 인덱스
style Object

CSS 스타일(!important 기능을 추가하여 inline style보다 우선순위로 적용가능, v2.1.174 이상부터 지원)
Returns:
Type
boolean

setCellStyles(firstrow, firstcol, lastrow, lastcol, style) → {boolean}

Since:
  • QCELL v1.0.0

지정한 범위 내의 셀들에 "셀 단위 스타일"을 설정합니다.

Example
QCell1.setCellStyles(3, 5, 10, 7, {"background-color" : "red", "border-color" : "red"});
Parameters:
Name Type Description
firstrow number

설정할 범위의 시작 행 인덱스
firstcol number

설정할 범위의 시작 열 인덱스
lastrow number

설정할 범위의 마지막 행 인덱스
lastcol number

설정할 범위의 마지막 열 인덱스
style Object

CSS 스타일
Returns:
Type
boolean

removeCellStyle(row, col) → {boolean}

Since:
  • QCELL v1.0.0

지정한 셀에 설정된 "셀 단위 스타일"을 제거합니다.

Example
QCell1.removeCellStyle(3, 5);
Parameters:
Name Type Description
row number

행 인덱스
col number

열 인덱스
Returns:
Type
boolean

removeCellStyles(firstrow, firstcol, lastrow, lastcol) → {boolean}

Since:
  • QCELL v1.0.0

지정한 범위 내의 셀들에 "셀 단위 스타일"을 제거합니다.

Example
QCell1.removeCellStyles(3, 5, 10, 7);
Parameters:
Name Type Description
firstrow number

제거할 범위의 시작 행 인덱스
firstcol number

제거할 범위의 시작 열 인덱스
lastrow number

제거할 범위의 마지막 행 인덱스
lastcol number

제거할 범위의 마지막 열 인덱스
Returns:
Type
boolean

clearCellStyles() → {boolean}

Since:
  • QCELL v1.0.0

QCELL에 적용된 모든 "셀 단위 스타일"을 제거합니다.(현재 화면에 표시된 스타일만 제거)

Example
QCell1.clearCellStyles();
Returns:
Type
boolean

clearDynamicStyles() → {boolean}

Since:
  • QCELL v1.0.0

QCELL 생성 이후 적용된 모든 스타일변경사항("열 단위 스타일", "셀 단위 스타일", "highlightrepeat")을 초기화합니다.(현재 화면에 표시된 스타일을 초기화)

Example
QCell1.clearDynamicStyles();
Returns:
Type
boolean

getSelectedRow() → {number}

Since:
  • QCELL v1.0.0

가장 마지막에 선택된 셀의 행 인덱스를 반환합니다.

Example
var nSelectedRow = QCell1.getSelectedRow();
Returns:
Type
number

getSelectedCol() → {Number}

Since:
  • QCELL v1.0.0

가장 마지막에 선택된 셀의 열 인덱스를 반환합니다.

Example
var nSelectedCol = QCell1.getSelectedCol();
Returns:
Type
Number

getSelectedRows() → {Array}

Since:
  • QCELL v1.0.0

선택된 셀들의 행 인덱스를 배열로 반환합니다.

Example
var arrSelectedRows = QCell1.getSelectedRows();
Returns:
Type
Array

getSelectedCols() → {Array}

Since:
  • QCELL v1.0.0

선택된 셀들의 열 인덱스를 배열로 반환합니다.

Example
var arrSelectedCols = QCell1.getSelectedCols();
Returns:
Type
Array

swapData(nSrc, nDest) → {boolean}

Since:
  • QCELL v2.1.175
Author:
  • jklee

지정한 행과 행의 데이터를 치환합니다.

Example
QCell1.swapData(2, 'first');
QCell1.swapData(2, 'last');
QCell1.swapData(2, 3);
Parameters:
Name Type Description
nSrc number

치환하기 위한 행 인덱스
nDest *

치환하기 위한 대상 행 인덱스(행 인덱스|'first'|'last')
Returns:
Type
boolean

moveData(nSrc, nDest) → {boolean}

Since:
  • QCELL v2.1.175
Author:
  • jklee

row data 전체를 지정된 위치로 변경

Example
QCell1.moveData(2, 'first');
QCell1.moveData(2, 'last');
QCell1.moveData(2, 3);
Parameters:
Name Type Description
nSrc number

욺기기를 위한 로우 넘버
nDest *

욺기기 위치(행 인덱스|'first'|'last')
Returns:
Type
boolean

moveCol(beforecol, aftercol) → {boolean}

Since:
  • QCELL v2.1.175

입력받은 열 인덱스에 해당하는 컬럼을 특정 위치로 이동시킵니다.

Example
QCell1.moveCol(3, 1);
Parameters:
Name Type Description
beforecol number

이동하기 전의 열 인덱스
aftercol number

이동한 후의 열 인덱스
Returns:
Type
boolean

scrollTop(row) → {Array}

Since:
  • QCELL v1.0.0

입력받은 행 인덱스로 세로 스크롤바의 scrollTop을 설정합니다.

Example
QCell1.scrollTop(3);
Parameters:
Name Type Description
row number

행 인덱스
Returns:
Type
Array

scrollLeft(col) → {Array}

Since:
  • QCELL v1.0.0

입력받은 열 인덱스로 가로 스크롤바의 scrollLeft를 설정합니다.

Example
QCell1.scrollLeft(3);
Parameters:
Name Type Description
col number

열 인덱스
Returns:
Type
Array

isScroll(type) → {boolean}

Since:
  • QCELL v1.0.0

입력받은 타입에 해당하는 스크롤바의 표시 여부를 반환합니다.

Example
QCell1.isScroll("vertical");
Parameters:
Name Type Description
type string

스크롤바 타입 {"vertical" | "horizontal"}
Returns:
Type
boolean

getUpdateInfo() → {object}

Since:
  • QCELL v2.1.69

갱신된 화면 위치 반환

Example
QCell1.getUpdateInfo();
Returns:
Type
object

getData() → {Array}

Since:
  • QCELL v1.0.0

QCELL의 데이터를 반환합니다.

Example
QCell1.getData();
Returns:
Type
Array

getAllData() → {Array}

Since:
  • QCELL v2.1.129

QCELL의 모든 데이터를 반환합니다.

Example
QCell1.getAllData();
Returns:
Type
Array

getAllDataWithFormat() → {Array}

Since:
  • QCELL v2.1.158
Author:
  • jklee

QCELL의 모든 데이터를 포멧이 적용 된 형태로 반환합니다.

Example
QCell1.getAllDataWithFormat();
Returns:
Type
Array

setData(data) → {boolean}

Since:
  • QCELL v1.0.0

입력받은 데이터로 QCELL 데이터를 갱신합니다.

Example
QCell1.setData([{"name" : "kevin", "age" : "35"},{"name" : "tom", "age" : "21"}]);	//QCELL의 data 타입이 "object"인 경우
QCell1.setData([["kevin", "35"],["tom", "21"]]);			//QCELL의 data 타입이 "array"인 경우
Parameters:
Name Type Description
data Array

갱신할 데이터
Returns:
Type
boolean

getRowData(row) → {Object|Array|undefined}

Since:
  • QCELL v1.0.0

입력받은 행 인덱스의 "행 단위 데이터"를 객체(또는 배열)로 반환합니다.

Example
var rowdata = QCell1.getRowData(3);
Parameters:
Name Type Description
row number

행 인덱스
Returns:
Type
Object | Array | undefined

getSelectedRowData() → {Object|Array|undefined}

Since:
  • QCELL v2.1.129

현재 선택되어진 행 인덱스의 "행 단위 데이터"를 객체(또는 배열)로 반환합니다.

Example
var rowdata = QCell1.getSelectedRowData();
Returns:
Type
Object | Array | undefined

setRowData(row, data) → {boolean}

Since:
  • QCELL v1.0.0

입력받은 행 인덱스의 "행 단위 데이터"를 갱신합니다.

Example
QCell1.setRowData(3, {"name" : "kevin", "age" : "35"});	//QCELL의 data 타입이 "object"인 경우
QCell1.setRowData(4, ["kevin", "35"]);			//QCELL의 data 타입이 "array"인 경우
Parameters:
Name Type Description
row number

행 인덱스
data Object | Array

행 단위 데이터
Returns:
Type
boolean

setRowDataEx(row, data) → {boolean}

Since:
  • QCELL v2.1.152
Author:
  • sonymaker

입력받은 행 인덱스의 "행 단위 데이터"와 숨겨진 행 인덱스의 "행 단위 데이터"까지 갱신합니다.

Example
QCell1.setRowDataEx(3, {"name" : "kevin", "age" : "35"});	//QCELL의 data 타입이 "object"인 경우
QCell1.setRowDataEx(4, ["kevin", "35"]);			//QCELL의 data 타입이 "array"인 경우
Parameters:
Name Type Description
row number

행 인덱스
data Object | Array

행 단위 데이터
Returns:
Type
boolean

getColData(col) → {Array}

Since:
  • QCELL v1.0.0

입력받은 열의 "열 단위 데이터"를 배열로 반환합니다.

Example
QCell1.getColData(3);
Parameters:
Name Type Description
col number

열 인덱스
Returns:
Type
Array

setColData(col, data) → {boolean}

Since:
  • QCELL v1.0.0

입력받은 열 인덱스의 "열 단위 데이터"를 갱신합니다.

Example
QCell1.setColData(4, ["kevin", "james"]);
Parameters:
Name Type Description
col number

열 인덱스
data Array

열 단위 데이터
Returns:
Type
boolean

getCellData(row, col) → {*}

Since:
  • QCELL v1.0.0

입력받은 행,열 인덱스에 해당하는 셀의 텍스트를 반환합니다.

Example
QCell1.getCellData(3, 1);
Parameters:
Name Type Description
row number

셀의 행 인덱스
col number

셀의 열 인덱스
Returns:
Type
*

getCellDataEx(row, key) → {*}

Since:
  • QCELL v2.1.88

입력받은 행,key 에 해당하는 셀의 데이터를 반환합니다.

Example
QCell1.getCellDataEx(3, 'name');
Parameters:
Name Type Description
row number

셀의 행 인덱스
key string

셀의 Key
Returns:
Type
*

getInitCellDataEx(row, key) → {*}

Since:
  • QCELL v2.1.165

행, key 에 해당하는 셀의 초기화 데이터를 반환합니다.

Example
QCell1.getInitCellDataEx(3, 'name');
Parameters:
Name Type Description
row number

셀의 행 인덱스
key string

셀의 Key
Returns:
Type
*

setCellData(row, col, data) → {boolean}

Since:
  • QCELL v1.0.0

입력받은 행,열 인덱스에 해당하는 셀의 데이터를 갱신합니다.

Example
QCell1.setCellData(3, 1, "test");
Parameters:
Name Type Description
row number

셀의 행 인덱스
col number

셀의 열 인덱스
data *

셀 데이터
Returns:
Type
boolean

setCellDataEx(row, key, data 또는 boolean) → {boolean}

Since:
  • QCELL v2.1.88

입력받은 행, Key 에 해당하는 셀의 데이터를 갱신합니다.(체크박스의 체크 true(선택) 또는 false(해제)를 지원합니다.)

Example
	QCell1.setCellDataEx(3, 'name', "test");
QCell1.setCellDataEx(3, 'check', true);
QCell1.setCellDataEx(3, 'check', false);
Parameters:
Name Type Description
row number

셀의 행 인덱스
key string

컬럼의 key 값
data||boolean *

셀 데이터||checkbox의 체크 선택 또는 해제
Returns:
Type
boolean

getCellLabel(row, col) → {*}

Since:
  • QCELL v1.0.0

지정한 셀의 현재 표기된 데이터를 반환합니다.

Example
QCell1.getCellLabel(3, 1);
Parameters:
Name Type Description
row number

데이터 반환할 셀의 행 인덱스
col number

데이터 반환할 셀의 열 인덱스
Returns:
Type
*

setCellLabel(row, col, data) → {boolean}

Since:
  • QCELL v2.1.63

지정한 셀의 설정한 데이터를 출력합니다.

Example
QCell1.setCellLabel(3, 1, '출력');
Parameters:
Name Type Description
row number

셀의 행 인덱스
col number

셀의 열 인덱스
data *

출력할 데이터
Returns:
Type
boolean

requestData(properties) → {*}

Since:
  • QCELL v2.1.3

Server와의 통신을 통해 데이터를 바인딩합니다.

Example
var properties = 
{
	  url:       "/data.do",
	  param: {
       data1: "1",
       data2: "2"
   },
   callback: fnCallback
}
QCell1.requestData(properties);
Parameters:
Name Type Description
properties Object

Server와 통신시 필요 정보

Properties
Name Type Description
url string

Server와 통신할 URL 주소
param Object

Server와 통신시 전달할 Parameter
callback function

Server와 통신 이후 실행할 콜백 함수
Returns:
Type
*

showProgress() → {boolean}

Since:
  • QCELL v2.1.6

Progress 이미지를 화면에 출력합니다.

Example
QCell1.showProgress();
Returns:
Type
boolean

hideProgress(time) → {boolean}

Since:
  • QCELL v2.1.6

Progress 이미지를 화면에서 숨김 처리합니다.

Example
QCell1.hideProgress(300);
Parameters:
Name Type Default Description
time number 500

Progress가 숨겨될 때까지의 시간(ms)
Returns:
Type
boolean

setHeaderCellValue(row, col, data) → {boolean}

Since:
  • QCELL v2.1.42

header의 title을 동적으로 변경 시 사용

Example
QCell1.setHeaderCellValue(0, 1, 'change');
Parameters:
Name Type Description
row number

셀의 행 인덱스
col number

셀의 열 인덱스
data *

셀 데이터
Returns:
Type
boolean

setHeaderCellValueEx(row, key, data) → {boolean}

Since:
  • QCELL v2.1.158
Author:
  • jklee

header의 title을 동적으로 변경 시 사용

Example
QCell1.setHeaderCellValue(0, 'test', 'change');
Parameters:
Name Type Description
row number

셀의 행 인덱스
key string

셀의 열 키 인덱스
data *

셀 데이터
Returns:
Type
boolean

getHeaderCellValueEx(row, key) → {string}

Since:
  • QCELL v2.1.158
Author:
  • jklee

header의 title 값을 반환합니다.

Example
QCell1.getHeaderCellValueEx(0, 'test');
Parameters:
Name Type Description
row number

셀의 행 인덱스
key string

셀의 열 키 인덱스
Returns:
Type
string

getFocusRowData() → {boolean}

Since:
  • QCELL v2.1.65

현재 포커스된 행의 데이터 반환

Example
QCell1.getFocusRowData();
Returns:
Type
boolean

findRow(data, startRow, targetCol) → {number}

Since:
  • QCELL v2.1.87

해당 row 이하에서 대상 컬럼 중 특정 데이터를 찾음.

Example
QCell1.findRow('abcd', 1, 1);
Parameters:
Name Type Description
data string

찾을 데이터
startRow number

찾기 시작할 행 인덱스
targetCol number

셀의 열 인덱스
Returns:
Type
number

findRowEx(data, startRow, key) → {number}

Since:
  • QCELL v2.1.145
Author:
  • jklee

해당 row 이하에서 대상 컬럼 중 특정 데이터를 찾음.

Example
QCell1.findRowEx('abcd', 1, 'name');
Parameters:
Name Type Description
data string

찾을 데이터
startRow number

찾기 시작할 행 인덱스
key string

셀의 키 인덱스
Returns:
Type
number

sort(sortlist) → {boolean}

Since:
  • QCELL v1.0.0

QCELL의 데이터를 특정 조건을 기준으로 정렬합니다. (조건이 2개이상이면 다중정렬)

Example
QCell1.sort([[3, "asc", "string"]]); //3번째 열을 기준으로 (string)오름차순으로 정렬 (단일 정렬)
QCell1.sort([[3, "asc", "string"],[1, "desc", "number"]]); //3번째 열을 기준으로 (string)오름차순으로, 1번째 열을 기준으로 (number)내림차순으로 정렬 (다중 정렬)
Parameters:
Name Type Description
sortlist Array

정렬 조건
sortlist[i].col number

열 인덱스
sortlist[i].sorttype string

정렬 타입 ("asc" | "desc")
sortlist[i].datatype string

데이터 타입 ("string" | "number")
Returns:
Type
boolean

bind(eventname, handler, data) → {boolean}

Since:
  • QCELL v1.0.0
Author:
  • sonymaker

입력받은 이벤트를 QCELL에 추가합니다.

바인드명(이벤트명)|발생 시점,상황|파라미터(객체)
click|그리드 영역 내에서 마우스를 클릭 했을 때 이벤트 발생|event
dblclick|그리드 영역 내에서 마우스를 더블클릭 했을 때 이벤트 발생|event
mouseenter|그리드영역 내로 마우스 진입시 이벤트 발생|event
mouseleave|그리드 영역 밖으로 마우스 진입(떠날때)시 이벤트 발생|event
mouseover|마우스가 그리드 영역 내 있을 시 이벤트 발생|event
mouseout|셀 영역을 벗어날때 이벤트 발생|event
mouseup|그리드 영역 내에서 마우스 버튼을 눌렀다 떼었을 때 이벤트 발생|event
mousedown|그리드 영역 내에서 마우스 버튼을 눌렀을 때 이벤트 발생|event

keydown|그리드 영역 안에서 키가 눌렸을때|event
keyup|그리드 영역 안에서 키를 누른 후 떼었을때|event
keypress|편집 상태에서 키가 눌렸을때|event

scrollmove|스크롤이 이동될때 이벤트 발생|event
scrolltop|스크롤이 최상단(top)에 위치했을때 발생 더 이상 위로 갈 수 없는 상황|event
scrollbottom|스크롤이 최하단(bottom)에 위치했을때 발생 더 이상 내려갈 수 없는 상황|event

aftercreated|그리드 생성(프로퍼티 설정을 가지고 그리드를 생성) 후 이벤트 발생|event
aftermovepage|페이지네이션 시 다른 페이지로 이동이 완료된 시점에 이벤트 발생|event
movepage|페이지네이션 시 다른 페이지 이동, 처음, 끝으로 이동을 클릭했을때 발생|event, strState

beforesort|정렬 기능 수행 전에 이벤트 발생|event
aftersort|정렬 기능 수행 후에 이벤트 발생|event
change|그리드 내 셀의 타입이 입력 폼(input, textarea)인 셀의 값이 변경되었을 때|event
valuechanged|값이 변경된 후 포커스를 빠져 나갈때 발생|event
datachanged|.setData()로 그리드의 데이터가 새로운 것으로 변경되었을때 발생|event
buttonclick|type이 inputbutton인 경우 버튼 클릭 시 이벤트 발생|event
rowdatachanged|.setRowData()로 그리드의 특정 로우의 데이터가 변경되었을때 발생|event
selected|콤보 선택 시 이벤트 발생|event, nRow,nCol, item
afterurlexceldown|서버를 통한 엑셀 다운로드 완료 후 발생|event
exceluploadlocend|엑셀 파일을 선택하여 큐셀 그리드에 로딩 후 발생|event

treeuiclicked|트리 UI를 클릭하여 트리를 열고 닫을 때 발생|event

Example
QCell1.bind("click", function(event){
	var objQCell = event.data.target;//event parameter에서 QCELL객체를 추출이 가능 
});
QCell1.bind("click keydown", function(event){//하나의 핸들러 callback 함수를 여러개의 이벤트에 연동이 가능
	var objQCell = event.data.target;
});
QCell1.bind("click keydown", function(event){//하나의 핸들러 callback 함수를 여러개의 이벤트에 연동이 가능
	var objQCell = event.data.target;
},{'param': 'qcell1'});
Parameters:
Name Type Description
eventname string

이벤트 이름 (동시에 여러개의 이벤트 추가 시 띄워쓰기로 구분)("click" || "dblclick || "mouseenter" || "mouseleave" || "mousemove" || " "mouseover" || "mousedown" || "mouseup" || "keydown" || "change" || "scrollmove" || "scrolltop" || "scrollbottom" || "aftercreated" || "aftermovepage" || "beforesort" || "aftersort" || "valuechanged" || "selected" || "afterurlexceldown" || "datachanged" || "rowdatachanged" || "buttonclick" ||) ※ "afterurlexceldown"는 크로스도메인 환경에서 지원되지 않으며, URL 다운로드에서만 동작합니다. 결과값은 이벤트 객체내 filedownresult로 확인할 수 있습니다.
handler requestCallback

추가된 이벤트 발생 시 호출할 핸들러 callback 함수
data object

핸들러 콜백에 추가적으로 전달 할 수 있는 데이터
Returns:
Type
boolean

unbind(eventname) → {boolean}

Since:
  • QCELL v1.0.0

입력받은 이벤트를 QCELL에서 제거합니다.

Example
QCell1.unbind("click");
QCell1.unbind("click keydown");
Parameters:
Name Type Description
eventname string

이벤트 이름 (동시에 여러개의 이벤트 제거 시 띄워쓰기로 구분)
Returns:
Type
boolean

getUserEventInfo() → {Object}

Since:
  • QCELL v1.0.0

QCELL에 추가된 사용자 이벤트 정보를 반환합니다.

Example
var objUserEventInfo = QCell1.getUserEventInfo();
Returns:
Type
Object

trigger(eventname) → {boolean}

Since:
  • QCELL v1.0.0

입력한 이벤트의 핸들러를 강제로 실행합니다.

Example
QCell1.trigger("click");
Parameters:
Name Type Description
eventname string

이벤트 이름
Returns:
Type
boolean

clickCell(row, col) → {boolean}

Since:
  • QCELL v.2.1.5

특정 Cell을 click한 것과 동일한 효과로 선택합니다.

Example
QCell1.clickCell(1, 3);
Parameters:
Name Type Description
row number

행 인덱스
col number

열 인덱스
Returns:
Type
boolean

dblClickCell(row, col) → {boolean}

Since:
  • QCELL v.2.1.5

특정 Cell을 double click한 것과 동일한 효과로 선택합니다.

Example
QCell1.dblClickCell(2, 4);
Parameters:
Name Type Description
row number

행 인덱스
col number

열 인덱스
Returns:
Type
boolean

focusCell(row, col,nTime) → {boolean}

Since:
  • QCELL v.2.1.9
Author:
  • seongdeuk1985

특정 Cell을 focus 효과를 내며 선택합니다.

Example
QCell1.focusCell(1, 3, 1000);
Parameters:
Name Type Description
row number

행 인덱스
col number

열 인덱스
nTime number

시간(ms)
Returns:
Type
boolean

excelDownload(properties) → {boolean}

Since:
  • QCELL v1.0.0

QCELL 에서 출력되는 내용을 엑셀파일로 저장합니다. (IE9 이하의 브라우저는 Server를 통하여 저장, 그 외의 브라우저는 자체 저장 및 Server틑 통한 저장 지원)

Example
var properties = 
{
	filename:       "excel",
	border:         true,
	headershow:     true,
	colwidth:       true,
	progressui:     true,	
	param:          {"data1": "data1", "data2": "data2"},
	addColumns:     [{"key": "abc", "width": "250", "title": ["title1", "title1-1"], "position": "2"}, {...}],
	delColumns:     [3, 4, ...],
	orderColumns:   [1, 6, 4, 3, ...],
	datatype: 	"string",
	exceltitle: 	"제목",
	usehtmltype: 	true,	
	excelfooter: 	QCell1.getCustomPanel()
	



}
QCell1.excelDownload(properties);
Parameters:
Name Type Description
properties Object

Excel Download 정보 설정

Properties
현재 패널의 설정 되어 있는 값을 얻어올 수 있는 getCustomPanel() API 추가 함. --
Name Type Attributes Default Description
usehtmltype boolean <optional>
 false

true면 html 값 그대로 표시(false면 그리드 데이터 그대로 표시)
datatype string <optional>
 "string"

모든 데이터가 숫자형이라도 문자열로 지정되어 export 되게 설정
excelfooter Object <optional>

설정된 하단 패널의 값을 표시(QCell1.getCustomPanel() API 사용 필수)

exceltitle string <optional>
 "string"

엑셀 저장시 타이틀 설정
progressui boolean <optional>
 "false"

progress ui 사용 여부
filename string

저장할 파일명 설정 (필수)
fileExt string <optional>
 "xlsx"

저장할 파일의 확장자명 설정
url string

서버 다운로드 시 호출 URL 설정 (IE9 이하 및 서버 다운로드시 필수)
border boolean <optional>
 false

Excel 문서에 각 영역별 border처리 여부 설정
headershow boolean <optional>
 false

Excel 문서에 Header 영역 출력 여부 설정
colwidth boolean <optional>
 false

Excel 문서에 QCELL과 같은 column 별 "px" 적용 여부 설정
huge boolean <optional>
 false

대용량 데이터 여부 설정
totaldata boolean <optional>
 false

로컬 pagination 기능 사용 중 전체 데이터 저장 설정
label boolean <optional>
 false

데이터를 value값이 아닌 label으로 출력 (v2.1.4 부터 지원)
col의 type이 "static", "input", "textarea", "datepicker"일 때 현재 화면의 표시되는 값으로 출력 (v.2.1.44 부터 지원)
param Object <optional>

서버로 전송할 파라미터(JSON) (v2.1.3 부터 지원)
addColumns Object <optional>

Excel 저장시 추가할 Column 정보 (v2.1.7 이상부터 지원)

Properties
Name Type Attributes Default Description
key string

추가할 Column 정보의 key
width string <optional>
 100

추가할 Column 정보의 width (단위 "px")
position string <optional>
 마지막 열 인덱스

추가할 Column 정보의 열 인덱스
title Object

추가할 Column 정보의 헤더 타이틀 (멀티 타이틀 설정 가능, string 배열)
delColumns Array <optional>

Excel 저장시 삭제할 Column의 index 정보 (v2.1.7 이상부터 지원)
orderColumns Array <optional>

Excel 저장시 변경할 Column의 index 순서 정보, QCELL 생성시점의 column정보의 수가 동일해야 하며, orderColumns > delColumns > addColumns 순으로 실행됨 (v2.1.7 이상부터 지원)
Returns:
Type
boolean

excelUpload(properties) → {boolean}

Since:
  • QCELL v1.0.0

QCELL 에서 업로드한 엑셀파일의 정보를 설정합니다. (IE9 이하의 브라우저는 Server를 통하여 업로드, 그 외의 브라우저는 자체 업로드 및 Server틑 통한 업로드 지원)

Example
var properties = 
{
	headerrows:     1,
	cellname:       "QCell1",
	fileid:         "file",
	url:            "/filedownload.do",
	mode:           "append",
	
} 
QCell1.excelUpload(properties);
Parameters:
Name Type Description
properties Object

Excel Upload 정보 설정

Properties
Name Type Description
headerrows number

header영역의 행 카운트 설정 (필수)
event Event

파일 객체의 file change event 설정 (로컬 업로드시 필수)
cellname string

QCell의 객체명 설정 (IE9 이하 및 서버업로드 필수)
fileid string

파일 객체의 ID 설정 (IE9 이하 및 서버업로드 필수)
url string

서버 업로드 시 호출 URL 설정 (IE9 이하 및 서버업로드 필수)
mode string

'append' 엑셀 업로드 시에 추가 기능 (v2.1.164 이상부터 지원)
Returns:
Type
boolean

excelExportInfo(properties) → {Object}

Since:
  • QCELL v2.1.9
Author:
  • seongdeuk1985

QCELL 에서 엑셀로 저장할 때 필요한 정보들을 추출합니다. (.excelDownload() API에서 파라미터 filename과 url외 동일)

Example
var properties = 
{
	border:         true,
	headershow:     true,
	colwidth:       true,
	param:       {"data1": "data1", "data2": "data2"},
	addColumns:     [{"key": "abc", "width": "250", "title": ["title1", "title1-1"], "position": "2"}, {...}],
	delColumns:     [3, 4, ...],
	orderColumns:   [1, 6, 4, 3, ...]
}
QCell1.excelExportInfo(pr_exportCellInfooperties);
Parameters:
Name Type Description
properties Object

Excel 저장시 설정 정보

Properties
Name Type Attributes Default Description
border boolean <optional>
 false

Excel 문서에 각 영역별 border처리 여부 설정
headershow boolean <optional>
 false

Excel 문서에 Header 영역 출력 여부 설정
colwidth boolean <optional>
 false

Excel 문서에 QCELL과 같은 column 별 "px" 적용 여부 설정
huge boolean <optional>
 false

대용량 데이터 여부 설정
label boolean <optional>
 false

데이터를 value값이 아닌 label으로 출력 (v2.1.4 부터 지원)
col의 type이 "static", "input", "textarea", "datepicker"일 때 현재 화면의 표시되는 값으로 출력 (v.2.1.44 부터 지원)
param Object <optional>

서버로 전송할 파라미터(JSON) (v2.1.3 부터 지원)
addColumns Object <optional>

Excel 저장시 추가할 Column 정보 (v2.1.7 이상부터 지원)

Properties
Name Type Attributes Default Description
key string

추가할 Column 정보의 key
width string <optional>
 100

추가할 Column 정보의 width (단위 "px")
position string <optional>
 마지막 열 인덱스

추가할 Column 정보의 열 인덱스
title Object

추가할 Column 정보의 헤더 타이틀 (멀티 타이틀 설정 가능, string 배열)
delColumns Array <optional>

Excel 저장시 삭제할 Column의 index 정보 (v2.1.7 이상부터 지원)
orderColumns Array <optional>

Excel 저장시 변경할 Column의 index 순서 정보, QCELL 생성시점의 column정보의 수가 동일해야 하며, orderColumns > delColumns > addColumns 순으로 실행됨 (v2.1.7 이상부터 지원)
Returns:
Type
Object

htmlDownload(properties) → {Boolean}

Since:
  • QCELL v2.1.64

QCELL을 HTML 파일로 저장합니다.

Parameters:
Name Type Description
properties Object

HTML 저장시 설정 정보

Properties
Name Type Attributes Default Description
filename string

저장할 HTML 파일명 설정 (필수)
label boolean <optional>
 false

데이터를 value값이 아닌 label으로 출력
Returns:
Type
Boolean

txtDownload(properties) → {Boolean}

Since:
  • QCELL v2.1.158
Author:
  • jklee

QCELL을 txt 파일로 저정합니다.

Example
var properties = 
{
	filename:       "txt",
	headershow:     true,
	addColumns:     [{"key": "abc", "width": "250", "title": ["title1", "title1-1"], "position": "2"}, {...}],
	usehtmltype: 	true,
	colsep: 	',',
	rowsep: 	'\n',
	label: 		true,	
	footer: 	QCell1.getCustomPanel()


}
QCell1.txtDownload(properties);
Parameters:
Name Type Description
properties Object

txt 저장시 설정 정보

Properties
Name Type Attributes Default Description
usehtmltype boolean <optional>
 false

true면 html 값 그대로 표시(false면 그리드 데이터 그대로 표시)
footer Object <optional>

설정된 하단 패널의 값을 표시(QCell1.getCustomPanel() API 사용 필수)
filename string

저장할 txt 파일명 설정 (필수)
label boolean <optional>
 false

데이터를 value값이 아닌 label으로 출력
headershow boolean <optional>
 false

Export시 header 포함 여부
colsep String <optional>
 ‘,’

Export시 지정한 문자열을 Col 간 구분자로 사용

rowsep String <optional>
 ‘\n’

Export시 지정한 문자열을 Row 간 구분자로 사용
addColums string

Export시 숨겨진 데이터 추가 할 수 있는 기능
단, excel export addColumns spec에 있는 width는 무시함(v.2.1.158 이상 지원)
Returns:
Type
Boolean

excelDownloadURLHuge(properties) → {boolean}

Since:
  • QCELL v2.1.67

QCELL 에서 출력되는 내용을 대용량 엑셀파일로 저장합니다. (Server를 통하여 저장)
기존 다운로드에서의 속성 border, headershow, colwidth, huge, label들은 true로 지정되어 동작하며 기존의 totaldata는 제거

Example
var properties = 
{
	filename:       "excel",
 fileExt:		"xlsx",
	param:       {"data1": "data1", "data2": "data2"},
	addColumns:     [{"key": "abc", "width": "250", "title": ["title1", "title1-1"], "position": "2"}, {...}],
	delColumns:     [3, 4, ...],
	orderColumns:   [1, 6, 4, 3, ...]
}
QCell1.excelDownloadURLHuge(properties);
Parameters:
Name Type Description
properties Object

Excel Download 정보 설정

Properties
Name Type Attributes Default Description
filename string

저장할 파일명 설정 (필수)
fileExt string <optional>
 "xlsx"

저장할 파일의 확장자명 설정
url string

서버 다운로드 시 호출 URL 설정 (IE9 이하 및 서버 다운로드시 필수)
param Object <optional>

서버로 전송할 파라미터(JSON) (v2.1.3 부터 지원)
addColumns Object <optional>

Excel 저장시 추가할 Column 정보 (v2.1.7 이상부터 지원)

Properties
Name Type Attributes Default Description
key string

추가할 Column 정보의 key
width string <optional>
 100

추가할 Column 정보의 width (단위 "px")
position string <optional>
 마지막 열 인덱스

추가할 Column 정보의 열 인덱스
title Object

추가할 Column 정보의 헤더 타이틀 (멀티 타이틀 설정 가능, string 배열)
delColumns Array <optional>

Excel 저장시 삭제할 Column의 index 정보 (v2.1.7 이상부터 지원)
orderColumns Array <optional>

Excel 저장시 변경할 Column의 index 순서 정보, QCELL 생성시점의 column정보의 수가 동일해야 하며, orderColumns > delColumns > addColumns 순으로 실행됨 (v2.1.7 이상부터 지원)
Returns:
Type
boolean

exportCellInfoURLHuge(properties) → {Object}

Since:
  • QCELL v2.1.67

QCELL 에서 엑셀로 저장할 때 필요한 정보들을 추출합니다. (.excelDownloadURLHuge() API에서 파라미터 filename과 url외 동일)
기존 다운로드에서의 속성 border, headershow, colwidth, huge, label들은 true로 지정되어 동작하며 기존의 totaldata는 제거

Example
var properties = 
{
	param:       {"data1": "data1", "data2": "data2"},
	addColumns:     [{"key": "abc", "width": "250", "title": ["title1", "title1-1"], "position": "2"}, {...}],
	delColumns:     [3, 4, ...],
	orderColumns:   [1, 6, 4, 3, ...]
}
QCell1.exportCellInfoURLHuge(properties);
Parameters:
Name Type Description
properties Object

Excel 저장시 설정 정보

Properties
Name Type Attributes Description
param Object <optional>

서버로 전송할 파라미터(JSON) (v2.1.3 부터 지원)
addColumns Object <optional>

Excel 저장시 추가할 Column 정보 (v2.1.7 이상부터 지원)

Properties
Name Type Attributes Default Description
key string

추가할 Column 정보의 key
width string <optional>
 100

추가할 Column 정보의 width (단위 "px")
position string <optional>
 마지막 열 인덱스

추가할 Column 정보의 열 인덱스
title Object

추가할 Column 정보의 헤더 타이틀 (멀티 타이틀 설정 가능, string 배열)
delColumns Array <optional>

Excel 저장시 삭제할 Column의 index 정보 (v2.1.7 이상부터 지원)
orderColumns Array <optional>

Excel 저장시 변경할 Column의 index 순서 정보, QCELL 생성시점의 column정보의 수가 동일해야 하며, orderColumns > delColumns > addColumns 순으로 실행됨 (v2.1.7 이상부터 지원)
Returns:
Type
Object

merge(strArea, strMergeType) → {boolean}

Since:
  • QCELL v1.0.0

병합할 영역과 방식을 설정합니다.

Example
QCell1.merge("header", "rowandcol");
Parameters:
Name Type Default Description
strArea string

병합할 영역 ("header" | "data")
strMergeType string "none"

병합할 방식
("header" 영역은 "row" | "col" | "rowandcol" | "colandrow" | "none")
("data" 영역은 "row" | "col" | "group" | "none")
Returns:
Type
boolean

setPageIndex(index) → {boolean}

Since:
  • QCELL v2.1.2

"현재 페이지 번호"를 설정합니다.

Example
QCell1.setPageIndex(2);
Parameters:
Name Type Description
index number

변경할 페이지 번호
Returns:
Type
boolean

getPageIndex() → {number}

Since:
  • QCELL v2.1.2

"현재 페이지 번호"를 반환합니다.

Example
var nPageIndex = QCell1.getPageIndex();
Returns:
Type
number

setPageUnit(index) → {boolean}

Since:
  • QCELL v2.1.2

"페이지 출력 행의 수"를 설정합니다.

Example
QCell1.setPageUnit(10);
Parameters:
Name Type Description
index number

변경할 페이지 출력 행의 수
Returns:
Type
boolean

getPageUnit() → {number}

Since:
  • QCELL v2.1.2

"페이지 출력 행의 수"를 반환합니다.

Example
var nPageUnit = QCell1.getPageUnit();
Returns:
Type
number

setPaginationParam(property) → {boolean}

Since:
  • QCELL v2.1.2

pagination 속성 "param"을 설정합니다.

Example
QCell1.setPaginationParam({"param1": 1, "param2": "RightTech"});
Parameters:
Name Type Description
property Object

서버로 전송시 전달할 파라미터(JSON)
Returns:
Type
boolean

getPaginationParam() → {Object}

Since:
  • QCELL v2.1.2

pagination 속성 "param"을 반환합니다.

Example
QCell1.getPaginationParam();
Returns:
Type
Object

setPaginationDatacount(count) → {boolean}

Since:
  • QCELL v2.1.3

pagination 속성 "datacount"를 설정합니다.

Example
QCell1.setPaginationDatacount(100);
Parameters:
Name Type Description
count number

전체 데이터의 수
Returns:
Type
boolean

getPaginationDatacount() → {number}

Since:
  • QCELL v2.1.3

pagination 속성 "datacount"을 반환합니다.

Example
QCell1.getPaginationDatacount();
Returns:
Type
number

setPaginationUrl(url) → {boolean}

Since:
  • QCELL v2.1.3

pagination 속성 "url"를 설정합니다.

Example
QCell1.setPaginationUrl("/loadurl.do");
Parameters:
Name Type Description
url string

서버와 통신할 url 주소
Returns:
Type
boolean

getPaginationUrl() → {string}

Since:
  • QCELL v2.1.3

pagination 속성 "url"을 반환합니다.

Example
QCell1.getPaginationUrl();
Returns:
Type
string

setPaginationLoadonce(loadonce) → {boolean}

Since:
  • QCELL v2.1.3

pagination 속성 "loadonce"를 설정합니다.

Example
QCell1.setPaginationLoadonce(true);
Parameters:
Name Type Description
loadonce boolean

서버와 통신할 때 전체 데이터를 가져올 것인지 부분 데이터를 가져올 것인지 구분 여부
Returns:
Type
boolean

getPaginationLoadonce() → {boolean}

Since:
  • QCELL v2.1.3

pagination 속성 "loadonce"을 반환합니다.

Example
QCell1.getPaginationLoadonce();
Returns:
Type
boolean

setPaginationInitSort() → {boolean}

Since:
  • QCELL v2.1.4

pagination 사용 중 설정된 sort정보를 초기화합니다.

Example
QCell1.setPaginationInitSort();
Returns:
Type
boolean

getRowheaderChecked(nCol) → {Array}

Since:
  • QCELL v2.1.4

rowheader "checkbox"인 열 인덱스의 checkbox에서 check 된 행 인덱스들을 배열로 반환합니다.

Example
QCell1.getRowheaderChecked(1);
Parameters:
Name Type Description
nCol number

열 인덱스
Returns:
Type
Array

setRowheaderChecked(nRow, nCol, bState) → {boolean}

Since:
  • QCELL v2.1.4

rowheader "checkbox"로 입력받은 행,열 인덱스에 해당하는 checkbox의 상태값을 갱신합니다.

Example
QCell1.setRowheaderChecked(1, 0, true);
Parameters:
Name Type Description
nRow number

행 인덱스
nCol number

열 인덱스
bState boolean

checkbox 상태값
Returns:
Type
boolean

setRowheaderCheckedArr(arrRow, nCol) → {boolean}

Since:
  • QCELL v2.1.4

rowheader "checkbox"로 입력받은 행의 배열,열 인덱스에 해당하는 checkbox를 check상태로 갱신합니다.

Example
QCell1.setRowheaderCheckedArr([1, 3, 5], 0);
Parameters:
Name Type Description
arrRow Array

행 인덱스 배열
nCol number

열 인덱스
Returns:
Type
boolean

setGroup(properties) → {boolean}

Since:
  • QCELL v2.1.5

입력받은 정보를 이용하여 QCELL의 데이터를 그룹화(Groupping)합니다.

Example
QCell1.setGroup({
	type	: "tree",
	columns	: [
		{
			key	: "sido",
			expand	: true,
			footer	: {
				"sido"	: ["시도: " : "groupvalue(0)", "의 Footer"],
				"goongu": ["읍면동 갯수: ", "count('dong')"],
				.
				.
				.
			}
		},
		{
			key	: "goongu",
			expand	: false,
			footer	: {
				"sido"	: ["군구: " : "groupvalue(0)", "의 Footer"],
				"goongu": ["읍면동 갯수: ", "count('dong')"],
				.
				.
				.
			}
		},
		.
		.
		.
	]
});
Parameters:
Name Type Description
properties Object

그룹화 정보

Properties
Name Type Attributes Default Description
type string <optional>
 "normal"

그룹화 타입("normal" | "tree" | "step" | "group")
hidekeydata boolean <optional>
 false

그룹화 타입이 "tree"일 때 그룹화 할 컬럼의 데이터의 숨김 여부 (v.2.1.47부터 적용)
sort string <optional>
 "asc"

그룹화 타입 정렬 옵션("asc" | "desc" | "none")
columns Array.<Object>

그룹화 할 컬럼들의 정보

통계함수

Name Parameters Description Return Type
childcount 없음 직계 자식노드들의 갯수 number
count 없음 전체 자식노드들의 갯수 number
countif countif(colkey, value) 전체 자식노드들 중에서 지정한 컬럼의 데이터가 기준값과 동일한 자식노드들의 갯수 number
sum sum(colkey) 전체 자식노드 데이터들의 총합(colkey값 미입력 시 데이터를 표시 할 컬럼의 키값으로 설정) number
average average(colkey) 전체 자식노드 데이터들의 평균(colkey값 미입력 시 데이터를 표시 할 컬럼의 키값으로 설정) number
groupvalue groupvalue(grouplevel) 그룹 헤더/푸터가 그려진 기준이 되는 그룹의 값 string
Properties
Name Type Attributes Default Description
key string

그룹화 할 컬럼의 키값
expand boolean <optional>
 true

"tree", "step" 그룹화 타입 사용 시 펼침 여부 설정("normal"과 "group" 그룹화 타입 사용 시 사용불가)
header Object.<key:string, celldata:Array> <optional>
 {}

그룹화 시 표시 할 그룹 헤더 행 정보

Properties
Name Type Description
key string

그룹 헤더 행에 데이터를 표시 할 컬럼의 키값
celldata Array.<string>

그룹 헤더 행에 표시 할 텍스트 데이터 배열(텍스트 or 통계함수)
footer Object.<key:string, celldata:Array> <optional>
 {}

그룹화 시 표시 할 그룹 푸터 행 정보

Properties
Name Type Description
key string

그룹 푸터 행에 데이터를 표시 할 컬럼의 키값
celldata Array.<string>

그룹 푸터 행에 표시 할 텍스트 데이터 배열(텍스트 or 통계함수)
Returns:
Type
boolean

clearGroup() → {boolean}

Since:
  • QCELL v2.1.5

그룹화(Groupping)를 해제합니다.

Example
QCell1.clearGroup();
Returns:
Type
boolean

setGrandTotal(properties) → {boolean}

Since:
  • QCELL v2.1.120

입력받은 정보를 이용하여 QCELL의 데이터를 활용하여 Grand total 을 추가합니다..

Example
QCell1.setGrandTotal({
	footer	: [
		 {
				"sido"	: ["시도: " : "groupvalue(0)", "의 Footer"],
				"goongu": ["읍면동 갯수: ", "count('dong')"],
				.
				.
				.
			},
		.
		.
		.
	]
});
Parameters:
Name Type Description
properties Object
Properties
Name Type Attributes Default Description
header Object.<key:string, celldata:Array> <optional>
 [{}]

GrandTotal에 표시 할 헤더 행 정보

Properties
Name Type Description
key string

GrandTotal 헤더 행에 데이터를 표시 할 컬럼의 키값
celldata Array.<string>

그룹 헤더 행에 표시 할 텍스트 데이터 배열(텍스트 or 통계함수)

Properties

Grand total 정보 통계함수

Name Parameters Description Return Type
childcount 없음 직계 자식노드들의 갯수 number
count 없음 전체 자식노드들의 갯수 number
countif countif(colkey, value) 전체 자식노드들 중에서 지정한 컬럼의 데이터가 기준값과 동일한 자식노드들의 갯수 number
sum sum(colkey) 전체 자식노드 데이터들의 총합(colkey값 미입력 시 데이터를 표시 할 컬럼의 키값으로 설정) number
average average(colkey) 전체 자식노드 데이터들의 평균(colkey값 미입력 시 데이터를 표시 할 컬럼의 키값으로 설정) number
footer Object.<key:string, celldata:Array> <optional>
 [{}]

그룹화 시 표시 할 그룹 푸터 행 정보

Properties
Name Type Description
key string

그룹 푸터 행에 데이터를 표시 할 컬럼의 키값
celldata Array.<string>

그룹 헤더 행에 표시 할 텍스트 데이터 배열(텍스트 or 통계함수)

Properties

Grand total 정보 통계함수

Name Parameters Description Return Type
childcount 없음 직계 자식노드들의 갯수 number
count 없음 전체 자식노드들의 갯수 number
countif countif(colkey, value) 전체 자식노드들 중에서 지정한 컬럼의 데이터가 기준값과 동일한 자식노드들의 갯수 number
sum sum(colkey) 전체 자식노드 데이터들의 총합(colkey값 미입력 시 데이터를 표시 할 컬럼의 키값으로 설정) number
average average(colkey) 전체 자식노드 데이터들의 평균(colkey값 미입력 시 데이터를 표시 할 컬럼의 키값으로 설정) number
Returns:
Type
boolean

clearGrandTotal() → {boolean}

Since:
  • QCELL v2.1.120

GrandTotal를 해제합니다.

Example
QCell1.clearGrandTotal();
Returns:
Type
boolean

setTree(properties) → {boolean}

Since:
  • QCELL v2.1.143
Author:
  • jklee

입력받은 정보를 이용하여 QCELL의 데이터를 계층화(Tree)합니다.

Example
QCell1.setTree({
		sort : 'none', //정렬 : 'asc' or 'desc', 'none'
		level :  'level', // 레벨 정보가 들어가 있는 컬럼
		columns: [
		{
			key: 'lev1',,   //1 depth
			expand: false  //초기 로딩 시 펼침여부
		},
		{
			key: 'lev2',,  //2 depth
			expand: false,
		},
		{
			key: 'lev3',,  //3 depth
			expand: false,
		},
		{
			key: 'lev4',,  
			expand: false,
		},...
			]
});
Parameters:
Name Type Description
properties Object

계층화 정보

Properties
Name Type Attributes Default Description
sort string <optional>
 none

트리의 정렬 순서 ("none" | "asc" | "desc")
level string <optional>
 level

레벨 정보가 들어가 있는 컬럼
leafindent number <optional>
 0

트리 단일 노드의 들여쓰기를 조절하는 값(v2.1.163 이상부터 지원)
moveFirst boolean <optional>
 true

setTree 이용 시 트리 UI 를 level1 의 위치에 표현 하도록 함(v2.1.164 이상부터 지원)
Returns:
Type
boolean

insertTreeNode(arrKey, objData) → {boolean}

Since:
  • QCELL v2.1.143
Author:
  • jklee

해당 위치에 새로운 트리 노드를 추가합니다.

Example
QCell1.insertTreeNode(["관리기능","시스템관리","제공기관 관리","test4"],
				{
					"code": "MN000025",
					"lev1": '관리기능',
					"lev2": '시스템관리',
					"lev3": '제공기관 관리',
					"lev4": 'test4',
					"lev5": '',
					"lev6": '',
					"useYn": "Y",
					"level": 4,
					"initYn": "Y",
					"searchYn": "Y",
					"newYn": "Y",
					"saveYn": "Y",
					"delYn": "Y",
					"seq": 2,
				  });
Parameters:
Name Type Description
arrKey Array

해야할 키 값 배열
objData Object

해야 할 실 데이터
Returns:
Type
boolean

removeTreeNode(arrKey) → {boolean}

Since:
  • QCELL v2.1.143
Author:
  • jklee

해당 위치에 트리 노드를 하위를 포함 하여 삭제 합니다..

Example
QCell1.removeTreeNode(["관리기능","시스템관리","제공기관 관리","test4"]);
Parameters:
Name Type Description
arrKey Array

해야할 키 값 배열
Returns:
Type
boolean

updateTreeNode(arrKey, objData) → {boolean}

Since:
  • QCELL v2.1.147
Author:
  • jklee

해당 위치에 트리 노드의 데이터를 변경 합니다.

Example
QCell1.updateTreeNode(["관리기능","시스템관리","제공기관 관리","test4"],{key1:'data1', key2:'data2'});
Parameters:
Name Type Description
arrKey Array

해야할 키 값 배열
objData object

해야할 키 값 배열
Returns:
Type
boolean

getTreeState(state) → {String}

Since:
  • QCELL v2.1.144
Author:
  • jklee

Tree 의 상태값을 가져 옵니다.

Example
QCell1.getTreeState();
QCell1.getTreeState('i');
Parameters:
Name Type Description
state string

반환할 행 상태 정보의 타입 ("i" | "u" | "d")
Returns:
Type
String

clearTreeState() → {boolean}

Since:
  • QCELL v2.1.144
Author:
  • jklee

Tree 의 상태값을 초기화 합니다..

Example
QCell1.clearTreeState();
Returns:
Type
boolean

setDisableContextmenu(ids) → {boolean}

Since:
  • QCELL v2.1.7

contextmenu에서 비활성화할 메뉴의 id를 설정합니다.

Example
QCell1.setDisableContextmenu(['contextmenu-1', '...']);
Parameters:
Name Type Description
ids Array

비활성화할 contextmenu의 id의 배열
Returns:
Type
boolean

setAbleContextmenu(ids) → {boolean}

Since:
  • QCELL v2.1.7

contextmenu에서 비활성화 된 메뉴 중 활성화 할 메뉴의 id를 설정합니다.

Example
QCell1.setAbleContextmenu(['contextmenu-1', '...']);
Parameters:
Name Type Description
ids Array

활성화할 contextmenu의 id의 배열
Returns:
Type
boolean

setContextmenu(obj) → {boolean}

Since:
  • QCELL v2.1.8

contextmenu를 설정합니다.

Example
QCell1.setContextmenu({
		header: {
			id: "...",
			contents:
			[
				{},...,{}
			]
		},
		data: {
			base: {
				id: "...",
				contents:
				[
					{},...,{}
				]
			},
			except: [
				{col:..., id: "...", contents:[{},...,{}]},
				{col:..., id: "...", contents:[{},...,{}]}
			]
		}
});
Parameters:
Name Type Description
obj Object

설정할 contextmenu
Returns:
Type
boolean

getContextmenuId() → {string}

Since:
  • QCELL v2.1.8

현재 마우스 커서가 위치한 Contextmenu의 id를 반환합니다.

Example
QCell1.getContextmenuId();
Returns:
Type
string

filter(col, filter) → {boolean}

Since:
  • QCELL v2.1.40

컬럼별 필터를 설정합니다.

Example
QCell1.filter([3,['data1','data2'...]]);
Parameters:
Name Type Description
col number

열 인덱스
filter Any

데이터
Returns:
Type
boolean

filterEx(key, filterEx) → {boolean}

Since:
  • QCELL v2.1.152
Author:
  • jklee

지정한 키 값에 대한 필터를 설정합니다.

Example
	QCell1.filterEx(['key1',['data1','data2'...]]);
Parameters:
Name Type Description
key string

key 값
filterEx Any

데이터
Returns:
Type
boolean

resetFilter(col) → {boolean}

Since:
  • QCELL v2.1.40

filter가 적용된 컬럼의 필터를 해제합니다.

Example
QCell1.resetFilter(3);
Parameters:
Name Type Description
col number

열 인덱스
Returns:
Type
boolean

resetFilterEx(col) → {boolean}

Since:
  • QCELL v2.1.152
Author:
  • jklee

filterEx가 적용된 컬럼의 필터를 해제합니다.

Example
QCell1.resetFilterEx(3);
Parameters:
Name Type Description
col number

열 인덱스
Returns:
Type
boolean

lookup(key, data, 조건) → {boolean}

Since:
  • QCELL v2.1.192
Author:
  • jklee

문자열을 포함한 내용을 검색합니다.

Example
QCell1.lookup([{key:'name' , condition: '김철수'}]);
QCell1.lookup([{key:'name' , condition : '김철'} , {key:'id' ,condition:'012'}] ,'or')
Parameters:
Name Type Description
key string

key 값
data string

데이터 값
조건 string

조건(or|and)
Returns:
Type
boolean

resetLookup() → {boolean}

Since:
  • QCELL v2.1.40

문자열을 포함한 내용 검색을 해제합니다.

Example
QCell1.resetLookup();
Returns:
Type
boolean

addRow(dataopt) → {boolean}

Since:
  • QCELL v1.0.0

마지막 행 다음 위치에 행을 추가합니다.

Example
QCell1.addRow();
QCell1.addRow({"name" : "kevin", "age" : "35"});	//QCELL의 data 타입이 "object"인 경우
QCell1.addRow(["kevin", "35"]);			//QCELL의 data 타입이 "array"인 경우
Parameters:
Name Type Attributes Default Description
data Object <optional>
 {}

행 데이터
Returns:
Type
boolean

addRows(count_or_data) → {boolean}

Since:
  • QCELL v1.0.0

마지막 행 다음 위치에 다수의 행을 추가합니다.

Example
QCell1.addRow(3);
QCell1.addRows([{"name" : "kevin", "age" : "35"}, {"name" : "jenny", "age" : "28"}]);//QCELL의 data 타입이 "object"인 경우
QCell1.addRows([["kevin", "35"], ["jenny", "28"]]);//QCELL의 data 타입이 "array"인 경우
Parameters:
Name Type Description
count_or_data number | Array

행의 개수 또는 행 데이터 배열
Returns:
Type
boolean

insertRow(row, dataopt) → {boolean}

Since:
  • QCELL v1.0.0

입력받은 행 인덱스 위치에 행을 삽입합니다.

Example
QCell1.insertRow(3);
QCell1.insertRow(3, {"name" : "kevin", "age" : "35"});	//QCELL의 data 타입이 "object"인 경우
QCell1.insertRow(3, ["kevin", "35"]);		//QCELL의 data 타입이 "array"인 경우
Parameters:
Name Type Attributes Default Description
row number

행 인덱스
data Object <optional>
 {}

행 데이터
Returns:
Type
boolean

insertRows(row, count_or_data) → {boolean}

Since:
  • QCELL v1.0.0

입력받은 행 인덱스 위치에 다수의 행을 삽입합니다.

Example
QCell1.insertRows(3, 2);
QCell1.insertRows(3, [{"name" : "kevin", "age" : "35"}, {"name" : "jenny", "age" : "28"}]);//QCELL의 data 타입이 "object"인 경우
QCell1.insertRows(3, [["kevin", "35"], ["jenny", "28"]]);//QCELL의 data 타입이 "array"인 경우
Parameters:
Name Type Description
row number

행 인덱스
count_or_data number | Array

행의 개수 또는 행 데이터 배열
Returns:
Type
boolean

insertRowsEx(data) → {boolean}

Since:
  • QCELL v1.0.0

입력받은 다수의 행 인덱스 위치에 행을 삽입합니다.

Example
QCell1.insertRowsEx([ [3, {"name" : "kevin", "age" : "35"}], [5,{"name" : "jenny", "age" : "28"}] ]);//QCELL의 data 타입이 "object"인 경우
QCell1.insertRowsEx([ [3, ["kevin", "35"]], [5, ["jenny", "28"]] ]);//QCELL의 data 타입이 "array"인 경우
Parameters:
Name Type Description
data Array

행 인덱스 위치, 행 데이터 배열의 배열
Returns:
Type
boolean

removeRow() → {boolean}

Since:
  • QCELL v1.0.0

마지막 행을 삭제합니다.

Example
QCell1.removeRow();
Returns:
Type
boolean

removeRows(count) → {boolean}

Since:
  • QCELL v1.0.0

마지막 행부터 입력받은 개수만큼 행을 삭제합니다.

Example
QCell1.removeRows(3);
Parameters:
Name Type Description
count number

삭제할 행의 개수
Returns:
Type
boolean

deleteRow(row) → {boolean}

Since:
  • QCELL v1.0.0

입력받은 행 인덱스 위치의 행을 삭제합니다.

Example
QCell1.deleteRow(3);
Parameters:
Name Type Description
row number

행 인덱스
Returns:
Type
boolean

deleteRows(row, count) → {boolean}

Since:
  • QCELL v1.0.0

입력받은 행 인덱스 위치부터 설정한 개수만큼 행을 삭제합니다.

Example
QCell1.deleteRows(3, 2);
Parameters:
Name Type Description
row number

행 인덱스
count number

삭제할 행의 개수
Returns:
Type
boolean

deleteRowsEx(rows) → {boolean}

Since:
  • QCELL v1.0.0

입력받은 행 인덱스 위치의 행을 삭제합니다.

Example
QCell1.deleteRowsEx([3,5,7]);
Parameters:
Name Type Description
rows Array

행 인덱스 배열
Returns:
Type
boolean

getState(state) → {Array}

Since:
  • QCELL v1.0.0

지정한 타입의 행 상태 정보를 반환합니다.

Example
QCell1.getState('i');
Parameters:
Name Type Description
state string

반환할 행 상태 정보의 타입 ("i" | "u" | "d")
Returns:
Type
Array

getStates() → {Object}

Since:
  • QCELL v1.0.0

행 상태 정보들을 반환합니다.

Example
QCell1.getStates();
Returns:
Type
Object

clearStates() → {boolean}

Since:
  • QCELL v2.1.56

삭제정보를 포함한 모든 상태정보를 삭제한다.

Example
QCell1.clearStates();
Returns:
Type
boolean

getStatesEx(propertyName) → {Object}

Since:
  • QCELL v2.1.27

행 상태 정보들을 반환합니다.

Example
QCell1.getStatesEx();
Parameters:
Name Type Description
propertyName string

(optional) 프로퍼티 명칭
Returns:
Type
Object

getStatesBySep(rowSep, colSep) → {string}

Since:
  • QCELL v2.1.28

행 상태 정보들을 구분자 형태로 반환합니다.

Example
QCell1.getStatesBySep();
Parameters:
Name Type Description
rowSep string

(optional) 행구분자
colSep string

(optional) 열구분자
Returns:
Type
string

getAllStates() → {Object}

Since:
  • QCELL v2.1.153
Author:
  • jklee

모든행에 대한 상태 정보들을 반환합니다.

Example
QCell1.getStates();
Returns:
Type
Object

setColOptions(nCol, options) → {Boolean}

Since:
  • QCELL v2.1.175
Author:
  • jklee

지정한 컬럼의 포맷 관련된 options을 변경한다.

Example
QCell1.setColOptions(3, { maxlength:10,format: { type: "number", rule: "#,###.##" } })

                                      ↓↓ 변경 ↓↓

QCell1.setColOptions(3, { maxlength:20, mask: { alias: 'currency', prefix: '￦', digits: 2 }, format: { type: "number", rule: "￦ #,###.##" } })
Parameters:
Name Type Description
nCol Number

변경할 열 인덱스
options Object

변경할 포맷 options 정보
Returns:
Type
Boolean

getColOptions(nCol) → {Boolean}

Since:
  • QCELL v2.1.175
Author:
  • jklee

지정한 컬럼의 options 정보를 반환한다..

Example
QCell1.getColOptions(3);
Parameters:
Name Type Description
nCol Number

반환할 열 인덱스
Returns:
Type
Boolean

getAllStatesBySep(strStateName, strRowName) → {string}

Since:
  • QCELL v2.1.39

모든 행 상태 정보들을 구분자 형태로 반환합니다.

Example
QCell1.getAllStatesBySep();
Parameters:
Name Type Description
strStateName string

(optional) 상태정보 표시 명
strRowName string

(optional) 행번호 표시 명
Returns:
Type
string

setCellDisable(row, col, bDisable) → {boolean}

Since:
  • QCELL v2.1.30

셀을 활성화 / 비활성화 상태로 설정합니다.

Example
QCell1.setCellDisable(3, 2,true);
Parameters:
Name Type Description
row number

활성화할 행 인덱스
col number

활성화할 열 인덱스
bDisable boolean

disable 여부
Returns:
Type
boolean

setCellsDisable(srow, scol, erow, ecol, bDisable) → {boolean}

Since:
  • QCELL v2.1.83

셀들을 활성화 / 비활성화 상태로 설정합니다.

Example
QCell1.setCellsDisable(3, 2, 5,2,true);
Parameters:
Name Type Description
srow number

활성화할 행 처음 인덱스
scol number

활성화할 열 처음 인덱스
erow number

활성화할 행 마지막 인덱스
ecol number

활성화할 열 마지막 인덱스
bDisable boolean

disable 여부
Returns:
Type
boolean

setRowDisable(row, bDisable, area) → {boolean}

Since:
  • QCELL v2.1.56

행을 활성화 / 비활성화 상태로 설정합니다.

Example
QCell1.setRowDisable(3, true);
Parameters:
Name Type Default Description
row number

활성화할 행 인덱스
bDisable boolean

disable 여부
area string "data"

설정할 영역 ("data" | "rowheader" | "all")
Returns:
Type
boolean

getColDisable(col) → {boolean}

Since:
  • QCELL vQCELL 2.1.174

컬럼의 활성화 / 비활성화 여부를 확인합니다.

Example
QCell1.getColDisable(2);
Parameters:
Name Type Description
col number

확인할 열 인덱스
Returns:
Type
boolean

setColDisable(col, bDisable) → {boolean}

Since:
  • QCELL v2.1.71

컬럼을 활성화 / 비활성화 상태로 설정합니다.

Example
QCell1.setColDisable(2, true);
Parameters:
Name Type Description
col number

활성화할 열 인덱스
bDisable boolean

disable 여부
Returns:
Type
boolean

closeEditMode() → {boolean}

Since:
  • QCELL v2.1.9

edit상태를 확인하고 edit상태이면 종료 설정합니다.

Example
QCell1.closeEditMode();
Returns:
Type
boolean

getRowState(row) → {string}

Since:
  • QCELL v2.1.82

행 상태정보를 반환한다.

Example
QCell1.getRowState(3);
Parameters:
Name Type Description
row number

반환할 행 인덱스
Returns:
Type
string

setRowState(row, state) → {boolean}

Since:
  • QCELL v2.1.26

행 상태정보를 설정한다.

Example
QCell1.setRowState(3,'d');
Parameters:
Name Type Description
row number

설정할 행 인덱스
state string

설정할 상태값('i'|'u'|'d')
Returns:
Type
boolean

removeRowState(row) → {boolean}

Since:
  • QCELL v2.1.26

행 상태정보를 삭제한다.

Example
QCell1.removeRowState(3);
Parameters:
Name Type Description
row number

설정할 행 인덱스
Returns:
Type
boolean

clearRowStates() → {boolean}

Since:
  • QCELL v2.1.26

모든 상태정보를 삭제한다.

Example
QCell1.clearRowStates();
Returns:
Type
boolean

checkRequired() → {Array}

Since:
  • QCELL v2.1.34

required 컬럼을 확인하여 비어 있다면 정보를 반환한다.

Example
QCell1.checkRequired();
Returns:
Type
Array

divisionSubmit(url, pageCnt) → {boolean}

Since:
  • QCELL v2.1.54

서버에 정보를 분할submit을 통해, 전체 데이터를 로딩한다.

Example
QCell1.divisionSubmit('/divisionSubmitSample.do', 5);
Parameters:
Name Type Description
url string

서버와 통신할 URL주소
pageCnt number

서버와 통신할 때마다 전달받을 데이터 갯수
Returns:
Type
boolean

insertStaticRow(row, dataopt) → {boolean}

Since:
  • QCELL v2.1.63

입력받은 행 인덱스 위치에 고정출력 행을 삽입합니다.

Example
QCell1.insertStaticRow(3);
QCell1.insertStaticRow(3, {"name" : "kevin", "age" : "35"});	//QCELL의 data 타입이 "object"인 경우
QCell1.insertStaticRow(3, ["kevin", "35"]);		//QCELL의 data 타입이 "array"인 경우
Parameters:
Name Type Attributes Default Description
row number

행 인덱스
data Object <optional>
 {}

행 데이터
Returns:
Type
boolean

deleteStaticRow(row) → {boolean}

Since:
  • QCELL v2.1.63

입력받은 행 인덱스 위치의 고정출력 행을 삭제합니다. (일반적인 행 삭제는 고정출력 행 정보가 삭제되지 않아, 반드시 고정출력 행은 해당 API를 거쳐 삭제해야 합니다.)

Example
QCell1.deleteStaticRow(3);
Parameters:
Name Type Description
row number

행 인덱스
Returns:
Type
boolean

getFocusRowState() → {Array}

Since:
  • QCELL v2.1.65

포커스된 행의 상태 정보를 반환합니다. 반환할 행 상태 정보의 타입 ("i" | "u" | "d")

Example
QCell1.getFocusRowState();
Returns:
Type
Array

getSelectRowState(row) → {Array}

Since:
  • QCELL v2.1.65

특정 행의 상태 정보를 반환합니다. 반환할 행 상태 정보의 타입 ("i" | "u" | "d")

Example
QCell1.getSelectRowState(3);
Parameters:
Name Type Description
row

상태 정보를 확인할 행의 인덱스
Returns:
Type
Array
Returns:
Type
Boolean

getColSum(nCol) → {Number}

Since:
  • QCELL v2.1.75

특정 컬럼의 데이터를 모두 더합니다.

Example
QCell1.getColSum(4);
Parameters:
Name Type Description
nCol number

컬럼의 열 인덱스
Returns:
Type
Number

isStaticRow(nCol) → {Number}

Since:
  • QCELL v2.1.75

특정 행이 출력전용 행인 static row인지 확인합니다.

Example
QCell1.isStaticRow(3);
Parameters:
Name Type Description
nCol number

행 인덱스
Returns:
Type
Number

editCell(row, col) → {boolean}

Since:
  • QCELL v2.1.90

edit 가능한 Cell 이면 Edit 상태 들어가도록 설정합니다.

Example
QCell1.editCell ( 3, 1)
Parameters:
Name Type Description
row number

행 인덱스
col number

열 인덱스
Returns:
Type
boolean

resetCustomPanel(val) → {string}

Since:
  • QCELL v2.1.177

하단 패널 방식을 설정합니다.
(해당 기능 사용 시 useexcelstylepanel : false 옵션 사용 권장)

Example
QCell1.resetCustomPanel('테스트입니다')
QCell1.resetCustomPanel()
Parameters:
Name Type Description
val string|none

설정값
Returns:
Type
string

getCustomPanel()

Since:
  • QCELL v2.1.177

현재 화면에 표시된 패널의 정보 값을 가져옵니다.

Example
QCell1.getCustomPanel();

getHeaderCheckedState(col) → {boolean}

Since:
  • QCELL v1.0.0

QCELL의 특정 열에 전체 선택 체크박스가 존재할 경우, 전체 선택 체크박스의 상태 값을 반환합니다.

Example
QCell1.getHeaderCheckedState(1);
Parameters:
Name Type Description
col number

열 인덱스
Returns:
Type
boolean

setHeaderChecked(col, state) → {void}

Since:
  • QCELL v1.0.0

QCELL의 특정 열에 전체 선택 체크박스가 존재할 경우, 전체 선택 체크박스의 상태 값을 설정합니다.

Example
QCell1.setHeaderChecked(1, true);
Parameters:
Name Type Description
col number

열 인덱스
state boolean

전체 선택 체크박스 상태 값 (true | false)
Returns:
Type
void

getCheckedRows(col) → {Array}

Since:
  • QCELL v1.0.0

QCELL의 특정 열의 타입이 "checkbox" 일 때, 선택된 행 인덱스들을 배열로 반환합니다.

Example
QCell1.getCheckedRows(1);
Parameters:
Name Type Description
col number

열 인덱스
Returns:
Type
Array

setSelectmenuValue(row, col, val) → {boolean}

Since:
  • QCELL v1.0.51

QCELL의 selectmenu Column의 데이터에서 value값을 설정하여, 그에 해당하는 label값을 QCELL에 출력시킵니다.

Example
QCell1.setSelectmenuValue(1, 5, '');
Parameters:
Name Type Description
row number

행 인덱스
col number

열 인덱스
val string | number

설정값
Returns:
Type
boolean

getSelectmenuLabel(row, col) → {string}

Since:
  • QCELL v2.1.84

selectmenu Column의 value값으로 label 값 가져오는 API 입니다.

Example
QCell1.getSelectmenuLabel(1, 5);
Parameters:
Name Type Description
row number

행 인덱스
col number

열 인덱스
Returns:
Type
string

getUseEmptyMessage() → {boolean}

Since:
  • QCELL v2.1.165

현재 useemptymessage 사용 여부를 true/false로 반환하는 api입니다.

Example
QCell1.getUseEmptyMessage();
Returns:
Type
boolean

setUseEmptyMessage () → {boolean}

Since:
  • QCELL v2.1.165

인자로 들어오는 boolean 값으로 emptymessage을 사용 여부를 설정하는 api입니다

Example
QCell1.setUseEmptyMessage(true);
Returns:
Type
boolean