Class ChartTextRecord

This record is used in conjunction with several child records (which further define the text displayed on the chart) to define the alignment, color, position, size, and so on of text fields that appear on the chart. The fields in this record have meaning according to the TEXT record's parent (CHART, LEGEND, or DEFAULTTEXT).

Inheritance
System.Object
Syncfusion.XlsIO.Parser.Biff_Records.BiffRecordRaw
ChartTextRecord
Implements
System.ICloneable
Namespace: Syncfusion.XlsIO.Parser.Biff_Records.Charts
Assembly: Syncfusion.XlsIO.Portable.dll
Syntax
[Biff]
public class ChartTextRecord : BiffRecordRaw, ICloneable, IBiffStorage

Constructors

ChartTextRecord()

Default constructor, initializes all fields with default values.

Declaration
public ChartTextRecord()

ChartTextRecord(Int32)

Reserved for record's internal data array.

Declaration
public ChartTextRecord(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.

ChartTextRecord(Stream, out Int32)

Read / initialize constructor.

Declaration
public ChartTextRecord(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_DATA_LABEL_FIRST_BIT

First bit of the data label placement value.

Declaration
public const int DEF_DATA_LABEL_FIRST_BIT = 0
Field Value
Type
System.Int32

DEF_DATA_LABEL_MASK

Mask for data label placement.

Declaration
public const int DEF_DATA_LABEL_MASK = 15
Field Value
Type
System.Int32

DEF_FIRST_ROTATION_BIT

First bit of the rotation value.

Declaration
public const int DEF_FIRST_ROTATION_BIT = 8
Field Value
Type
System.Int32

DEF_RECORD_SIZE

Correct size of the record.

Declaration
public const int DEF_RECORD_SIZE = 32
Field Value
Type
System.Int32

DEF_ROTATION_MASK

Mask for the rotation value.

Declaration
public const int DEF_ROTATION_MASK = 1792
Field Value
Type
System.Int32

Properties

BackgroundMode

Display mode of the background.

Declaration
public ExcelChartBackgroundMode BackgroundMode { get; set; }
Property Value
Type
ExcelChartBackgroundMode

ColorIndex

Index to color value of text.

Declaration
public ExcelKnownColors ColorIndex { get; set; }
Property Value
Type
ExcelKnownColors

DataLabelPlacement

Data label placement.

Declaration
public ExcelDataLabelPosition DataLabelPlacement { get; set; }
Property Value
Type
ExcelDataLabelPosition

HorzAlign

Horizontal alignment of the text.

Declaration
public ExcelChartHorzAlignment HorzAlign { get; set; }
Property Value
Type
ExcelChartHorzAlignment

IsAutoColor

True if automatic color; False if user-selected color.

Declaration
public bool IsAutoColor { get; set; }
Property Value
Type
System.Boolean

IsAutoMode

True if background is set to automatic.

Declaration
public bool IsAutoMode { get; set; }
Property Value
Type
System.Boolean

IsAutoText

True to use automatically generated text string; False to use user-created text string. Must be one for fShowValue to be meaningful.

Declaration
public bool IsAutoText { get; set; }
Property Value
Type
System.Boolean

IsDeleted

True if an automatic text label has been deleted by the user.

Declaration
public bool IsDeleted { get; set; }
Property Value
Type
System.Boolean

IsGenerated

True if default or unmodified; False if modified.

Declaration
public bool IsGenerated { get; set; }
Property Value
Type
System.Boolean

IsShowBubbleSizes

True to show bubble sizes.

Declaration
public bool IsShowBubbleSizes { get; set; }
Property Value
Type
System.Boolean

IsShowKey

If text is an attached data label: True to draw legend key with data label; False if no legend key.

Declaration
public bool IsShowKey { get; set; }
Property Value
Type
System.Boolean

IsShowLabel

True to show label.

Declaration
public bool IsShowLabel { get; set; }
Property Value
Type
System.Boolean

IsShowLabelPercent

True to show category label and value as a percentage (pie charts only).

Declaration
public bool IsShowLabelPercent { get; set; }
Property Value
Type
System.Boolean

IsShowPercent

True to show value as a percent. This bit applies only to pie charts.

Declaration
public bool IsShowPercent { get; set; }
Property Value
Type
System.Boolean

IsShowValue

True if text of label is the value of the data point; False if text is the category label.

Declaration
public bool IsShowValue { get; set; }
Property Value
Type
System.Boolean

IsVertical

True if text is not horizontal; False if text is horizontal.

Declaration
public bool IsVertical { get; set; }
Property Value
Type
System.Boolean

MaximumRecordSize

Maximum possible size of the record.

Declaration
public override int MaximumRecordSize { get; }
Property Value
Type
System.Int32
Overrides
Syncfusion.XlsIO.Parser.Biff_Records.BiffRecordRaw.MaximumRecordSize

MinimumRecordSize

Minimum possible size of the record.

Declaration
public override int MinimumRecordSize { get; }
Property Value
Type
System.Int32
Overrides
Syncfusion.XlsIO.Parser.Biff_Records.BiffRecordRaw.MinimumRecordSize

Options

Option flags. Read-only.

Declaration
public ushort Options { get; }
Property Value
Type
System.UInt16

Options2

Option flags. Read-only.

Declaration
public ushort Options2 { get; set; }
Property Value
Type
System.UInt16

Rotation

Rotation.

Declaration
public TRotation Rotation { get; set; }
Property Value
Type
TRotation

TextColor

Text color.

Declaration
public uint TextColor { get; set; }
Property Value
Type
System.UInt32

TextRotation

Text rotation.

Declaration
public short TextRotation { get; set; }
Property Value
Type
System.Int16

TextRotationOrNull

Text rotation.

Declaration
public Nullable<short> TextRotationOrNull { get; set; }
Property Value
Type
System.Nullable<System.Int16>

VertAlign

Vertical alignment of the text.

Declaration
public ExcelChartVertAlignment VertAlign { get; set; }
Property Value
Type
ExcelChartVertAlignment

XPos

X-position of the text in 1/4000 of chart area.

Declaration
public uint XPos { get; set; }
Property Value
Type
System.UInt32

XSize

X-size of the text in 1/4000 of chart area.

Declaration
public uint XSize { get; set; }
Property Value
Type
System.UInt32

YPos

Y-position of the text in 1/4000 of chart area.

Declaration
public uint YPos { get; set; }
Property Value
Type
System.UInt32

YSize

Y-size of the text in 1/4000 of chart area.

Declaration
public uint YSize { get; set; }
Property Value
Type
System.UInt32

Methods

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
Syncfusion.XlsIO.Parser.Biff_Records.BiffRecordRaw.ParseStructure(Syncfusion.XlsIO.Parser.Biff_Records.DataProvider, System.Int32, System.Int32, Syncfusion.XlsIO.ExcelVersion)

Implements

System.ICloneable