LocalTreeDataProvider

LocalTreeDataProvider 클래스. DataProviderBase 를 상속한다.

상세 설명

[상위 클래스]

DataProviderBase

프로퍼티 정보

onDataChanged


onDataChanged: (provider: LocalTreeDataProvider) => void

데이터가 변경 되었음을 알리는 콜백

상세 설명

key 입력이나 LocalTreeDataProvider.setValue() 를 이용하여 데이터를 변경한후 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

기본값

null

예제 코드

dataProvider.onDataChanged = function (provider) {
     console.log('dataChanged!');
};

onRowAdded


onRowAdded: (provider: LocalTreeDataProvider, row: number) => void

행이 추가되었음을 알리는 콜백

상세 설명

TreeDataProvider에 데이터가 추가된 후 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

row - 데이터 행의 트리 id

기본값

null

예제 코드

dataProvider.onRowAdded = function (provider, row) {
     console.log("DataProvider row added at "+ row);
};

onRowAdding


onRowAdding: (provider: LocalTreeDataProvider, row: number, index: number, child: any) => boolean

행이 추가됨을 결정하는 콜백

상세 설명

TreeDataProvider에 데이터가 추가되기 직전에 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

row - 데이터 행의 트리 id

index - 부모 행의 자식들 중 삽입된 행의 위치(순서)

child - 추가 된 행의 자식 데이터

기본값

null [반환값] - 기본값: true, 명시적으로 false를 리턴하면 행이 삽입되지 않는다.

예제 코드

dataProvider.onRowAdding = function (provider, row, index, child) {
     if (row > 100) {
         return false;
     }
     return true;
};

onRowCountChanged


onRowCountChanged: (provider: LocalTreeDataProvider, newCount: number) => void

행의 갯수가 변경되었음을 알리는 콜백

상세 설명

행 추가 및 삭제 등으로 행의 개수가 변경됐을 때 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

newCount - 변경된 행의 갯수

예제 코드

dataProvider.onRowCountChanged = function (provider, count) {
    console.log("DataProvider rowCount changed as: " + newCount);
};

onRowDeleted


onRowDeleted: (provider: LocalTreeDataProvider, row: number) => void

행 삭제가 되었음을 알리는 콜백

상세 설명

TreeDataProvider에 데이터가 삭제된 후 호출한다.

softDeleting = true 일 경우 Row의 State가 Deleted로 변경된 것 만으로는 호출되지 않는다.

완전히 TreeDataProvider에서 삭제되었을 때 발생한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

row - 데이터 행의 트리 id

기본값

null

예제 코드

dataProvider.onRowDeleted = function (provider, row) {
     console.log('dataProvider row deleted ' + row);
};

onRowDeleting


onRowDeleting: (provider: LocalTreeDataProvider, row: number) => boolean

행 삭제를 결정하는 콜백

상세 설명

TreeDataProvider에 데이터가 삭제되기 전 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

row - 데이터 행의 트리 id

기본값

null

[반환값] - - 기본값: true, 삭제하려면 true, 삭제를 취소하려면 false 를 반환한다.

예제 코드

dataProvider.onRowDeleting = function (provider, row) {
     if (row < 100) {
         return false;
     }
     return true;
};

onRowParentChanged


onRowParentChanged: (provider: LocalTreeDataProvider, row: number, parent: number, index: number) => void

행의 부모가 바뀐 것을 알리는 콜백

상세 설명

LocalTreeDataProvider.changeRowParent() 함수를 사용하여 부모가 바뀐 후에 발생한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

row - 이동한 데이터 행의 트리 id

parent - 이동한 곳의 부모 아이템

index - 이동한 부모의 위치 index

기본값

null

예제 코드

dataProvider.onRowParentChanged = function (provider, row, parent, index) {
     console.log('parent row changed to ' + parent);
};

onRowParentChanging


onRowParentChanging: (provider: LocalTreeDataProvider, row: number, parent: number, index: number) => boolean

