XlFont.CustomFont(String) Method

Creates the XlFont object that specifies a custom font with the given face name.

Namespace: DevExpress.Export.Xl

Assembly: DevExpress.Printing.v24.1.Core.dll

NuGet Package: DevExpress.Printing.Core

Declaration

C#

public static XlFont CustomFont(
    string fontName
)

VB.NET

Public Shared Function CustomFont(
    fontName As String
) As XlFont

Parameters

Name	Type	Description
fontName	String	A String value that specifies the font name.

Returns

Type	Description
XlFont	An XlFont class instance that represents the custom font.

Remarks

Use the static CustomFont methods to create the XlFont class instance with the specified font attributes (font name, size and/or color). To apply this font to cell content, assign the XlFont object to the IXlCell.Formatting property or pass it to the IXlCell.ApplyFormatting method as a parameter, as shown in the example below.

C#

using (IXlSheet sheet = document.CreateSheet()) {
    // Create the first row in the worksheet.
    using (IXlRow row = sheet.CreateRow()){
        // Create the first cell in the row.
        using (IXlCell cell = row.CreateCell())
        {
            // Set the cell value.
            cell.Value = "Custom font";
            // Specify the custom font attributes.
            XlFont font = XlFont.CustomFont("Century Gothic", 14, Color.DeepSkyBlue);
            font.Bold = true;
            // Apply the custom font to the cell content.
            cell.ApplyFormatting(font);
        }
    }
}

VB.NET

Using sheet As IXlSheet = document.CreateSheet()
    ' Create the first row in the worksheet.
    Using row As IXlRow = sheet.CreateRow()
        ' Create the first cell in the row.
        Using cell As IXlCell = row.CreateCell()
            ' Set the cell value.
            cell.Value = "Custom font"
            ' Specify the custom font attributes.
            Dim font As XlFont = XlFont.CustomFont("Century Gothic", 14, Color.DeepSkyBlue)
            font.Bold = True
            ' Apply the custom font to the cell content.
            cell.ApplyFormatting(font)
        End Using
    End Using
End Using

You can also use the XlFontBase.Name property of the XlFont object to define a particular cell font. For more information on how to specify font settings for an individual cell, refer to the How to: Configure Cell Font Settings article.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the CustomFont(String) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-grid-copy-cells-in-biff8-format-using-excel-export-api/CS/gridCopyToClipboardExample/CopyToClipboardHelper.cs#L90

Font appearanceFont = appearance.Font;
XlFont font = XlFont.CustomFont(appearanceFont.Name);
font.Size = appearanceFont.SizeInPoints;

VB.NET

winforms-grid-copy-cells-in-biff8-format-using-excel-export-api/VB/gridCopyToClipboardExample/CopyToClipboardHelper.vb#L81

Dim appearanceFont As Font = appearance.Font
Dim font As XlFont = XlFont.CustomFont(appearanceFont.Name)
font.Size = appearanceFont.SizeInPoints