Class ConditionalFormatRule

조건부서식규칙

조건부 서식 규칙에 액세스합니다. 새 규칙을 만들려면 SpreadsheetApp.newConditionalFormatRule() 및 ConditionalFormatRuleBuilder를 사용합니다. Sheet.setConditionalFormatRules(rules)를 사용하여 특정 시트의 규칙을 설정할 수 있습니다.

메서드

메서드반환 유형간략한 설명
copy()ConditionalFormatRuleBuilder이 규칙의 설정이 포함된 규칙 빌더 사전 설정을 반환합니다.
getBooleanCondition()BooleanCondition이 규칙에서 불리언 조건 기준을 사용하는 경우 규칙의 BooleanCondition 정보를 검색합니다.
getGradientCondition()GradientCondition이 규칙이 그라데이션 조건 기준을 사용하는 경우 규칙의 GradientCondition 정보를 가져옵니다.
getRanges()Range[]이 조건부 서식 규칙이 적용되는 범위를 가져옵니다.

자세한 문서

copy()

이 규칙의 설정이 포함된 규칙 빌더 사전 설정을 반환합니다.

리턴

ConditionalFormatRuleBuilder: 이 규칙의 설정을 기반으로 하는 빌더

getBooleanCondition()

이 규칙에서 불리언 조건 기준을 사용하는 경우 규칙의 BooleanCondition 정보를 검색합니다. 그 외에는 null를 반환합니다. 

// Log the boolean criteria type of the first conditional format rules of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

리턴

BooleanCondition: 불리언 조건 객체 또는 규칙에서 불리언 조건을 사용하지 않는 경우 null입니다.

getGradientCondition()

이 규칙이 그라데이션 조건 기준을 사용하는 경우 규칙의 GradientCondition 정보를 가져옵니다. 그 외에는 null를 반환합니다. 

// Log the gradient minimum color of the first conditional format rule of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const gradientCondition = rule.getGradientCondition();
if (gradientCondition != null) {
  // Assume the color has ColorType.RGB.
  Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString());
}

리턴

GradientCondition: 그라데이션 조건 객체 또는 규칙에서 그라데이션 조건을 사용하지 않는 경우 null입니다.

getRanges()

이 조건부 서식 규칙이 적용되는 범위를 가져옵니다. 

// Log each range of the first conditional format rule of a sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const ranges = rule.getRanges();
for (let i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

리턴

Range[]: 이 조건부 서식 규칙이 적용되는 범위입니다.