행의 부모를 바꾸는 것을 결정하는 콜백

상세 설명

LocalTreeDataProvider.changeRowParent() 함수를 사용하여 부모를 바꾸려고 할때 발생한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

row - 이동하려는 데이터 행의 트리 id

parent - 이동하려는 곳의 부모 아이템

index - 이동하려는 부모의 위치 인덱스

기본값

null [반환값] - false를 반환하면 이동이 취소된다.

예제 코드

dataProvider.onRowParentChanging = function (provider, row, parent, index) {
     if (row % 2 === 0) {
         return true;
     }
     return false;
};

onRowsAdded


onRowsAdded: (provider: LocalTreeDataProvider, parent: number, rows: number[]) => void

행들이 추가되었음을 알리는 콜백

상세 설명

TreeDataProvider에 데이터가 추가된 후 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

parent - 부모의 id

rows - 데이터 행들의 트리 id들

기본값

null

예제 코드

dataProvider.onRowsAdded = function (provider, parent, rows) {
     console.log("DataProvider row added at " + parent + " as " + rows.join(", "));
};

onRowsDeleted


onRowsDeleted: (provider: LocalTreeDataProvider, rows: number[]) => void

행들이 삭제가 되었음을 알리는 콜백

상세 설명

TreeDataProvider에 데이터 행들이 삭제된 후 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

rows - 데이터 행들의 트리 id들

기본값

null

예제 코드

dataProvider.onRowsDeleted = function (provider, rows) {
     console.log('DataProvider rows deleted: ' + rows.join(', '));
};

onRowSiblingMoved


onRowSiblingMoved: (provider: LocalTreeDataProvider, row: number, offset: number) => void

행 들의 형제 간 이동했음을 알리는 콜백

상세 설명

LocalTreeDataProvider.moveRowSibling() 함수를 사용하여 형제 간 위치가 바뀌었을 때 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

row - 이동한 데이터 행의 트리 id

offset - 상하 위치 단계 값

기본값

null

예제 코드

dataProvider.onRowSiblingMoved = function (provider, row, offset) {
     console.log('sibling row moved on: ' + row);
};

onRowSiblingMoving


onRowSiblingMoving: (provider: LocalTreeDataProvider, row: number, offset: number) => boolean

행 들의 형제 간 이동을 결정하는 콜백

상세 설명

LocalTreeDataProvider.moveRowSibling() 함수를 사용하여 형제 간 위치를 바꾸려고 할때 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

row - 이동하려는 데이터 행의 트리 id

offset - 상하 위치 단계 값

기본값

null [반환값] - 기본값: true, false를 반환하면 이동이 취소된다.

예제 코드

dataProvider.onRowSiblingMoving = function (provider, row, offset) {
     if (row % 2 === 0) {
         return true;
     }
     return false;
};

onRowsSiblingMoved


onRowsSiblingMoved: (provider: LocalTreeDataProvider, rows: number[], offset: number) => void

dragAndDrop을 이용해서 형제 간 이동했음을 알리는 콜백

상세 설명

마우스 dragAndDrop을 사용하여 형제 간 위치가 바뀌었을 때 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

rows - 이동한 데이터 행의 트리 id 배열

offset - 상하 위치 단계 값

기본값

null

예제 코드

dataProvider.onRowsSiblingMoved = function (provider, rows, offset) {
     console.log('sibling row moved on: ' + row);
};

onRowsSiblingMoving


onRowsSiblingMoving: (provider: LocalTreeDataProvider, rows: number[], offset: number) => boolean

DragAndDrop을 이용한 형제 간 이동을 결정하는 콜백

상세 설명

마우스 dragAndDrop을 사용하여 형제 간 위치를 바꾸려고 할때 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

rows - 이동하려는 데이터 행의 트리 id 배열

offset - 상하 위치 단계 값

기본값

null [반환값] - 기본값: true, false를 반환하면 이동이 취소된다.

예제 코드

