2.4.152 Legend

The Legend record specifies properties of a legend, and specifies the beginning of a collection of records defined by Chart Sheet Substream ABNF.  The collection of records specifies a legend.  The absence of this collection of records implies that a legend does not exist on the chart.


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

x

y

dx

dy

unused

wSpace

A

B

C

D

E

F

reserved2

x (4 bytes):  An unsigned integer that specifies the x-position, in SPRC, of the upper-left corner of the bounding rectangle of the legend. MUST be ignored and the x1 field from the following Pos record MUST be used instead.

y (4 bytes):  An unsigned integer that specifies the y-position, in SPRC, of the upper-left corner of the bounding rectangle of the legend. MUST be ignored and the y1 field from the following Pos record MUST be used instead.

dx (4 bytes):  An unsigned integer that specifies the width, in SPRC, of the bounding rectangle of the legend. MUST be ignored and the x2 field from the following Pos record MUST be used instead.

dy (4 bytes):  An unsigned integer that specifies the height, in SPRC, of the bounding rectangle of the legend. MUST be ignored and the y2 field from the following Pos record MUST be used instead.

unused (1 byte): Undefined and MUST be ignored.

wSpace (1 byte):  An unsigned integer that specifies the space between legend entries. MUST be 0x01, which represents 40 twips between legend entries.

A - fAutoPosition (1 bit):  A bit that specifies whether the legend is automatically positioned. If this field is 0x1, then fAutoPosX MUST be 0x1 and fAutoPosY MUST be 0x1.

B - reserved1 (1 bit): MUST be 1, and MUST be ignored.

C - fAutoPosX (1 bit):  A bit that specifies whether the x-positioning of the legend is automatic.

D - fAutoPosY (1 bit):  A bit that specifies whether the y-positioning of the legend is automatic.

E - fVert (1 bit):  A bit that specifies the layout of the legend entries. MUST equal 0x1 if fWasDataTable is equal to 0x1. MUST be a value from the following table:

Value

Meaning

0x0

The legend contains multiple columns of legend entries, or the size of the legend was manually changed from the default size.

0x1

The legend contains a single column of legend entries.

F - fWasDataTable (1 bit):  A bit that specifies whether the legend is shown in a data table.

reserved2 (10 bits): MUST be zero, and MUST be ignored.