ExcelScript.ConditionalFormat interface

Ein Objekt, das den Bereich, das Format, die Regel und andere Eigenschaften eines bedingten Formats kapselt.

Methoden

delete()

Löscht dieses bedingte Format.

getCellValue()

Gibt die Eigenschaften des bedingten Zellwertformats zurück, wenn das aktuelle bedingte Format ein CellValue Typ ist.

getColorScale()

Gibt die Bedingten Formateigenschaften der Farbskala zurück, wenn das aktuelle bedingte Format ein ColorScale Typ ist.

getCustom()

Gibt die benutzerdefinierten Eigenschaften des bedingten Formats zurück, wenn das aktuelle bedingte Format ein benutzerdefinierter Typ ist.

getDataBar()

Gibt die Datenbalkeneigenschaften zurück, wenn das aktuelle bedingte Format ein Datenbalken ist.

getIconSet()

Gibt die Eigenschaften für das bedingte Format des Symbolsatzes zurück, wenn es sich bei dem aktuellen bedingten Format um einen IconSet Typ handelt.

getId()

Die Priorität des bedingten Formats im aktuellen ConditionalFormatCollection.

getPreset()

Gibt das voreingestellte kriterienbedingte Format zurück. Weitere Details finden Sie unter ExcelScript.PresetCriteriaConditionalFormat.

getPriority()

Die Priorität (oder der Index) innerhalb der Bedingten Formatsammlung, in der dieses bedingte Format derzeit vorhanden ist. Wenn Sie dies ändern, werden auch die Prioritäten anderer bedingter Formate geändert, um eine zusammenhängende Prioritätsreihenfolge zu ermöglichen. Verwenden Sie eine negative Priorität, um von hinten zu beginnen. Prioritäten, die größer als die Grenzen sind, werden abgerufen und auf die maximale (oder minimale, wenn negative) Priorität festgelegt. Beachten Sie außerdem, dass Sie beim Ändern der Priorität eine neue Kopie des Objekts an diesem neuen Prioritätsort erneut abrufen müssen, wenn Sie weitere Änderungen daran vornehmen möchten.

getRange()

Gibt den Bereich zurück, auf den das konditonale Format angewendet wird. Wenn das bedingte Format auf mehrere Bereiche angewendet wird, gibt diese Funktion ein Objekt zurück, dessen isNullObject Eigenschaft auf true.

getRanges()

Gibt die RangeAreasaus einem oder mehreren rechteckigen Bereichen, auf die das konditonale Format angewendet wird.

getStopIfTrue()

Wenn die Bedingungen dieses bedingten Formats erfüllt sind, werden keine Formate niedrigerer Priorität für diese Zelle wirksam. Der Wert befindet sich null auf Datenbalken, Symbolsätzen und Farbskalen, da hierfür kein Konzept vorhanden StopIfTrue ist.

getTextComparison()

Gibt die spezifischen Eigenschaften des bedingten Textformats zurück, wenn das aktuelle bedingte Format ein Texttyp ist. Beispielsweise zum Formatieren von Zellen, die mit dem Wort "Text" übereinstimmen.

getTopBottom()

Gibt die Eigenschaften des oberen/unteren bedingten Formats zurück, wenn das aktuelle bedingte Format ein TopBottom Typ ist. Beispielsweise zum Formatieren der obersten 10 % oder der unteren 10 Elemente.

getType()

Ein Typ von bedingtem Format. Es kann jeweils nur ein Wert festgelegt werden.

setPriority(priority)

Die Priorität (oder der Index) innerhalb der Bedingten Formatsammlung, in der dieses bedingte Format derzeit vorhanden ist. Wenn Sie dies ändern, werden auch die Prioritäten anderer bedingter Formate geändert, um eine zusammenhängende Prioritätsreihenfolge zu ermöglichen. Verwenden Sie eine negative Priorität, um von hinten zu beginnen. Prioritäten, die größer als die Grenzen sind, werden abgerufen und auf die maximale (oder minimale, wenn negative) Priorität festgelegt. Beachten Sie außerdem, dass Sie beim Ändern der Priorität eine neue Kopie des Objekts an diesem neuen Prioritätsort erneut abrufen müssen, wenn Sie weitere Änderungen daran vornehmen möchten.

setStopIfTrue(stopIfTrue)

Wenn die Bedingungen dieses bedingten Formats erfüllt sind, werden keine Formate niedrigerer Priorität für diese Zelle wirksam. Der Wert befindet sich null auf Datenbalken, Symbolsätzen und Farbskalen, da hierfür kein Konzept vorhanden StopIfTrue ist.

Details zur Methode

delete()

Löscht dieses bedingte Format.

delete(): void;

Gibt zurück

void

getCellValue()

Gibt die Eigenschaften des bedingten Zellwertformats zurück, wenn das aktuelle bedingte Format ein CellValue Typ ist.

getCellValue(): CellValueConditionalFormat | undefined;

Gibt zurück

getColorScale()

Gibt die Bedingten Formateigenschaften der Farbskala zurück, wenn das aktuelle bedingte Format ein ColorScale Typ ist.