dataProvider.onRowsSiblingMoving = function (provider, rows, offset) {
     if (row.length > 1) {
         return false;
     }
     return true;
};

onRowStateChanged


onRowStateChanged: (provider: LocalTreeDataProvider, row: number) => void

행 상태가 변경되었음을 알리는 콜백

상세 설명

TreeDataProvider의 데이터행의 rowState가 변경된 뒤 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

row - 변경된 데이터 행의 트리 id

기본값

null

예제 코드

dataProvider.onRowStateChanged = function (provider, row) {
     console.log('dataProvider row state changed: ' + row);
};

onRowStatesChanged


onRowStatesChanged: (provider: LocalTreeDataProvider, rows: number[]) => void

여러 행들의 상태가 변경되었음을 알리는 콜백

상세 설명

TreeDataProvider에서 여러 건의 데이터행의 rowState가 변경된 뒤 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

rows - 변경된 데이터 행들의 트리 id 들

기본값

null

예제 코드

dataProvider.onRowStatesChanged = function (provider, rows) {
     console.log('dataProvider row state changed: ' + rows.join(','));
};

onRowsUpdated


onRowsUpdated: (provider: LocalTreeDataProvider, rows: number[]) => void

다수의 데이터 행이 변경되었음을 알리는 콜백

상세 설명

updateRows 등의 함수에서 이벤트 일괄 반영되도록 했을 때 발생한다.

[매개변수 목록]

provider - DataProvider 컨트롤

rows - 변경된 데이터 행들의 트리 id들

기본값

null

예제 코드

dataProvider.onRowsUpdated = function (provider, rows) {
     console.log("DataProvider rows updated: " + rows.join(', '));
};

onRowsUpdating


onRowsUpdating: (provider: LocalTreeDataProvider, rows: number[]) => boolean

다수의 데이터 행 변경을 결정하는 콜백

[매개변수 목록]

provider - DataProvider 컨트롤

rows - 변경될 데이터 행들의 트리 id

기본값

null

예제 코드

dataProvider.onRowsUpdating = function (provider, rows) {
     if (rows.length > 10) {
         return false;
     }
     return true;
};

onRowUpdated


onRowUpdated: (provider: LocalTreeDataProvider, row: number) => void

행 수정이 되었음을 알리는 콜백

상세 설명

TreeDataProvider에 데이터가 수정되기 전에 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

row - 데이터 행의 트리 id

기본값

null

예제 코드

dataProvider.onRowUpdated = function (provider, row) {
     console.log("DataProvider row updated: " + row);
};

onRowUpdating


onRowUpdating: (provider: LocalTreeDataProvider, row: number) => boolean

행 수정을 결정하는 콜백

상세 설명

TreeDataProvider에 데이터가 수정되기 전에 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

row - 데이터 행의 트리 id

기본값

null [반환값] - 기본값: true, false 를 반환하면 수정이 취소된다.

예제 코드

dataProvider.onRowUpdating = function (provider, row) {
     if(row % 2 === 0) {
         console.log("DataProvider row updated: " + row);
         return true;
     }
     return false;
};

onValueChanged


onValueChanged: (provider: LocalTreeDataProvider, row: number, field: number) => void

데이터의 값이 변경 되었음을 알리는 콜백

상세 설명

LocalTreeDataProvider.setValue() 를 이용하여 데이터를 변경한후 호출한다.

[매개변수 목록]

provider - TreeDataProvider 컨트롤

row - 값이 변경된 데이터 행의 트리 id.

field - 필드의 인덱스.

기본값

null

예제 코드

dataProvider.onValueChanged = function (provider, row, field) {
     console.log('DataProvider row Value changed at ' + row + ' on ' + field);
};

메서드 정보

addChildRow


addChildRow(row:number,values:DataValues,iconIndex:number,hasChildren:boolean):number

지정한 트리 행의 자식 행을 추가한다.

