컬럼 속성 및 이벤트
GridColumn
컬럼 정보 모델
GridColumn의 자손 클래스인 DataColumn 또는 SeriesColumn 이 사용된다.
Properties
- checked : 체크 여부
- displayIndex : 컬럼이 속한 컬럼그룹내에서 컬럼의 표시 순서를 나타낸다.
- displayText : 컬럼이 속한 컬럼그룹내에서 컬럼의 표시 텍스트
- displayWidth : 컬럼이 속한 컬럼그룹내에서 컬럼의 표시 너비
- fillWidth : 컬럼 그룹 내 너비
- footer : 컬럼 푸터 (여러 개 있을 경우 첫 번째 아이템)
- footers : 컬럼 푸터 컬렉션 오브젝트
- groupFooter : 그룹 푸터 (여러 개일 경우 첫번째 아이템)
- groupFooters : 그룹 푸터 컬렉션 오브젝트.
- header : 컬럼 헤더
- headerSummaries : 헤더 Summary 컬렉션 오브젝트.
- headerSummary : 헤더 Summary (여러 개일 경우 첫 번째 아이템)
- index : 순서
- layout : 레이아웃 아이템 객체
- movable : 컬럼 이동 가능 여부
- name : 컬럼 이름
- resizable : 컬럼 너비 조절 가능 여부
- visible : 컬럼 표시 여부
- width : 컬럼 너비
ValueColumn
GridColumn 을 상속한 컬럼 정보 모델
서식 정보 등이 들어가 있다.
Events
- buttonVisibleCallback : 컬럼 버튼 표시 콜백
- styleCallback : 스타일을 지정하기 위한 콜백
property
- blankWhenCopy : 클립 보드에 복사 시 빈 값을 넘겨줄지의 여부
- blankWhenExport : 자동으로 생성된 filter들
- booleanFormat : 컬럼에 지정되어 있는 Boolean 형식의 값일 때 표시되는 서식
- button : 데이터 셀 우측에 표시할 버튼
- buttonVisibility : 컬럼 버튼의 표시 방법
- datetimeFormat : 컬럼에 지정되어 있는 날짜 형식의 값일 때 표시되는 서식 undefined이면 GridBase.formatOptions에 지정된 numberFormat이 적용된다.
- displayMinusZero : -0.00 처럼 표시되는것을 0.00 으로 표시 여부
- edgeMark : edgeMark 표시여부
- editButtonVisibility : 셀 편집기 버튼의 표시 방법
- editor : 편집기
- exportStyleName : excel로 export될때 사용될 스타일 명
- numberFormat : 컬럼에 지정되어 있는 숫자 형식의 값일 때 표시되는 서식 천단위기호,소수점을 변경하는 경우 ;로 구분해서 지정.
- popupMenu : 팝업메뉴
- popupMenuName : 팝업메뉴 이름
- prefix : 앞에 추가 될 텍스트
- renderer : 렌더러
- styleName : 스타일 클래스 명
- suffix : 뒤에 추가 될 텍스트
- textFormat : 텍스트 형식의 값일 때 표시되는 서식
- textInputCase : 편집기에 입력되는 값의 대소문자 변환 형태
SeriesColumn
하나 이상의 데이터 값을 동시에 표시하는 컬럼
하나 이상의 필드 데이터 값을 동시에 표시하기 때문에 fieldName 대신 fieldnames 라는 속성이 있다.
property
- fieldNames : 설정된 필드명들
DataColumn
ValueColumn 을 상속한 컬럼 정보 모델
정렬, 필터링, 그룹 정보 등을 가지고 있다.
Events
- displayCallback : 화면에 표시하는 값을 설정하기 위한 콜백
- objectCallback : field의 dataType이 object인 경우 화면에 표시하는 값을 설정하기 위한 콜백
DataColumn property
- autoFilter : 자동 필터링 적용 여부
- autoFilters : 자동으로 생성된 filter들
- breakMergeOnEmpty : 빈 셀일 때 머지 중단 여부
- button : 데이터 셀의 우측에 표시할 버튼 종류
- buttonWidth : 버튼의 너비
- cellProtectProps : 엑셀 export시 셀의 잠금 또는 수식 숨기기를 설정한다.
- defaultValue : 초기값
- displayText : header/export/feedback에 표시되는 text;
- editable : 편집 가능 여부
- equalBlank : 같은 컬럼의 이전 행의 셀과 값이 동일할때 셀의 묶음 여부
- equalBlankExpression : equalBlank 가 true인 경우 같은 값으로 처리할 수식
- equalBlankLine : 이전행의 값과 동일할때 셀 하단 라인 표시 여부
- equalBlankText : 이전행의 값과 동일할때 표시되는 string
- excelFormat : 엑셀 export 시 출력되는 서식
- excelFormulaStatement : 엑셀 export시 출력되는 수식
- fieldIndex : 컬럼이 표시하는 필드의 인덱스
- fieldName : 컬럼이 표시하는 데이터 필드의 이름
- filterable : 필터링 가능 여부
- filterIconVisible : 필터 Icon 표시여부
- filters : 필터들
- filterSelectorWidth : 필터 선택창의 너비
- groupable : true로 지정하면 사용자가 컬럼 헤더를 마우스로 드래깅해서 그룹핑을 할 수 있다.
- groupLevel : rowGroup의 group순번.
- hasFilters : 컬럼에 filter가 있는지 확인한다.
- labelField : 컬럼 셀에 표시될 값의 목록을 지정하는 필드
- labels : 컬럼 셀에 표시될 값의 목록
- lookupData : values와 labels를 설정한다.
- lookupDisplay : 컬럼 셀에 values 목록 중 셀의 값에 해당하는 위치에 있는 labels 항목의 값의 표시 여부
- lookupKeyFields : lookupKeyFields
- lookupSourceId : 등록한 lookupSourceTree의 id
- mergeEdit : merge된 셀을 편집했을때 merge된 모든 행을 변경한다.
- mergeRule : 컬럼 머지 규칙
- nanText : 값이 NaN 일 경우 표시되는 텍스트
- objectKey : field의 dataType이 object인 경우 화면에 보여주고자하는 name
- placeHolder : 셀 데이터가 없는 경우 표시되는 문자열
- placeHolderStyleName : 셀 데이터가 없는 경우 적용되는 class명
- readOnly : readOnly 여부
- required : 필수 여부
- requiredLevel : 검증 시 값이 요구될 때 표시될 레벨
- requiredMessage : 검증 시 값이 요구될 때 발생하는 메시지
- showInlineFilter : filterPanel의 입력창 표시여부
- sortable : 정렬 가능 여부
- sortByLabel : Label 기준으로 정렬 여부
- sortDirection : 정렬 방식
- sortOrder : 정렬 순서
- tag : 사용자가 지정하는 임의 값
- textOfInvalid : 셀 데이터가 lookup values 에 없는 경우 표시되는 텍스트
- validations : 이 컬럼에 적용할 EditValidation 목록
- values : 컬럼 셀에 실제 값의 목록
- valueSeparator : 각 값을 구분하기 위한 구분자
- valueType : 컬럼에 연결된 데이터 필드의 dataType
- zeroText : 값이 0일 때 표시되는 텍스트
컬럼 레이아웃 속성 및 이벤트
CellLayoutItem
레이아웃을 설정하기 위한 기반 모델
하위 모델을 이용하여 GridBase.setColumnLayout() 으로 설정 시, 특정 속성만 사용 가능.
- cellWidth : 셀 너비
- fillWidth : GridFitStyle.FILL 로 설정된 후 사용하는 너비 비율
- groupShowMode : 상위 레이아웃의 expanded상태에서 따라서 표시하거나 숨긴다.
- name : 레이아웃 명
- type : layout의 type을 지정한다.
- vindex : 전체 그룹 혹은 상위 그룹 내에서의 표시 순서
- visible : 표시 여부
- width : 너비
CellLayoutColumnItem
컬럼 레이아웃 정보 모델
GridBase.getLayoutByColumn() 에서 해당 모델을 반환할 수 있다.
GridBase.setColumnLayout() 로 설정될 때에는 특정 속성만 사용 가능하다.
GridColumn.layout 의 속성으로 설정 가능하다.
CellLayoutItem 을 상속한다.
Properties
- breakMergeOnEmpty : 빈 셀일 때 머지 중단 여부
- cellSpan : 기본 셀 스팬 개수
- column : 컬럼명
- dataSpan : 셀 스팬 개수
- equalBlank : 같은 컬럼의 이전 행의 셀과 값이 동일할때 셀의 묶음 여부
- equalBlankExpression : equalBlank 가 true인 경우 같은 값으로 처리할 수식
- footerSpan : footer가 하나일때 컬럼레이아웃별 footer의 span을 지정한다.
- footerSpans : 푸터 스팬 개수
- footerUserSpans : 사용자 지정 footer span
- groupFooterSpans : 그룹 푸터 스팬 개수
- groupFooterUserSpans : 사용자 지정 groupFooter span
- headerSpan : 헤더 스팬 개수
- mergeRule : 컬럼 머지할 때의 규칙
- summarySpan : headerSummary가 하나일때 컬럼 레이아웃 별 headerSummary의 span을 지정한다.
- summarySpans : summary 스팬 개수
- summaryUserSpans : 사용자 지정 headerSummary span
Events
- footerSpanCallback : 사용자 지정 footer 스팬을 위한 콜백
- groupFooterSpanCallback : 사용자 지정 groupFooter 스팬을 위한 콜백
- groupFooterUserSpanCallback : 사용자 지정 groupFooter UserSpan을 위한 콜백 groupFooterSpanCallback과는 다르게 block단위로 span할수 있다.
- spanCallback : 사용자 지정 스팬을 위한 콜백
- summarySpanCallback : 사용자 지정 headerSummary 스팬을 위한 콜백
CellLayoutGroupItem
그룹 레이아웃 정보 모델
실제 컬럼이 아닌 화면 상에서 보이는 컬럼 묶음이다.
CellLayoutItem 을 상속한다.
Properties
- childColumnMovable : 하위 레이아웃의 이동여부
- direction : 셀 배치 방향
- expandable : 하위 레이아웃확장 여부
- expanded : 레이아웃 확장 상태
- header : 헤더의 레이아웃 설정 정보
- hideChildHeaders : 하위 레이아웃의 헤더 숨김 여부
- items : 하위 레이아웃 아이템들
- movable : 이동 가능 여부
- resizable : 너비 조정 가능 여부
- tiedColumn : CellLayoutGroupItem.hideChildHeaders가 true일때 그룹헤더 대신 표시할 컬럼을 지정한다.