Freigeben über


Excel.Interfaces.ConditionalFormatLoadOptions interface

Ein Objekt, das den Bereich, das Format, die Regel und andere Eigenschaften eines bedingten Formats kapselt. Weitere Informationen zum Objektmodell für bedingte Formatierung finden Sie unter Anwenden der bedingten Formatierung auf Excel-Bereiche.

Hinweise

[ API-Satz: ExcelApi 1.6 ]

Eigenschaften

$all

Wenn Sie $all für die Ladeoptionen angeben, werden alle skalaren Eigenschaften (zRange.address. B. ) geladen, aber nicht die Navigationseigenschaften (zRange.format.fill.color. B. ).

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.

custom

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.

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.

preset

Gibt das bedingte Format der voreingestellten Kriterien zurück. Weitere Details finden Sie unter Excel.PresetCriteriaConditionalFormat.

presetOrNullObject

Gibt das bedingte Format der voreingestellten Kriterien zurück. Weitere Details finden Sie unter Excel.PresetCriteriaConditionalFormat.

priority

Die Priorität (oder der Index) in der Auflistung des bedingten Formats, in der dieses bedingte Format derzeit vorhanden ist. Wenn Sie dies ändern, ändern sich auch die Prioritäten anderer bedingter Formate, 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 Begrenzungen sind, werden 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 dieser neuen Prioritätsposition abrufen müssen, wenn Sie weitere Änderungen daran vornehmen möchten.

stopIfTrue

Wenn die Bedingungen dieses bedingten Formats erfüllt sind, werden keine Formate niedrigerer Priorität für diese Zelle wirksam. Der Wert ergibt sich null aus Datenbalken, Symbolsätzen und Farbskalen, da es für diese kein Konzept von StopIfTrue gibt.

textComparison

Gibt die spezifischen Eigenschaften des bedingten Textformats zurück, wenn das aktuelle bedingte Format ein Texttyp ist. Beispielsweise, um Zellen zu formatieren, die dem Wort "Text" entsprechen.

textComparisonOrNullObject

Gibt die spezifischen Eigenschaften des bedingten Textformats zurück, wenn das aktuelle bedingte Format ein Texttyp ist. Beispielsweise, um Zellen zu formatieren, die dem Wort "Text" entsprechen.

topBottom

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

topBottomOrNullObject

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

type

Ein Typ des bedingten Formats. Es kann jeweils nur eine festgelegt werden.

Details zur Eigenschaft

$all

Wenn Sie $all für die Ladeoptionen angeben, werden alle skalaren Eigenschaften (zRange.address. B. ) geladen, aber nicht die Navigationseigenschaften (zRange.format.fill.color. B. ).

$all?: boolean;

Eigenschaftswert

boolean

cellValue

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

cellValue?: Excel.Interfaces.CellValueConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

cellValueOrNullObject

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

cellValueOrNullObject?: Excel.Interfaces.CellValueConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

colorScale

Gibt die Eigenschaften des bedingten Formats der Farbskala zurück, wenn das aktuelle bedingte Format ein ColorScale Typ ist.

colorScale?: Excel.Interfaces.ColorScaleConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

colorScaleOrNullObject

Gibt die Eigenschaften des bedingten Formats der Farbskala zurück, wenn das aktuelle bedingte Format ein ColorScale Typ ist.

colorScaleOrNullObject?: Excel.Interfaces.ColorScaleConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

custom

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

custom?: Excel.Interfaces.CustomConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

customOrNullObject

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

customOrNullObject?: Excel.Interfaces.CustomConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

dataBar

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

dataBar?: Excel.Interfaces.DataBarConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

dataBarOrNullObject

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

dataBarOrNullObject?: Excel.Interfaces.DataBarConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

iconSet

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

iconSet?: Excel.Interfaces.IconSetConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

iconSetOrNullObject

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

iconSetOrNullObject?: Excel.Interfaces.IconSetConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

id

Die Priorität des bedingten Formats im aktuellen ConditionalFormatCollection.

id?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.6 ]

preset

Gibt das bedingte Format der voreingestellten Kriterien zurück. Weitere Details finden Sie unter Excel.PresetCriteriaConditionalFormat.

preset?: Excel.Interfaces.PresetCriteriaConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

presetOrNullObject

Gibt das bedingte Format der voreingestellten Kriterien zurück. Weitere Details finden Sie unter Excel.PresetCriteriaConditionalFormat.

presetOrNullObject?: Excel.Interfaces.PresetCriteriaConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

priority

Die Priorität (oder der Index) in der Auflistung des bedingten Formats, in der dieses bedingte Format derzeit vorhanden ist. Wenn Sie dies ändern, ändern sich auch die Prioritäten anderer bedingter Formate, 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 Begrenzungen sind, werden 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 dieser neuen Prioritätsposition abrufen müssen, wenn Sie weitere Änderungen daran vornehmen möchten.

priority?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.6 ]

stopIfTrue

Wenn die Bedingungen dieses bedingten Formats erfüllt sind, werden keine Formate niedrigerer Priorität für diese Zelle wirksam. Der Wert ergibt sich null aus Datenbalken, Symbolsätzen und Farbskalen, da es für diese kein Konzept von StopIfTrue gibt.

stopIfTrue?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.6 ]

textComparison

Gibt die spezifischen Eigenschaften des bedingten Textformats zurück, wenn das aktuelle bedingte Format ein Texttyp ist. Beispielsweise, um Zellen zu formatieren, die dem Wort "Text" entsprechen.

textComparison?: Excel.Interfaces.TextConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

textComparisonOrNullObject

Gibt die spezifischen Eigenschaften des bedingten Textformats zurück, wenn das aktuelle bedingte Format ein Texttyp ist. Beispielsweise, um Zellen zu formatieren, die dem Wort "Text" entsprechen.

textComparisonOrNullObject?: Excel.Interfaces.TextConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

topBottom

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

topBottom?: Excel.Interfaces.TopBottomConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

topBottomOrNullObject

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

topBottomOrNullObject?: Excel.Interfaces.TopBottomConditionalFormatLoadOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.6 ]

type

Ein Typ des bedingten Formats. Es kann jeweils nur eine festgelegt werden.

type?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.6 ]