매개변수

  • row: number

    지정한 데이터 행의 트리 id. 지정하지 않을경우 루트 행을 지정한다.

  • values: DataValues

    추가할 행의 필드 값 배열 또는 Object

  • iconIndex: number

    트리 행에 표시할 아이콘 인덱스. 기본값: -1

  • hasChildren: boolean

    자식의 있는지 표시 여부. 기본값: false. true면 자식이 있는 것으로 표시

반환값

타입: number

성공적으로 추가하면 추가된 행 고유번호를, 실패하면 -1을 반환한다.

예제 코드

treeProvider.addChildRow(4, ['value1', 'value2', 'value3', 'value4'], -1, true);

changeRowParent


changeRowParent(row:number,parent:number,index:number):boolean

특정 데이터행의 위치를 지정한 행의 하위로 이동한다.

매개변수

  • row: number

    데이터 행의 트리 id

  • parent: number

    지정한 부모 행의 id. 이 행의 하위로 이동한다.

  • index: number

    형제들 사이에서의 위치

반환값

타입: boolean

해당 데이터 행 또는 그 부모행이 존재하지 않을 경우 false를 반환한다.

예제 코드

dataProvider.changeRowParent(4, 1, 2);

clearRows


clearRows():void

DataProvider의 모든 행을 삭제한다.

예제 코드

treeProvider.clearRows();

fillCsvData


fillCsvData(data:any,options:DataFillOptions):void

지정한 설정에 따라 csv 데이터를 로드하여 TreeDataProvider 로컬 저장소에 저장한다.

매개변수

예제 코드

let options = {
     start: 1,
     count: 3
}

dataProvider.fillCsvData(data, options);

fillJsonData


fillJsonData(data:any,options:DataFillOptions):void

지정한 설정에 따라 Json 데이터를 로드하여 TreeDataProvider 로컬 저장소에 저장한다.

매개변수

예제 코드

let options = {
     start: 1,
     count: 3
}

dataProvider.fillJsonData([
 {
   FieldA: 'ABC',
   FieldB: 10
 }, {
   FieldA: 'DEF',
   FieldB: 30
 }], options);

fillXmlData


fillXmlData(data:any,options:DataFillOptions):void

지정한 설정에 따라 xml 데이터를 로드하여 TreeDataProvider 로컬 저장소에 저장한다.

매개변수

예제 코드

let options = {
     start: 1,
     count: 3
}

dataProvider.fillXmlData(data, options);

getAncestors


getAncestors(row:number):number[]

지정한 행의 조상 행들의 id를 반환한다.

매개변수

  • row: number

    지정한 데이터 행의 트리 id

반환값

타입: number[]

지정한 행 또는 행의 조상 행들이 존재하지 않을 경우 null을 반환한다.

예제 코드

let ances = treeProvider.getAncestors(4);

getChildCount


getChildCount(row:number):number

지정한 행의 자식 행들의 개수를 반환한다.

매개변수

  • row: number

    지정한 데이터 행의 트리 id. -1일 경우 루트 행의 자식 행들의 개수를 반환한다.

반환값

타입: number

지정한 행 또는 자식 행이 존재하지 않을 경우 0을 반환한다

예제 코드

let childCount = treeProvider.getChildCount(4);

getChildren


getChildren(row:number):number[]

지정한 행의 모든 자식 행들의 고유 번호를 반환한다.

매개변수

  • row: number

    지정한 데이터 행의 트리 id, -1일 경우 루트 행의 자식 행들의 고유 번호를 반환한다.

반환값

타입: number[]

지정한 행이 존재하지 않을 경우 null을 반환한다.

예제 코드

let children = treeProvider.getChildren(4);

getDescendantCount


getDescendantCount(row:number):number

지정한 행의 자손 행들의 개수를 반환한다.

매개변수

  • row: number

    지정한 데이터 행의 트리 id, -1일 경우 루트 행의 자손 행들의 개수를 반환한다.

반환값

타입: number

예제 코드

let descenCount = treeProvider.getDescendantCount(4);

getDescendants


getDescendants(row:number,maxLevel:number):number[]