getColorScale(): ColorScaleConditionalFormat | undefined;

Gibt zurück

getCustom()

Gibt die benutzerdefinierten Eigenschaften des bedingten Formats zurück, wenn das aktuelle bedingte Format ein benutzerdefinierter Typ ist.

getCustom(): CustomConditionalFormat | undefined;

Gibt zurück

getDataBar()

Gibt die Datenbalkeneigenschaften zurück, wenn das aktuelle bedingte Format ein Datenbalken ist.

getDataBar(): DataBarConditionalFormat | undefined;

Gibt zurück

getIconSet()

Gibt die Eigenschaften für das bedingte Format des Symbolsatzes zurück, wenn es sich bei dem aktuellen bedingten Format um einen IconSet Typ handelt.

getIconSet(): IconSetConditionalFormat | undefined;

Gibt zurück

getId()

Die Priorität des bedingten Formats im aktuellen ConditionalFormatCollection.

getId(): string;

Gibt zurück

string

getPreset()

Gibt das voreingestellte kriterienbedingte Format zurück. Weitere Details finden Sie unter ExcelScript.PresetCriteriaConditionalFormat.

getPreset(): PresetCriteriaConditionalFormat | undefined;

Gibt zurück

getPriority()

Die Priorität (oder der Index) innerhalb der Bedingten Formatsammlung, in der dieses bedingte Format derzeit vorhanden ist. Wenn Sie dies ändern, werden auch die Prioritäten anderer bedingter Formate geändert, um eine zusammenhängende Prioritätsreihenfolge zu ermöglichen. Verwenden Sie eine negative Priorität, um von hinten zu beginnen. Prioritäten, die größer als die Grenzen sind, werden abgerufen und auf die maximale (oder minimale, wenn negative) Priorität festgelegt. Beachten Sie außerdem, dass Sie beim Ändern der Priorität eine neue Kopie des Objekts an diesem neuen Prioritätsort erneut abrufen müssen, wenn Sie weitere Änderungen daran vornehmen möchten.

getPriority(): number;

Gibt zurück

number

getRange()

Gibt den Bereich zurück, auf den das konditonale Format angewendet wird. Wenn das bedingte Format auf mehrere Bereiche angewendet wird, gibt diese Funktion ein Objekt zurück, dessen isNullObject Eigenschaft auf true.

getRange(): Range;

Gibt zurück

getRanges()

Gibt die RangeAreasaus einem oder mehreren rechteckigen Bereichen, auf die das konditonale Format angewendet wird.

getRanges(): RangeAreas;

Gibt zurück

getStopIfTrue()

Wenn die Bedingungen dieses bedingten Formats erfüllt sind, werden keine Formate niedrigerer Priorität für diese Zelle wirksam. Der Wert befindet sich null auf Datenbalken, Symbolsätzen und Farbskalen, da hierfür kein Konzept vorhanden StopIfTrue ist.

getStopIfTrue(): boolean;

Gibt zurück

boolean

getTextComparison()

Gibt die spezifischen Eigenschaften des bedingten Textformats zurück, wenn das aktuelle bedingte Format ein Texttyp ist. Beispielsweise zum Formatieren von Zellen, die mit dem Wort "Text" übereinstimmen.

getTextComparison(): TextConditionalFormat | undefined;

Gibt zurück

getTopBottom()

Gibt die Eigenschaften des oberen/unteren bedingten Formats zurück, wenn das aktuelle bedingte Format ein TopBottom Typ ist. Beispielsweise zum Formatieren der obersten 10 % oder der unteren 10 Elemente.

getTopBottom(): TopBottomConditionalFormat | undefined;

Gibt zurück

getType()

Ein Typ von bedingtem Format. Es kann jeweils nur ein Wert festgelegt werden.

getType(): ConditionalFormatType;

Gibt zurück

setPriority(priority)

Die Priorität (oder der Index) innerhalb der Bedingten Formatsammlung, in der dieses bedingte Format derzeit vorhanden ist. Wenn Sie dies ändern, werden auch die Prioritäten anderer bedingter Formate geändert, um eine zusammenhängende Prioritätsreihenfolge zu ermöglichen. Verwenden Sie eine negative Priorität, um von hinten zu beginnen. Prioritäten, die größer als die Grenzen sind, werden abgerufen und auf die maximale (oder minimale, wenn negative) Priorität festgelegt. Beachten Sie außerdem, dass Sie beim Ändern der Priorität eine neue Kopie des Objekts an diesem neuen Prioritätsort erneut abrufen müssen, wenn Sie weitere Änderungen daran vornehmen möchten.

setPriority(priority: number): void;

Parameter

priority

number

Gibt zurück

void

setStopIfTrue(stopIfTrue)

Wenn die Bedingungen dieses bedingten Formats erfüllt sind, werden keine Formate niedrigerer Priorität für diese Zelle wirksam. Der Wert befindet sich null auf Datenbalken, Symbolsätzen und Farbskalen, da hierfür kein Konzept vorhanden StopIfTrue ist.

setStopIfTrue(stopIfTrue: boolean): void;

Parameter

stopIfTrue

boolean

Gibt zurück

void