Class BooleanCondition

BooleanCondition

ConditionalFormatRules의 불리언 조건에 액세스합니다. 각 조건부 형식 규칙은 하나의 불리언 조건을 포함할 수 있습니다. 불리언 조건 자체에는 불리언 기준 (값 포함)과 형식 설정이 포함됩니다. 기준은 셀의 콘텐츠를 기준으로 평가되어 true 또는 false 값을 생성합니다. 기준이 true로 평가되면 조건의 서식 설정이 셀에 적용됩니다.

메서드

메서드반환 유형간략한 설명
getBackgroundObject()Color이 불리언 조건의 배경 색상을 가져옵니다.
getBold()Boolean이 불리언 조건이 텍스트에 굵은 글꼴을 적용하면 true를 반환하고 이 불리언 조건이 텍스트에서 굵은 글꼴을 삭제하면 false를 반환합니다.
getCriteriaType()BooleanCriteriaBooleanCriteria enum에 정의된 대로 규칙의 기준 유형을 가져옵니다.
getCriteriaValues()Object[]규칙의 기준에 관한 인수 배열을 가져옵니다.
getFontColorObject()Color이 불리언 조건의 글꼴 색상을 가져옵니다.
getItalic()Boolean이 불리언 조건이 텍스트에 기울임꼴을 적용하면 true를 반환하고 이 불리언 조건이 텍스트에서 기울임꼴을 삭제하면 false를 반환합니다.
getStrikethrough()Boolean이 불리언 조건이 텍스트에 취소선을 추가하면 true를 반환하고 텍스트에서 취소선을 삭제하면 false를 반환합니다.
getUnderline()Boolean이 불리언 조건이 텍스트에 밑줄을 표시하면 true를 반환하고 이 불리언 조건이 텍스트에서 밑줄을 삭제하면 false를 반환합니다.

자세한 문서

getBackgroundObject()

이 불리언 조건의 배경 색상을 가져옵니다. 설정되지 않은 경우 null을 반환합니다.

// Logs the boolean condition background color for each conditional format rule
// on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const color = rule.getBooleanCondition().getBackgroundObject();
  Logger.log(`Background color: ${color.asRgbColor().asHexString()}`);
}

리턴

Color: 배경 색상 또는 이 조건에 설정되지 않은 경우 null입니다.


getBold()

이 불리언 조건이 텍스트에 굵은 글꼴을 적용하면 true를 반환하고 이 불리언 조건이 텍스트에서 굵은 글꼴을 삭제하면 false를 반환합니다. 굵게 표시가 영향을 받지 않으면 null를 반환합니다.

// Logs the boolean condition font weight for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const bold = rule.getBooleanCondition().getBold();
  Logger.log(`Bold: ${bold}`);
}

리턴

Boolean: 불리언 조건에 따라 텍스트를 굵게 표시할지 여부 또는 굵게 표시가 영향을 받지 않는 경우 null


getCriteriaType()

BooleanCriteria enum에 정의된 대로 규칙의 기준 유형을 가져옵니다. 기준의 인수를 가져오려면 getCriteriaValues()를 사용합니다. 이러한 값을 사용하여 조건부 서식 규칙을 만들거나 수정하려면 ConditionalFormatRuleBuilder.withCriteria(criteria, args)를 참고하세요.

// Log information about the conditional formats on the active sheet that use
// boolean conditions.

const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats();
SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => {
  const booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    const criteria = booleanCondition.getCriteriaType();
    const args = booleanCondition.getCriteriaValues();
    Logger.log(`The conditional format rule is ${criteria} ${args}`);
  }
});

리턴

BooleanCriteria: 조건부 서식 기준의 유형입니다.


getCriteriaValues()

규칙의 기준에 관한 인수 배열을 가져옵니다. 기준 유형을 가져오려면 getCriteriaType()를 사용합니다. 이러한 값을 사용하여 조건부 서식 규칙을 만들거나 수정하려면 ConditionalFormatRuleBuilder.withCriteria(criteria, args)를 참고하세요.

// Log information about the conditional formats on the active sheet that use
// boolean conditions.

const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats();
SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => {
  const booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    const criteria = booleanCondition.getCriteriaType();
    const args = booleanCondition.getCriteriaValues();
    Logger.log(`The conditional format rule is ${criteria} ${args}`);
  }
});

리턴

Object[]: 규칙의 기준 유형에 적합한 인수 배열입니다. 인수의 개수와 유형은 ConditionalFormatRuleBuilder 클래스의 상응하는 when...() 메서드와 일치합니다.


getFontColorObject()

이 불리언 조건의 글꼴 색상을 가져옵니다. 설정되지 않은 경우 null을 반환합니다.

// Logs the boolean condition font color for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const color = rule.getBooleanCondition().getFontColorObject();
  Logger.log(`Font color: ${color.asRgbColor().asHexString()}`);
}

리턴

Color: 글꼴 색상 또는 이 조건에 대해 설정되지 않은 경우 null입니다.


getItalic()

이 불리언 조건이 텍스트에 기울임꼴을 적용하면 true를 반환하고 이 불리언 조건이 텍스트에서 기울임꼴을 삭제하면 false를 반환합니다. 기울임꼴이 영향을 받지 않으면 null을 반환합니다.

// Logs the boolean condition font style for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const italic = rule.getBooleanCondition().getItalic();
  Logger.log(`Italic: ${italic}`);
}

리턴

Boolean: 불리언 조건에 따라 텍스트에 기울임꼴이 적용되는지 여부 또는 기울임꼴이 영향을 받지 않는 경우 null


getStrikethrough()

이 불리언 조건이 텍스트에 취소선을 추가하면 true를 반환하고 텍스트에서 취소선을 삭제하면 false를 반환합니다. 취소선이 영향을 받지 않으면 null를 반환합니다.

// Logs the boolean condition strikethrough setting for each conditional format
// rule on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const strikethrough = rule.getBooleanCondition().getStrikethrough();
  Logger.log(`Strikethrough: ${strikethrough}`);
}

리턴

Boolean: 불리언 조건에 따라 텍스트에 취소선이 적용되는지 여부 또는 취소선이 영향을 받지 않는 경우 null


getUnderline()

이 불리언 조건이 텍스트에 밑줄을 표시하면 true를 반환하고 이 불리언 조건이 텍스트에서 밑줄을 삭제하면 false를 반환합니다. 밑줄이 영향을 받지 않으면 null을 반환합니다.

// Logs the boolean condition underline setting for each conditional format rule
// on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const underline = rule.getBooleanCondition().getUnderline();
  Logger.log(`Underline: ${underline}`);
}

리턴

Boolean: 불리언 조건이 텍스트에 밑줄을 표시하는지 여부 또는 밑줄이 영향을 받지 않는 경우 null

지원 중단된 메서드