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[]: 이 조건부 서식 규칙이 적용되는 범위입니다.