Generatore di regole di formattazione condizionale.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
build() | Conditional | Costruisce una regola di formattazione condizionale dalle impostazioni applicate al generatore. |
copy() | Conditional | Restituisce un preset del generatore di regole con le impostazioni di questa regola. |
get | Boolean | Recupera le informazioni Boolean della regola se questa utilizza criteri di condizione booleana. |
get | Gradient | Recupera le informazioni Gradient della regola, se questa utilizza i criteri della condizione di gradiente. |
get | Range[] | Recupera gli intervalli a cui viene applicata questa regola di formattazione condizionale. |
set | Conditional | Imposta il colore di sfondo per il formato della regola di formattazione condizionale. |
set | Conditional | Imposta il colore di sfondo per il formato della regola di formattazione condizionale. |
set | Conditional | Imposta il testo in grassetto per il formato della regola di formattazione condizionale. |
set | Conditional | Imposta il colore del carattere per il formato della regola di formattazione condizionale. |
set | Conditional | Imposta il colore del carattere per il formato della regola di formattazione condizionale. |
set | Conditional | Cancella il valore del punto di massima sfumatura della regola di formattazione condizionale e utilizza il valore massimo nei relativi intervalli. |
set | Conditional | Cancella il valore del punto di massima sfumatura della regola di formattazione condizionale e utilizza il valore massimo nei relativi intervalli. |
set | Conditional | Imposta i campi punto massimo del gradiente della regola di formattazione condizionale. |
set | Conditional | Imposta i campi punto massimo del gradiente della regola di formattazione condizionale. |
set | Conditional | Imposta i campi del punto intermedio del gradiente della regola di formattazione condizionale. |
set | Conditional | Imposta i campi del punto intermedio del gradiente della regola di formattazione condizionale. |
set | Conditional | Cancella il valore del punto minimo del gradiente della regola di formattazione condizionale e utilizza il valore minimo gli intervalli della regola. |
set | Conditional | Cancella il valore del punto minimo del gradiente della regola di formattazione condizionale e utilizza il valore minimo gli intervalli della regola. |
set | Conditional | Imposta i campi punto minimo del gradiente della regola di formattazione condizionale. |
set | Conditional | Imposta i campi punto minimo del gradiente della regola di formattazione condizionale. |
set | Conditional | Imposta il testo in corsivo per il formato della regola di formattazione condizionale. |
set | Conditional | Imposta uno o più intervalli a cui viene applicata questa regola di formattazione condizionale. |
set | Conditional | Imposta il barrato del testo per il formato della regola di formattazione condizionale. |
set | Conditional | Imposta la sottolineatura del testo per il formato della regola di formattazione condizionale. |
when | Conditional | Imposta la regola di formattazione condizionale da attivare quando la cella è vuota. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata quando la cella non è vuota. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che si attivi quando una data è successiva al valore specificato. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è successiva alla data relativa specificata. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è precedente a quella specificata. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è precedente alla data relativa specificata. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è uguale a quella specificata. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è uguale alla data relativa specificata. |
when | Conditional | Imposta la regola di formattazione condizionale da attivare quando la formula specificata ha valore true . |
when | Conditional | Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è compreso tra due valori specificati o è uno di questi. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è uguale al valore specificato. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è maggiore del valore specificato. |
when | Conditional | Imposta la regola di formato condizionale in modo che venga attivata quando un numero è maggiore o uguale al valore specificato. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è inferiore al valore fornito. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è minore o uguale al valore fornito. |
when | Conditional | Imposta la regola di formato condizionale in modo che si attivi quando un numero non rientra tra due valori specificati e non è uguale a nessuno dei due. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che si attivi quando un numero non è uguale al valore specificato. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che si attivi quando l'input contiene il valore specificato. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata quando l'input non contiene il valore specificato. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che si attivi quando l'input termina con il valore specificato. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che si attivi quando l'input è uguale al valore specificato. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che si attivi quando l'input inizia con il valore specificato. |
with | Conditional | Imposta la regola del formato condizionale in base ai criteri definiti dai valori Boolean , tipicamente ricavati da criteria e arguments di una regola esistente. |
Documentazione dettagliata
build()
Costruisce una regola di formattazione condizionale dalle impostazioni applicate al generatore.
Invio
Conditional
: una rappresentazione della regola di formattazione condizionale
copy()
Restituisce un preset del generatore di regole con le impostazioni di questa regola.
Invio
Conditional
: un generatore basato sulle impostazioni di questa regola
get Boolean Condition()
Recupera le informazioni Boolean
della regola se questa utilizza criteri di condizione booleana. In caso contrario, restituisce null
.
// Log the boolean criteria type of the first conditional format rules of a // sheet. const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; const booleanCondition = rule.getBooleanCondition(); if (booleanCondition != null) { Logger.log(booleanCondition.getCriteriaType()); }
Invio
Boolean
: l'oggetto condizione booleana o null
se la regola non utilizza una condizione booleana.
get Gradient Condition()
Recupera le informazioni Gradient
della regola, se questa utilizza i criteri della condizione di gradiente. In caso contrario, restituisce null
.
// Log the gradient minimum color of the first conditional format rule of a // sheet. const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; const gradientCondition = rule.getGradientCondition(); if (gradientCondition != null) { // Assume the color has ColorType.RGB. Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString()); }
Invio
Gradient
: l'oggetto condizione di sfumatura o null
se la regola non utilizza una condizione di sfumatura.
get Ranges()
Recupera gli intervalli a cui viene applicata questa regola di formattazione condizionale.
// Log each range of the first conditional format rule of a sheet. const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; const ranges = rule.getRanges(); for (let i = 0; i < ranges.length; i++) { Logger.log(ranges[i].getA1Notation()); }
Invio
Range[]
: gli intervalli a cui viene applicata questa regola di formattazione condizionale.
set Background(color)
Imposta il colore di sfondo per il formato della regola di formattazione condizionale. Se specifichi null
viene rimossa l'impostazione di formato del colore di sfondo dalla regola.
// 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore desiderato o null per cancellare. |
Invio
Conditional
: il generatore, per l'accodamento
set Background Object(color)
Imposta il colore di sfondo per il formato della regola di formattazione condizionale. Se specifichi null
viene rimossa l'impostazione di formato del colore di sfondo dalla regola.
// 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setBackground(color) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | L'oggetto di colore desiderato o null per cancellare. |
Invio
Conditional
: il generatore, per l'accodamento.
set Bold(bold)
Imposta il testo in grassetto per il formato della regola di formattazione condizionale. Se bold
è true
, la regola mette in grassetto il testo se la condizione è soddisfatta. Se false
, la regola rimuove eventuali caratteri in grassetto esistenti se la condizione è soddisfatta. Se passi null
, l'impostazione di formattazione in grassetto viene rimossa dalla regola.
// 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setBold(true) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
bold | Boolean | Indica se il testo deve essere in grassetto se la condizione di formattazione è soddisfatta. null rimuove questa impostazione. |
Invio
Conditional
: il generatore, per l'accodamento
set Font Color(color)
Imposta il colore del carattere per il formato della regola di formattazione condizionale. Se specifichi null
, viene rimossa dalla regola l'impostazione del formato del colore del carattere.
// 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setFontColor('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore desiderato o null per cancellare. |
Invio
Conditional
: il generatore, per l'accodamento
set Font Color Object(color)
Imposta il colore del carattere per il formato della regola di formattazione condizionale. Se specifichi null
, viene rimossa dalla regola l'impostazione del formato del colore del carattere.
// 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setFontColor(color) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | L'oggetto di colore desiderato o null per cancellare. |
Invio
Conditional
: il generatore, per l'accodamento.
set Gradient Maxpoint(color)
Cancella il valore del punto di massima sfumatura della regola di formattazione condizionale e utilizza il valore massimo nei relativi intervalli. Imposta anche il colore del punto massimo del gradiente sul colore di input.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint('#FF0000') .setGradientMinpoint('#FFFFFF') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del punto massimo da impostare. |
Invio
Conditional
: il generatore, per l'accodamento
set Gradient Maxpoint Object(color)
Cancella il valore del punto di massima sfumatura della regola di formattazione condizionale e utilizza il valore massimo nei relativi intervalli. Imposta anche il colore del punto massimo del gradiente sul colore di input.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const textColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); const backgroundColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint(textColor) .setGradientMinpoint(backgroundColor) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | L'oggetto colore punto massimo da impostare. |
Invio
Conditional
: il generatore, per l'accodamento.
set Gradient Maxpoint Object With Value(color, type, value)
Imposta i campi punto massimo del gradiente della regola di formattazione condizionale.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); const color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); const color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue( color1, SpreadsheetApp.InterpolationType.NUMBER, '100', ) .setGradientMidpointWithValue( color2, SpreadsheetApp.InterpolationType.NUMBER, '50', ) .setGradientMinpointWithValue( color3, SpreadsheetApp.InterpolationType.NUMBER, '0', ) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | Il colore del punto massimo da impostare. |
type | Interpolation | Il tipo di interpolazione del punto massimo da impostare. |
value | String | Il valore maxpoint da impostare. |
Invio
Conditional
: il generatore, per l'accodamento.
set Gradient Maxpoint With Value(color, type, value)
Imposta i campi punto massimo del gradiente della regola di formattazione condizionale.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue( '#0000FF', SpreadsheetApp.InterpolationType.NUMBER, '100', ) .setGradientMidpointWithValue( '#00FF00', SpreadsheetApp.InterpolationType.NUMBER, '50', ) .setGradientMinpointWithValue( '#FF0000', SpreadsheetApp.InterpolationType.NUMBER, '0', ) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del punto massimo da impostare. |
type | Interpolation | Il tipo di interpolazione del punto massimo da impostare. |
value | String | Il valore maxpoint da impostare. |
Invio
Conditional
: il generatore, per l'accodamento
set Gradient Midpoint Object With Value(color, type, value)
Imposta i campi del punto intermedio del gradiente della regola di formattazione condizionale. Cancella tutti i campi relativi al punto intermedio se il tipo di interpolazione passato è 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); const color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); const color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue( color1, SpreadsheetApp.InterpolationType.NUMBER, '100', ) .setGradientMidpointWithValue( color2, SpreadsheetApp.InterpolationType.NUMBER, '50', ) .setGradientMinpointWithValue( color3, SpreadsheetApp.InterpolationType.NUMBER, '0', ) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | Il colore del punto intermedio da impostare. |
type | Interpolation | Il tipo di interpolazione del punto intermedio da impostare o null per cancellare. |
value | String | Il valore del punto medio da impostare. |
Invio
Conditional
: il generatore, per l'accodamento.
set Gradient Midpoint With Value(color, type, value)
Imposta i campi del punto intermedio del gradiente della regola di formattazione condizionale. Cancella tutti i campi relativi al punto intermedio se il tipo di interpolazione passato è 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue( '#0000FF', SpreadsheetApp.InterpolationType.NUMBER, '100', ) .setGradientMidpointWithValue( '#00FF00', SpreadsheetApp.InterpolationType.NUMBER, '50', ) .setGradientMinpointWithValue( '#FF0000', SpreadsheetApp.InterpolationType.NUMBER, '0', ) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del punto intermedio da impostare. |
type | Interpolation | Il tipo di interpolazione del punto intermedio da impostare o null per cancellare. |
value | String | Il valore del punto medio da impostare. |
Invio
Conditional
: il generatore, per l'accodamento
set Gradient Minpoint(color)
Cancella il valore del punto minimo del gradiente della regola di formattazione condizionale e utilizza il valore minimo gli intervalli della regola. Imposta anche il colore del punto minimo del gradiente sul colore inserito.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint('#FF0000') .setGradientMinpoint('#FFFFFF') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del punto minimo da impostare. |
Invio
Conditional
: il generatore, per l'accodamento
set Gradient Minpoint Object(color)
Cancella il valore del punto minimo del gradiente della regola di formattazione condizionale e utilizza il valore minimo gli intervalli della regola. Imposta anche il colore del punto minimo del gradiente sul colore inserito.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const textColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); const backgroundColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint(textColor) .setGradientMinpoint(backgroundColor) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | L'oggetto colore punto minimo da impostare. |
Invio
Conditional
: il generatore, per l'accodamento.
set Gradient Minpoint Object With Value(color, type, value)
Imposta i campi punto minimo del gradiente della regola di formattazione condizionale.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); const color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); const color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue( color1, SpreadsheetApp.InterpolationType.NUMBER, '100', ) .setGradientMidpointWithValue( color2, SpreadsheetApp.InterpolationType.NUMBER, '50', ) .setGradientMinpointWithValue( color3, SpreadsheetApp.InterpolationType.NUMBER, '0', ) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | Il colore del punto minimo da impostare. |
type | Interpolation | Il tipo di interpolazione del punto minimo da impostare. |
value | String | Il valore punto minimo da impostare. |
Invio
Conditional
: il generatore, per l'accodamento.
set Gradient Minpoint With Value(color, type, value)
Imposta i campi punto minimo del gradiente della regola di formattazione condizionale.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue( '#0000FF', SpreadsheetApp.InterpolationType.NUMBER, '100', ) .setGradientMidpointWithValue( '#00FF00', SpreadsheetApp.InterpolationType.NUMBER, '50', ) .setGradientMinpointWithValue( '#FF0000', SpreadsheetApp.InterpolationType.NUMBER, '0', ) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del punto minimo da impostare. |
type | Interpolation | Il tipo di interpolazione del punto minimo da impostare. |
value | String | Il valore punto minimo da impostare. |
Invio
Conditional
: il generatore, per l'accodamento
set Italic(italic)
Imposta il testo in corsivo per il formato della regola di formattazione condizionale. Se italic
è true
, la regola mette in corsivo il testo se la condizione è soddisfatta. Se false
, la regola rimuove eventuali testi in corsivo se la condizione è soddisfatta. Se specifichi null
, l'impostazione di formattazione in corsivo viene rimossa dalla regola.
// 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setItalic(true) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
italic | Boolean | Indica se il testo deve essere in corsivo se la condizione di formato è soddisfatta.
null rimuove questa impostazione. |
Invio
Conditional
: il generatore, per l'accodamento
set Ranges(ranges)
Imposta uno o più intervalli a cui viene applicata questa regola di formattazione condizionale. Questa operazione sostituisce eventuali intervalli esistenti. L'impostazione di un array vuoto cancella tutti gli intervalli esistenti. Una regola deve avere almeno un intervallo.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const rangeOne = sheet.getRange('A1:B3'); const rangeTwo = sheet.getRange('D4:F6'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground('#FF0000') .setRanges([rangeOne, rangeTwo]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
ranges | Range[] | Gli intervalli a cui viene applicata questa regola di formattazione condizionale. |
Invio
Conditional
: il generatore, per l'accodamento
set Strikethrough(strikethrough)
Imposta il barrato del testo per il formato della regola di formattazione condizionale. Se strikethrough
è
true
, la regola barra il testo se la condizione è soddisfatta; se false
, la regola
rimuove la formattazione barrata esistente se la condizione è soddisfatta. Se specifichi null
, la regola rimuove l'impostazione di formattazione barrata.
// 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setStrikethrough(true) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
strikethrough | Boolean | Indica se il testo deve essere barrato se la condizione di formattazione è soddisfatta. null rimuove questa impostazione. |
Invio
Conditional
: il generatore, per l'accodamento
set Underline(underline)
Imposta la sottolineatura del testo per il formato della regola di formattazione condizionale. Se underline
è true
, la regola sottolinea il testo se la condizione è soddisfatta; se false
, la regola rimuove eventuali sottolineature esistenti se la condizione è soddisfatta. Se specifichi null
, l'impostazione di formato del testo sottolineato viene rimossa dalla regola.
// 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setUnderline(true) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
underline | Boolean | Indica se il testo deve essere sottolineato se la condizione di formattazione è soddisfatta.
null rimuove questa impostazione. |
Invio
Conditional
: il generatore, per l'accodamento
when Cell Empty()
Imposta la regola di formattazione condizionale da attivare quando la cella è vuota.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to // turn red if they are empty. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenCellEmpty() .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Invio
Conditional
: il generatore, per l'accodamento
when Cell Not Empty()
Imposta la regola di formattazione condizionale in modo che venga attivata quando la cella non è vuota.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to // turn red if they are not empty. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenCellNotEmpty() .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Invio
Conditional
: il generatore, per l'accodamento
when Date After(date)
Imposta la regola di formattazione condizionale in modo che si attivi quando una data è successiva al valore specificato.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenDateAfter(new Date('11/4/1993')) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date | La data più recente. |
Invio
Conditional
: il generatore, per l'accodamento
when Date After(date)
Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è successiva alla data relativa specificata.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Relative | La data più recente relativa al tipo di data selezionato. |
Invio
Conditional
: il generatore, per l'accodamento
when Date Before(date)
Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è precedente a quella specificata.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenDateBefore(new Date('11/4/1993')) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date | La data meno recente non accettabile. |
Invio
Conditional
: il generatore, per l'accodamento
when Date Before(date)
Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è precedente alla data relativa specificata.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Relative | La data più recente relativa al tipo di data selezionato. |
Invio
Conditional
: il generatore, per l'accodamento
when Date Equal To(date)
Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è uguale a quella specificata.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenDateEqualTo(new Date('11/4/1993')) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date | L'unica data accettabile. |
Invio
Conditional
: il generatore, per l'accodamento
when Date Equal To(date)
Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è uguale alla data relativa specificata.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to // turn red if they contain todays date. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Relative | La data più recente relativa al tipo di data selezionato. |
Invio
Conditional
: il generatore, per l'accodamento
when Formula Satisfied(formula)
Imposta la regola di formattazione condizionale da attivare quando la formula specificata ha valore 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)". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenFormulaSatisfied('=EQ(B4, C3)') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
formula | String | Una formula personalizzata che restituisce true se l'input è valido. |
Invio
Conditional
: il generatore, per l'accodamento
when Number Between(start, end)
Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è compreso tra due valori specificati o è uno di questi.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Number | Il valore minimo accettabile. |
end | Number | Il valore accettabile più alto. |
Invio
Conditional
: il generatore, per l'accodamento
when Number Equal To(number)
Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è uguale al valore specificato.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to // turn red if they contain the number 10. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberEqualTo(10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | L'unico valore accettabile. |
Invio
Conditional
: il generatore, per l'accodamento
when Number Greater Than(number)
Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è maggiore del valore specificato.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberGreaterThan(10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il valore non accettabile più alto. |
Invio
Conditional
: il generatore, per l'accodamento
when Number Greater Than Or Equal To(number)
Imposta la regola di formato condizionale in modo che venga attivata quando un numero è maggiore o uguale al valore specificato.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberGreaterThanOrEqualTo(10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il valore minimo accettabile. |
Invio
Conditional
: il generatore, per l'accodamento
when Number Less Than(number)
Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è inferiore al valore fornito.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberLessThan(10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il valore minimo non accettabile. |
Invio
Conditional
: il generatore, per l'accodamento
when Number Less Than Or Equal To(number)
Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è minore o uguale al valore fornito.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberLessThanOrEqualTo(10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il valore accettabile più alto. |
Invio
Conditional
: il generatore, per l'accodamento
when Number Not Between(start, end)
Imposta la regola di formato condizionale in modo che si attivi quando un numero non rientra tra due valori specificati e non è uguale a nessuno dei due.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberNotBetween(1, 10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Number | Il valore minimo non accettabile. |
end | Number | Il valore non accettabile più alto. |
Invio
Conditional
: il generatore, per l'accodamento
when Number Not Equal To(number)
Imposta la regola di formattazione condizionale in modo che si attivi quando un numero non è uguale al valore specificato.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberNotEqualTo(10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | L'unico valore non accettato. |
Invio
Conditional
: il generatore, per l'accodamento
when Text Contains(text)
Imposta la regola di formattazione condizionale in modo che si attivi quando l'input contiene il valore specificato.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to // turn red if they contain the text "hello". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextContains('hello') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il valore che l'input deve contenere. |
Invio
Conditional
: il generatore, per l'accodamento
when Text Does Not Contain(text)
Imposta la regola di formattazione condizionale in modo che venga attivata quando l'input non contiene il valore specificato.
// 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextDoesNotContain('hello') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il valore che l'input non deve contenere. |
Invio
Conditional
: il generatore, per l'accodamento
when Text Ends With(text)
Imposta la regola di formattazione condizionale in modo che si attivi quando l'input termina con il valore specificato.
// 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEndsWith('hello') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Testo da confrontare con la fine della stringa. |
Invio
Conditional
: il generatore, per l'accodamento
when Text Equal To(text)
Imposta la regola di formattazione condizionale in modo che si attivi quando l'input è uguale al valore specificato.
// 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | L'unico valore accettabile. |
Invio
Conditional
: il generatore, per l'accodamento
when Text Starts With(text)
Imposta la regola di formattazione condizionale in modo che si attivi quando l'input inizia con il valore specificato.
// 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextStartsWith('hello') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il testo da confrontare con l'inizio della stringa. |
Invio
Conditional
: il generatore, per l'accodamento
with Criteria(criteria, args)
Imposta la regola del formato condizionale in base ai criteri definiti dai valori Boolean
, tipicamente ricavati da criteria
e arguments
di una regola esistente.
// 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. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); const booleanCondition = rules[0].getBooleanCondition(); if (booleanCondition != null) { const rule = SpreadsheetApp.newConditionalFormatRule() .withCriteria( booleanCondition.getCriteriaType(), booleanCondition.getCriteriaValues(), ) .setBackground('#000000') .setRanges(rules[0].getRanges()) .build(); rules.push(rule); } sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
criteria | Boolean | Il tipo di criteri di formattazione condizionale. |
args | Object[] | Un array di argomenti appropriati al tipo di criteri; il numero di argomenti e il loro tipo corrispondono al metodo when...() corrispondente riportato sopra. |
Invio
Conditional
: il generatore, per l'accodamento