지정한 행의 자손 행들의 id를 반환한다.

매개변수

  • row: number
  • maxLevel: number

    반환할 수 있는 최대 레벨 깊이. 설정 된 값 이하의 레벨을 가진 행들만 반환한다.

반환값

타입: number[]

예제 코드

let descendants = treeProvider.getDescendants(4, 2);

getHiddenRows


getHiddenRows():number[]

숨겨진 행들의 번호를 반환한다.

반환값

타입: number[]

예제 코드

let rows = treeProvider.getHiddenRows();

getIconIndex


getIconIndex(row:number):number

트리 행에 표시된 아이콘 인덱스를 반환한다.

매개변수

  • row: number

    데이터 행의 트리 id

반환값

타입: number

예제 코드

let iconIndex = treeProvider.getIconIndex(4);

getJsonRow


getJsonRow(row:number):any

지정한 데이터 행을 JSON 객체로 반환한다.

매개변수

  • row: number

    지정한 데이터 행의 트리 id

반환값

타입: any

지정한 행이 존재하지 않을 경우 null을 반환한다.

예제 코드

let jsonRow = treeProvider.getJsonRow(4);

getJsonRows


getJsonRows(row:number,recursive:boolean,childRowsProp:string,iconProp:string):object[]

지정한 데이터 행과 자손들을 JSON 객체로 반환한다.

매개변수

  • row: number

    지정한 데이터 행의 트리 id, 지정하지 않거나 rowId를 null로 지정하면 루트 행의 데이터를 가져옵니다.

  • recursive: boolean

    자손을 포함할 것인지 여부. 기본값: false

  • childRowsProp: string

    자식 속성의 속성명을 지정한다. 기본값: 'rows'

  • iconProp: string

    아이콘 필드의 속성명을 지정한다. 기본값: 'iconIndex'

반환값

타입: object[]

지정한 행이 존재하지 않을 경우 null을 반환한다.

예제 코드

let jsonRow = treeProvider.getJsonRows(4, true);

getLevel


getLevel(row:number):number

지정한 행의 level을 반환한다.

매개변수

  • row: number

    지정한 데이터 행의 트리 id

반환값

타입: number

예제 코드

let level = treeProvider.getLevel(4);

getOutputRow


getOutputRow(options:DataOutputOptions,row:number,iconProp:string):object

지정한 데이터 행을 형식을 적용하여 JSON 객체로 가져온다.

매개변수

  • options: DataOutputOptions

    DataOutputOptions 와 같은 모델의 설정 정보

  • row: number

    지정한 데이터 행의 트리 id. 지정하지 않을경우 루트 행의 결과를 반환한다.

  • iconProp: string

    아이콘 필드의 속성명을 지정한다. 기본값: 'iconIndex'

반환값

타입: object

지정한 데이터 행이 존재하지 않으면 null을 반환한다.

예제 코드

let opt = {
     nullText: '빈 값'
}
let row = dataProvider.getOutputRow(opt, 4);

getOutputRows


getOutputRows(options:DataOutputOptions,row:number,recursive:boolean,childRowsProp:string,iconProp:string):object[]

지정한 데이터 행과 자손들을 형식을 적용하여 JSON 객체로 가져온다.

매개변수

  • options: DataOutputOptions

    DataOutputOptions 와 같은 모델의 설정 정보

  • row: number

    지정한 데이터 행의 트리 id. 지정하지 않을경우 루트 행의 결과를 반환한다.

  • recursive: boolean

    자손을 포함할 것인지 여부. 기본값: false

  • childRowsProp: string

    자식 속성의 속성명을 지정한다. 기본값: 'rows'

  • iconProp: string

    아이콘 필드의 속성명을 지정한다. 기본값: 'iconIndex'

반환값

타입: object[]

지정한 데이터 행이 존재하지 않으면 null을 반환한다.

예제 코드

let opt = {
     nullText: '빈 값'
}
let row = dataProvider.getOutputRows(opt, 4);

