Class GradientCondition

그라데이션조건

ConditionalFormatRuleApis에서 그라디언트 (색상) 조건에 액세스합니다. 각 조건부 형식 규칙은 단일 그라데이션 조건을 포함할 수 있습니다. 그라데이션 조건은 숫자 스케일 (최솟값, 중간값, 최댓값)을 따라 세 개의 점으로 정의되며, 각 점에는 색상, 값, InterpolationType가 있습니다. 셀의 콘텐츠가 숫자 스케일의 값과 비교되고 셀에 적용된 색상은 셀 콘텐츠가 그라디언트 조건 최솟값, 중간값, 최대값 지점에 얼마나 가까운지를 기반으로 보간됩니다. 

// Logs all the information inside gradient conditional format rules on a sheet.
// The below snippet assumes all colors have ColorType.RGB.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (let i = 0; i < rules.length; i++) {
  const gradient = rules[i].getGradientCondition();

  const minColor = gradient.getMinColorObject().asRgbColor().asHexString();
  const minType = gradient.getMinType();
  const minValue = gradient.getMinValue();
  const midColor = gradient.getMidColorObject().asRgbColor().asHexString();
  const midType = gradient.getMidType();
  const midValue = gradient.getMidValue();
  const maxColor = gradient.getMaxColorObject().asRgbColor().asHexString();
  const maxType = gradient.getMaxType();
  const maxValue = gradient.getMaxValue();

  Logger.log(`The conditional format gradient information for rule ${i}:
    MinColor ${minColor}, MinType ${minType}, MinValue ${minValue},
    MidColor ${midColor}, MidType ${midType}, MidValue ${midValue},
    MaxColor ${maxColor}, MaxType ${maxType}, MaxValue ${maxValue}`);
}

메서드

메서드반환 유형간략한 설명
getMaxColorObject()Color이 그라데이션 조건의 최대 값에 설정된 색상을 가져옵니다.
getMaxType()InterpolationType이 그라데이션 조건의 최대 값에 대한 보간 유형을 가져옵니다.
getMaxValue()String이 그라데이션 조건의 최대 값을 가져옵니다.
getMidColorObject()Color이 그라데이션 조건의 중간값에 설정된 색상을 가져옵니다.
getMidType()InterpolationType이 그라데이션 조건의 중간점 값에 대한 보간 유형을 가져옵니다.
getMidValue()String이 그라데이션 조건의 중간값을 가져옵니다.
getMinColorObject()Color이 그라데이션 조건의 최솟값에 설정된 색상을 가져옵니다.
getMinType()InterpolationType이 그라데이션 조건의 최솟값에 대한 보간 유형을 가져옵니다.
getMinValue()String이 그라디언트 조건의 최솟값을 가져옵니다.

자세한 문서

getMaxColorObject()

이 그라데이션 조건의 최대 값에 설정된 색상을 가져옵니다. 색상이 설정되지 않은 경우 null을 반환합니다.

리턴

Color: 이 그라데이션 조건의 최대 값 또는 null에 설정된 색상입니다.

getMaxType()

이 그라데이션 조건의 최대 값에 대한 보간 유형을 가져옵니다. 그래디언트 최대 유형이 설정되지 않은 경우 null을 반환합니다.

리턴

InterpolationType: 이 그라데이션 조건의 최대 값에 대한 보간 유형 또는 null

getMaxValue()

이 그라데이션 조건의 최대 값을 가져옵니다. InterpolationType이 MAX이거나 최대 값이 설정되지 않은 경우 빈 문자열을 반환합니다.

리턴

String: 지정된 경우 최대 값 또는 빈 문자열

getMidColorObject()

이 그라데이션 조건의 중간값에 설정된 색상을 가져옵니다. 색상이 설정되지 않은 경우 null을 반환합니다.

리턴

Color: 이 그라데이션 조건의 중간값 또는 null에 설정된 색상입니다.

getMidType()

이 그라데이션 조건의 중간점 값에 대한 보간 유형을 가져옵니다. 그라데이션 중간 유형이 설정되지 않은 경우 null을 반환합니다.

리턴

InterpolationType: 이 그라데이션 조건의 중간점 값에 대한 보간 유형 또는 null

getMidValue()

이 그라데이션 조건의 중간값을 가져옵니다. 그라데이션 중간 값이 설정되지 않은 경우 빈 문자열을 반환합니다.

리턴

String: 중간값 또는 빈 문자열

getMinColorObject()

이 그라데이션 조건의 최솟값에 설정된 색상을 가져옵니다. 색상이 설정되지 않은 경우 null을 반환합니다.

리턴

Color: 이 그라데이션 조건의 최솟값 또는 null에 설정된 색상입니다.

getMinType()

이 그라데이션 조건의 최솟값에 대한 보간 유형을 가져옵니다. 그래디언트 최솟값 유형이 설정되지 않은 경우 null을 반환합니다.

리턴

InterpolationType: 이 그라데이션 조건의 최솟값에 대한 보간 유형 또는 null

getMinValue()

이 그라디언트 조건의 최솟값을 가져옵니다. InterpolationType이 MIN이거나 최솟값이 설정되지 않은 경우 빈 문자열을 반환합니다.

리턴

String: 지정된 경우 최솟값 또는 빈 문자열

지원 중단된 메서드