소스 보기

page no.

기능 설명

그리드의 OnCellLoaded 이벤트에서 필드의 표시 속성을 설정하면, 필드 단위 속성이라도 셀마다 다르게 적용할 수 있습니다.
셀 데이터 값에 따라 서식 · 정렬 · 스타일을 다르게 보여 주고 싶을 때 사용합니다.

셀별 지정을 지원하는 속성은 다음 다섯 개입니다.

속성	설명	디자인 창 위치	API
DataStyle	데이터 스타일	필드 탭 > 스타일 섹션 > 데이터 스타일	field.SetBoxStyle(BoxStyleCode: string): void
TextPosition	텍스트 가로 정렬	필드 탭 > 정렬 섹션 > 텍스트 가로 정렬	field.TextPosition
VerticalAlign	텍스트 세로 정렬	필드 탭 > 정렬 섹션 > 텍스트 세로 정렬	field.VerticalAlign
Format	서식	필드 탭 > 데이터 섹션 > 서식	field.Format
Unit	단위	필드 탭 > 데이터 섹션 > 단위	field.Unit

사용 방법

기능 위치 : i-AUD Designer > 스크립트 에디터 > DataGrid · TreeGrid 의 OnCellLoaded 이벤트

코드 예시

var GRD = Matrix.getObject("GRD_MAIN");
GRD.OnCellLoaded = function(sender, args){
    if(args.Field.Name == "수량"){
        if(args.Row.GetValue("년도") == "2014"){
            args.Field.Format = "{0:#,##0.00}";  // 소수 2자리
            args.Field.TextPosition = "start";   // 왼쪽 정렬
        } else {
            args.Field.Format = "{0:N8}";        // 소수 8자리
            args.Field.TextPosition = "end";     // 오른쪽 정렬
        }
    }
};

적용 보고서 화면

OnCellLoaded 이벤트 실행 규칙은 기존과 같습니다. 이벤트는 셀마다 한 번만 실행되고, 셀의 값이 수정된 경우에만 그 셀에서 다시 실행됩니다.

내보내기에는 적용되지 않습니다. 엑셀 등으로 내보낼 때는 셀별로 기억된 설정이 아니라 필드의 현재 설정이 적용됩니다. 화면에서 행마다 다르게 보이던 서식이 내보낸 파일에서는 하나의 서식으로 출력될 수 있습니다.

변경 사항 — OnCellLoaded 이벤트의 동작

변경 단계

동작 설명

릴리즈 번호

기존 : 다시 그릴 때마다 실행

스크롤이나 정렬 등으로 그리드가 다시 그려질 때마다 모든 셀의 OnCellLoaded 이벤트가 매번 다시 실행되었습니다. 스크립트에서 행마다 필드의 서식 등을 다르게 설정한 경우, 다시 그릴 때마다 설정도 다시 적용되므로 표시는 항상 유지되었습니다.

※ 셀 수만큼 스크립트가 반복 실행되어 성능 부담이 컸습니다.

-

성능 개선 : 셀마다 한 번만 실행

성능 개선을 위해, 데이터가 변경되지 않는 한 OnCellLoaded 이벤트가 셀마다 한 번만 실행되도록 변경되었습니다.

다만 서식(Format) 등은 필드에 하나만 저장되는 속성이기 때문에, 스크립트에서 행마다 다르게 설정해 쓰던 보고서에서는 차이가 생겼습니다. 처음 열었을 때는 정상 표시되지만, 그리드를 다시 그릴 때는 이벤트가 다시 실행되지 않아 마지막에 설정된 값으로만 표시될 수 있습니다.

2019년 11월

기능 개선 : 셀별 표시 설정 기억

각 셀이 자신의 OnCellLoaded 에서 설정된 표시 속성 다섯 가지(Format · Unit · TextPosition · VerticalAlign · DataStyle)를 기억합니다. 그리드를 다시 그릴 때는 이벤트를 다시 실행하지 않고 셀이 기억한 설정으로 표시하므로, 이전 성능 개선을 그대로 유지하면서 이전 제품과 같은 표시 결과를 얻을 수 있습니다.

기존 보고서는 수정 없이 그대로 쓸 수 있습니다.

7.0.610.20260903-11

i-AUD : 7.0.610.0-202609021412

기능 정보	API Open	UI Open	Read Only	Not Use	Hidden	Not Recommend	해당 없음
시작 버전 정보	i-AUD : 7.0.610.0-202609021412 Release No : 7.0.610.20260903-11

샘플 URL : https://rnd.bimatrix.co.kr/aud7/ 또는 https://aud.bimatrix.co.kr 등 외부 접근 위치에 샘플이 있을 경우 보고서 경로를 입력합니다.
샘플 파일

(BCRM#G3687) 그리드 OnCellLoaded 이벤트가 그리드 그릴때마다 실행될 수 있도록 하는 그리드 옵션 추가

추가 이슈 처리가 있을 경우 표 뒤에 행 추가 한 다음 작성 합니다.