getParent


getParent(row:number):number

지정한 행의 부모의 row id를 반환한다.

매개변수

  • row: number

    지정한 데이터 행의 트리 id

반환값

타입: number

행 또는 부모 행이 존재하지 않을 경우 -1을 반환한다

예제 코드

let p = treeProvider.getParent(4);

getRowCount


getRowCount():number

저장 된 데이터행의 갯수를 반환한다.

반환값

타입: number

상세 설명

루트의 하위에 저장되어있는 모든 아이템의 갯수를 반환한다.

예제 코드

let rowCount = ds.getRowCount();

getValue


getValue(row:number,field:string | number):any

지정한 데이터 셀의 값을 반환한다.

매개변수

  • row: number

    데이터 행의 트리 id

  • field: string | number

    필드명 또는 인덱스

반환값

타입: any

해당 데이터 행이 존재하지 않을 경우 null을 반환한다.

예제 코드

let val = dataProvider.getValue(2, 10);

hideRows


hideRows(dataRows:number[] | number):void

지정한 행 또는 행들을 화면에서 감춘다.

매개변수

  • dataRows: number[] | number

    숨기고 싶은 행 번호 또는 번호들

상세 설명

숨겨진 상태에서 remove, insert가 발생하는 경우 dataRow가 변경될 수 있으므로 사용시 주의한다.

예제 코드

// single
treeProvider.hideRows(4);

// array
treeProvider.hideRows([3,4]);

insertChildRow


insertChildRow(row:number,index:number,values:DataValues,iconIndex:number,hasChildren:boolean):number

지정한 트리 행의 자식행들 중 원하는 위치에 자식행을 추가한다.

매개변수

  • row: number

    지정한 데이터 행의 트리 id. 지정하지 않을경우 루트 행을 지정한다.

  • index: number

    지정한 부모 행의 자식들 중 삽입하려는 행이 들어갈 위치

  • values: DataValues

    필드값의 배열이나 필드들을 속성으로 하는 json 객체

  • iconIndex: number

    트리 행에 표시할 아이콘 인덱스. 기본값: -1

  • hasChildren: boolean

    자식의 있는지 표시 여부. 기본값: false. true면 자식이 있는 것으로 표시

반환값

타입: number

성공적으로 추가하면 추가된 행 고유번호를, 실패하면 -1을 반환한다.

예제 코드

treeProvider.insertChildRow(4, 3, ['value1', 'value2', 'value3', 'value4'], -1, true);

isHiddenRow


isHiddenRow(dataRow:number):boolean

지정된 행이 숨겨진 행인지의 여부를 반환한다.

매개변수

  • dataRow: number

    지정한 데이터 행의 고유번호

반환값

타입: boolean

예제 코드

let isHidden = treeProvider.isHiddenRow(4);

moveRowSibling


moveRowSibling(row:number,offset:number):boolean

같은 부모의 형제 사이에서 특정 데이터행의 위치를 지정한 단계만큼 이동한다.

매개변수

  • row: number

    데이터 행의 트리 id

  • offset: number

    지정 단계 값

반환값

타입: boolean

해당 데이터 행이 존재하지 않을 경우 false를 반환한다

예제 코드

dataProvider.moveRowSibling(4, 1);

removeRow


removeRow(row:number):boolean

지정한 데이터행을 삭제한다.

매개변수

  • row: number

    삭제할 데이터 행의 트리 id

반환값

타입: boolean

- 지정한 행 또는 행의 부모가 존재할 경우 성공여부를, 하지 않을경우 false를 반환한다.

상세 설명

지정한 데이터행이 조상행인 경우 모든 자손행들도 같이 삭제된다. DataProvider의 softDeleting이 true인 경우 실제로 삭제되지않고 rowState만 변경된다.

예제 코드

treeProvider.removeRow(4);

removeRows


removeRows(rows:number[]):boolean

지정한 데이터 행들을 삭제한다.

