중요 업데이트 알림사용해보기제품구매도움영상문의
RealGrid2v2.6.2

  • 튜토리얼
      • 인디케이터
      • 상태바
      • 체크바
      • 체크바와 데이터 필드의 연동
      • 컨텍스트 메뉴
      • 토스트 메시지 창
      • 커서
      • 열 고정하기
      • 행 고정하기
      • 선택
      • 다중 선택
      • 같은 값의 셀 생략하기
      • 셀 버튼
      • 팝업 메뉴 버튼
      • 셀 병합
      • Lookup 컬럼
      • Lookup 트리
      • 툴팁
      • 그룹헤더 툴팁
      • 화면 표시값 변경하기
      • Place Holder
      • 컬럼 만들기
      • 컬럼 속성 동적 변경하기(visible, editable)
      • 컬럼 너비 자동 조정
      • 데이터 정렬
      • 컬럼 이동
      • 자동 필터링
      • 데이터 필터링
      • 컬럼 레이아웃(컬럼 그룹)
      • 컬럼 레이아웃(컬럼 그룹) 속성 동적 변경하기
      • 컬럼 너비 조절
      • 그룹컬럼 접기
      • 셀 가로병합
      • 레이아웃(추가, 삭제)
      • 라인 편집기
      • 멀티라인 편집기
      • 숫자 편집기
      • 드롭다운 편집기
      • 날짜 편집기
      • 마스크 편집기
      • 입력제한 편집기
      • 행 추가/삽입
      • 행 삭제
      • 행 데이터 수정
      • 행/셀 데이터 가져오기
      • 셀 데이터 수정
      • 헤더 높이
      • 헤더 체크박스 사용
      • 컬럼 푸터
      • 컬럼 푸터 병합
      • 상단 요약 표시
      • 컬럼 헤더 HTML Template
      • 컬럼 레이아웃(그룹 컬럼) 헤더 HTML Template
      • 행 높이
      • 행 그룹핑
      • 그룹핑 API
      • 행 병합 그룹핑
      • 아이템 모델
      • 그리드 동적 높이
      • JSON 데이터 가져오기
      • XML 데이터 가져오기
      • 그리드 Lazy Loading 구현
      • 마스터 디테일 예
      • provider 공유하기
      • 데이터 타입
      • 불린 타입 필드
      • 날짜 타입 필드
      • Object 타입 필드
      • Subtypes
      • 롤백
      • 검색
      • 계산 필드
      • 그리드에서 페이징 처리 1
      • 그리드에서 페이징 처리 2
      • 행 Drag & Drop
      • Grid To Grid
      • 텍스트 렌더러
      • 체크 렌더러
      • 바 렌더러
      • 이미지 렌더러
      • 아이콘 렌더러
      • 도형 렌더러
      • 시그널 렌더러
      • 링크 렌더러
      • HTML 렌더러
      • 바코드 렌더러
      • 커스텀 렌더러 - 이미지버튼
      • 구글차트 연동
      • 하이차트 연동
      • 시리즈 컬럼
      • 스파크 컬럼
      • 행 상태
      • Undo / Redo
      • 복사하기/붙여넣기
      • 병합 일괄 수정
      • RealGrid2 스타일
      • 사용자 스타일 - 개요
      • 바디 영역 스타일
      • 헤더, 풋터, 상태바 스타일
      • 셀, 데이터 영역 스타일
      • 편집 영역 스타일
      • styleName 속성 및 콜백
      • 컬럼 동적 스타일
      • 행 동적 스타일
      • 셀 동적 스타일
      • RealGrid2 테마
      • 포커스 스타일
      • 엑셀 내보내기
      • 행 그룹된 그리드 내보내기
      • 여러 레이아웃으로 구성된 그리드 내보내기
      • 다중 그리드 Excel 내보내기
      • Excel문서에 제목 추가하기
      • 엑셀 스타일
      • 이미지 엑셀 내보내기
      • 사용자 지정 문자 출력
      • 엑셀 시트 보호
      • Mobile FormView
      • 대량 데이터 불러오기
      • 트리뷰
      • 트리 구현 - Array데이터
      • 트리 구현 - Object데이터
      • 트리 구현 - Xml데이터
      • 트리 노드 조작하기
      • 트리 아이콘 1
      • 트리 아이콘 2
      • 트리 이벤트
      • 트리 Lazy Loading
      • 사용자 지정 컬럼 유효성 검사
      • 사용자 지정 행 유효성 검사
      • 전체 유효성 검사
      • 유효성 검사 통과
      • 이벤트 발생 순서
      • 클릭 이벤트
      • 렌더링 완료 이벤트
      • 하이차트 연동 컬럼 선택
      • 하이차트 연동 컬럼 필터링
      • 하이차트 연동 행 선택
      • amchart 연동 체크 선택
      • amchart 연동 행 선택
      • 추천 설정
      • 필드와 컬럼 일괄 생성
      • SPAN(컬럼그룹)
      • 행 상태에 따른 특정 컬럼 편집 제어
      • CheckBar에서 자식 노드 연동하여 체크하기
      • Excel Import
      • Group Footer 표시여부 조작하기
      • 체크바와 관계된 팁
      • 상태바와 관계된 팁
      • 동적 에디터 변경
      • text타입 날짜 편집기
      • ColorPicker 연결
      • 파일 Drag and Drop
      • 셀 병합에서 텍스트를 상단으로 이동
      • 병합된 셀의 합계 계산
      • HEADER와 FOOTER에 여러줄로 표시하기
      • 행 삭제와 관계된 팁

체크바

