Neuigkeiten in der Excel-JavaScript-API 1.6

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.
  • Bietet Priorität und stopifTrue Funktionalität.
  • 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. Die 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 im Anforderungssatz 1.6 oder früher.

Klasse Felder Beschreibung
Anwendung suspendApiCalculationUntilNextSync() Hält die Berechnung an, bis der nächste context.sync() aufgerufen wird.
CellValueConditionalFormat format Gibt ein Format-Objekt zurück, das die bedingten Formatierungen Schriftart, Füllung, Rahmen und andere Eigenschaften 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 zur bedingten Formatierung ausgewertet werden soll.
Formel2 Die Formel, falls erforderlich, für die die Regel zur bedingten Formatierung ausgewertet werden soll.
operator Der Operator des bedingten Zellwertformats.
ConditionalColorScaleCriteria maximum Der maximale Punkt des Farbskalierungskriteriums.
Mittelpunkt Der Mittelpunkt des Farbskala-Kriteriums, wenn es sich bei der Farbskala um eine 3-Farben-Skala handelt.
minimum Der niedrigste Punkt des Farbskala-Kriteriums.
ConditionalColorScaleCriterion color HTML-Farbcodedarstellung der Farbe der Farbskala (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 darstellt, im Format #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange").
fillColor HTML-Farbcode, der die Füllfarbe darstellt, im Format #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange").
matchPositiveBorderColor Gibt an, ob der negative Datenbalken die gleiche Rahmenfarbe hat wie der positive Datenbalken.
matchPositiveFillColor Gibt an, ob der negative Datenbalken die gleiche Füllfarbe hat wie der positive Datenbalken.
ConditionalDataBarPositiveFormat borderColor HTML-Farbcode, der die Farbe der Rahmenlinie darstellt, im Format #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange").
fillColor HTML-Farbcode, der die Füllfarbe darstellt, im Format #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange").
gradientFill Gibt an, ob der Datenbalken einen Farbverlauf aufweist.
ConditionalDataBarRule formula Die Formel, auf deren Grundlage die Datenbalkenregel ausgewertet werden soll, falls erforderlich.
type Der Regeltyp für den Datenbalken.
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.
Benutzerdefiniert 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 Eigenschaften des Datenbalkens zurück, wenn das aktuelle bedingte Format ein Datenbalken ist.
dataBarOrNullObject Gibt die Eigenschaften des Datenbalkens 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 die bedingte Formatierung angewendet wird.
iconSet Gibt die Eigenschaften des Symbolsatzes für bedingtes Format zurück, wenn das aktuelle bedingte Format ein IconSet Typ ist.
iconSetOrNullObject Gibt die Eigenschaften des Symbolsatzes für bedingtes Format zurück, wenn das aktuelle bedingte Format ein IconSet Typ ist.
id Die Priorität der bedingten Formatierung 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) innerhalb der Auflistung bedingter Formate, 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 Formats für Text zurück, wenn das aktuelle bedingte Format eine Textart ist.
textComparisonOrNullObject Gibt die spezifischen Eigenschaften des bedingten Formats für Text zurück, wenn das aktuelle bedingte Format eine Textart 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 Eine Art bedingtes Format
ConditionalFormatCollection add(type: Excel.ConditionalFormatType) Fügt der Sammlung 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 zur bedingten Formatierung ausgewertet werden soll.
formulaLocal Die Formel, auf deren Grundlage die Regel zur bedingten Formatierung in der Sprache des Benutzers ausgewertet werden soll.
formulaR1C1 Die Formel, falls erforderlich, für die die Regel zur bedingten Formatierung in R1S1-Notation ausgewertet werden soll.
ConditionalIconCriterion customIcon Andernfalls null wird das benutzerdefinierte Symbol für das aktuelle Kriterium zurückgegeben, falls es vom Standardsymbolsatz abweicht.
formula Eine Zahl oder eine Formel, je nach Typ.
operator greaterThan oder greaterThanOrEqual für jeden der Regeltypen für das bedingte Format.
type Die Basis für die bedingte Symbolformel.
ConditionalPresetCriteriaRule Kriterien Das Kriterium des bedingten Formats.
ConditionalRangeBorder color HTML-Farbcode, der die Farbe der Rahmenlinie darstellt, im Format #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange").
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 Rand 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 Rand ab.
right Erhält den richtigen Rand.
top Ruft den oberen Rand 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 den durchgestrichenen Status der Schriftart an.
underline Der Typ der Unterstreichung, der auf die Schriftart angewendet wird.
ConditionalRangeFormat borders Sammlung von Rahmenobjekten, die für den gesamten Bereich der bedingten Formatierung gelten.
fill Gibt das Füllobjekt zurück, das für den gesamten Bereich der bedingten Formatierung definiert ist.
font Gibt das Schriftartobjekt zurück, das für den gesamten Bereich der bedingten Formatierung definiert ist.
numberFormat Stellt den Excel-Zahlenformatcode 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 Format-Objekt zurück, das die bedingten Formatierungen Schriftart, Füllung, Rahmen und andere Eigenschaften kapselt.
Regel Gibt das Rule Objekt mit diesem bedingten Format an.
DataBarConditionalFormat axisColor HTML-Farbcode, der die Farbe der Achsenlinie im Format #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt.
axisFormat Darstellung der Bestimmung der Achse für einen Excel-Datenbalken.
barDirection Gibt die Richtung an, auf der die Datenbalkengrafik basieren soll.
lowerBoundRule Die Regel, was die Untergrenze für einen Datenbalken darstellt (und wie sie berechnet wird, falls zutreffend)
negativeFormat Darstellung aller Werte links von der Achse in einem Excel-Datenbalken.
positiveFormat Darstellung aller Werte rechts von der Achse in einem Excel-Datenbalken.
showDataBarOnly Wenn true, blendet die Werte in den Zellen aus, auf die 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 mögliche benutzerdefinierte Symbole für bedingte Symbole.
reverseIconOrder If true, kehrt die Symbolreihenfolge für den Symbolsatz um.
showIconOnly Wenn true, werden die Werte ausgeblendet und nur Symbole angezeigt.
style Wenn aktiviert, wird die Option zum Symbolsatz für das bedingte Format angezeigt.
PresetCriteriaConditionalFormat format Gibt ein Format-Objekt zurück, das die bedingten Formatierungen Schriftart, Füllung, Rahmen und andere Eigenschaften kapselt.
Regel Die Regel des bedingten Formats.
Range calculate() Berechnet einen Zellbereich auf einem Arbeitsblatt.
conditionalFormats Die Sammlung dieser ConditionalFormats Schnittmenge den Bereich.
TextConditionalFormat format Gibt ein Format-Objekt zurück und kapselt die Schriftart, Füllung, Rahmen und andere Eigenschaften des bedingten Formats.
Regel Die Regel des bedingten Formats.
TopBottomConditionalFormat format Gibt ein Format-Objekt zurück und kapselt die Schriftart, Füllung, Rahmen und andere Eigenschaften des bedingten Formats.
Regel Die Kriterien für das obere/untere bedingte Format.
Arbeitsblatt calculate(markAllDirty: boolean) Berechnet alle Zellen auf einem Arbeitsblatt.

Siehe auch

  • Last updated on