Class BooleanCondition

BooleanCondition

ConditionalFormatRules のブール条件へのアクセス。各 条件付き書式ルールにブール型の条件を 1 つ指定できます。ブール型の条件自体 には、ブール値の条件（値を含む）と書式設定の設定が含まれています。基準が評価されます セルのコンテンツに対して実行され、その結果は true または false になります。もし 条件が true と評価された場合、条件の書式設定がセルに適用されます。

メソッド

メソッド戻り値の型概要
getBackgroundObject()Colorこのブール値の条件の背景色を取得します。
getBold()Booleanこのブール値の条件でテキストを太字にすると true を返し、太字にした場合は false を返します ブール型の条件は、テキストの太字を取り除きます。
getCriteriaType()BooleanCriteriaBooleanCriteria 列挙型で定義されているルールの条件タイプを取得します。
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.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var color = rules[i].getBooleanCondition().getBackgroundObject();
  Logger.log("The background color for rule %s is %s", i, color.asRgbColor().asHexString());
}

戻る

Color - 背景色。この条件で設定されていない場合は null。

getBold()

このブール値の条件でテキストを太字にすると true を返し、太字にした場合は false を返します ブール型の条件は、テキストの太字を取り除きます。太字が影響を受けていない場合は、null を返します。 

// Logs the boolean condition font weight for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var bold = rules[i].getBooleanCondition().getBold();
  Logger.log("The font bold setting for rule %s is %b", i, weight);
}

戻る

Boolean - ブール型の条件でテキストを太字にするかどうか。太字の場合は null 影響なし

getCriteriaType()

BooleanCriteria 列挙型で定義されているルールの条件タイプを取得します。取得するには、 getCriteriaValues() を使用します。これらの値を使用して 条件付き書式ルールを変更する場合は、ConditionalFormatRuleBuilder.withCriteria(criteria, args) をご覧ください。 

// Log information about the conditional formats on the active sheet that use
// boolean conditions.
var sheet = SpreadsheetApp.getActiveSheet;
var formats = sheet.getConditionalFormats();
sheet.getConditionalFormats().forEach(function(format) {
  var booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    var criteria = booleanCondition.getCriteriaType();
    var args = booleanCondition.getCriteriaValues();
    Logger.log('The conditional format rule is %s %s', criteria, args);
  }
});

戻る

BooleanCriteria - 条件付き書式条件のタイプ

getCriteriaValues()

ルールの条件を表す引数の配列を取得します。条件タイプを取得するには、getCriteriaType() を使用します。これらの値を使用して条件付き書式ルールを作成または変更する方法については、以下をご覧ください。 ConditionalFormatRuleBuilder.withCriteria(criteria, args)。 

// Log information about the conditional formats on the active sheet that use
// boolean conditions.
var sheet = SpreadsheetApp.getActiveSheet;
var formats = sheet.getConditionalFormats();
sheet.getConditionalFormats().forEach(function(format) {
  var booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    var criteria = booleanCondition.getCriteriaType();
    var args = booleanCondition.getCriteriaValues();
    Logger.log('The conditional format rule is %s %s', criteria, args);
  }
});

戻る

Object[] - ルールの条件タイプに応じた引数の配列。引数の数 かつ、その型が ConditionalFormatRuleBuilder クラスの対応する when...() メソッドと一致している

getFontColorObject()

このブール条件のフォントの色を取得します。設定されていない場合は null を返します。 

// Logs the boolean condition font color for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var color = rules[i].getBooleanCondition().getFontColorObject();
  Logger.log("The font color for rule %s is %s", i, color.asRgbColor().asHexString());
}

戻る

Color - フォントの色。この条件で設定されていない場合は null。

getItalic()

このブール値の条件でテキストを斜体にする場合は true を返し、次の場合は false を返します このブール型の条件により、テキストから斜体が除去されます。斜体が指定された場合、null を返します。 影響は受けません。 

// Logs the boolean condition font style for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var italic = rules[i].getBooleanCondition().getItalic();
  Logger.log("The font italic setting for rule %s is %b", i, italic);
}

戻る

Boolean - ブール型の条件でテキストを斜体にするかどうか。null 斜体は影響を受けません

getStrikethrough()

このブール値条件でテキストに取り消し線が引かれた場合は true を返し、このブール値条件によってテキストから取り消し線を取り除いた場合は false を返します。次の場合は null を返します。 取り消し線は影響を受けません。 

// Logs the boolean condition strikethrough setting for each conditional format rule on a
// sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var strikethrough = rules[i].getBooleanCondition().getStrikethrough();
  Logger.log("The font strikethrough setting for rule %s is %b", i, strikethrough);
}

戻る

Boolean - ブール型の条件がテキストを外すかどうか。null の場合は、 取り消し線は影響を受けません

getUnderline()

このブール条件がテキストに下線を引く場合は true を返し、次の場合は false を返します このブール値の条件により、テキストから下線が削除されます。下線が引かれる場合は null を返します。 影響を受けることはありません。 

// Logs the boolean condition underline setting for each conditional format rule on a sheet.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
for (int i = 0; i < rules.length; i++) {
  var underline = rules[i].getBooleanCondition().getUnderline();
  Logger.log("The font underline setting for rule %s is %b", i, underline);
}

戻る

Boolean - ブール型の条件によってテキストに下線を付けるかどうか。下線を表示する場合は null にします。 下線は影響を受けません

サポート終了のメソッド