체크바(CheckBar)는 그리드의 특정 행을 선택하기 위해 사용합니다. CheckBar에 의해 선택된 특정 행들은 복사나 삭제등 명령을 일괄처리 하기위해 사용할 수 있습니다.

체크바를 설정하는 방법

체크바의 설정을 변경하는 것은 setCheckBar()를 사용 합니다.
현재 설정된 상태를 확인하는 것은 getCheckBar()을 사용 합니다.

체크바의 화면 표시여부를 지정

  • visible: 체크바 영역의 화면 표시여부를 지정합니다.
gridView.setCheckBar({
  visible: false
});
gridView.setCheckBar({
  visible: true
});

한 행만 체크 가능(라디오 버튼)

체크바의 속성중 exclusive 속성을 true 로 설정하면 라디오 버튼처럼 하나의 행만 체크할 수 있습니다.

  • exclusive: 하나의 행만 체크가능한지 여부를 지정합니다.
gridView.setCheckBar({
  exclusive: true
});
gridView.setCheckBar({
  exclusive: false
});

모두 체크

기본값으로 체크바의 헤드영역에 v 표시가 되어 있습니다. 이 영역을 클릭하게 되면 모든 행이 체크되게 됩니다.

  • showAll: 체크바 헤드 영역의 v 표시여부를 지정합니다. false 인 경우 헤드 영역을 클릭해도 모든 행이 체크되지 않습니다.
gridView.setCheckBar({
  showAll: false
});
gridView.setCheckBar({
  showAll: true
});

체크하기

한 행씩 체크할 수 있는 API: checkItem(), checkRow()
여러 행을 체크할 수 있는 API: checkItems(), checkRows()
전체 행을 체크할 수 있는 API: checkAll()

gridView.checkItem(0, true);
gridView.checkItem(0, false);

아무 컬럼이나 컬럼의 헤더를 클릭하여 소트 후 아래 버튼을 클릭하세요.

gridView.checkRow(0, true);
gridView.checkRow(0, false);

dataRow, itemIndex가 다르기 때문에 결과가 다릅니다.

gridView.checkItems([1, 2], true);
gridView.checkItems([1, 2], false);

아무 컬럼의 헤더를 클릭하여 소트 후 아래 버튼을 클릭하세요.

gridView.checkRows([1, 2], true);
gridView.checkRows([1, 2], false);

Head/Foot

체크바의 헤드와 풋 영역에 글자를 표시할 수 있습니다.
아래 속성을 사용하려면 showAll속성의 값은 false 이어야 합니다.

  • headText: head 영역에 표시할 text를 지정한다.
  • footText: foot 영역에 표시할 text를 지정한다.
gridView.setCheckBar({
  showAll: false,
  headText: "H",
  footText: "F"
});

Checkable 제어

아래와 같은 수식을 사용하여 체크바에 체크 가능 여부를 제어할 수 있습니다.

  • values[] - 표시 중인 행의 각 필드 값을 values[“field name”]나 values[fieldIndex]로 리턴.
  • row - 표시 중인 행의 Item 인덱스.
  • datarow - 표시 중인 행의 데이터행 인덱스.
  • checked - 표시 중인 행의 checked 상태. true/false로 리턴.
  • checkable - 표시 중인 행의 체크가능 상태. true/false로 리턴.
  • state - 표시 중인 행이 참조하는 데이터행의 상태. ‘c’:생성, ‘u’:수정, ‘d’:삭제, ‘x’:생성 후 삭제.

관계 연산자

  • equal(같다)는 == 가 아니라 = 입니다.
  • not equal(같지않다)는 != 가 아니라 <> 입니다.
  • greater then(크다)는 > 입니다.
  • less then(작다)는 < 입니다.
  • not은 ! 가 아니라 not 입니다.
  • and는 && 가 아니라 and 입니다.
  • or는 || 가 아니라 or 입니다.

ex)
state = 'c': 새로 추가된 행만 체크 가능
values['Gender'] = '남': Gender필드값이 '남'인 행만 체크 가능
row < 10: itemIndex가 10 이하인 행만 체크 가능
datarow < 10: dataRow가 10 이하인 행만 체크 가능
(datarow < 10) and (state = 'c'): dataRow가 10 미만이고 새로 추가된 행만 체크 가능

이러한 수식들을 checkBar.checkableExpression 에 설정 후 gridView.applyCheckable() 사용하여 그리드에 적용시킬 수 있습니다.
gridView.setCheckableExpression()을 사용하여 설정과 적용을 한번에 적용할 수도 있습니다.
적용된 체커블 상태의 초기화는 gridView.resetCheckables()을 사용합니다.

//수식만 설정
gridView.checkBar.checkableExpression = "values['Gender'] = '남'";
//설정된 수식을 실제로 적용
gridView.applyCheckables();
//수식의 설정과 적용을 동시에 
gridView.setCheckableExpression("row < 5", true);
//적용된 수식을 제거
gridView.resetCheckables();

선택된 행 값 가져오기

//반환되는 값은 dataRow
var rows = gridView.getCheckedRows(true);
alert(rows);
//반환되는 값은 itemIndex
var items = gridView.getCheckedItems();
alert(items);

체크바 병합

체크바에 병합할 조건의 필드를 조건으로 추가해서 조건에 따라 체크바 영역을 병합시킬 수 있습니다.

gridView.checkBar.mergeRule = "value['Gender']"

체크, 텍스트 동시사용

체크바 헤더에 체크박스와 텍스트를 동시에 보여지도록 설정할 수 있습니다. checkLocation 속성으로 체크박스의 위치를 지정합니다.

gridView.setCheckBar({headText: "선택", checkLocation: "bottom", width: 50});