menu

Document Processing

ExtendedFormatImpl Class - C# Excel Library API Reference | Syncfusion

    Show / Hide Table of Contents

    ExtendedFormatImpl Class

    Contains the font attributes (font name, font size, color, and so on) for an object.

    Inheritance
    System.Object
    CommonObject
    ExtendedFormatImpl
    Implements
    IExtendedFormat
    IParentApplication
    System.IComparable
    System.ICloneable
    IXFIndex
    ICloneParent
    System.IDisposable
    Inherited Members
    CommonObject.AddReference()
    CommonObject.AppImplementation
    CommonObject.Application
    CommonObject.CheckDisposed()
    CommonObject.Dispose()
    CommonObject.Finalize()
    CommonObject.FindParent(Object, Type)
    CommonObject.FindParent(Object, Type, Boolean)
    CommonObject.FindParent(Type)
    CommonObject.FindParent(Type, Boolean)
    CommonObject.FindParent(Type[])
    CommonObject.FindParents(Type[])
    CommonObject.m_bIsDisposed
    CommonObject.OnDispose()
    CommonObject.Parent
    CommonObject.ReferenceCount
    CommonObject.ReleaseReference()
    CommonObject.SetParent(Object)
    Namespace: Syncfusion.XlsIO.Implementation
    Assembly: Syncfusion.XlsIO.Base.dll
    Syntax
    public class ExtendedFormatImpl : CommonObject, IInternalExtendedFormat, IExtendedFormat, IParentApplication, IComparable, ICloneable, IXFIndex, ICloneParent, IDisposable

    Constructors

    ExtendedFormatImpl(IApplication, Object)

    Sets application and parent fields.

    Declaration
    public ExtendedFormatImpl(IApplication application, object parent)
    Parameters
    Type Name Description
    IApplication application

    Application object for the format.

    System.Object parent

    Parent object for the format.

    Fields

    DEF_NO_PARENT_INDEX

    Parent index that indicates that extended format doesn't have any parent format.

    Declaration
    public const int DEF_NO_PARENT_INDEX = 4095
    Field Value
    Type
    System.Int32

    MaxTintValue

    Maximum tint value.

    Declaration
    public const int MaxTintValue = 32767
    Field Value
    Type
    System.Int32

    TopToBottomRotation

    Indicates that text is drawn from top to bottom.

    Declaration
    public const int TopToBottomRotation = 255
    Field Value
    Type
    System.Int32

    Properties

    Borders

    Declaration
    public IBorders Borders { get; }
    Property Value
    Type
    IBorders

    BottomBorderColor

    Get/set BottomBorder color.

    Declaration
    public ColorObject BottomBorderColor { get; }
    Property Value
    Type
    ColorObject

    BottomBorderLineStyle

    Gets / sets line style of the bottom border.

    Declaration
    public ExcelLineStyle BottomBorderLineStyle { get; set; }
    Property Value
    Type
    ExcelLineStyle

    Color

    Returns or sets the cell shading color.

    Declaration
    public Color Color { get; set; }
    Property Value
    Type
    System.Drawing.Color

    ColorIndex

    Returns or sets the color of the interior. The color is specified as an index value into the current color palette.

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

    ColorObject

    Returns or sets the cell shading color.

    Declaration
    public ColorObject ColorObject { get; }
    Property Value
    Type
    ColorObject

    DiagonalBorderColor

    Get/set DiagonalUpBorder color.

    Declaration
    public ColorObject DiagonalBorderColor { get; }
    Property Value
    Type
    ColorObject

    DiagonalDownBorderLineStyle

    Gets / sets line style of the diagonal border.

    Declaration
    public ExcelLineStyle DiagonalDownBorderLineStyle { get; set; }
    Property Value
    Type
    ExcelLineStyle

    DiagonalDownVisible

    Indicates whether DiagonalDown line is visible.

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

    DiagonalUpBorderLineStyle

    Gets / sets line style of the diagonal border.

    Declaration
    public ExcelLineStyle DiagonalUpBorderLineStyle { get; set; }
    Property Value
    Type
    ExcelLineStyle

    DiagonalUpVisible

    Indicates whether DiagonalUp line is visible.

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

    FillBackground

    Get / set fill background color.

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

    FillBackgroundRGB

    Get / set fill background color.

    Declaration
    public Color FillBackgroundRGB { get; set; }
    Property Value
    Type
    System.Drawing.Color

    FillForeground

    Get / set fill foreground color.

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

    FillForegroundRGB

    Get / set fill foreground color.

    Declaration
    public Color FillForegroundRGB { get; set; }
    Property Value
    Type
    System.Drawing.Color

    FillPattern

    Get / set fill pattern.

    Declaration
    public ExcelPattern FillPattern { get; set; }
    Property Value
    Type
    ExcelPattern

    Font

    Gets font object for this extended format. Read-only.

    Declaration
    public virtual IFont Font { get; }
    Property Value
    Type
    IFont

    FontIndex

    Get / set font index.

    Declaration
    public int FontIndex { get; set; }
    Property Value
    Type
    System.Int32

    FormulaHidden

    Indicates whether formula is hidden.

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

    Gradient

    Gets / sets gradient object.

    Declaration
    public IGradient Gradient { get; set; }
    Property Value
    Type
    IGradient

    HasBorder

    Gets or sets whether border is present

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

    HasParent

    Indicates whether this format is child format.

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

    HorizontalAlignment

    Horizontal alignment.

    Declaration
    public ExcelHAlign HorizontalAlignment { get; set; }
    Property Value
    Type
    ExcelHAlign

    IncludeAlignment

    Flag for horizontal and vertical alignment, text wrap, indentation, orientation, rotation, and text direction. If False, the attribute of parent style is used.

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

    IncludeBorder

    Flag for border lines. If False, the attribute of parent style is used.

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

    IncludeFont

    Flag for font. If False, the attribute of parent style is used.

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

    IncludeNumberFormat

    Flag for number format. If False, the attribute of parent style is used.

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

    IncludePatterns

    Flag for background area style. If False, the attribute of parent style is used.

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

    IncludeProtection

    Flag for cell protection (cell locked and formula hidden). If False, the attribute of parent style is used.

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

    IndentLevel

    Indent level.

    Declaration
    public int IndentLevel { get; set; }
    Property Value
    Type
    System.Int32

    InnerBottomBorderColor

    Returns color of the bottom border. Read-only.

    Declaration
    protected ColorObject InnerBottomBorderColor { get; }
    Property Value
    Type
    ColorObject

    InnerColor

    Declaration
    protected ColorObject InnerColor { get; }
    Property Value
    Type
    ColorObject

    InnerDiagonalBorderColor

    Returns color of the diagonal border. Read-only.

    Declaration
    protected ColorObject InnerDiagonalBorderColor { get; }
    Property Value
    Type
    ColorObject

    InnerLeftBorderColor

    Returns color of the left border. Read-only.

    Declaration
    protected ColorObject InnerLeftBorderColor { get; }
    Property Value
    Type
    ColorObject

    InnerPatternColor

    Declaration
    protected ColorObject InnerPatternColor { get; }
    Property Value
    Type
    ColorObject

    InnerRightBorderColor

    Returns color of the right border. Read-only.

    Declaration
    protected ColorObject InnerRightBorderColor { get; }
    Property Value
    Type
    ColorObject

    InnerTopBorderColor

    Returns color of the top border. Read-only.

    Declaration
    protected ColorObject InnerTopBorderColor { get; }
    Property Value
    Type
    ColorObject

    IsDefaultColor

    Indicates whether color is default. Read-only.

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

    IsDefaultPatternColor

    Indicates whether pattern color is default. Read-only.

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

    IsFirstSymbolApostrophe

    If true then first symbol in cell is apostrophe.

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

    IsModified

    Gets value indicating whether format was modified, compared to parent format.

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

    JustifyLast

    For far east languages. Supported only for format. Always 0 for US.

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

    LeftBorderColor

    Get/set LeftBorder color.

    Declaration
    public ColorObject LeftBorderColor { get; }
    Property Value
    Type
    ColorObject

    LeftBorderLineStyle

    Gets / sets line style of the left border.

    Declaration
    public ExcelLineStyle LeftBorderLineStyle { get; set; }
    Property Value
    Type
    ExcelLineStyle

    Locked

    Indicates whether cell with this XF is locked.

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

    NumberFormat

    Returns or sets the format code for the object. Read/write String.

    Declaration
    public string NumberFormat { get; set; }
    Property Value
    Type
    System.String

    NumberFormatIndex

    Get / set Format index.

    Declaration
    public int NumberFormatIndex { get; set; }
    Property Value
    Type
    System.Int32

    NumberFormatLocal

    Returns or sets the format code for the object as a string in the language of the user. Read/write String.

    Declaration
    public string NumberFormatLocal { get; set; }
    Property Value
    Type
    System.String

    NumberFormatObject

    Gets number format object.

    Declaration
    public FormatImpl NumberFormatObject { get; }
    Property Value
    Type
    FormatImpl

    NumberFormatSettings

    Returns object that describes number format. Read-only.

    Declaration
    public INumberFormat NumberFormatSettings { get; }
    Property Value
    Type
    INumberFormat

    ParentCollection

    Returns parent collection. Read-only.

    Declaration
    protected ExtendedFormatsCollection ParentCollection { get; }
    Property Value
    Type
    Syncfusion.XlsIO.Implementation.Collections.ExtendedFormatsCollection

    PatternColor

    Returns or sets the color of the interior pattern as an Color value.

    Declaration
    public Color PatternColor { get; set; }
    Property Value
    Type
    System.Drawing.Color

    PatternColorIndex

    Returns or sets the color of the interior pattern as an index into the current color palette.

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

    PatternColorObject

    Returns or sets the color of the interior pattern as an Color value.

    Declaration
    public ColorObject PatternColorObject { get; }
    Property Value
    Type
    ColorObject

    Properties

    List of extended property.

    Declaration
    public List<ExtendedProperty> Properties { get; set; }
    Property Value
    Type
    System.Collections.Generic.List<Syncfusion.XlsIO.Parser.Biff_Records.ExtendedProperty>

    ReadingOrder

    Text direction, the reading order for far east versions.

    Declaration
    public ExcelReadingOrderType ReadingOrder { get; set; }
    Property Value
    Type
    ExcelReadingOrderType

    Record

    Read-only. Returns ExtendedFormatRecord with information about this format.

    Declaration
    public ExtendedFormatRecord Record { get; protected set; }
    Property Value
    Type
    Syncfusion.XlsIO.Parser.Biff_Records.ExtendedFormatRecord

    RightBorderColor

    Get/set RightBorder color.

    Declaration
    public ColorObject RightBorderColor { get; }
    Property Value
    Type
    ColorObject

    RightBorderLineStyle

    Gets / sets line style of the right border.

    Declaration
    public ExcelLineStyle RightBorderLineStyle { get; set; }
    Property Value
    Type
    ExcelLineStyle

    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 int Rotation { get; set; }
    Property Value
    Type
    System.Int32
    Exceptions
    Type Condition
    System.ArgumentOutOfRangeException

    Thrown when value is more than 0xFF.

    ShrinkToFit

    True- Indicates that the contents are shrunk to fit into cell.

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

    TopBorderColor

    Get/set TopBorder color.

    Declaration
    public ColorObject TopBorderColor { get; }
    Property Value
    Type
    ColorObject

    TopBorderLineStyle

    Gets / sets line style of the top border.

    Declaration
    public ExcelLineStyle TopBorderLineStyle { get; set; }
    Property Value
    Type
    ExcelLineStyle

    VerticalAlignment

    Vertical alignment.

    Declaration
    public ExcelVAlign VerticalAlignment { get; set; }
    Property Value
    Type
    ExcelVAlign

    Workbook

    Returns parent workbook.

    Declaration
    public WorkbookImpl Workbook { get; }
    Property Value
    Type
    WorkbookImpl

    WrapText

    True - Indicates that text is wrapped at right border.

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

    XFormatIndex

    Gets format index in m_book.InnerFormats.

    Declaration
    public int XFormatIndex { get; }
    Property Value
    Type
    System.Int32

    XFRecord

    Read-only. Returns ExtendedXFormat with information about this format.

    Declaration
    public ExtendedXFRecord XFRecord { get; protected set; }
    Property Value
    Type
    Syncfusion.XlsIO.Parser.Biff_Records.ExtendedXFRecord

    XFType

    Type of the extended format.

    Declaration
    public ExtendedFormatRecord.TXFType XFType { get; set; }
    Property Value
    Type
    Syncfusion.XlsIO.Parser.Biff_Records.ExtendedFormatRecord.TXFType

    Methods

    BeginUpdate()

    Starts updating process.

    Declaration
    public void BeginUpdate()

    Clear()

    Clears the format

    Declaration
    public void Clear()

    Clone()

    Creates a new object that is a copy of the current instance.

    Declaration
    public object Clone()
    Returns
    Type Description
    System.Object

    A new object that is a copy of the current instance.

    CompareTo(ExtendedFormatImpl)

    Declaration
    public int CompareTo(ExtendedFormatImpl twin)
    Parameters
    Type Name Description
    ExtendedFormatImpl twin
    Returns
    Type
    System.Int32

    CompareTo(Object)

    Compares the current instance with another object of the same type.

    Declaration
    public int CompareTo(object obj)
    Parameters
    Type Name Description
    System.Object obj

    Object to compare with this instance.

    Returns
    Type Description
    System.Int32

    Less than zero - This instance is less than obj. Zero - This instance is equal to obj. Greater than zero - This instance is greater than obj.

    CompareToWithoutIndex(ExtendedFormatImpl)

    Compares formats without comparing indexes.

    Declaration
    public int CompareToWithoutIndex(ExtendedFormatImpl twin)
    Parameters
    Type Name Description
    ExtendedFormatImpl twin

    Format to compare.

    Returns
    Type Description
    System.Int32

    0 if formats are equal.

    CopyColorsFrom(ExtendedFormatImpl)

    Copies color settings from specified format object.

    Declaration
    protected void CopyColorsFrom(ExtendedFormatImpl format)
    Parameters
    Type Name Description
    ExtendedFormatImpl format

    CopyFromTo(ExtendedFormatImpl, ExtendedFormatImpl, Boolean)

    Copies one extended format into another.

    Declaration
    public static void CopyFromTo(ExtendedFormatImpl childFormat, ExtendedFormatImpl parentFormat, bool bSetFlag)
    Parameters
    Type Name Description
    ExtendedFormatImpl childFormat

    Destination format.

    ExtendedFormatImpl parentFormat

    Source format.

    System.Boolean bSetFlag

    Indicates whether we should change corresponding Include... flag(s) after copying data.

    CopyTo(ExtendedFormatImpl)

    Copies all data from this XF into another.

    Declaration
    public void CopyTo(ExtendedFormatImpl twin)
    Parameters
    Type Name Description
    ExtendedFormatImpl twin

    Format to copy into.

    CreateChildFormat()

    Creates child format if this format is for named style and registers it in workbook.

    Declaration
    public ExtendedFormatImpl CreateChildFormat()
    Returns
    Type Description
    ExtendedFormatImpl

    Child format.

    CreateChildFormat(ExtendedFormatImpl)

    Declaration
    public ExtendedFormatImpl CreateChildFormat(ExtendedFormatImpl oldFormat)
    Parameters
    Type Name Description
    ExtendedFormatImpl oldFormat
    Returns
    Type
    ExtendedFormatImpl

    CreateChildFormat(Boolean)

    Creates child format if this format is for named style.

    Declaration
    public ExtendedFormatImpl CreateChildFormat(bool bRegister)
    Parameters
    Type Name Description
    System.Boolean bRegister

    Defines whether to register format in workbook.

    Returns
    Type Description
    ExtendedFormatImpl

    Child format.

    EndUpdate()

    Ends updating process.

    Declaration
    public void EndUpdate()

    Equals(Object)

    Determines whether two Object instances are equal.

    Declaration
    public override bool Equals(object obj)
    Parameters
    Type Name Description
    System.Object obj

    The Object to compare with the current Object.

    Returns
    Type Description
    System.Boolean

    True if the specified Object is equal to the current Object; otherwise, False.

    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.

    InitializeColors()

    Initializes color objects.

    Declaration
    protected void InitializeColors()

    SynchronizeWithParent()

    Synchronizes properties with parent record.

    Declaration
    public void SynchronizeWithParent()

    TypedClone(Object)

    Creates a new object that is a copy of the current instance.

    Declaration
    public ExtendedFormatImpl TypedClone(object parent)
    Parameters
    Type Name Description
    System.Object parent
    Returns
    Type Description
    ExtendedFormatImpl

    A new object that is a copy of the current instance.

    UpdateFromCurrentExtendedFormat(ExtendedFormatImpl)

    Updates values from current format.

    Declaration
    public void UpdateFromCurrentExtendedFormat(ExtendedFormatImpl CurrXF)
    Parameters
    Type Name Description
    ExtendedFormatImpl CurrXF

    UpdateFromCurrentExtendedFormatNew(ExtendedFormatImpl, Boolean)

    Updates values from current format

    Declaration
    public void UpdateFromCurrentExtendedFormatNew(ExtendedFormatImpl CurrXF, bool isCellStyle)
    Parameters
    Type Name Description
    ExtendedFormatImpl CurrXF

    Source extended format record to copy from

    System.Boolean isCellStyle

    UpdateFromParent()

    Updates values from parent format and initializes colors if necessary.

    Declaration
    public void UpdateFromParent()

    Explicit Interface Implementations

    ICloneParent.Clone(Object)

    Creates a new object that is a copy of the current instance.

    Declaration
    object ICloneParent.Clone(object parent)
    Parameters
    Type Name Description
    System.Object parent

    Parent object for a copy of this instance.

    Returns
    Type Description
    System.Object

    A new object that is a copy of this instance.

    Implements

    IExtendedFormat
    IParentApplication
    System.IComparable
    System.ICloneable
    IXFIndex
    ICloneParent
    System.IDisposable
    Back to top Generated by DocFX
    Copyright © 2001 - 2025 Syncfusion Inc. All Rights Reserved