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 | Crea 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 regola
utilizza criteri di 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 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 massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola. |
set | Conditional | Cancella il valore massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola. |
set | Conditional | Imposta i campi maxpoint del gradiente della regola di formattazione condizionale. |
set | Conditional | Imposta i campi maxpoint del gradiente della regola di formattazione condizionale. |
set | Conditional | Imposta i campi del punto medio del gradiente della regola di formattazione condizionale. |
set | Conditional | Imposta i campi del punto medio del gradiente della regola di formattazione condizionale. |
set | Conditional | Cancella il valore minimo del gradiente della regola di formattazione condizionale e utilizza invece il valore minimo negli intervalli della regola. |
set | Conditional | Cancella il valore minimo del gradiente della regola di formattazione condizionale e utilizza invece il valore minimo negli intervalli della regola. |
set | Conditional | Imposta i campi del punto minimo del gradiente della regola di formattazione condizionale. |
set | Conditional | Imposta i campi del punto minimo del gradiente della regola di formattazione condizionale. |
set | Conditional | Imposta il 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 la barratura 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 in modo che venga attivata 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 l'attivazione della regola di formattazione condizionale 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 alla data 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 in modo che venga attivata quando la formula specificata restituisce il valore true . |
when | Conditional | Imposta la regola di formattazione condizionale in modo che si attivi quando un numero rientra tra due valori specificati o è uguale a uno di questi. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è uguale al valore specificato. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è maggiore del valore specificato. |
when | Conditional | Imposta la regola di formattazione 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 venga attivata quando un numero è inferiore al valore specificato. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è minore o uguale al valore specificato. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata 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 venga attivata quando un numero non è uguale al valore specificato. |
when | Conditional | Imposta la regola di formattazione condizionale in modo che venga attivata 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 venga attivata 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 venga attivata quando l'input inizia con il valore specificato. |
with | Conditional | Imposta la regola di formattazione condizionale sui criteri definiti dai valori Boolean ,
in genere presi da criteria e arguments di una
regola esistente. |
Documentazione dettagliata
build()
Crea una regola di formattazione condizionale dalle impostazioni applicate al generatore.
Indietro
Conditional
: una rappresentazione della regola di formattazione condizionale.
copy()
Restituisce un preset del generatore di regole con le impostazioni di questa regola.
Indietro
Conditional
: un builder 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()); }
Indietro
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 regola
utilizza criteri di 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()); }
Indietro
Gradient
: l'oggetto condizione sfumatura o null
se la regola non utilizza una condizione 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()); }
Indietro
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. L'inserimento di null
rimuove l'impostazione di formattazione 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Background Object(color)
Imposta il colore di sfondo per il formato della regola di formattazione condizionale. L'inserimento di null
rimuove l'impostazione di formattazione 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 colore desiderato o null per cancellare. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Bold(bold)
Imposta il 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 qualsiasi
grassetto esistente se la condizione è soddisfatta. L'inserimento di null
rimuove l'impostazione del formato in grassetto 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 visualizzato in grassetto se la condizione di formattazione è soddisfatta; null rimuove questa impostazione. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Font Color(color)
Imposta il colore del carattere per il formato della regola di formattazione condizionale. L'inserimento di null
rimuove
l'impostazione del formato del colore del carattere dalla regola.
// 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Font Color Object(color)
Imposta il colore del carattere per il formato della regola di formattazione condizionale. L'inserimento di null
rimuove
l'impostazione del formato del colore del carattere dalla regola.
// 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 colore desiderato o null per cancellare. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Gradient Maxpoint(color)
Cancella il valore massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola. 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Gradient Maxpoint Object(color)
Cancella il valore massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola. 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Gradient Maxpoint Object With Value(color, type, value)
Imposta i campi maxpoint 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 maxpoint da impostare. |
value | String | Il valore maxpoint da impostare. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Gradient Maxpoint With Value(color, type, value)
Imposta i campi maxpoint 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 maxpoint da impostare. |
value | String | Il valore maxpoint da impostare. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Gradient Midpoint Object With Value(color, type, value)
Imposta i campi del punto medio del gradiente della regola di formattazione condizionale. Cancella tutti i campi del punto medio
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 intermedio da impostare. |
type | Interpolation | Il tipo di interpolazione del punto medio da impostare o null da cancellare. |
value | String | Il valore del punto medio da impostare. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Gradient Midpoint With Value(color, type, value)
Imposta i campi del punto medio del gradiente della regola di formattazione condizionale. Cancella tutti i campi del punto medio
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 intermedio da impostare. |
type | Interpolation | Il tipo di interpolazione del punto medio da impostare o null da cancellare. |
value | String | Il valore del punto medio da impostare. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Gradient Minpoint(color)
Cancella il valore minimo del gradiente della regola di formattazione condizionale e utilizza invece il valore minimo negli intervalli della regola. Imposta anche il colore del punto minimo 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 minimo da impostare. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Gradient Minpoint Object(color)
Cancella il valore minimo del gradiente della regola di formattazione condizionale e utilizza invece il valore minimo negli intervalli della regola. Imposta anche il colore del punto minimo 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 minimo da impostare. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Gradient Minpoint Object With Value(color, type, value)
Imposta i campi del 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 minpoint da impostare. |
value | String | Il valore del punto minimo da impostare. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Gradient Minpoint With Value(color, type, value)
Imposta i campi del 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 minpoint da impostare. |
value | String | Il valore del punto minimo da impostare. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Italic(italic)
Imposta il 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
qualsiasi corsivo esistente se la condizione è soddisfatta. Se inserisci null
, l'impostazione del formato 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 formattazione è soddisfatta;
null rimuove questa impostazione. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Ranges(ranges)
Imposta uno o più intervalli a cui viene applicata questa regola di formattazione condizionale. Questa operazione sostituisce eventuali intervalli esistenti. Se imposti un array vuoto, vengono cancellati 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
set Strikethrough(strikethrough)
Imposta la barratura del testo per il formato della regola di formattazione condizionale. Se strikethrough
è
true
, la regola sbarra il testo se la condizione è soddisfatta; se false
, la regola
rimuove qualsiasi formattazione di sbarratura esistente se la condizione è soddisfatta. L'inserimento di null
rimuove l'impostazione di formattazione barrata dalla regola.
// 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
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 le sottolineature
esistenti se la condizione è soddisfatta. L'inserimento di null
rimuove l'impostazione di formattazione
della sottolineatura 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 | Se il testo deve essere sottolineato o meno se la condizione di formattazione è soddisfatta;
null rimuove questa impostazione. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Cell Empty()
Imposta la regola di formattazione condizionale in modo che venga attivata 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);
Indietro
Conditional
: il generatore, per il concatenamento.
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);
Indietro
Conditional
: il generatore, per il concatenamento.
when Date After(date)
Imposta l'attivazione della regola di formattazione condizionale 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
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 rispetto al tipo di data selezionato. |
Indietro
Conditional
: il generatore, per il concatenamento.
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 prima data non accettabile. |
Indietro
Conditional
: il generatore, per il concatenamento.
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 rispetto al tipo di data selezionato. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Date Equal To(date)
Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è uguale alla data 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
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 rispetto al tipo di data selezionato. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Formula Satisfied(formula)
Imposta la regola di formattazione condizionale in modo che venga attivata quando la formula specificata restituisce il 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Number Between(start, end)
Imposta la regola di formattazione condizionale in modo che si attivi quando un numero rientra tra due valori specificati o è uguale a 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Number Equal To(number)
Imposta la regola di formattazione condizionale in modo che venga attivata 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Number Greater Than(number)
Imposta la regola di formattazione condizionale in modo che venga attivata 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 inaccettabile più alto. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Number Greater Than Or Equal To(number)
Imposta la regola di formattazione 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Number Less Than(number)
Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è inferiore 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 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 più basso inaccettabile. |
Indietro
Conditional
: il generatore, per il concatenamento.
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 specificato.
// 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Number Not Between(start, end)
Imposta la regola di formattazione condizionale in modo che venga attivata 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 più basso inaccettabile. |
end | Number | Il valore inaccettabile più alto. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Number Not Equal To(number)
Imposta la regola di formattazione condizionale in modo che venga attivata 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 accettabile. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Text Contains(text)
Imposta la regola di formattazione condizionale in modo che venga attivata 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 deve contenere l'input. |
Indietro
Conditional
: il generatore, per il concatenamento.
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. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Text Ends With(text)
Imposta la regola di formattazione condizionale in modo che venga attivata 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. |
Indietro
Conditional
: il generatore, per il concatenamento.
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. |
Indietro
Conditional
: il generatore, per il concatenamento.
when Text Starts With(text)
Imposta la regola di formattazione condizionale in modo che venga attivata 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 | Testo da confrontare con l'inizio della stringa. |
Indietro
Conditional
: il generatore, per il concatenamento.
with Criteria(criteria, args)
Imposta la regola di formattazione condizionale sui criteri definiti dai valori Boolean
,
in genere presi 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 per il tipo di criteri; il numero di argomenti e
il loro tipo corrispondono al metodo when...() corrispondente riportato sopra. |
Indietro
Conditional
: il generatore, per il concatenamento.