페이지 이력

page no.

Showpageid

개선 배경그리드의 OnCellLoaded 이벤트 API를 이용해 필드의 기능 설명

그리드의 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 이벤트

코드 예시

코드 블럭

language	js
theme	Confluence
title	코드 예시
linenumbers	true
collapse	true

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";     // 오른쪽 정렬
        }
    }
};

적용 보고서 화면
Image Modified

도움말

title	참고 사항

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

참고사항

title	주의 사항

내보내기에는 적용되지 않습니다. 엑셀 등으로 내보낼 때는 셀별로 기억된 설정이 아니라 필드의 현재 설정이 적용됩니다. 화면에서 행마다 다르게 보이던 서식이 내보낸 파일에서는 하나의 서식으로 출력될 수 있습니다.
OnCellLoaded 이벤트 실행 규칙은 기존과 동일합니다.
- 이벤트는 셀마다 한 번만 실행되고, 셀의 값이 수정된 경우에만 해당 셀에서 다시 실행됩니다.

참고사항

title	주의 사항

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

변경 단계	동작 설명	릴리즈 번호
이전 동작

-

— 다시 그릴 때마다 실행

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

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

-

성능 개선

(이슈 #6996)

— 셀마다 한 번만 실행

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

다만 서식(Format) 등은 필드에 하나만 저장되는 속성이기 때문에, 스크립트에서 행마다 다르게 설정해

사용하던

쓰던 보고서에서는 차이가 생겼습니다

=>

. 처음 열었을 때는 정상 표시되지만,

그리드가

그리드를 다시

그려질

그릴 때는 이벤트가 다시 실행되지 않아 마지막에 설정된 값으로만 표시될 수 있습니다.	2019년 11월
현재 — 셀별 표시 설정 기억	각 셀이 자신의

OnCellLoaded에서

OnCellLoaded 에서 설정된 표시 속성

5가지

다섯 가지(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

정보

title	샘플 정보

샘플 URL :
샘플 파일

첨부 파일

patterns	.jsp,.zip,.xml,.js,.mtsd,.xlsx,.xlsb,.mtzb,.mtvx,.mtx,.mtxz,.mtsz

페이지 속성

hidden	true

정보

title	BCRM 정보

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

공간 바로가기

페이지 트리

버전 비교

이전 버전 1

새 버전 2

키