[]
DEMOS DOC DESIGNER API
DOWNLOAD
(Showing Draft Content)

조건부 서식 적용

조건부 서식은 특정 조건에 따라 셀에 서식을 적용할 수 있는 기능입니다. 템플릿 시트(TemplateSheet)에서 조건부 서식을 설정하려면 워크시트를 통해 조건부 서식을 설정해야 합니다. 보고서가 생성될 때, 셀의 확장 여부에 따라 조건부 서식의 범위도 함께 변경될 수 있습니다. ConditionalFormats 클래스의 addCellValueRule 메서드를 사용하여 새로운 조건부 서식 규칙을 추가할 수 있습니다.

참고:

  • 조건부 서식은 템플릿 시트에서 적용할 수 있으며, 리포트 시트의 렌더 모드를 DataEntryPreview로 전환할 경우 성능이 향상됩니다.

  • 조건부 서식이 설정된 셀이 템플릿 시트에서 확장되지 않은 셀이라면, 리포트 시트 상에서 조건부 서식의 범위는 변경되지 않지만, 셀 확장 기준 좌상단 셀에 따라 위치가 오프셋될 수 있습니다.

  • 조건부 서식이 설정된 셀이 템플릿 시트에서 확장된 셀이라면, 리포트 시트 상에서 조건부 서식 범위는 셀 확장에 따라 같이 확장되며, 이 경우에도 셀 확장 기준 좌상단 셀로 인해 오프셋이 발생할 수 있습니다.

아래 코드는 셀의 값이 15 이하일 경우 텍스트 색상을 빨간색으로 표시하는 조건부 서식 규칙을 설정하는 예시입니다:

const cfs = templateSheet.conditionalFormats;

// 새 스타일 생성
const style = new GC.Spread.Sheets.Style();
style.foreColor = 'red';

// 범위 정의
const ranges = [new GC.Spread.Sheets.Range(2, 2, 1, 1)];

// 셀 값이 15 이하일 경우 글자색을 빨간색으로 설정
cfs.addCellValueRule(GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.lessThanOrEqualsTo, 15, 15, style, ranges);

위 코드의 실행 결과는 다음과 같습니다:

image