Bases: xlwt.BIFFRecords.BiffRecord
This record contains a Boolean value determining whether Excel makes a backup of the file while saving.
Bases: xlwt.BIFFRecords.BiffRecord
Offset Size Contents 0 2 Version, contains 0600H for BIFF8 and BIFF8X 2 2 Type of the following data:
0005H = Workbook globals 0006H = Visual Basic module 0010H = Worksheet 0020H = Chart 0040H = Macro sheet 0100H = Workspace file
4 2 Build identifier 6 2 Build year 8 4 File history flags 12 4 Lowest Excel version that can read all records in this file
Bases: xlwt.BIFFRecords.BiffRecord
This record represents an empty cell.
Record BLANK, BIFF5-BIFF8:
Offset Size Contents 0 2 Index to row 2 2 Index to first column (fc) 4 2 indexes to XF record
Bases: xlwt.BIFFRecords.BiffRecord
This record contains a Boolean value determining whether to save values linked from external workbooks (CRN records and XCT records). In BIFF3 and BIFF4 this option is stored in the WSBOOL record.
Record BOOKBOOL, BIFF5-BIFF8:
Offset Size Contents 0 2 0 = Save external linked values;
1 = Do not save external linked values
Bases: xlwt.BIFFRecords.BiffRecord
This record represents a cell that contains a boolean or error value.
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Page Settings Block. It contains the bottom page margin of the current worksheet.
Offset Size Contents 0 8 Bottom page margin in inches
(IEEE 754 floating-point value, 64?bit double precision)
Bases: xlwt.BIFFRecords.BiffRecord
This record is located in the workbook globals area and represents a sheet inside of the workbook. For each sheet a BOUNDSHEET record is written. It stores the sheet name and a stream offset to the BOF record within the workbook stream. The record is also known as BUNDLESHEET.
Record BOUNDSHEET, BIFF5-BIFF8: Offset Size Contents 0 4 Absolute stream position of the BOF record of the sheet represented by this record. This
field is never encrypted in protected files.
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Calculation Settings Block. It specifies the maximum number of times the formulas should be iteratively calculated. This is a fail-safe against mutually recursive formulas locking up a spreadsheet application.
Record CALCCOUNT, BIFF2-BIFF8:
Offset Size Contents 0 2 Maximum number of iterations allowed in circular references
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Calculation Settings Block. It specifies whether to calculate formulas manually, automatically or automatically except for multiple table operations.
Record CALCMODE, BIFF2-BIFF8:
Offset Size Contents 0 2 FFFFH = automatic except for multiple table operations
0000H = manually 0001H = automatically (default)
Bases: xlwt.BIFFRecords.BiffRecord
This record stores the text encoding used to write byte strings, stored as MS Windows code page identifier. The CODEPAGE record in BIFF8 always contains the code page 1200 (UTF-16). Therefore it is not possible to obtain the encoding used for a protection password (it is not UTF-16).
Record CODEPAGE, BIFF2-BIFF8:
Offset Size Contents 0 2 Code page identifier used for byte string text encoding:
016FH = 367 = ASCII 01B5H = 437 = IBM PC CP-437 (US) 02D0H = 720 = IBM PC CP-720 (OEM Arabic) 02E1H = 737 = IBM PC CP-737 (Greek) 0307H = 775 = IBM PC CP-775 (Baltic) 0352H = 850 = IBM PC CP-850 (Latin I) 0354H = 852 = IBM PC CP-852 (Latin II (Central European)) 0357H = 855 = IBM PC CP-855 (Cyrillic) 0359H = 857 = IBM PC CP-857 (Turkish) 035AH = 858 = IBM PC CP-858 (Multilingual Latin I with Euro) 035CH = 860 = IBM PC CP-860 (Portuguese) 035DH = 861 = IBM PC CP-861 (Icelandic) 035EH = 862 = IBM PC CP-862 (Hebrew) 035FH = 863 = IBM PC CP-863 (Canadian (French)) 0360H = 864 = IBM PC CP-864 (Arabic) 0361H = 865 = IBM PC CP-865 (Nordic) 0362H = 866 = IBM PC CP-866 (Cyrillic (Russian)) 0365H = 869 = IBM PC CP-869 (Greek (Modern)) 036AH = 874 = Windows CP-874 (Thai) 03A4H = 932 = Windows CP-932 (Japanese Shift-JIS) 03A8H = 936 = Windows CP-936 (Chinese Simplified GBK) 03B5H = 949 = Windows CP-949 (Korean (Wansung)) 03B6H = 950 = Windows CP-950 (Chinese Traditional BIG5) 04B0H = 1200 = UTF-16 (BIFF8) 04E2H = 1250 = Windows CP-1250 (Latin II) (Central European) 04E3H = 1251 = Windows CP-1251 (Cyrillic) 04E4H = 1252 = Windows CP-1252 (Latin I) (BIFF4-BIFF7) 04E5H = 1253 = Windows CP-1253 (Greek) 04E6H = 1254 = Windows CP-1254 (Turkish) 04E7H = 1255 = Windows CP-1255 (Hebrew) 04E8H = 1256 = Windows CP-1256 (Arabic) 04E9H = 1257 = Windows CP-1257 (Baltic) 04EAH = 1258 = Windows CP-1258 (Vietnamese) 0551H = 1361 = Windows CP-1361 (Korean (Johab)) 2710H = 10000 = Apple Roman 8000H = 32768 = Apple Roman 8001H = 32769 = Windows CP-1252 (Latin I) (BIFF2-BIFF3)
Bases: xlwt.BIFFRecords.BiffRecord
This record specifies the width for a given range of columns. If a column does not have a corresponding COLINFO record, the width specified in the record STANDARDWIDTH is used. If this record is also not present, the contents of the record DEFCOLWIDTH is used instead. This record also specifies a default XF record to use for cells in the columns that are not described by any cell record (which contain the XF index for that cell). Additionally, the option flags field contains hidden, outline, and collapsed options applied at the columns.
Record COLINFO, BIFF3-BIFF8:
Offset Size Contents 0 2 Index to first column in the range 2 2 Index to last column in the range 4 2 Width of the columns in 1/256 of the width of the zero character, using default font
(first FONT record in the file)
6 2 Index to XF record for default column formatting 8 2 Option flags:
Bits Mask Contents 0 0001H 1 = Columns are hidden 10-8 0700H Outline level of the columns (0 = no outline) 12 1000H 1 = Columns are collapsed
10 2 Not used
Bases: xlwt.BIFFRecords.BiffRecord
Whenever the content of a record exceeds the given limits (see table), the record must be split. Several CONTINUE records containing the additional data are added after the parent record.
BIFF version Maximum data size of a record BIFF2-BIFF7 2080 bytes (2084 bytes including record header) BIFF8 8224 bytes (8228 bytes including record header) (0x2020)
Record CONTINUE, BIFF2-BIFF8: Offset Size Contents 0 var. Data continuation of the previous record
Unicode strings are split in a special way. At the beginning of each CONTINUE record the option flags byte is repeated. Only the character size flag will be set in this flags byte, the Rich-Text flag and the Far-East flag are set to zero. In each CONTINUE record it is possible that the character size changes from 8-bit characters to 16-bit characters and vice versa.
Never a Unicode string is split until and including the first character. That means, all header fields (string length, option flags, optional Rich-Text size, and optional Far-East data size) and the first character of the string have to occur together in the leading record, or have to be moved completely into the CONTINUE record. Formatting runs cannot be split between their components (character index and FONT record index). If a string is split between two formatting runs, the option flags field will not be repeated in the CONTINUE record.
Bases: xlwt.BIFFRecords.BiffRecord
This record stores two Windows country identifiers. The first represents the user interface language of the Excel version that has saved the file, and the second represents the system regional settings at the time the file was saved.
Record COUNTRY, BIFF3-BIFF8:
Offset Size Contents 0 2 Windows country identifier of the user interface language of Excel 2 2 Windows country identifier of the system regional settings
The following table shows most of the used country identifiers. Most of these identifiers are equal to the international country calling codes.
1 USA 2 Canada 7 Russia
Bases: xlwt.BIFFRecords.BiffRecord
This record specifies if the file contains an additional BIFF5/BIFF7 workbook stream. Record DSF, BIFF8: Offset Size Contents 0 2 0 = Only the BIFF8 Workbook stream is present
1 = Additional BIFF5/BIFF7 Book stream is in the file
A double stream file can be read by Excel 5.0 and Excel 95, and still contains all new features added to BIFF8 (which are left out in the BIFF5/BIFF7 Book stream).
Bases: xlwt.BIFFRecords.BiffRecord
This record specifies the base date for displaying date values. All dates are stored as count of days past this base date. In BIFF2-BIFF4 this record is part of the Calculation Settings Block. In BIFF5-BIFF8 it is stored in the Workbook Globals Substream.
Record DATEMODE, BIFF2-BIFF8:
Offset Size Contents 0 2 0 = Base is 1899-Dec-31 (the cell = 1 represents 1900-Jan-01)
1 = Base is 1904-Jan-01 (the cell = 1 represents 1904-Jan-02)
Bases: xlwt.BIFFRecords.BiffRecord
This record specifies the default column width for columns that do not have a specific width set using the record COLINFO or COLWIDTH. This record has no effect, if a STANDARDWIDTH record is present in the file.
Record DEFCOLWIDTH, BIFF2-BIFF8:
Offset Size Contents 0 2 Column width in characters, using the width of the zero
character from default font (first FONT record in the file)
Bases: xlwt.BIFFRecords.BiffRecord
This record specifies the default height and default flags for rows that do not have a corresponding ROW record.
Record DEFAULTROWHEIGHT, BIFF3-BIFF8:
Offset Size Contents 0 2 Option flags:
Bit Mask Contents 0 0001H 1 = Row height and default font height do not match 1 0002H 1 = Row is hidden 2 0004H 1 = Additional space above the row 3 0008H 1 = Additional space below the row
2 2 Default height for unused rows, in twips = 1/20 of a point
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Calculation Settings Block. It stores the maximum change of the result to exit an iteration.
Record DELTA, BIFF2-BIFF8:
Offset Size Contents 0 8 Maximum change in iteration
- (IEEE 754 floating-point value,
- 64bit double precision)
Bases: xlwt.BIFFRecords.BiffRecord
Record DIMENSIONS, BIFF8:
Offset Size Contents 0 4 Index to first used row 4 4 Index to last used row, increased by 1 8 2 Index to first used column 10 2 Index to last used column, increased by 1 12 2 Not used
Bases: xlwt.BIFFRecords.BiffRecord
Bases: xlwt.BIFFRecords.BiffRecord
This record occurs in conjunction with the SST record. It is used by Excel to create a hash table with stream offsets to the SST record to optimise string search operations. Excel may not shorten this record if strings are deleted from the shared string table, so the last part might contain invalid data. The stream indexes in this record divide the SST into portions containing a constant number of strings.
Record EXTSST, BIFF8:
Offset Size Contents 0 2 Number of strings in a portion, this number is >=8 2 var. List of OFFSET structures for all portions. Each OFFSET contains the following data:
Offset Size Contents 0 4 Absolute stream position of first string of the portion 4 2 Position of first string of the portion inside of current record,
including record header. This counter restarts at zero, if the SST record is continued with a CONTINUE record.6 2 Not used
Bases: xlwt.BIFFRecords.BiffRecord
In BIFF8 the record stores a list with indexes to SUPBOOK records (list of REF structures, 6.100). See 5.10.3 for details about external references in BIFF8.
Record EXTERNSHEET, BIFF8: Offset Size Contents
0 2 Number of following REF structures (nm) 2 6nm List of nm REF structures. Each REF contains the following data:
- Offset Size Contents
- 0 2 Index to SUPBOOK record 2 2 Index to first SUPBOOK sheet 4 2 Index to last SUPBOOK sheet
Bases: xlwt.BIFFRecords.BiffRecord
Record EXTERNNAME for external names and Analysis add-in functions, BIFF5-BIFF8: Offset Size Contents 0 2 Option flags (see below) 2 2 0 for global names, or:
BIFF5: One-based index to EXTERNSHEET record containing the sheet name, BIFF8: One-based index to sheet list in preceding EXTERNALBOOK record.
4 2 Not used 6 var. BIFF5: Name (byte string, 8-bit string length, ?2.5.2).
BIFF8: Name (Unicode string, 8-bit string length, ?2.5.3). See DEFINEDNAME record (?5.33) for a list of built-in names, if the built-in flag is set in the option flags above.
var. var. Formula data (RPN token array, ?3)
Option flags for external names (BIFF5-BIFF8) Bit Mask Contents 0 0001H 0 = Standard name; 1 = Built-in name 1 0002H 0 = Manual link; 1 = Automatic link (DDE links and OLE links only) 2 0004H 1 = Picture link (DDE links and OLE links only) 3 0008H 1 = This is the “StdDocumentName” identifier (DDE links only) 4 0010H 1 = OLE link 14-5 7FE0H Clipboard format of last successful update (DDE links and OLE links only) 15 8000H 1 = Iconified picture link (BIFF8 OLE links only)
Bases: xlwt.BIFFRecords.BiffRecord
Bases: xlwt.BIFFRecords.BiffRecord
Offset Size Contents 0 2 Height of the font (in twips = 1/20 of a point) 2 2 Option flags:
Bit Mask Contents 0 0001H 1 = Characters are bold (redundant, see below) 1 0002H 1 = Characters are italic 2 0004H 1 = Characters are underlined (redundant, see below) 3 0008H 1 = Characters are struck out
0010H 1 = Outline 0020H 1 = Shadow
4 2 Colour index 6 2 Font weight (100-1000).
Standard values are 0190H (400) for normal text and 02BCH (700) for bold text.
13 1 Not used 14 var. Font name:
BIFF5/BIFF7: Byte string, 8-bit string length BIFF8: Unicode string, 8-bit string length
The boldness and underline flags are still set in the options field, but not used on reading the font. Font weight and underline type are specified in separate fields instead.
Bases: xlwt.BIFFRecords.BiffRecord
Semantic is equal to HEADER record
Bases: xlwt.BIFFRecords.BiffRecord
Offset Size Contents 0 2 Index to row 2 2 Index to column 4 2 Index to XF record 6 8 Result of the formula 14 2 Option flags:
Bit Mask Contents 0 0001H 1 = Recalculate always 1 0002H 1 = Calculate on open 3 0008H 1 = Part of a shared formula
16 4 Not used 20 var. Formula data (RPN token array)
Bases: xlwt.BIFFRecords.BiffRecord
This record specifies if the option to print sheet grid lines (record PRINTGRIDLINES) has ever been changed.
Record GRIDSET, BIFF3-BIFF8:
Offset Size Contents 0 2 0 = Print grid lines option never changed
1 = Print grid lines option changed
Bases: xlwt.BIFFRecords.BiffRecord
This record contains information about the layout of outline symbols.
Record GUTS, BIFF3-BIFF8:
Offset Size Contents 0 2 Width of the area to display row outlines (left of the sheet), in pixel 2 2 Height of the area to display column outlines (above the sheet), in pixel 4 2 Number of visible row outline levels (used row levels + 1; or 0, if not used) 6 2 Number of visible column outline levels (used column levels + 1; or 0, if not used)
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Page Settings Block. It specifies if the sheet is centred horizontally when printed.
Record HCENTER, BIFF3-BIFF8:
Offset Size Contents 0 2 0 = Print sheet left aligned
1 = Print sheet centred horizontally
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Page Settings Block. It specifies the page header string for the current worksheet. If this record is not present or completely empty (record size is 0), the sheet does not contain a page header.
Record HEADER for non-empty page header, BIFF2-BIFF8: Offset Size Contents 0 var. Page header string
BIFF2-BIFF7: Non-empty byte string, 8bit string length BIFF8: Non-empty Unicode string, 16bit string length
The header string may contain special commands, i.e. placeholders for the page number, current date, or text formatting attributes. These fields are represented by single letters (exception: font name and size, see below) with a leading ampersand (“&”). If the ampersand is part of the regular header text, it will be duplicated (“&&”). The page header is divided into 3 sections: the left, the centred, and the right section. Each section is introduced by a special command. All text and all commands following are part of the selected section. Each section starts with the text formatting specified in the default font (first FONT record in the file). Active formatting attributes from a previous section do not go into the next section.
The following table shows all available commands:
Command Contents && The “&” character itself &L Start of the left section &C Start of the centred section &R Start of the right section &P Current page number &N Page count &D Current date &T Current time &A Sheet name (BIFF5-BIFF8) &F File name without path &Z File path without file name (BIFF8X) &G Picture (BIFF8X) &B Bold on/off (BIFF2-BIFF4) &I Italic on/off (BIFF2-BIFF4) &U Underlining on/off &E Double underlining on/off (BIFF5-BIFF8) &S Strikeout on/off &X Superscript on/off (BIFF5-BIFF8) &Y Subscript on/off (BIFF5-BIFF8) &”<fontname>” Set new font <fontname> &”<fontname>,<fontstyle>”
Set new font with specified style <fontstyle>. The style <fontstyle> is in most cases one of “Regular”, “Bold”, “Italic”, or “Bold Italic”. But this setting is dependent on the used font, it may differ (localised style names, or “Standard”, “Oblique”, ...). (BIFF5-BIFF8)
Bases: xlwt.BIFFRecords.BiffRecord
This record specifies whether and how to show objects in the workbook.
Record HIDEOBJ, BIFF3-BIFF8: Offset Size Contents 0 2 Viewing mode for objects:
0 = Show all objects 1 = Show placeholders 2 = Do not show objects
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Page Settings Block. It contains all horizontal manual page breaks.
Record HORIZONTALPAGEBREAKS, BIFF8: Offset Size Contents 0 2 Number of following row index structures (nm) 2 6nm List of nm row index structures. Each row index
- structure contains:
- Offset Size Contents 0 2 Index to first row below the page break 2 2 Index to first column of this page break 4 2 Index to last column of this page break
The row indexes in the lists must be ordered ascending. If in BIFF8 a row contains several page breaks, they must be ordered ascending by start column index.
Bases: xlwt.BIFFRecords.BiffRecord
Bases: xlwt.BIFFRecords.BiffRecord
Bases: xlwt.BIFFRecords.SupBookRecord
In each file occurs a SUPBOOK that is used for internal 3D references. It stores the number of sheets of the own document.
Record SUPBOOK for 3D references, BIFF8: Offset Size Contents
0 2 Number of sheets in this document 2 2 01H 04H (relict of BIFF5/BIFF7, the byte string “<04H>”, see 3.9.1)
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Calculation Settings Block. It stores if iterations are allowed while calculating recursive formulas.
Record ITERATION, BIFF2-BIFF8:
Offset Size Contents 0 2 0 = Iterations off; 1 = Iterations on
Bases: xlwt.BIFFRecords.BiffRecord
This record represents a cell that contains a string. It replaces the LABEL record and RSTRING record used in BIFF2-BIFF7.
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Page Settings Block. It contains the left page margin of the current worksheet.
Record LEFTMARGIN, BIFF2-BIFF8:
Offset Size Contents 0 8 Left page margin in inches
(IEEE 754 floating-point value, 64bit double precision)
Bases: xlwt.BIFFRecords.BiffRecord
Bases: xlwt.BIFFRecords.BiffRecord
This record contains all merged cell ranges of the current sheet.
Record MERGEDCELLS, BIFF8:
Offset Size Contents 0 var. Cell range address list with all merged ranges
A cell range address list consists of a field with the number of ranges and the list of the range addresses.
Cell range address list, BIFF8:
Offset Size Contents 0 2 Number of following cell range addresses (nm) 2 8*nm List of nm cell range addresses
Cell range address, BIFF8:
Offset Size Contents 0 2 Index to first row 2 2 Index to last row 4 2 Index to first column 6 2 Index to last column
Bases: xlwt.BIFFRecords.BiffRecord
This record represents a cell range of empty cells. All cells are located in the same row.
Record MULBLANK, BIFF5-BIFF8:
Offset Size Contents 0 2 Index to row 2 2 Index to first column (fc) 4 2*nc List of nc=lc-fc+1 16-bit indexes to XF records 4+2*nc 2 Index to last column (lc)
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of a Link Table. It contains the name and the token array of an internal defined name. Token arrays of defined names contain tokens with aberrant token classes.
Record NAME, BIFF5/BIFF7: Offset Size Contents
0 2 Option flags, see below 2 1 Keyboard shortcut (only for command macro names, see below) 3 1 Length of the name (character count, ln) 4 2 Size of the formula data (sz) 6 2 0 = Global name, otherwise index to EXTERNSHEET record (one-based) 8 2 0 = Global name, otherwise index to sheet (one-based)10 1 Length of menu text (character count, lm) 11 1 Length of description text (character count, ld) 12 1 Length of help topic text (character count, lh) 13 1 Length of status bar text (character count, ls) 14 ln Character array of the name
14+ln sz Formula data (RPN token array without size field, 4)
var. ld Character array of description text var. lh Character array of help topic text var. ls Character array of status bar text
Record NAME, BIFF8: Offset Size Contents
0 2 Option flags, see below 2 1 Keyboard shortcut (only for command macro names, see below) 3 1 Length of the name (character count, ln) 4 2 Size of the formula data (sz) 6 2 Not used 8 2 0 = Global name, otherwise index to sheet (one-based)10 1 Length of menu text (character count, lm) 11 1 Length of description text (character count, ld) 12 1 Length of help topic text (character count, lh) 13 1 Length of status bar text (character count, ls) 14 var. Name (Unicode string without length field, 3.4)
var. sz Formula data (RPN token array without size field, 4)
[var.] var. (optional, only if lm > 0) Menu text (Unicode string without length field, 3.4) [var.] var. (optional, only if ld > 0) Description text (Unicode string without length field, 3.4) [var.] var. (optional, only if lh > 0) Help topic text (Unicode string without length field, 3.4) [var.] var. (optional, only if ls > 0) Status bar text (Unicode string without length field, 3.4)
Bases: xlwt.BIFFRecords.BiffRecord
Record FORMAT, BIFF8: Offset Size Contents 0 2 Format index used in other records 2 var. Number format string (Unicode string, 16-bit string length)
From BIFF5 on, the built-in number formats will be omitted. The built-in formats are dependent on the current regional settings of the operating system. The following table shows which number formats are used by default in a US-English environment. All indexes from 0 to 163 are reserved for built-in formats. The first user-defined format starts at 164.
The built-in number formats, BIFF5-BIFF8
Index Type Format string 0 General General 1 Decimal 0 2 Decimal 0.00 3 Decimal #,##0 4 Decimal #,##0.00 5 Currency “$”#,##0_);(“$”#,## 6 Currency “$”#,##0_);[Red](“$”#,## 7 Currency “$”#,##0.00_);(“$”#,## 8 Currency “$”#,##0.00_);[Red](“$”#,## 9 Percent 0% 10 Percent 0.00% 11 Scientific 0.00E+00 12 Fraction # ?/? 13 Fraction # ??/?? 14 Date M/D/YY 15 Date D-MMM-YY 16 Date D-MMM 17 Date MMM-YY 18 Time h:mm AM/PM 19 Time h:mm:ss AM/PM 20 Time h:mm 21 Time h:mm:ss 22 Date/Time M/D/YY h:mm 37 Account _(#,##0_);(#,##0) 38 Account _(#,##0_);[Red](#,##0) 39 Account _(#,##0.00_);(#,##0.00) 40 Account _(#,##0.00_);[Red](#,##0.00) 41 Currency _(“$”* #,##0_);_(“$”* (#,##0);_(“$”* “-“_);_(@_) 42 Currency _(* #,##0_);_(* (#,##0);_(* “-“_);_(@_) 43 Currency _(“$”* #,##0.00_);_(“$”* (#,##0.00);_(“$”* “-”??_);_(@_) 44 Currency _(* #,##0.00_);_(* (#,##0.00);_(* “-”??_);_(@_) 45 Time mm:ss 46 Time [h]:mm:ss 47 Time mm:ss.0 48 Scientific ##0.0E+0 49 Text @
Bases: xlwt.BIFFRecords.BiffRecord
This record represents a cell that contains an IEEE-754 floating-point value.
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the worksheet/workbook protection. It determines whether the objects of the current sheet are protected. Object protection is not active, if this record is omitted.
Bases: xlwt.BIFFRecords.BiffRecord
This record contains the definition of all user-defined colours available for cell and object formatting.
Record PALETTE, BIFF3-BIFF8:
Offset Size Contents 0 2 Number of following colours (nm). Contains 16 in BIFF3-BIFF4 and 56 in BIFF5-BIFF8. 2 4*nm List of nm RGB colours
The following table shows how colour indexes are used in other records:
Colour index Resulting colour or internal list index 00H Built-in Black (R = 00H, G = 00H, B = 00H) 01H Built-in White (R = FFH, G = FFH, B = FFH) 02H Built-in Red (R = FFH, G = 00H, B = 00H) 03H Built-in Green (R = 00H, G = FFH, B = 00H) 04H Built-in Blue (R = 00H, G = 00H, B = FFH) 05H Built-in Yellow (R = FFH, G = FFH, B = 00H) 06H Built-in Magenta (R = FFH, G = 00H, B = FFH) 07H Built-in Cyan (R = 00H, G = FFH, B = FFH) 08H First user-defined colour from the PALETTE record (entry 0 from record colour list) .........................
17H (BIFF3-BIFF4) Last user-defined colour from the PALETTE record (entry 15 or 55 from record colour list) 3FH (BIFF5-BIFF8)
18H (BIFF3-BIFF4) System window text colour for border lines (used in records XF, CF, and 40H (BIFF5-BIFF8) WINDOW2 (BIFF8 only))
19H (BIFF3-BIFF4) System window background colour for pattern background (used in records XF, and CF) 41H (BIFF5-BIFF8)
43H System face colour (dialogue background colour) 4DH System window text colour for chart border lines 4EH System window background colour for chart areas 4FH Automatic colour for chart border lines (seems to be always Black) 50H System ToolTip background colour (used in note objects) 51H System ToolTip text colour (used in note objects) 7FFFH System window text colour for fonts (used in records FONT, EFONT, and CF)
Bases: xlwt.BIFFRecords.BiffRecord
This record stores the position of window panes. It is part of the Sheet View Settings Block. If the sheet does not contain any splits, this record will not occur. A sheet can be split in two different ways, with unfrozen panes or with frozen panes. A flag in the WINDOW2 record specifies, if the panes are frozen, which affects the contents of this record.
Record PANE, BIFF2-BIFF8: Offset Size Contents 0 2 Position of the vertical split
(px, 0 = No vertical split): Unfrozen pane: Width of the left pane(s) (in twips = 1/20 of a point) Frozen pane: Number of visible columns in left pane(s)
If the panes are frozen, pane 0 is always active, regardless of the cursor position. The correct identifiers for all possible combinations of visible panes are shown in the following pictures.
px = 0, py = 0 px = 0, py > 0 ————————– ————|————- | | | | | | | 3 | | | | | - 3 - ————————– | | | | | | | 2 | | | | | ————————– ————|————-
px > 0, py = 0 px > 0, py > 0 ————|————- ————|————- | | | | | | | | | | 3 | 2 | | | | | | | - 3 | 1 - ————————– | | | | | | | | | | 1 | 0 | | | | | | | ————|————- ————|————-
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the worksheet/workbook protection. It stores a 16-bit hash value, calculated from the worksheet or workbook protection password.
Based on the algorithm provided by Daniel Rentz of OpenOffice.
Bases: xlwt.BIFFRecords.BiffRecord
This record stores if formulas use the real cell values for calculation or the values displayed on the screen. In BIFF2- BIFF4 this record is part of the Calculation Settings Block. In BIFF5-BIFF8 it is stored in the Workbook Globals Substream.
Record PRECISION, BIFF2-BIFF8:
Offset Size Contents 0 2 0 = Use displayed values;
1 = Use real cell values
Bases: xlwt.BIFFRecords.BiffRecord
This record stores if sheet grid lines will be printed.
Record PRINTGRIDLINES, BIFF2-BIFF8:
Offset Size Contents 0 2 0 = Do not print sheet grid lines;
1 = Print sheet grid lines
Bases: xlwt.BIFFRecords.BiffRecord
This record stores if the row and column headers (the areas with row numbers and column letters) will be printed.
Record PRINTHEADERS, BIFF2-BIFF8:
Offset Size Contents 0 2 0 = Do not print row/column headers;
1 = Print row/column headers
Bases: xlwt.BIFFRecords.BiffRecord
Bases: xlwt.BIFFRecords.BiffRecord
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the worksheet/workbook protection. It specifies whether a worksheet or a workbook is protected against modification. Protection is not active, if this record is omitted.
Bases: xlwt.BIFFRecords.BiffRecord
This record represents a cell that contains an RK value (encoded integer or floating-point value). If a floating-point value cannot be encoded to an RK value, a NUMBER record will be written.
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Calculation Settings Block. It stores which method is used to show cell addresses in formulas. The “RC” mode uses numeric indexes for rows and columns, i.e. “R(1)C(-1)”, or “R1C1:R2C2”. The “A1” mode uses characters for columns and numbers for rows, i.e. “B1”, or “$A$1:$B$2”.
Record REFMODE, BIFF2-BIFF8:
Offset Size Contents 0 2 0 = RC mode; 1 = A1 mode
Bases: xlwt.BIFFRecords.BiffRecord
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Page Settings Block. It contains the right page margin of the current worksheet.
Offset Size Contents 0 8 Right page margin in inches
(IEEE 754 floating-point value, 64?bit double precision)
Bases: xlwt.BIFFRecords.BiffRecord
This record contains the properties of a single row in a sheet. Rows and cells in a sheet are divided into blocks of 32 rows.
Record ROW, BIFF3-BIFF8:
Offset Size Contents 0 2 Index of this row 2 2 Index to column of the first cell which is described by a cell record 4 2 Index to column of the last cell which is described by a cell record,
increased by 1
8 2 Not used 10 2 In BIFF3-BIFF4 this field contains a relative offset
to calculate stream position of the first cell record for this row. In BIFF5-BIFF8 this field is not used anymore, but the DBCELL record instead.
Bit Mask Contents 2-0 00000007H Outline level of the row 4 00000010H 1 = Outline group starts or ends here (depending
on where the outline buttons are located, see WSBOOL record), and is collapsed
5 00000020H 1 = Row is hidden (manually, or by a filter or outline group) 6 00000040H 1 = Row height and default font height do not match 7 00000080H 1 = Row has explicit default format (fl) 8 00000100H Always 1 27-16 0FFF0000H If fl=1: Index to default XF record 28 10000000H 1 = Additional space above the row. This flag is set,
if the upper border of at least one cell in this row or if the lower border of at least one cell in the row above is formatted with a thick line style. Thin and medium line styles are not taken into account.
Bases: xlwt.BIFFRecords.BiffRecord
This record contains a list of all strings used anywhere in the workbook. Each string occurs only once. The workbook uses indexes into the list to reference the strings.
Record SST, BIFF8: Offset Size Contents 0 4 Total number of strings in the workbook (see below) 4 4 Number of following strings (nm) 8 var. List of nm Unicode strings, 16-bit string length
The first field of the SST record counts the total occurrence of strings in the workbook. For instance, the string AAA is used 3 times and the string BBB is used 2 times. The first field contains 5 and the second field contains 2, followed by the two strings.
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Calculation Settings Block. It contains the “Recalculate before save” option in Excel’s calculation settings dialogue.
Record SAVERECALC, BIFF3-BIFF8:
Offset Size Contents 0 2 0 = Do not recalculate;
1 = Recalculate before saving the document
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the worksheet/workbook protection. It determines whether the scenarios of the current sheet are protected. Scenario protection is not active, if this record is omitted.
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Page Settings Block. It stores the page format settings of the current sheet. The pages may be scaled in percent or by using an absolute number of pages. This setting is located in the WSBOOL record. If pages are scaled in percent, the scaling factor in this record is used, otherwise the “Fit to pages” values. One of the “Fit to pages” values may be 0. In this case the sheet is scaled to fit only to the other value.
Record SETUP, BIFF5-BIFF8:
Offset Size Contents 0 2 Paper size (see below) 2 2 Scaling factor in percent 4 2 Start page number 6 2 Fit worksheet width to this number of pages
(0 = use as many as needed)
Bit Mask Contents 0 0001H 0 = Print pages in columns
1 = Print pages in rows
The following flags are valid for BIFF8 only: 9 0200H 0 = Print notes as displayed
1 = Print notes at end of sheet
12 2 Print resolution in dpi 14 2 Vertical print resolution in dpi 16 8 Header margin (IEEE 754 floating-point value,
64bit double precision)
32 2 Number of copies to print
PAPER TYPES:
Index Paper type Paper size 0 Undefined 1 Letter 8 1/2” x 11” 2 Letter small 8 1/2” x 11” 3 Tabloid 11” x 17” 4 Ledger 17” x 11” 5 Legal 8 1/2” x 14” 6 Statement 5 1/2” x 8 1/2” 7 Executive 7 1/4” x 10 1/2” 8 A3 297mm x 420mm 9 A4 210mm x 297mm 10 A4 small 210mm x 297mm 11 A5 148mm x 210mm 12 B4 (JIS) 257mm x 364mm 13 B5 (JIS) 182mm x 257mm 14 Folio 8 1/2” x 13” 15 Quarto 215mm x 275mm 16 10x14 10” x 14” 17 11x17 11” x 17” 18 Note 8 1/2” x 11” 19 Envelope #9 3 7/8” x 8 7/8” 20 Envelope #10 4 1/8” x 9 1/2” 21 Envelope #11 4 1/2” x 10 3/8” 22 Envelope #12 4 3/4” x 11” 23 Envelope #14 5” x 11 1/2” 24 C 17” x 22” 25 D 22” x 34” 26 E 34” x 44” 27 Envelope DL 110mm x 220mm 28 Envelope C5 162mm x 229mm 29 Envelope C3 324mm x 458mm 30 Envelope C4 229mm x 324mm 31 Envelope C6 114mm x 162mm 32 Envelope C6/C5 114mm x 229mm 33 B4 (ISO) 250mm x 353mm 34 B5 (ISO) 176mm x 250mm 35 B6 (ISO) 125mm x 176mm 36 Envelope Italy 110mm x 230mm 37 Envelope Monarch 3 7/8” x 7 1/2” 38 63/4 Envelope 3 5/8” x 6 1/2” 39 US Standard Fanfold 14 7/8” x 11” 40 German Std. Fanfold 8 1/2” x 12” 41 German Legal Fanfold 8 1/2” x 13” 42 B4 (ISO) 250mm x 353mm 43 Japanese Postcard 100mm x 148mm 44 9x11 9” x 11” 45 10x11 10” x 11” 46 15x11 15” x 11” 47 Envelope Invite 220mm x 220mm 48 Undefined 49 Undefined 50 Letter Extra 9 1/2” x 12” 51 Legal Extra 9 1/2” x 15” 52 Tabloid Extra 11 11/16” x 18” 53 A4 Extra 235mm x 322mm 54 Letter Transverse 8 1/2” x 11” 55 A4 Transverse 210mm x 297mm 56 Letter Extra Transv. 9 1/2” x 12” 57 Super A/A4 227mm x 356mm 58 Super B/A3 305mm x 487mm 59 Letter Plus 8 1/2” x 12 11/16” 60 A4 Plus 210mm x 330mm 61 A5 Transverse 148mm x 210mm 62 B5 (JIS) Transverse 182mm x 257mm 63 A3 Extra 322mm x 445mm 64 A5 Extra 174mm x 235mm 65 B5 (ISO) Extra 201mm x 276mm 66 A2 420mm x 594mm 67 A3 Transverse 297mm x 420mm 68 A3 Extra Transverse 322mm x 445mm 69 Dbl. Japanese Postcard 200mm x 148mm 70 A6 105mm x 148mm 71 72 73 74 75 Letter Rotated 11” x 8 1/2” 76 A3 Rotated 420mm x 297mm 77 A4 Rotated 297mm x 210mm 78 A5 Rotated 210mm x 148mm 79 B4 (JIS) Rotated 364mm x 257mm 80 B5 (JIS) Rotated 257mm x 182mm 81 Japanese Postcard Rot. 148mm x 100mm 82 Dbl. Jap. Postcard Rot. 148mm x 200mm 83 A6 Rotated 148mm x 105mm 84 85 86 87 88 B6 (JIS) 128mm x 182mm 89 B6 (JIS) Rotated 182mm x 128mm 90 12x11 12” x 11”
Bases: object
Bases: xlwt.BIFFRecords.BiffRecord
STYLE record for user-defined cell styles, BIFF3-BIFF8: Offset Size Contents 0 2 Bit Mask Contents
11-0 0FFFH Index to style XF record 15 8000H Always 0 for user-defined styles
STYLE record for built-in cell styles, BIFF3-BIFF8: Offset Size Contents 0 2 Bit Mask Contents
11-0 0FFFH Index to style XF record 15 8000H Always 1 for built-in styles
The RowLevel and ColLevel styles specify the formatting of subtotal cells in a specific outline level. The level is specified by the last field in the STYLE record. Valid values are 0-6 for the outline levels 1-7.
Bases: xlwt.BIFFRecords.BiffRecord
This record mainly stores the URL of an external document and a list of sheet names inside this document. Furthermore it is used to store DDE and OLE object links, or to indicate an internal 3D reference or an add-in function. See 5.10.3 for details about external references in BIFF8.
Bases: xlwt.BIFFRecords.BiffRecord
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Page Settings Block. It contains the top page margin of the current worksheet.
Offset Size Contents 0 8 Top page margin in inches
(IEEE 754 floating-point value, 64?bit double precision)
Bases: xlwt.BIFFRecords.BiffRecord
This record specifies if the formulas in the workbook can use natural language formulas. This type of formula can refer to cells by its content or the content of the column or row header cell.
Record USESELFS, BIFF8:
Offset Size Contents 0 2 0 = Do not use natural language formulas
1 = Use natural language formulas
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Page Settings Block. It specifies if the sheet is centred vertically when printed.
Record VCENTER, BIFF3-BIFF8:
Offset Size Contents 0 2 0 = Print sheet aligned at top page border
1 = Print sheet vertically centred
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the Page Settings Block. It contains all vertical manual page breaks.
Record VERTICALPAGEBREAKS, BIFF8: Offset Size Contents 0 2 Number of following column index structures (nm) 2 6nm List of nm column index structures. Each column index
- structure contains:
Offset Size Contents 0 2 Index to first column following the page
break2 2 Index to first row of this page break 4 2 Index to last row of this page break
The column indexes in the lists must be ordered ascending. If in BIFF8 a column contains several page breaks, they must be ordered ascending by start row index.
Bases: xlwt.BIFFRecords.BiffRecord
This record stores a 16 bit value with Boolean options for the current sheet. From BIFF5 on the “Save external linked values” option is moved to the record BOOKBOOL.
Option flags of record WSBOOL, BIFF3-BIFF8:
Bit Mask Contents 0 0001H 0 = Do not show automatic page breaks
1 = Show automatic page breaks
The following flags are valid for BIFF4-BIFF8 only: 14 4000H 0 = Standard expression evaluation
1 = Alternative expression evaluation
Bases: xlwt.BIFFRecords.BiffRecord
Offset Size Contents 0 2 Horizontal position of the document window (in twips = 1/20 of a point) 2 2 Vertical position of the document window (in twips = 1/20 of a point) 4 2 Width of the document window (in twips = 1/20 of a point) 6 2 Height of the document window (in twips = 1/20 of a point) 8 2 Option flags:
Bits Mask Contents 0 0001H 0 = Window is visible 1 = Window is hidden 1 0002H 0 = Window is open 1 = Window is minimised 3 0008H 0 = Horizontal scroll bar hidden 1 = Horizontal scroll bar visible 4 0010H 0 = Vertical scroll bar hidden 1 = Vertical scroll bar visible 5 0020H 0 = Worksheet tab bar hidden 1 = Worksheet tab bar visible
10 2 Index to active (displayed) worksheet 12 2 Index of first visible tab in the worksheet tab bar 14 2 Number of selected worksheets (highlighted in the worksheet tab bar) 16 2 Width of worksheet tab bar (in 1/1000 of window width). The remaining space is used by the
horizontal scrollbar.
Bases: xlwt.BIFFRecords.BiffRecord
Record WINDOW2, BIFF8:
Offset Size Contents 0 2 Option flags (see below) 2 2 Index to first visible row 4 2 Index to first visible column 6 2 Colour index of grid line colour. Note that in BIFF2-BIFF7 an RGB colour is
written instead.
8 2 Not used 10 2 Cached magnification factor in page break preview (in percent); 0 = Default (60%) 12 2 Cached magnification factor in normal view (in percent); 0 = Default (100%) 14 4 Not used
In BIFF8 this record stores used magnification factors for page break preview and normal view. These values are used to restore the magnification, when the view is changed. The real magnification of the currently active view is stored in the SCL record. The type of the active view is stored in the option flags field (see below).
0 0001H 0 = Show formula results 1 = Show formulas 1 0002H 0 = Do not show grid lines 1 = Show grid lines 2 0004H 0 = Do not show sheet headers 1 = Show sheet headers 3 0008H 0 = Panes are not frozen 1 = Panes are frozen (freeze) 4 0010H 0 = Show zero values as empty cells 1 = Show zero values 5 0020H 0 = Manual grid line colour 1 = Automatic grid line colour 6 0040H 0 = Columns from left to right 1 = Columns from right to left 7 0080H 0 = Do not show outline symbols 1 = Show outline symbols 8 0100H 0 = Keep splits if pane freeze is removed 1 = Remove splits if pane freeze is removed 9 0200H 0 = Sheet not selected 1 = Sheet selected (BIFF5-BIFF8)
10 0400H 0 = Sheet not visible 1 = Sheet visible (BIFF5-BIFF8) 11 0800H 0 = Show in normal view 1 = Show in page break preview (BIFF8)
The freeze flag specifies, if a following PANE record describes unfrozen or frozen panes.
* This class appends the optional SCL record *
Record SCL, BIFF4-BIFF8:
This record stores the magnification of the active view of the current worksheet. In BIFF8 this can be either the normal view or the page break preview. This is determined in the WINDOW2 record. The SCL record is part of the Sheet View Settings Block.
Offset Size Contents 0 2 Numerator of the view magnification fraction (num) 2 2 Denumerator [denominator] of the view magnification fraction (den) The magnification is stored as reduced fraction. The magnification results from num/den.
SJM note: Excel expresses (e.g.) 25% in reduced form i.e. 1/4. Reason unknown. This code writes 25/100, and Excel is happy with that.
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the worksheet/workbook protection. It determines whether the window configuration of this document is protected. Window protection is not active, if this record is omitted.
Bases: xlwt.BIFFRecords.BiffRecord
This record is part of the file protection. It contains the name of the user that has saved the file. The user name is always stored as an equal-sized string. All unused characters after the name are filled with space characters. It is not required to write the mentioned string length. Every other length will be accepted too.
Bases: xlwt.BIFFRecords.BiffRecord
XF_TYPE_PROT XF Type and Cell Protection (3 Bits), BIFF3-BIFF8 These 3 bits are part of a specific data byte. Bit Mask Contents 0 01H 1 = Cell is locked 1 02H 1 = Formula is hidden 2 04H 0 = Cell XF; 1 = Style XF
XF_USED_ATTRIB Attributes Used from Parent Style XF (6 Bits), BIFF3-BIFF8 Each bit describes the validity of a specific group of attributes. In cell XFs a cleared bit means the attributes of the parent style XF are used (but only if the attributes are valid there), a set bit means the attributes of this XF are used. In style XFs a cleared bit means the attribute setting is valid, a set bit means the attribute should be ignored. Bit Mask Contents 0 01H Flag for number format 1 02H Flag for font 2 04H Flag for horizontal and vertical alignment, text wrap, indentation, orientation, rotation, and
text direction3 08H Flag for border lines 4 10H Flag for background area style 5 20H Flag for cell protection (cell locked and formula hidden)
XF_HOR_ALIGN Horizontal Alignment (3 Bits), BIFF2-BIFF8 The horizontal alignment consists of 3 bits and is part of a specific data byte. Value Horizontal alignment 00H General 01H Left 02H Centred 03H Right 04H Filled 05H Justified (BIFF4-BIFF8X) 06H Centred across selection (BIFF4-BIFF8X) 07H Distributed (BIFF8X)
XF_VERT_ALIGN Vertical Alignment (2 or 3 Bits), BIFF4-BIFF8 The vertical alignment consists of 2 bits (BIFF4) or 3 bits (BIFF5-BIFF8) and is part of a specific data byte. Vertical alignment is not available in BIFF2 and BIFF3. Value Vertical alignment 00H Top 01H Centred 02H Bottom 03H Justified (BIFF5-BIFF8X) 04H Distributed (BIFF8X)
XF_ORIENTATION Text Orientation (2 Bits), BIFF4-BIFF7 In the BIFF versions BIFF4-BIFF7, text can be rotated in steps of 90 degrees or stacked. The orientation mode consists of 2 bits and is part of a specific data byte. In BIFF8 a rotation angle occurs instead of these flags. Value Text orientation 00H Not rotated 01H Letters are stacked top-to-bottom, but not rotated 02H Text is rotated 90 degrees counterclockwise 03H Text is rotated 90 degrees clockwise
XF_ROTATION Text Rotation Angle (1 Byte), BIFF8 Value Text rotation 0 Not rotated 1-90 1 to 90 degrees counterclockwise 91-180 1 to 90 degrees clockwise 255 Letters are stacked top-to-bottom, but not rotated
XF_BORDER_34 Cell Border Style (4 Bytes), BIFF3-BIFF4 Cell borders contain a line style and a line colour for each line of the border. Bit Mask Contents 2-0 00000007H Top line style 7-3 000000F8H Colour index for top line colour 10-8 00000700H Left line style 15-11 0000F800H Colour index for left line colour 18-16 00070000H Bottom line style 23-19 00F80000H Colour index for bottom line colour 26-24 07000000H Right line style 31-27 F8000000H Colour index for right line colour
XF_AREA_34 Cell Background Area Style (2 Bytes), BIFF3-BIFF4 A cell background area style contains an area pattern and a foreground and background colour. Bit Mask Contents 5-0 003FH Fill pattern 10-6 07C0H Colour index for pattern colour 15-11 F800H Colour index for pattern background
Record XF, BIFF8: Offset Size Contents 0 2 Index to FONT record 2 2 Index to FORMAT record 4 2 Bit Mask Contents
2-0 0007H XF_TYPE_PROT . XF type, cell protection (see above) 15-4 FFF0H Index to parent style XF (always FFFH in style XFs)
- 6 1 Bit Mask Contents
- 2-0 07H XF_HOR_ALIGN . Horizontal alignment (see above) 3 08H 1 = Text is wrapped at right border 6-4 70H XF_VERT_ALIGN . Vertical alignment (see above)
7 1 XF_ROTATION: Text rotation angle (see above) 8 1 Bit Mask Contents
3-0 0FH Indent level 4 10H 1 = Shrink content to fit into cell 5 merge 7-6 C0H Text direction (BIFF8X only)
00b = According to context 01b = Left-to-right 10b = Right-to-left
- 9 1 Bit Mask Contents
- 7-2 FCH XF_USED_ATTRIB . Used attributes (see above)
- 10 4 Cell border lines and background area:
- Bit Mask Contents 3-0 0000000FH Left line style 7-4 000000F0H Right line style 11-8 00000F00H Top line style 15-12 0000F000H Bottom line style 22-16 007F0000H Colour index for left line colour 29-23 3F800000H Colour index for right line colour 30 40000000H 1 = Diagonal line from top left to right bottom 31 80000000H 1 = Diagonal line from bottom left to right top
- 14 4 Bit Mask Contents
- 6-0 0000007FH Colour index for top line colour 13-7 00003F80H Colour index for bottom line colour 20-14 001FC000H Colour index for diagonal line colour 24-21 01E00000H Diagonal line style 31-26 FC000000H Fill pattern
- 18 2 Bit Mask Contents
- 6-0 007FH Colour index for pattern colour 13-7 3F80H Colour index for pattern background
Bases: xlwt.BIFFRecords.SupBookRecord
Add-in function names are stored in EXTERNNAME records following this record.
Offset Size Contents 0 2 0001H 2 2 01H 3AH (relict of BIFF5, the byte string ‘:’, see EXTERNSHEET record, 5.41)
Bases: xlwt.BIFFRecords.BiffRecord
Bases: xlwt.BIFFRecords.BiffRecord
Bases: object
Bases: object
Bases: object
Bases: object
Bases: exceptions.Exception
An exception indicating that a Formula could not be successfully parsed.
Bases: xlwt.antlr.LLkParser
lots of Excel Magic Numbers
The XF record is able to store explicit cell formatting attributes or the attributes of a cell style. Explicit formatting includes the reference to a cell style XF record. This allows to extend a defined cell style with some explicit attributes. The formatting attributes are divided into 6 groups:
Number format Number format index (index to FORMAT record) Font Font index (index to FONT record) Alignment Horizontal and vertical alignment, text wrap, indentation,
orientation/rotation, text direction
Border Border line styles and colours Background Background area style and colours Protection Cell locked, formula hidden
For each group a flag in the cell XF record specifies whether to use the attributes contained in that XF record or in the referenced style XF record. In style XF records, these flags specify whether the attributes will overwrite explicit cell formatting when the style is applied to a cell. Changing a cell style (without applying this style to a cell) will change all cells which already use that style and do not contain explicit cell attributes for the changed style attributes. If a cell XF record does not contain explicit attributes in a group (if the attribute group flag is not set), it repeats the attributes of its style XF record.
Bases: object
Bases: object
Bases: object
Bases: object
Bases: object
Bases: xlwt.Style.EasyXFException
Bases: xlwt.Style.EasyXFException
Bases: exceptions.Exception
Bases: object
Bases: object
From BIFF8 on, strings are always stored using UTF-16LE text encoding. The character array is a sequence of 16-bit values4. Additionally it is possible to use a compressed format, which omits the high bytes of all characters, if they are all zero.
The following tables describe the standard format of the entire string, but in many records the strings differ from this format. This will be mentioned separately. It is possible (but not required) to store Rich-Text formatting information and Asian phonetic information inside a Unicode string. This results in four different ways to store a string. The character array is not zero-terminated.
The string consists of the character count (as usual an 8-bit value or a 16-bit value), option flags, the character array and optional formatting information. If the string is empty, sometimes the option flags field will not occur. This is mentioned at the respective place.
Offset Size Contents 0 1 or 2 Length of the string (character count, ln) 1 or 2 1 Option flags:
Bit Mask Contents 0 01H Character compression (ccompr):
0 = Compressed (8-bit characters) 1 = Uncompressed (16-bit characters)
- 2 04H Asian phonetic settings (phonetic):
- 0 = Does not contain Asian phonetic settings 1 = Contains Asian phonetic settings
- 3 08H Rich-Text settings (richtext):
- 0 = Does not contain Rich-Text settings 1 = Contains Rich-Text settings
[2 or 3] 2 (optional, only if richtext=1) Number of Rich-Text formatting runs (rt) [var.] 4 (optional, only if phonetic=1) Size of Asian phonetic settings block (in bytes, sz) var. ln or
2·ln Character array (8-bit characters or 16-bit characters, dependent on ccompr)
[var.] 4·rt (optional, only if richtext=1) List of rt formatting runs [var.] sz (optional, only if phonetic=1) Asian Phonetic Settings Block
pack row and column into the required 4 byte format
Convert an Excel cell reference string in A1 notation to numeric row/col notation.
Returns: row, col, row_abs, col_abs
Convert an Excel cell reference string in A1 notation to numeric row/col notation.
Returns: row, col
Convert cell range string in A1 notation to numeric row/col pair.
Returns: row1, col1, row2, col2
Convert two (row,column) pairs into a cell range string in A1:B2 notation.
Returns: cell range string
Convert numeric row/col notation to an Excel cell reference string in A1 notation.
BOF Type = workbook globals Interface Header MMS Interface End WRITEACCESS CODEPAGE DSF TABID FNGROUPCOUNT Workbook Protection Block
WINDOWPROTECT PROTECT PASSWORD PROT4REV PROT4REVPASSBACKUP HIDEOBJ WINDOW1 DATEMODE PRECISION REFRESHALL BOOKBOOL FONT + FORMAT * XF + STYLE +
USESELFS
BOUNDSHEET +
COUNTRY
Bases: object
BOF UNCALCED INDEX Calculation Settings Block PRINTHEADERS PRINTGRIDLINES GRIDSET GUTS DEFAULTROWHEIGHT WSBOOL Page Settings Block Worksheet Protection Block DEFCOLWIDTH COLINFO SORT DIMENSIONS Row Blocks WINDOW2 SCL PANE SELECTION STANDARDWIDTH MERGEDCELLS LABELRANGES PHONETIC Conditional Formatting Table Hyperlink Table Data Validity Table SHEETLAYOUT (BIFF8X only) SHEETPROTECTION (BIFF8X only) RANGEPROTECTION (BIFF8X only) EOF
Bases: object
Bases: object
Bases: exceptions.Exception
Bases: object
Bases: object
For a given token type return the AST node type. First we lookup a mapping table, second we try _class and finally we resolve to “antlr.CommonAST”.
Specify a mapping between a token type and a (AST) class.
Specify a mapping between a token type and a (AST) class.
Bases: xlwt.antlr.AST
Bases: xlwt.antlr.AST
Bases: object
Bases: xlwt.antlr.InputBuffer
Bases: xlwt.antlr.TokenStream
Bases: xlwt.antlr.ANTLRException
Bases: xlwt.antlr.BaseAST
Bases: xlwt.antlr.CommonAST
Bases: xlwt.antlr.CommonToken
Bases: xlwt.antlr.Token
Bases: object
Bases: xlwt.antlr.Parser
Bases: object
Bases: xlwt.antlr.RecognitionException
Bases: xlwt.antlr.RecognitionException
Bases: object
Bases: object
Bases: object
Bases: xlwt.antlr.ANTLRException
Bases: object
Bases: object
Bases: xlwt.antlr.TokenStream
Bases: xlwt.antlr.ANTLRException
Bases: xlwt.antlr.TokenStreamBasicFilter
Bases: xlwt.antlr.TokenStream
Bases: object
Bases: object
Bases: exceptions.Exception
Portions copyright © 2007, Stephen John Machin, Lingfo Pty Ltd All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. None of the names of Stephen John Machin, Lingfo Pty Ltd and any contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.