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[] - この条件付き書式ルールが適用される範囲。