RealGrid2 튜토리얼
컬럼 속성 및 이벤트

컬럼 속성 및 이벤트

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일때 그룹헤더 대신 표시할 컬럼을 지정한다.