ColorType.Tint プロパティ

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

Tint.スキーマの次の属性を表します。 tint

[DocumentFormat.OpenXml.SchemaAttr(0, "tint")]
public DocumentFormat.OpenXml.DoubleValue Tint { get; set; }

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

Public Property Tint As DoubleValue

DoubleValue を返します。

ECMA International Standard ECMA-376 の次の情報は、このクラスを操作するときに役立ちます。

色に適用される色の値を指定します。

指定された場合は、色の RGB 値に適用され、適用される最終的な色 tint が決定されます。

この tint 値は、-1.0 から 2 倍の値として格納されます。 1.0、-1.0 は 100% 暗く、1.0 は 100% 明るくなります。また、0.0 は変更を意味します。

RGB 値を読み込む場合、HLS 値が (0.) の HLS に変換されます。 HLSMAX)、HLSMAX は現在 255 です。

色に色合いを適用する方法の例を次に示します。

If (tint < 0)

Lum' = Lum * (1.0 + tint)

たとえば、Lum = 200;tint = -0.5;暗くする 50%

Lum' = 200 * (0.5) => 100

たとえば、Lum = 200;tint = -1.0;100% 暗くする (黒にする)

Lum' = 200 * (1.0 - 1.0) => 0

If (tint > 0)

Lum' = Lum * (1.0 - tint) + (HLSMAX – HLSMAX * (1.0 - tint))

たとえば、Lum = 100;tint = 0.75;明るい 75%

Lum' = 100 * (1 - 0.75) + (HLSMAX – HLSMAX * (1 - 0.75))

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

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

たとえば、Lum = 100;tint = 1.0;100% 軽くする (白にする)

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

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

= 0 + (255 – 0) = 255

この属性に使用できる値は、XML スキーマデータ型によって double 定義されます。