Class ConditionalFormatRule

ConditionalFormatRule

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

메서드

메서드반환 유형간략한 설명
copy()ConditionalFormatRuleBuilder이 규칙의 설정이 포함된 규칙 빌더 사전 설정을 반환합니다.
getBooleanCondition()BooleanCondition|null이 규칙이 불리언 조건 기준을 사용하는 경우 규칙의 BooleanCondition 정보를 가져옵니다.
getGradientCondition()GradientCondition|null이 규칙이 그라데이션 조건 기준을 사용하는 경우 규칙의 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 - 불리언 조건 객체입니다. 규칙에서 불리언 조건을 사용하지 않는 경우 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 - 그라데이션 조건 객체입니다. 규칙에서 그라데이션 조건을 사용하지 않는 경우 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[] - 이 조건부 서식 규칙이 적용되는 범위입니다.