Neuigkeiten in der Excel-JavaScript-API 1.6

  • Artikel

Bedingte Formatierung

Führt die bedingte Formatierung eines Bereichs ein. Ermöglicht die folgenden Arten von bedingter Formatierung.

  • Farbskala
  • Datenbalken
  • Symbolsatz
  • Benutzerdefiniert

Weitere Schritte:

  • Gibt den Bereich zurück, auf den das bedingte Format angewendet wird.
  • Entfernen der bedingten Formatierung.
  • Stellt Priorität und stopifTrue Funktion bereit.
  • Abrufen der Auflistung der gesamten bedingten Formatierung für einen bestimmten Bereich.
  • Löscht alle bedingten Formate, die im aktuellen angegebenen Bereich aktiv sind.

API-Liste

In der folgenden Tabelle sind die APIs im Excel-JavaScript-API-Anforderungssatz 1.6 aufgeführt. Informationen zum Anzeigen der API-Referenzdokumentation für alle APIs, die vom Excel-JavaScript-API-Anforderungssatz 1.6 oder früher unterstützt werden, finden Sie unter Excel-APIs in Anforderungssatz 1.6 oder früher.

Klasse Felder Beschreibung
Anwendung suspendApiCalculationUntilNextSync() Hält die Berechnung an, bis die nächste context.sync() aufgerufen wird.
CellValueConditionalFormat format Gibt ein Formatobjekt zurück, das die Schriftart, Füllung, Rahmen und andere Eigenschaften für bedingte Formate kapselt.
Regel Gibt das Regelobjekt für dieses bedingte Format an.
ColorScaleConditionalFormat Kriterien Die Kriterien der Farbskala.
threeColorScale Wenn true, hat die Farbskala drei Punkte (Minimum, Mittelpunkt, Maximum), andernfalls zwei (Minimum, Maximum).
ConditionalCellValueRule formel1 Die Formel, falls erforderlich, für die die Regel für das bedingte Format ausgewertet werden soll.
Formula2 Die Formel, falls erforderlich, für die die Regel für das bedingte Format ausgewertet werden soll.
operator Der Operator des bedingten Zellwertformats.
ConditionalColorScaleCriteria maximum Der maximale Punkt des Farbskalakriteriums.
Mittelpunkt Der Mittelpunkt des Farbskalakriteriums, wenn die Farbskala eine 3-Farbskala ist.
minimum Der Mindestpunkt des Farbskalakriteriums.
ConditionalColorScaleCriterion color HTML-Farbcodedarstellung der Farbskalafarbe (z. B. #FF0000 steht für Rot).
formula Eine Zahl, eine Formel oder null (wenn type ist lowestValue).
type Worauf die bedingte Formel des Kriteriums basieren soll.
ConditionalDataBarNegativeFormat Bordercolor HTML-Farbcode, der die Farbe der Rahmenlinie in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt.
Fillcolor HTML-Farbcode, der die Füllfarbe in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt.
matchPositiveBorderColor Gibt an, ob der negative Datenbalken die gleiche Rahmenfarbe wie der positive Datenbalken aufweist.
matchPositiveFillColor Gibt an, ob der negative Datenbalken dieselbe Füllfarbe wie der positive Datenbalken aufweist.
ConditionalDataBarPositiveFormat Bordercolor HTML-Farbcode, der die Farbe der Rahmenlinie in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt.
Fillcolor HTML-Farbcode, der die Füllfarbe in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt.
gradientFill Gibt an, ob der Datenbalken einen Farbverlauf aufweist.
ConditionalDataBarRule formula Die Formel, falls erforderlich, für die die Datenbalkenregel ausgewertet werden soll.
type Der Regeltyp für die Datenleiste.
ConditionalFormat cellValue Gibt die Eigenschaften des bedingten Formats des Zellwerts zurück, wenn das aktuelle bedingte Format ein CellValue Typ ist.
cellValueOrNullObject Gibt die Eigenschaften des bedingten Formats des Zellwerts zurück, wenn das aktuelle bedingte Format ein CellValue Typ ist.
colorScale Gibt die Eigenschaften des bedingten Formats der Farbskala zurück, wenn das aktuelle bedingte Format ein ColorScale Typ ist.
colorScaleOrNullObject Gibt die Eigenschaften des bedingten Formats der Farbskala zurück, wenn das aktuelle bedingte Format ein ColorScale Typ ist.
Benutzerdefinierte Gibt die eigenschaften des benutzerdefinierten bedingten Formats zurück, wenn das aktuelle bedingte Format ein benutzerdefinierter Typ ist.
customOrNullObject Gibt die eigenschaften des benutzerdefinierten bedingten Formats zurück, wenn das aktuelle bedingte Format ein benutzerdefinierter Typ ist.
Databar Gibt die Datenbalkeneigenschaften zurück, wenn das aktuelle bedingte Format ein Datenbalken ist.
dataBarOrNullObject Gibt die Datenbalkeneigenschaften zurück, wenn das aktuelle bedingte Format ein Datenbalken ist.
delete() Löscht dieses bedingte Format.
getRange() Gibt den Bereich zurück, auf den das bedingte Format angewendet wird.
getRangeOrNullObject() Gibt den Bereich zurück, auf den das konditonale Format angewendet wird.
Iconset Gibt die Eigenschaften des bedingten Formats zurück, wenn das aktuelle bedingte Format ein IconSet Typ ist.
iconSetOrNullObject Gibt die Eigenschaften des bedingten Formats zurück, wenn das aktuelle bedingte Format ein IconSet Typ ist.
id Die Priorität des bedingten Formats im aktuellen ConditionalFormatCollection.
Voreinstellung Gibt das bedingte Format der voreingestellten Kriterien zurück.
presetOrNullObject Gibt das bedingte Format der voreingestellten Kriterien zurück.
Priorität Die Priorität (oder der Index) in der Auflistung des bedingten Formats, in der dieses bedingte Format derzeit vorhanden ist.
stopIfTrue Wenn die Bedingungen dieses bedingten Formats erfüllt sind, werden keine Formate niedrigerer Priorität für diese Zelle wirksam.
textComparison Gibt die spezifischen Eigenschaften des bedingten Textformats zurück, wenn das aktuelle bedingte Format ein Texttyp ist.
textComparisonOrNullObject Gibt die spezifischen Eigenschaften des bedingten Textformats zurück, wenn das aktuelle bedingte Format ein Texttyp ist.
topBottom Gibt die Eigenschaften des oberen/unteren bedingten Formats zurück, wenn das aktuelle bedingte Format ein TopBottom Typ ist.
topBottomOrNullObject Gibt die Eigenschaften des oberen/unteren bedingten Formats zurück, wenn das aktuelle bedingte Format ein TopBottom Typ ist.
type Ein Typ des bedingten Formats.
ConditionalFormatCollection add(type: Excel.ConditionalFormatType) Fügt der Auflistung ein neues bedingtes Format mit der ersten/obersten Priorität hinzu.
clearAll() Löscht alle bedingten Formate, die im aktuellen angegebenen Bereich aktiv sind.
getCount() Gibt die Anzahl der bedingten Formate in der Arbeitsmappe zurück.
getItem(id: string) Gibt ein bedingtes Format für die angegebene ID zurück.
getItemAt(index: number) Gibt ein bedingtes Format am angegebenen Index zurück.
items Ruft die geladenen untergeordneten Elemente in dieser Sammlung ab.
ConditionalFormatRule formula Die Formel, falls erforderlich, für die die Regel für das bedingte Format ausgewertet werden soll.
formulaLocal Die Formel, falls erforderlich, für die die Regel für das bedingte Format in der Sprache des Benutzers ausgewertet werden soll.
formulaR1C1 Die Formel, falls erforderlich, für die die bedingte Formatregel in R1C1-Schreibweise ausgewertet werden soll.
ConditionalIconCriterion customIcon Das benutzerdefinierte Symbol für das aktuelle Kriterium, wenn es sich von dem Standardsymbolsatz unterscheidet, wird andernfalls null zurückgegeben.
formula Eine Zahl oder eine Formel, je nach Typ.
operator greaterThan oder greaterThanOrEqual für jeden Regeltyp für das bedingte Symbolformat.
type Die Basis für die bedingte Symbolformel.
ConditionalPresetCriteriaRule Kriterium Das Kriterium des bedingten Formats.
ConditionalRangeBorder color HTML-Farbcode, der die Farbe der Rahmenlinie in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt.
sideIndex Konstanter Wert, der die bestimmte Seiten des Rahmens angibt.
style Einer der Konstanten der Linienart, die die Linienart für den Rahmen angibt.
ConditionalRangeBorderCollection bottom Ruft den unteren Rahmen ab.
count Die Anzahl der Rahmen-Objekte in der Auflistung.
getItem(index: Excel.ConditionalRangeBorderIndex) Ruft ein Rahmen-Objekt ab, das den Namen verwendet
getItemAt(index: number) Ruft ein Rahmen-Objekt ab, das den Namen verwendet
items Ruft die geladenen untergeordneten Elemente in dieser Sammlung ab.
left Ruft den linken Rahmen ab.
right Ruft den rechten Rahmen ab.
top Ruft den oberen Rahmen ab.
ConditionalRangeFill clear() Setzt die Füllung zurück.
color HTML-Farbcode, der die Farbe der Füllung darstellt, im Formular #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "Orange").
ConditionalRangeFont bold Gibt an, ob die Schriftart fett formatiert ist.
clear() Setzt die Schriftartformate zurück.
color HTML-Farbcodedarstellung der Textfarbe (z. B. #FF0000 steht für Rot).
italic Gibt an, ob die Schriftart kursiv ist.
strikethrough Gibt die durchgestrichene status der Schriftart an.
underline Der Auf die Schriftart angewendete Unterstreichungstyp.
ConditionalRangeFormat borders Auflistung von Rahmenobjekten, die für den gesamten bedingten Formatbereich gelten.
fill Gibt das Füllobjekt zurück, das für den gesamten bedingten Formatbereich definiert ist.
font Gibt das Schriftartobjekt zurück, das für den allgemeinen bedingten Formatbereich definiert ist.
Numberformat Stellt den Zahlenformatcode von Excel für den angegebenen Bereich dar.
ConditionalTextComparisonRule operator Der Operator des bedingten Textformats.
text Der Textwert des bedingten Formats.
ConditionalTopBottomRule rank Der Rang zwischen 1 und 1000 für numerische Ränge oder 1 und 100 als Prozentränge.
type Formatieren Sie Werte basierend auf dem oberen oder unteren Rang.
CustomConditionalFormat format Gibt ein Formatobjekt zurück, das die Schriftart, Füllung, Rahmen und andere Eigenschaften für bedingte Formate kapselt.
Regel Gibt das Rule -Objekt in diesem bedingten Format an.
DataBarConditionalFormat axisColor HTML-Farbcode, der die Farbe der Achsenlinie in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt.
Axisformat Darstellung, wie die Achse für einen Excel-Datenbalken bestimmt wird.
barDirection Gibt die Richtung an, auf der die Datenbalkengrafik basieren soll.
lowerBoundRule Die Regel, was die untere Grenze (und wie sie ggf. berechnet wird) für einen Datenbalken.
negativeFormat Darstellung aller Werte links von der Achse in einer Excel-Datenleiste.
positiveFormat Darstellung aller Werte rechts neben der Achse in einem Excel-Datenbalken.
showDataBarOnly Bei truewerden die Werte in den Zellen ausgeblendet, in denen der Datenbalken angewendet wird.
upperBoundRule Die Regel, die bestimmt, was die obere Grenze für einen Datenbalken darstellt (und wie diese ggf. berechnet wird).
IconSetConditionalFormat Kriterien Ein Array von Kriterien und Symbolsätzen für die Regeln und potenzielle benutzerdefinierte Symbole für bedingte Symbole.
reverseIconOrder Gibt truean, dass die Symbolreihenfolgen für den Symbolsatz umgekehrt werden.
showIconOnly Bei truewerden die Werte ausgeblendet und nur Symbole angezeigt.
style Wenn festgelegt, wird die Symbolsatzoption für das bedingte Format angezeigt.
PresetCriteriaConditionalFormat format Gibt ein Formatobjekt zurück, das die Schriftart, Füllung, Rahmen und andere Eigenschaften für bedingte Formate kapselt.
Regel Die Regel des bedingten Formats.
Range calculate() Berechnet einen Zellbereich auf einem Arbeitsblatt.
conditionalFormats Die Auflistung von ConditionalFormats , die den Bereich überschneidet.
TextConditionalFormat format Gibt ein Formatobjekt zurück, das die Schriftart, die Füllung, die Rahmen und andere Eigenschaften des bedingten Formats kapselt.
Regel Die Regel des bedingten Formats.
TopBottomConditionalFormat format Gibt ein Formatobjekt zurück, das die Schriftart, die Füllung, die Rahmen und andere Eigenschaften des bedingten Formats kapselt.
Regel Die Kriterien des bedingten Formats oben/unten.
Arbeitsblatt calculate(markAllDirty: boolean) Berechnet alle Zellen auf einem Arbeitsblatt.

Siehe auch