2.5.161 XFPropColor
The XFPropColor structure specifies a color.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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.