ColorType.Tint Eigenschaft

Definition

Namespace:

DocumentFormat.OpenXml.Spreadsheet

Assembly:

DocumentFormat.OpenXml.dll

Paket:

DocumentFormat.OpenXml v3.0.1

Farbton

Stellt das folgende Attribut im Schema dar: tint

public DocumentFormat.OpenXml.DoubleValue? Tint { get; set; }

member this.Tint : DocumentFormat.OpenXml.DoubleValue with get, set

Public Property Tint As DoubleValue

Eigenschaftswert

DoubleValue

Gibt zurück DoubleValue.

Hinweise

Die folgenden Informationen aus dem INTERNATIONALEN ECMA-Standard ECMA-376 können bei der Arbeit mit dieser Klasse nützlich sein.

Gibt den Farbtonwert an, der auf die Farbe angewendet wird.

Wenn tint angegeben wird, wird er auf den RGB-Wert der Farbe angewendet, um die endgültige angewendete Farbe zu bestimmen.

Der tint Wert wird als Double von −1,0 gespeichert. 1.0, wobei −1,0 100 % abdunkelt und 1,0 100 % aufhellen bedeutet. Außerdem bedeutet 0.0 keine Änderung.

Beim Laden des RGB-Werts wird er in HLS konvertiert, wobei HLS-Werte (0.) sind. HLSMAX), wobei HLSMAX derzeit 255 ist.

Hier sind einige Beispiele für das Anwenden von Farbton auf Farben:

Wenn (Tönung < 0)

Lum' = Lum * (1,0 + Tönung)

Beispiel: Lum = 200; tint = −0,5; 50 % abdunkelt

Lum' = 200 * (0,5) => 100

Beispiel: Lum = 200; tint = −1,0; 100% abdunkeln (schwarz machen)

Lum' = 200 * (1,0 − 1,0) => 0

Wenn (Tönung > 0)

Lum' = Lum * (1,0 − Tönung) + (HLSMAX – HLSMAX * (1,0 − Tönung))

Beispiel: Lum = 100; tint = 0,75; 75 % aufhellen

Lum' = 100 * (1 − 0,75) + (HLSMAX – HLSMAX * (1 − 0,75))

= 100 * 0,25 + (255 – 255 * 0,25)

= 25 + (255 – 63) = 25 + 192 = 217

Beispiel: Lum = 100; tint = 1,0; 100 % aufhellen (weiß machen)

Lum' = 100 * (1 − 1) + (HLSMAX – HLSMAX * (1 − 1))

= 100 * 0 + (255 – 255 * 0)

= 0 + (255 – 0) = 255

Die möglichen Werte für dieses Attribut werden durch den XML-Schemadatentyp double definiert.