2.5.161 XFPropColor

The XFPropColor structure specifies a color.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

A

xclrType

icv

nTintShade

dwRgba

A - fValidRGBA (1 bit): A bit that specifies whether the xclrType, icv and nTintShade fields are used to set the dwRgba field.

xclrType (7 bits):  An unsigned integer that specifies how the color information is stored. This value MUST be a value from the following table:

Value

Meaning

0x00

Automatic foreground and background colors

0x01

Palette color. The value of icv MUST be less than or equal to 220.

0x02

RGBA color

0x03

Theme color. The value of icv MUST be less than or equal to 11.

0x04

Color not set.

icv (1 byte): An unsigned integer that specifies color information. The type and meaning of this field depends on the value of the xclrType field and is specified by the following tables.

Value of xclrType

Meaning of icv field

0x00

Undefined and MUST be ignored.

0x01

An Icv (section 2.5.76) that specifies a color from a color palette.

0x02

Undefined and MUST be ignored.

0x03

An unsigned integer that specifies a subelement of the clrScheme element in the Theme (section 2.1.7.52) part ABNF, as defined in [ISO/IEC29500-1:2016], section 20.1.6.2, that specifies a color. The following table specifies which subelement of clrScheme to use for each legal value of the index.

    

Value of index

Sub-element of clrScheme

0x00

dk1

0x01

lt1

0x02

dk2

0x03

lt2

0x04

accent1

0x05

accent2

0x06

accent3

0x07

accent4

0x08

accent5

0x09

accent6

0x0A

hlink

0x0B

folHlink

nTintShade (2 bytes): A signed integer that specifies the tint of the color. This value is mapped to the range -1.0 to 1.0. Positive values lighten the color and negative values darken the color. This value MUST NOT equal -32768.

dwRgba (4 bytes): A LongRGBA (section 2.5.90) structure that specifies the color.