매개변수

  • rows: number[]

    삭제할 데이터 행들의 트리 id들. 지정하지 않거나 빈 배열을 입력할 경우, false를 반환한다.

반환값

타입: boolean

- 삭제의 성공여부를 반환한다.

상세 설명

지정한 데이터행이 조상행인 경우 모든 자손행들도 같이 삭제된다. DataProvider의 softDeleting이 true인 경우 실제로 삭제되지않고 rowState만 변경된다.

예제 코드

treeProvider.removeRow(1,3,4);

resetHiddenRows


resetHiddenRows():void

숨겨진 모든 행을 다시 표시한다.

예제 코드

treeProvider.resetHiddenRows();

searchData



검색 설정 방식에 따라 특정 값이 있는 셀을 찾는다.

매개변수

반환값

타입: SearchCellResult

찾은 셀의 정보, SearchCellResult 모델이다.

예제 코드

ds.searchData({fields:['fieldName'], value: 'value', parentId: 3});

searchDataRow


searchDataRow(options:SearchOptions):number

검색 설정 방식에 따라 특정 값이 있는 행을 찾는다.

매개변수

반환값

타입: number

찾은 행의 인덱스

예제 코드

ds.searchDataRow({fields:['fieldName'], values: ['value'], parentId: 3});

setCsvRows


setCsvRows(rows:string,treeField:string,needSorting:boolean,childrenField:string,iconField:string):void

트리의 데이터를 새로운 CSV 데이터로 설정한다.

매개변수

  • rows: string

    설정할 데이터

  • treeField: string

    필드 명

  • needSorting: boolean
  • childrenField: string

    자식 행이 있는 지를 지시하는 필드, 자식의 필드 명.

  • iconField: string

    트리 노드에 표시할 아이콘 경로를 값으로 가지고 있는 필드 이름

상세 설명

트리의 기존 데이터행들을 모두 삭제하고 매개변수로 전달되는 CSV를 데이터 행들로 추가한다.

예제 코드

let rows = `Username; Identifier;First name;Last name
booker12;9012;Rachel;Booker
grey07;2070;Laura;Grey
johnson81;4081;Craig;Johnson
jenkins46;9346;Mary;Jenkins
smith79;5079;Jamie;Smith
`
dataProvider.setCsvRows(rows, 'number', false, '', 'icon');

setIconIndex


setIconIndex(row:number,iconIndex:number):void

지정한 행의 아이콘을 변경한다.

매개변수

  • row: number

    아이콘을 변경할 행의 트리 id

  • iconIndex: number

    새로 변경할 아이콘 인덱스

예제 코드

treeProvider.setIconIndex(42, 4);

setNestedRows


setNestedRows(json:any,rowsProp:string,childRowsProp:string,childrenProp:string,iconProp:string):void

?

매개변수

  • json: any
  • rowsProp: string
  • childRowsProp: string
  • childrenProp: string
  • iconProp: string

setObjectRows


setObjectRows(json:any,rowsProp:string,childrenProp:string,iconProp:string):void

트리의 데이터를 새로운 JSON 데이터로 설정한다.

매개변수

  • json: any

    설정할 데이터. Json 배열이거나 Json 배열을 속성으로 갖는 object. Json 배열이 아닌 경우 rowsProp에 지정된 속성을 배열로 지정해야 한다.

  • rowsProp: string

    Json 중 트리의 데이터 행들로 사용될 배열을 값으로 하는 속성의 이름

  • childrenProp: string

    자식 행이 있는 지를 지시하는 속성 이름. 해당 속성의 값이 자식의 필드 이름과 같아야한다.

  • iconProp: string

    트리 노드에 표시할 아이콘 경로를 값으로 가지고 있는 속성 이름

상세 설명

트리의 기존 데이터행들을 모두 삭제하고 매개변수로 전달되는 JSON 객체를 데이터 행들로 추가한다.

예제 코드

dataProvider.setObjectRows(rows, 'number', '', 'icon');

setRows


