rMateGridH5 6.0

Class: SpanXMLListCollection

SpanXMLListCollection

new SpanXMLListCollection()

병합정보를 포함하는 XML정보를 저장하는 콜렉션 컴포넌트입니다.

See:

Members

autoResetRowSpanboolean

자동 rowSpan 해제 여부

소팅이나 필터링이 적용된 경우 해당라인의 cell속성의 rowSpan정보를 1로 지정하고, 나머지 라인의 cell 속성을 없애도록 하여 모든 데이터가 보이도록 합니다.

Default Value:
  • true

dispatchEventEnabledboolean

이벤트 발생 여부

false로 할 경우 함수 addCellAttributeDetailAt(), addRowAttributeDetailAt() 함수등을 한꺼번에 여러 번 실행시킬 때

이벤트가 발생하지 않아 매번 그리드가 다시 그려지는 것을 방지할 수 있습니다.

설정 후에는(true로 설정한 후) refresh()를 실행시켜 그리드를 다시 그리도록 합니다.

Default Value:
  • true

extractableboolean

전체 데이터를 조사하여 행,열에 대한 병합 정보를 추출할지 여부.

데이터에 병합정보를 넣지 않고, 속성 저장 함수를 수행하여 병합 정보를 설정할 경우에는 이 속성을 이용하여 정보수집을 막아 필요없는 작업을 안하도록 합니다.

Default Value:
  • true

readonlylengthnumber

데이터의 개수

See:
  • 자바스크립트에서 사용할 때는 getter함수를 사용합니다. - getLength()

sortSort

소팅시 적용할 Sort의 객체.

설정시 자동으로 정렬이 이루어지지 않으므로, 이 속성을 설정 한 후에 refresh() 메서드를 호출해야합니다.

See:
  • 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSort(), setSort(value)
  • Sort

sourceobject

SpanXMLListCollection의 원천 데이터 XML.

See:
  • 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSource(), setSource(value)

Methods

addCellAttributeDetailAt(rowNo, colNo, rowSpan, colSpan, styleName, backgroundColor, formatString)

셀 속성을 추가합니다.

Name Type Description
rowNo number

행의 index번호
colNo number

컬럼의 index번호(DataGrid의 columns기준)
rowSpan number

병합하려는 행의 개수
colSpan number

병합하려는 컬럼의 개수
styleName string

셀에 적용하려는 스타일명
backgroundColor color

배경색
formatString string

셀에 적용할 마스크 패턴

addEventListener(type, listener)

type에 선언된 이벤트가 발생할 경우 이벤트를 받을 수 있는 listener 함수를 등록합니다.

Name Type Description
type string

이벤트 종류를 표현하는 문자열
listener function

이벤트 발생시 불려질 함수

addRowAttributeDetailAt(rowNo, styleName, backgroundColor, formatString, editable, rowHeight)

행 속성을 추가합니다.

Name Type Description
rowNo number

행의 index번호
styleName string

셀에 적용하려는 스타일명
backgroundColor color

배경색
formatString string

셀에 적용할 마스크 패턴
editable boolean

행의 수정가능 여부
rowHeight number

행높이

getCellAttributeAt(rowNo, colNo){SpanCellAttribute}

셀 속성을 반환합니다.

Name Type Description
rowNo number

행의 index번호
colNo number

컬럼의 index번호(DataGrid의 columns기준)
Returns:
Type Description
SpanCellAttribute 셀 속성 객체, 없을시 null

getItemIndex(item){number}

특정 요소의 위치를 가져옵니다.

Name Type Description
item object

검색하려는 요소
Returns:
Type Description
number 요소의 위치 값. 없을 경우에는 -1

getRowAttributeAt(rowNo){SpanRowAttribute}

행 속성을 반환합니다.

Name Type Description
rowNo number

행의 index번호
Returns:
Type Description
SpanRowAttribute 행 속성 객체, 없을시 null

refresh()

정렬이나 필터링에 의해 재계산을 수행합니다.

removeAllAttribute()

모든 셀, 행 속성을 삭제합니다.

removeCellAttributeAt(rowNo, colNo){boolean}

셀 속성을 삭제합니다.

Name Type Description
rowNo number

행의 index번호
colNo number

컬럼의 index번호(DataGrid의 columns기준)
Returns:
Type Description
boolean 성공시 true, 실패시 false

removeEventListener(type, listener)

type에 선언된 이벤트에 연결된 listener 함수를 제거합니다.

Name Type Description
type string

이벤트 종류를 표현하는 문자열
listener function

이벤트 발생시 불려질 함수

removeRowAttributeAt(rowNo){boolean}

행 속성을 삭제합니다.

Name Type Description
rowNo number

행의 index번호
Returns:
Type Description
boolean 성공시 true, 실패시 false

toXMLString(){string}

데이터의 내용을 XML문자열로 반환합니다.

Returns:
Type Description
string 변환된 문자열

Events

collectionChange

콜렉션의 데이터에 변경이 일어났을때 발생합니다. (그리드의 에디팅 기능을 이용할 경우에는 발생하지 않음)

Type:
  • Event
Properties:
Name Type Description
kind string

변경의 내용. 다음 중 한 개가 됩니다.
- add : 데이터 행 추가
- remove : 데이터 행 삭제
- refresh : 소팅이나 필터링에 의해 데이터의 변화가 발생한 상태
- replace : 데이터 행 수정
- reset : 콜렉션 자체가 수정되어 reset이 필요한 상태
- update : 데이터의 여러행의 수정이 일어난 경우
location number

데이터가 추가, 삭제, 수정된 경우 해당 행의 번호
items Array

데이터가 추가, 삭제된 경우 해당 행이 들어있는 배열