条件付き書式ルールのビルダー。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number between 1 and 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
メソッド
詳細なドキュメント
build()
copy()
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[]
- この条件付き書式ルールが適用される範囲。
setBackground(color)
条件付き書式ルールの書式の背景色を設定します。null
で渡す
背景色の形式の設定がルールから削除されます。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color to red if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | String | 消去する色または null 。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
setBackgroundObject(color)
条件付き書式ルールの書式の背景色を設定します。null
で渡す
背景色の形式の設定がルールから削除されます。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color to theme background color if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setBackground(color) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | Color | クリアするカラー オブジェクトまたは null 。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー。
setBold(bold)
条件付き書式ルールの書式のテキストを太字に設定します。bold
が true
の場合、
条件が満たされるとルールのテキストが太字で表示されます。false
の場合、このルールによって既存のすべての
一致する場合は太字で表示されます。null
を渡すと、太字の書式設定が
表示されます。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their // text bold if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setBold(true) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
bold | Boolean | 書式の条件を満たしている場合にテキストを太字にするかどうかを指定します。null がこの設定を削除します。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
setFontColor(color)
条件付き書式ルールの書式のフォントの色を設定します。null
を渡すと、
フォントの色の書式を設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font // color to red if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setFontColor("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | String | 消去する色または null 。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
setFontColorObject(color)
条件付き書式ルールの書式のフォントの色を設定します。null
を渡すと、
フォントの色の書式を設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font // color to theme text color if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setFontColor(color) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | Color | クリアするカラー オブジェクトまたは null 。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー。
setGradientMaxpoint(color)
条件付き書式ルールのグラデーションの最大値をクリアし、代わりに最大値を使用します 計算します。また、グラデーションの maxpoint カラーを入力色に設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere between white and red, based on their values in comparison to // the ranges minimum and maximum values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint("#FF0000") .setGradientMinpoint("#FFFFFF") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | String | 設定する最大ポイントの色。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
setGradientMaxpointObject(color)
条件付き書式ルールのグラデーションの最大値をクリアし、代わりに最大値を使用します 計算します。また、グラデーションの maxpoint カラーを入力色に設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere between theme text and background colors, based on their values // in comparison to the ranges minimum and maximum values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var textColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var backgroundColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint(textColor) .setGradientMinpoint(backgroundColor) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | Color | 設定する最大ポイント カラー オブジェクト。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー。
setGradientMaxpointObjectWithValue(color, type, value)
条件付き書式ルールのグラデーションの maxpoint フィールドを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from theme accent 1, accent 2 to accent 3 colors, based on their // values in comparison to the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | Color | 設定する最大ポイントの色。 |
type | InterpolationType | 設定する最大ポイント補間タイプ。 |
value | String | 設定する最大値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー。
setGradientMaxpointWithValue(color, type, value)
条件付き書式ルールのグラデーションの maxpoint フィールドを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from red green to blue, based on their values in comparison to // the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | String | 設定する最大ポイントの色。 |
type | InterpolationType | 設定する最大ポイント補間タイプ。 |
value | String | 設定する最大値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
setGradientMidpointObjectWithValue(color, type, value)
条件付き書式ルールのグラデーション中間点フィールドを設定します。すべての中点フィールドをクリアします
渡された補間タイプが null
の場合。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on // their values in comparison to the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | Color | 設定する中点の色。 |
type | InterpolationType | 設定する中点補間タイプ、またはクリアする場合は null 。 |
value | String | 設定する中間値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー。
setGradientMidpointWithValue(color, type, value)
条件付き書式ルールのグラデーション中間点フィールドを設定します。すべての中点フィールドをクリアします
渡された補間タイプが null
の場合。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from red green to blue, based on their values in comparison to // the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | String | 設定する中点の色。 |
type | InterpolationType | 設定する中点補間タイプ、またはクリアする場合は null 。 |
value | String | 設定する中間値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
setGradientMinpoint(color)
条件付き書式ルールのグラデーションの最小値をクリアして、代わりに最小値を使用します 計算します。また、グラデーションの最低点の色を入力色に設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere between white and red, based on their values in comparison to // the ranges minimum and maximum values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint("#FF0000") .setGradientMinpoint("#FFFFFF") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | String | 設定する最小点の色。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
setGradientMinpointObject(color)
条件付き書式ルールのグラデーションの最小値をクリアして、代わりに最小値を使用します 計算します。また、グラデーションの最低点の色を入力色に設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere between theme text and background colors, based on their values // in comparison to the ranges minimum and maximum values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var textColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var backgroundColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint(textColor) .setGradientMinpoint(backgroundColor) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | Color | 設定する最小ポイント カラー オブジェクト。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー。
setGradientMinpointObjectWithValue(color, type, value)
条件付き書式ルールのグラデーションの最小値フィールドを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on // their values in comparison to the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | Color | 設定する最小点の色。 |
type | InterpolationType | 設定する最小点補間タイプ。 |
value | String | 設定する最小値の値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー。
setGradientMinpointWithValue(color, type, value)
条件付き書式ルールのグラデーションの最小値フィールドを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from red to green to blue, based on their values in comparison to // the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
color | String | 設定する最小点の色。 |
type | InterpolationType | 設定する最小点補間タイプ。 |
value | String | 設定する最小値の値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
setItalic(italic)
条件付き書式ルールの書式のテキストを斜体に設定します。italic
が true
の場合、
条件が満たされるとテキストが斜体になります。false
の場合、このルールによって
斜体になります。null
を渡すと、斜体がなくなります。
書式設定をルールで適用できます。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their // text italic if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setItalic(true) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
italic | Boolean | 書式条件を満たす場合にテキストを斜体にするかどうか
null がこの設定を削除します。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
setRanges(ranges)
この条件付き書式ルールを適用する 1 つ以上の範囲を設定します。このオペレーション 既存の範囲がすべて置き換えられます空の配列を設定すると、既存の範囲がすべて消去されます。ルールは 少なくとも 1 つの範囲が必要です。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 and range D4:F6 // to turn red if they contain a number between 1 and 10. var sheet = SpreadsheetApp.getActiveSheet(); var rangeOne = sheet.getRange("A1:B3"); var rangeTwo = sheet.getRange("D4:F6"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground("#FF0000") .setRanges([rangeOne, rangeTwo]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
ranges | Range[] | この条件付き書式ルールが適用される範囲です。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
setStrikethrough(strikethrough)
条件付き書式ルールの書式に取り消し線を設定します。strikethrough
が
true
: 条件が満たされると、ルールのテキストに取り消し線が引かれます。false
の場合、ルール
条件が満たされると、既存の取り消し線が引かれます。null
で渡す
ルールから取り消し線の書式設定が削除されます。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to strikethrough // their text if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setStrikethrough(true) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
strikethrough | Boolean | 書式条件が次の場合にテキストに取り消し線を引くかどうか
met;null がこの設定を削除します。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
setUnderline(underline)
条件付き書式ルールの書式に下線を設定します。underline
が true
の場合、条件が満たされるとルールによりテキストに下線が引かれます。false
の場合、このルールによって
条件が満たされると既存の下線が引かれますnull
を渡すと下線が削除されます
書式設定をルールで適用できます。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to underline // their text if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setUnderline(true) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
underline | Boolean | 書式条件を満たす場合にテキストに下線を付けるかどうか
null がこの設定を削除します。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenCellEmpty()
セルが空の場合にトリガーする条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they are empty. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenCellEmpty() .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenCellNotEmpty()
セルが空でない場合にトリガーする条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they are not empty. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenCellNotEmpty() .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenDateAfter(date)
指定した値より後の日付にトリガーされるように、条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a date after 11/4/1993. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateAfter(new Date("11/4/1993")) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
date | Date | 最新の日付。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenDateAfter(date)
指定された相対的な日付より後の日付でトリガーされるように、条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a date after today. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
date | RelativeDate | 選択した日付タイプに関連する最新の日付。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenDateBefore(date)
指定した日付より前の日付がトリガーされるように条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a date before 11/4/1993. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateBefore(new Date("11/4/1993")) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
date | Date | 使用できない最も早い日付です。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenDateBefore(date)
指定された相対的な日付より前の日付にトリガーされるように、条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a date before today. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
date | RelativeDate | 選択した日付タイプに関連する最新の日付。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenDateEqualTo(date)
日付が指定された日付と等しい場合にトリガーする条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain the date 11/4/1993. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateEqualTo(new Date("11/4/1993")) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
date | Date | 唯一の許容日。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenDateEqualTo(date)
日付が指定された相対日付と等しい場合にトリガーする条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain todays date. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
date | RelativeDate | 選択した日付タイプに関連する最新の日付。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenFormulaSatisfied(formula)
指定された数式が true
と評価されたときにトリガーする条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they satisfy the condition "=EQ(B4, C3)". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenFormulaSatisfied("=EQ(B4, C3)") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
formula | String | 入力が有効な場合に true と評価されるカスタム数式。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenNumberBetween(start, end)
数値が 2 つの範囲にある場合、または 2 つの範囲にある場合にトリガーするように条件付き書式ルールを設定します。 使用できます。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number between 1 and 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
start | Number | 許容される最小値。 |
end | Number | 許容される最大値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenNumberEqualTo(number)
数値が指定された値と等しい場合にトリガーする条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain the number 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberEqualTo(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
number | Number | 唯一の許容値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenNumberGreaterThan(number)
数値が指定された値より大きい場合にトリガーする条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red // if they contain a number greater than 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberGreaterThan(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
number | Number | 許容できない最大値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenNumberGreaterThanOrEqualTo(number)
数値が指定した値以上である場合にトリガーする条件付き書式ルールを設定します あります。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number greater than or equal to 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberGreaterThanOrEqualTo(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
number | Number | 許容される最小値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenNumberLessThan(number)
指定した値より小さい数値が出現した場合にトリガーする条件付き書式ルールを設定します あります。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number less than 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberLessThan(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
number | Number | 許可されない最小値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenNumberLessThanOrEqualTo(number)
指定された数値以下の場合にトリガーする条件付き書式ルールを設定します あります。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number less than or equal to 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberLessThanOrEqualTo(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
number | Number | 許容される最大値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenNumberNotBetween(start, end)
数値が範囲外で、かつどちらも「ない」場合にトリガーされるように、条件付き書式ルールを設定します 表します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number not between 1 and 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberNotBetween(1, 10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
start | Number | 許可されない最小値。 |
end | Number | 許容できない最大値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenNumberNotEqualTo(number)
数値が指定された値と等しくない場合にトリガーする条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they don't contain the number 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberNotEqualTo(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
number | Number | 許可されない唯一の値です。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenTextContains(text)
入力に指定された値が含まれている場合にトリガーする条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain the text "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextContains("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
text | String | 入力に含める必要がある値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenTextDoesNotContain(text)
指定された値が入力に含まれていない場合にトリガーする条件付き書式ルールを設定します。 あります。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they don't contain the text "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextDoesNotContain("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
text | String | 入力に含めてはならない値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenTextEndsWith(text)
入力が指定された値で終了したときにトリガーする条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they end with the text "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEndsWith("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
text | String | 文字列の末尾と比較するテキスト。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenTextEqualTo(text)
入力が指定された値と等しい場合にトリガーする条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they have text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
text | String | 唯一の許容値。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
whenTextStartsWith(text)
入力が指定値で始まる場合にトリガーする条件付き書式ルールを設定します。
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they start with the text "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextStartsWith("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
text | String | 文字列の先頭と比較するテキスト。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー
withCriteria(criteria, args)
条件付き書式ルールを BooleanCriteria
値で定義された条件に設定します。
通常は、データセットの criteria
と arguments
から取得されます。
確認できます。
// Adds a new conditional format rule that is a copy of the first active // conditional format rule, except it instead sets its cells to have a black // background color. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); var booleanCondition = rules[0].getBooleanCondition(); if (booleanCondition != null) { var rule = SpreadsheetApp.newConditionalFormatRule() .withCriteria(booleanCondition.getCriteriaType(), booleanCondition.getCriteriaValues()) .setBackground("#000000") .setRanges(rule.getRanges()) .build(); rules.push(rule); } sheet.setConditionalFormatRules(rules);
パラメータ
名前 | 型 | 説明 |
---|---|---|
criteria | BooleanCriteria | 条件付き書式条件のタイプ。 |
args | Object[] | 条件タイプに応じた引数の配列。使用できる引数の数と、
その型は、上記の対応する when...() メソッドと一致します。 |
戻る
ConditionalFormatRuleBuilder
- チェーン用のビルダー