setRows(rows:DataValues[],treeField:string,needSorting:boolean,childrenField:string,iconField:string):void

트리의 데이터를 새로운 데이터로 설정한다.

매개변수

  • rows: DataValues[]

    설정할 데이터

  • treeField: string

    필드 명

  • needSorting: boolean
  • childrenField: string

    자식 행이 있는 지를 지시하는 필드, 자식의 필드 명

  • iconField: string

    트리 노드에 표시할 아이콘 경로를 값으로 가지고 있는 필드 이름

상세 설명

트리의 기존 데이터행들을 모두 삭제하고 매개변수로 전달되는 배열의 배열을 데이터 행들로 추가한다.

예제 코드

dataProvider.setRows([{
         'uno', 1, 'one', 'ichi', 'ee', 'I'
     }, {
         'dos', 2, 'two', 'ni', 'er', 'II'
     }
], 'number', false, '', 'icon');

setValue


setValue(row:number,field:string | number,value:any):void

지정한 데이터 셀의 값을 변경한다.

매개변수

  • row: number

    데이터 행의 트리 id

  • field: string | number

    필드명 또는 인덱스

  • value: any

예제 코드

dataProvider.setValue(2, 5, 'newValue');

setXmlRows


setXmlRows(xml:any,rowElement:string,childrenField:string,iconField:string):void

트리의 데이터를 새로운 XML 데이터로 설정한다.

매개변수

  • xml: any

    설정할 데이터

  • rowElement: string

    XML 중 트리의 데이터 행들로 사용될 element의 이름

  • childrenField: string

    자식 행이 있는 지를 지시하는 필드, 자식의 필드 명

  • iconField: string

    트리 노드에 표시할 아이콘 경로를 값으로 가지고 있는 필드 이름

상세 설명

트리의 기존 데이터행들을 모두 삭제하고 매개변수로 전달되는 XML을 데이터 행들로 추가한다. rowElement에 "row"를 입력하면 루트의 row element가 사용될 것이고, rowElement에 "row[0].row"를 입력하면 루트의 첫번째 행이 사용될 것이다. "row.row"는 "row[0].row"와 같다.

예제 코드

dataProvider.setXmlRows(rows, 'number', false, '', 'icon');

showHiddenRows


showHiddenRows(dataRows:number[] | number):void

화면에서 감춘 행또는 행들을 보여준다.

매개변수

  • dataRows: number[] | number

    보이고 싶은 행 번호 또는 번호들

상세 설명

filterMode, sortMode:"explicit"인 경우 showHiddenRows()를 사용하면 필터나 정렬이 재적용된다. 접힌(collapse) 상태로 표시된다.

예제 코드

// single
treeProvider.showHiddenRows(4);

// array
treeProvider.showHiddenRows([3,4]);

updateRow


updateRow(row:number,values:any[],strict:boolean):boolean

지정한 데이터행의 필드 값들을 수정한다.

매개변수

  • row: number

    지정한 데이터 행의 트리 id

  • values: any[]

    변경 값. 필드값의 배열이거나, array또는 json객체다.

  • strict: boolean

    값이 undefined거나 명시되지 않은 필드는 기존 값을 유지한다.

반환값

타입: boolean

지정한 데이터 행이 존재할 경우 성공여부를, 하지 않을 경우 false를 반환한다.

예제 코드

treeProvider.updateRow(4, ['value1', 'value2', 'value3', 'value4'], true);

updateRows


updateRows(rows:number[],values:any[],strict:boolean):void

지정한 데이터행들의 필드 값들을 수정한다.

매개변수

  • rows: number[]
  • values: any[]

    변경 값. 필드값의 배열이거나, array또는 json객체다.

  • strict: boolean

    값이 undefined거나 명시되지 않은 필드는 기존 값을 유지한다.

예제 코드

treeProvider.updateRow([4,3], [{'value1', 'value2', 'value3', 'value4'}, {'val1', 'val2', 'val3', 'val4'}], true);