Añadir más elementos al documento - Parte IV

En este cuarto tutorial de la serie, veremos cómo añadir gráficos a los documentos.

Más información Xceed Words para .NET

Esta semana veremos cómo añadir gráficos a los documentos.

Gráficos

Cuando se quiere llamar la atención del lector, un gráfico ofrece la posibilidad de mostrar información y datos de una forma más visual que una tabla.

Creación de un gráfico

Actualmente hay 3 tipos de gráficos disponibles: Gráfico de barras, Gráfico de líneas y Gráfico circular.

// Create a new BarChart
var c1 = new BarChart();

// Create a new LineChart
var c2 = new LineChart();

// Create a new PieChart
var c3 = new PieChart();

Leyenda del gráfico

Un ChartLegend no es obligatorio, pero puede facilitar al lector la comprensión de los datos mostrados en el gráfico. Para añadir un ChartLegend se llama a la función AñadirLeyenda en el gráfico. Los parámetros a incluir son la posición del gráfico (Inferior, Izquierda, Derecha, Superior o SuperiorDerecha), y si se permite que los elementos del gráfico se superpongan a este ChartLegend (true/false).

// Add a ChartLegent
c.AddLegend( ChartLegendPosition.Left, false );

La eliminación del ChartLegend existente de un gráfico se realiza llamando a su función EliminarLeyenda método.

// Remove the ChartLegend
c.RemoveLegend();

Datos gráficos

En un escenario real, lo más probable es que tenga una base de datos de la que obtener los datos. Para nuestro ejemplo, crearemos algunos datos nosotros mismos utilizando una simple clase ChartData que contiene 2 propiedades: Categoría (cadena) y Gastos (doble).

// Create the data.
var canada = new List()
{
  new ChartData() { Category = "Food", Expenses = 100 },
  new ChartData() { Category = "Housing", Expenses = 120 },
  new ChartData() { Category = "Transportation", Expenses = 140 },
  new ChartData() { Category = "Health Care", Expenses = 150 }
};
var usa = new List()
{
  new ChartData() { Category = "Food", Expenses = 200 },
  new ChartData() { Category = "Housing", Expenses = 150 },
  new ChartData() { Category = "Transportation", Expenses = 110 },
  new ChartData() { Category = "Health Care", Expenses = 100 }
};
var brazil = new List()
{
  new ChartData() { Category = "Food", Expenses = 125 },
  new ChartData() { Category = "Housing", Expenses = 80 },
  new ChartData() { Category = "Transportation", Expenses = 110 },
  new ChartData() { Category = "Health Care", Expenses = 60 }
};

 A continuación, crearemos una serie con los datos y la añadiremos al gráfico llamando a su función AñadirSerie método.

// Create and add series by binding X and Y.
var s1 = new Series( "Brazil" );
s1.Bind( brazil, "Category", "Expenses" );
c.AddSeries( s1 );

var s2 = new Series( "USA" );
s2.Bind( usa, "Category", "Expenses" );
c.AddSeries( s2 );

var s3 = new Series( "Canada" );
s3.Bind( canada, "Category", "Expenses" );
c.AddSeries( s3 );

Añadir gráficos

Una vez que el Gráfico está listo, se puede añadir a un documento llamando a InsertarGráfico o InsertChartAfterParagraph en el Documento.

// Create a new chart
var chart = new BarChart();

// Add data to the chart
// ...

// Option 1: Insert the chart at the end of the document
document.InsertChart( chart );

// Option 2: Insert the chart after the specified paragraph in the document
var paragraph = document.paragraphs[ 3 ];
document.InsertChart( chart , paragraph );

Nota: Tanto el InsertarGráfico y InsertChartAfterParagraph también admite 2 parámetros opcionales adicionales, para indicar una anchura y una altura para el gráfico. 

Eliminar gráficos

La eliminación de un Gráfico existente de un documento se realiza llamando a Eliminar en el XML del gráfico.

// Remove a Chart
chart.Xml.Remove();

Para más información, consulte el documentación.