NumericOptions.Format Property

Gets or sets a value that specifies the formatting applied to numeric values.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v23.2.dll

NuGet Package: DevExpress.Wpf.Charts

Declaration

C#

public NumericFormat Format { get; set; }

VB.NET

Public Property Format As NumericFormat

Property Value

Type	Description
NumericFormat	A NumericFormat enumeration value.

Available values:

Name	Description
General	Displays numbers without any specific formatting applied to them. Integer and fractional parts are separated using the decimal symbol specified in your computer’s regional settings. Example: 100.
Scientific	Displays numbers using standard scientific notation. This format is determined by your computer’s regional settings. Example: 1.00E+002.
FixedPoint	Displays numbers as real numeric values with the specified number of decimal places. The number of decimal places is specified by the NumericOptions.Precision property, and the decimal separator is based upon your computer’s regional settings. Example: 100.00.
Currency	Displays numbers as currency, using the currency format specified in your computer’s regional settings. Example: $100.
Percent	Displays numbers multiplied by 100 with a percent sign (%) appended to the right; displays two digits to the right of the symbol specified in your computer’s regional settings. Example: 100 %.
Number	Displays numbers as numeric values, using the number format specified in your computer’s regional settings. Example: 100.00.

Property Paths

You can access this nested property as listed below:

Object Type	Path to Format
PointOptions	.ArgumentNumericOptions .Format
PointOptions	.ValueNumericOptions .Format

Remarks

Use the Format property, to define the appropriate format for numeric values representation in axis labels, series point labels or in legend.

Example

This example demonstrates how to customize the PointOptions.ValueNumericOptions and PercentOptions properties.

Window1.xaml

<dxc:AreaFullStackedSeries2D.PointOptions>
    <dxc:PointOptions>
        <dxc:PointOptions.ValueNumericOptions>
            <dxc:NumericOptions Format="Percent" Precision="2" />
        </dxc:PointOptions.ValueNumericOptions>
        <dxc:AreaFullStackedSeries2D.PercentOptions>
            <dxc:PercentOptions PercentageAccuracy="3" />
        </dxc:AreaFullStackedSeries2D.PercentOptions>
    </dxc:PointOptions>
</dxc:AreaFullStackedSeries2D.PointOptions>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Format property.

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.

XAML

pivotgridcontrol-and-gaugecontrol-integration-e3332/CS/PivotGauges/MainWindow.xaml#L17

<dxc:PointOptions.ValueNumericOptions>
    <dxc:NumericOptions Format="Currency" Precision="0" />
</dxc:PointOptions.ValueNumericOptions>

wpf-data-grid-display-chart-control-in-grid-details/CS/WpfApplication19/MainWindow.xaml#L27

<dxc:PointOptions.ValueNumericOptions>
    <dxc:NumericOptions Format="Percent" Precision="0"/>
</dxc:PointOptions.ValueNumericOptions>

wpf-data-grid-create-master-detail-grid-in-code/CS/MasterDetailInCode/MainWindow.xaml#L24

<dxc:PointOptions.ValueNumericOptions>
    <dxc:NumericOptions Format="Percent" Precision="0"/>
</dxc:PointOptions.ValueNumericOptions>