Class ConditionalFormatRule

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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var 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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var 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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var ranges = rule.getRanges();
for (var i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

리턴

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