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
Namespace: Syncfusion.XlsIO.Parser.Biff_Records.Charts
Assembly: Syncfusion.XlsIO.NET.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
MinimumRecordSize
Minimum possible size of the record.
Declaration
public override int MinimumRecordSize { get; }
Property Value
Type |
---|
System.Int32 |
Overrides
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. |