Class ExtendedFormatRecord
One of the most complex records. There are two types: Style and Cell. It should be noted that fields in the extended format record are somewhat arbitrary. Almost all of the fields are bit-level, but we name them as best as possible by functional group. In some places, this is more conducive than others.
Inheritance
Namespace: Syncfusion.XlsIO.Parser.Biff_Records
Assembly: Syncfusion.XlsIO.Base.dll
Syntax
[Biff]
public class ExtendedFormatRecord : BiffRecordRaw, ICloneable, IBiffStorage
Constructors
ExtendedFormatRecord()
Default constructor
Declaration
public ExtendedFormatRecord()
ExtendedFormatRecord(Int32)
Reserved for the record's internal data array.
Declaration
public ExtendedFormatRecord(int iReserve)
Parameters
Type | Name | Description |
---|---|---|
System.Int32 | iReserve | Amount of bytes for data array. |
Exceptions
Type | Condition |
---|---|
System.ArgumentOutOfRangeException | If amount of bytes requested is less than zero. |
ExtendedFormatRecord(Stream, out Int32)
Read / initialize constructor.
Declaration
public ExtendedFormatRecord(Stream stream, out int itemSize)
Parameters
Type | Name | Description |
---|---|---|
System.IO.Stream | stream | Stream from which record data should be read. |
System.Int32 | itemSize | Size of read item. |
Exceptions
Type | Condition |
---|---|
System.ArgumentNullException | If stream is not specified. |
System.ApplicationException | If stream does not support read or seek operations. |
Fields
DEF_DEFAULT_COLOR_INDEX
Default color index.
Declaration
public const int DEF_DEFAULT_COLOR_INDEX = 65
Field Value
Type |
---|
System.Int32 |
DEF_DEFAULT_PATTERN_COLOR_INDEX
Default pattern color index.
Declaration
public const int DEF_DEFAULT_PATTERN_COLOR_INDEX = 64
Field Value
Type |
---|
System.Int32 |
Properties
_123Prefix
Declaration
public bool _123Prefix { get; set; }
Property Value
Type |
---|
System.Boolean |
AdtlFillPattern
Fill pattern: This property changes bits of the m_uiAddPaletteOptions class member.
Declaration
public ushort AdtlFillPattern { get; set; }
Property Value
Type |
---|
System.UInt16 |
Exceptions
Type | Condition |
---|---|
System.ArgumentOutOfRangeException | Thrown when value is more than 0x3F. |
AlignmentOptions
Alignment options bits in one location. Read-only.
Declaration
public int AlignmentOptions { get; }
Property Value
Type |
---|
System.Int32 |
BorderBottom
Bottom line style: This property changes bits of the m_usBorderOptions class member.
Declaration
public ExcelLineStyle BorderBottom { get; set; }
Property Value
Type |
---|
ExcelLineStyle |
BorderLeft
Left line style: This property changes bits of the m_usBorderOptions class member.
Declaration
public ExcelLineStyle BorderLeft { get; set; }
Property Value
Type |
---|
ExcelLineStyle |
BorderOptions
Border options bits in one location. Read-only.
Declaration
public int BorderOptions { get; }
Property Value
Type |
---|
System.Int32 |
BorderRight
Right line style: This property changes bits of the m_usBorderOptions class member.
Declaration
public ExcelLineStyle BorderRight { get; set; }
Property Value
Type |
---|
ExcelLineStyle |
BorderTop
Top line style: This property changes bits of the m_usBorderOptions class member.
Declaration
public ExcelLineStyle BorderTop { get; set; }
Property Value
Type |
---|
ExcelLineStyle |
BottomBorderPaletteIndex
Color index for bottom line color. This property changes bits of the m_uiAddPaletteOptions class member.
Declaration
public ushort BottomBorderPaletteIndex { get; set; }
Property Value
Type |
---|
System.UInt16 |
Exceptions
Type | Condition |
---|---|
System.ArgumentOutOfRangeException | Thrown when value is more than 0x7F. |
CellOptions
Cell options bits in one location. Read-only.
Declaration
public int CellOptions { get; }
Property Value
Type |
---|
System.Int32 |
DiagonalFromBottomLeft
Diagonal line is drawing from bottom left to top right corner of cell.
Declaration
public bool DiagonalFromBottomLeft { get; set; }
Property Value
Type |
---|
System.Boolean |
DiagonalFromTopLeft
Diagonal line is drawing from top left to bottom right corner of cell.
Declaration
public bool DiagonalFromTopLeft { get; set; }
Property Value
Type |
---|
System.Boolean |
DiagonalLineColor
Color index for diagonal line color. This property changes bits of the m_uiAddPaletteOptions class member.
Declaration
public ushort DiagonalLineColor { get; set; }
Property Value
Type |
---|
System.UInt16 |
Exceptions
Type | Condition |
---|---|
System.ArgumentOutOfRangeException | Thrown when value is more than 0x7F. |
DiagonalLineStyle
Diagonal line style. This property changes bits of the m_uiAddPaletteOptions class member.
Declaration
public ushort DiagonalLineStyle { get; set; }
Property Value
Type |
---|
System.UInt16 |
Exceptions
Type | Condition |
---|---|
System.ArgumentOutOfRangeException | Thrown when value is more than 0x0F. |
FillBackground
Color index for pattern color This property changes bits of m_usFillPaletteOptions.
Declaration
public ushort FillBackground { get; set; }
Property Value
Type |
---|
System.UInt16 |
Exceptions
Type | Condition |
---|---|
System.ArgumentOutOfRangeException | Thrown when value is more than 0x7F. |
FillForeground
Color index for pattern background. This property changes bits of m_usFillPaletteOptions.
Declaration
public ushort FillForeground { get; set; }
Property Value
Type |
---|
System.UInt16 |
Exceptions
Type | Condition |
---|---|
System.ArgumentOutOfRangeException | Thrown when value is more than 0x7F. |
FontIndex
Index to font record.
Declaration
public ushort FontIndex { get; set; }
Property Value
Type |
---|
System.UInt16 |
FormatIndex
Index to FORMAT record:
Declaration
public ushort FormatIndex { get; set; }
Property Value
Type |
---|
System.UInt16 |
HAlignmentType
Horizontal alignment.
Declaration
public ExcelHAlign HAlignmentType { get; set; }
Property Value
Type |
---|
ExcelHAlign |
Indent
Gets or sets indent level.
Declaration
public byte Indent { get; set; }
Property Value
Type |
---|
System.Byte |
IsHidden
True if formula is hidden.
Declaration
public bool IsHidden { get; set; }
Property Value
Type |
---|
System.Boolean |
IsLocked
True if cell is locked.
Declaration
public bool IsLocked { get; set; }
Property Value
Type |
---|
System.Boolean |
IsNotParentAlignment
Flag for horizontal and vertical alignment, text wrap, indentation, orientation, rotation, and text direction. If False, then an attribute of the parent style is used.
Declaration
public bool IsNotParentAlignment { get; set; }
Property Value
Type |
---|
System.Boolean |
IsNotParentBorder
Flag for border lines. If False, then an attribute of the parent style is used.
Declaration
public bool IsNotParentBorder { get; set; }
Property Value
Type |
---|
System.Boolean |
IsNotParentCellOptions
Flag for cell protection (cell locked and formula hidden). If False, then attributes of the parent style is used.
Declaration
public bool IsNotParentCellOptions { get; set; }
Property Value
Type |
---|
System.Boolean |
IsNotParentFont
Flag for font, if False, then an attribute of the parent style is used.
Declaration
public bool IsNotParentFont { get; set; }
Property Value
Type |
---|
System.Boolean |
IsNotParentFormat
Flag for number format, if False, then an attribute of the parent style is used.
Declaration
public bool IsNotParentFormat { get; set; }
Property Value
Type |
---|
System.Boolean |
IsNotParentPattern
Flag for background area style. If False, then an attribute of the parent style is used.
Declaration
public bool IsNotParentPattern { get; set; }
Property Value
Type |
---|
System.Boolean |
JustifyLast
For far east languages supported only for format, always use False for US.
Declaration
public bool JustifyLast { get; set; }
Property Value
Type |
---|
System.Boolean |
LeftBorderPaletteIndex
Color index for left line color This property changes bits of the m_usPaletteOptions class member.
Declaration
public ushort LeftBorderPaletteIndex { get; set; }
Property Value
Type |
---|
System.UInt16 |
Exceptions
Type | Condition |
---|---|
System.ArgumentOutOfRangeException | Thrown when value is more than 0x7F. |
MaximumRecordSize
Read-only. Returns maximum possible size of record's internal data array.
Declaration
public override int MaximumRecordSize { get; }
Property Value
Type |
---|
System.Int32 |
Overrides
MergeCells
True if extended format contains merged cells.
Declaration
public bool MergeCells { get; set; }
Property Value
Type |
---|
System.Boolean |
MinimumRecordSize
Read-only. Returns minimum possible size of record's internal data array.
Declaration
public override int MinimumRecordSize { get; }
Property Value
Type |
---|
System.Int32 |
Overrides
ParentIndex
Gets /sets index to parent style XF (always FFFH in style XFs in Excel 97).
Declaration
public ushort ParentIndex { get; set; }
Property Value
Type |
---|
System.UInt16 |
ReadingOrder
Text direction, the reading order for far east versions.
Declaration
public ushort ReadingOrder { get; set; }
Property Value
Type |
---|
System.UInt16 |
RightBorderPaletteIndex
Color index for right line color. This property changes bits of the m_usPaletteOptions class member.
Declaration
public ushort RightBorderPaletteIndex { get; set; }
Property Value
Type |
---|
System.UInt16 |
Exceptions
Type | Condition |
---|---|
System.ArgumentOutOfRangeException | Thrown when value is more than 0x7F. |
Rotation
Text rotation angle: 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.
Declaration
public ushort Rotation { get; set; }
Property Value
Type |
---|
System.UInt16 |
Exceptions
Type | Condition |
---|---|
System.ArgumentOutOfRangeException | Thrown when value is more than 0xFF. |
ShrinkToFit
True means to shrink content to fit into cell.
Declaration
public bool ShrinkToFit { get; set; }
Property Value
Type |
---|
System.Boolean |
TopBorderPaletteIndex
Color index for top line color. This property changes bits of the m_uiAddPaletteOptions class member.
Declaration
public ushort TopBorderPaletteIndex { get; set; }
Property Value
Type |
---|
System.UInt16 |
Exceptions
Type | Condition |
---|---|
System.ArgumentOutOfRangeException | Thrown when value is more than 0x7F. |
VAlignmentType
Vertical alignment.
Declaration
public ExcelVAlign VAlignmentType { get; set; }
Property Value
Type |
---|
ExcelVAlign |
WrapText
True means that text is wrapped at right border.
Declaration
public bool WrapText { get; set; }
Property Value
Type |
---|
System.Boolean |
XFType
Type of extended format record.
Declaration
public ExtendedFormatRecord.TXFType XFType { get; set; }
Property Value
Type |
---|
ExtendedFormatRecord.TXFType |
Methods
CompareTo(ExtendedFormatRecord)
Compares with Extended format record.
Declaration
public int CompareTo(ExtendedFormatRecord twin)
Parameters
Type | Name | Description |
---|---|---|
ExtendedFormatRecord | twin | Param to compare. |
Returns
Type | Description |
---|---|
System.Int32 | Returns compare results. |
CopyAlignment(ExtendedFormatRecord)
Copies alignment settings from another extended format record.
Declaration
public void CopyAlignment(ExtendedFormatRecord source)
Parameters
Type | Name | Description |
---|---|---|
ExtendedFormatRecord | source | Source record to copy data from. |
CopyBorders(ExtendedFormatRecord)
Copies border settings from another extended format record.
Declaration
public void CopyBorders(ExtendedFormatRecord source)
Parameters
Type | Name | Description |
---|---|---|
ExtendedFormatRecord | source | Source record to copy data from. |
CopyPatterns(ExtendedFormatRecord)
Copies pattern settings from another extended format record.
Declaration
public void CopyPatterns(ExtendedFormatRecord source)
Parameters
Type | Name | Description |
---|---|---|
ExtendedFormatRecord | source | Source record to copy data from. |
CopyProtection(ExtendedFormatRecord)
Copies protection / cells settings from another extended format record.
Declaration
public void CopyProtection(ExtendedFormatRecord source)
Parameters
Type | Name | Description |
---|---|---|
ExtendedFormatRecord | source | Source record to copy data from. |
CopyTo(BiffRecordRaw)
Copies data from the current Biff record to the specified Biff record.
Declaration
public override void CopyTo(BiffRecordRaw raw)
Parameters
Type | Name | Description |
---|---|---|
Syncfusion.XlsIO.Parser.Biff_Records.BiffRecordRaw | raw | Biff record that will receive data from the current record. |
Overrides
CopyTo(ExtendedFormatRecord)
Copies data from the current ExtendedFormat record to the specified ExtendedFormat record.
Declaration
public void CopyTo(ExtendedFormatRecord twin)
Parameters
Type | Name | Description |
---|---|---|
ExtendedFormatRecord | twin | ExtendedFormat record that will receive data from the current record. |
GetHashCode()
Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table.
Declaration
public override int GetHashCode()
Returns
Type | Description |
---|---|
System.Int32 | A hash code for the current Object. |
ParseStructure(DataProvider, Int32, Int32, ExcelVersion)
Parse structure of record. Converts data buffer to special values according to record specification.
Declaration
public override void ParseStructure(DataProvider provider, int iOffset, int iLength, ExcelVersion version)
Parameters
Type | Name | Description |
---|---|---|
DataProvider | provider | Object that provides access to the data. |
System.Int32 | iOffset | Offset to the record's data. |
System.Int32 | iLength | Length of the record's data. |
ExcelVersion | version | Excel version used for infill. |
Overrides
Exceptions
Type | Condition |
---|---|
WrongBiffRecordDataException | If there is any internal error. |