FormatCode

ChartNumberFormat.FormatCode property

Obtiene o establece el código de formato aplicado a una etiqueta de datos.

public string FormatCode { get; set; }

Observaciones

El formato numérico se usa para cambiar la forma en que aparece un valor en la etiqueta de datos y se puede usar de maneras muy creativas. Los ejemplos de formatos numéricos:

Número: “#,##0,00”

Moneda - “"$"#,##0.00”

Hora: “[$-x-systime]h:mm:ss AM/PM”

Fecha: “d/mm/aaaa”

Porcentaje - “0,00%”

Fracción - “# ?/?”

Científico - “0.00E+00”

Texto - “@”

Contabilidad - “-"$"* #,##0.00-;-"$"* #,##0.00_-;-"$"* "-"?? -;-@-”

Personalizado con color: “[Rojo]-#,##0.0”

Ejemplos

Muestra cómo configurar el formato para los valores del gráfico.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertChart(ChartType.Column, 500, 300);
Chart chart = shape.Chart;

// Borra la serie de datos de demostración del gráfico para comenzar con un gráfico limpio.
chart.Series.Clear();

// Agrega una serie personalizada al gráfico con categorías para el eje X,
 // y valores numéricos respectivos grandes para el eje Y.
chart.Series.Add("Aspose Test Series",
    new [] { "Word", "PDF", "Excel", "GoogleDocs", "Note" },
    new double[] { 1900000, 850000, 2100000, 600000, 1500000 });

 // Establece el formato numérico de las etiquetas de marca del eje Y para no agrupar dígitos con comas.
chart.AxisY.NumberFormat.FormatCode = "#,##0";

// Esta bandera puede anular el valor anterior y extraer el formato numérico de la celda de origen.
Assert.False(chart.AxisY.NumberFormat.IsLinkedToSource);

doc.Save(ArtifactsDir + "Charts.SetNumberFormatToChartAxis.docx");

Muestra cómo habilitar y configurar etiquetas de datos para una serie de gráficos.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Agregue un gráfico de líneas, luego borre su serie de datos de demostración para comenzar con un gráfico limpio,
// y luego establece un título.
Shape shape = builder.InsertChart(ChartType.Line, 500, 300);
Chart chart = shape.Chart;
chart.Series.Clear();
chart.Title.Text = "Monthly sales report";

// Inserta una serie de gráficos personalizados con meses como categorías para el eje X,
// y respectivas cantidades decimales para el eje Y.
ChartSeries series = chart.Series.Add("Revenue", 
    new[] { "January", "February", "March" }, 
    new[] { 25.611d, 21.439d, 33.750d });

// Habilite las etiquetas de datos y luego aplique un formato de número personalizado para los valores que se muestran en las etiquetas de datos.
// Este formato tratará los valores decimales mostrados como millones de dólares estadounidenses.
series.HasDataLabels = true;
ChartDataLabelCollection dataLabels = series.DataLabels;
dataLabels.ShowValue = true;
dataLabels.NumberFormat.FormatCode = "\"US$\" #,##0.000\"M\"";
dataLabels.Font.Size = 12;            

doc.Save(ArtifactsDir + "Charts.DataLabelNumberFormat.docx");

Ver también