Trabajando con los Gráficos
El nuevo insertChart método se agregó en el DocumentBuilder clase. Así que veamos cómo insertar un gráfico de columna simple en el documento usando insertar Chart método.
Cómo insertar un gráfico desde Scratch utilizando Aspose.Words
En esta sección aprenderemos a insertar un gráfico en un documento.
Insertar la columna Chart
El siguiente ejemplo de código muestra cómo insertar el gráfico de columna:
El código produce el siguiente resultado:
Hay cuatro sobrecargas diferentes para la serie Agregar método, que fueron expuestos a cubrir todas las posibles variantes de fuentes de datos para todos los tipos de gráficos:
El código produce el siguiente resultado:
Insertar Scatter Chart
El siguiente ejemplo de código muestra cómo insertar una tabla de distribución:
El código produce el siguiente resultado:
Insertar la zona Chart
El siguiente ejemplo de código muestra cómo insertar un diagrama de área:
El código produce el siguiente resultado:
Insertar Bubble Chart
El siguiente ejemplo de código muestra cómo insertar un gráfico de burbujas:
El código produce el siguiente resultado:
Trabajando con los Gráficos a través Shape.Chart
Objeto
Una vez que el gráfico fue insertado y lleno de datos, usted es capaz de cambiar su apariencia. Shape.Chart propiedad contiene todas las opciones relacionadas con el gráfico disponibles a través del público API.
Por ejemplo, cambiemos. Título de Gráfico o comportamiento de leyenda:
El código genera los siguientes resultados:
Cómo trabajar con ChartSeriesColección de Chart
Miremos en ChartSeries colección. Todas las series de gráficos están disponibles a través de chart.getSeries() colección, que es Iterable:
Usted puede eliminar la serie uno por uno o limpiar todos ellos, así como añadir una nueva si es necesario. El gráfico recién insertado tiene algunas series predeterminadas agregadas a esta colección. Para eliminarlos necesitas llamar al gráfico.getSeries().clear() método.
Trabajando con la clase de serie de gráficos individuales
Aquí es cómo trabajar con una serie particular.
Véase el resultado a continuación:
Todo soltero ChartSeries Por defecto ChartDataPoint opciones, por favor trate de usar el siguiente código para cambiarlos:
Cómo trabajar con un solo ChartDataPoint de un ChartSeries
Uso ChartDataPoint usted es capaz de personalizar el formato de un único punto de datos de la serie de gráficos:
Véase el resultado a continuación:
Cómo trabajar con ChartDataLabel de una sola tabla
Uso ChartDataLabel puede especificar el formato de una sola etiqueta de datos de la serie de gráficos, como show/hide LegendKey, CategoryName, SeriesName, Valor etc:
Véase el resultado a continuación:
Cómo definir las opciones predeterminadas para ChartDataLabels of ChartSeries
El ChartDataLabelCollection clase define propiedades que se pueden utilizar para establecer opciones predeterminadas ChartDataLabels para Chart Series. Estas propiedades incluyen setShowCategoryName, setShowBubbleSize, setShowPercentage, setShowName, setShow Valor etc:
Véase el resultado a continuación:
Cómo Formato Número de etiqueta de datos de gráficos
Usando el NumberFormat propiedad, puede especificar el formato número de una sola etiqueta de datos del gráfico.
El siguiente ejemplo de código muestra cómo formatear un número de la etiqueta de datos:
Cómo establecer las propiedades de eje de carga
Si desea trabajar con ejes de gráficos, escalas y unidades de visualización para el eje de valor, por favor use ChartAxis, AxisDisplayUnit, y AxisScaling clases.
El siguiente ejemplo de código muestra cómo definir las propiedades X y Y-axis:
Cómo establecer DateValor del tiempo del eje
El siguiente ejemplo de código muestra cómo establecer valores de fecha/hora a las propiedades del eje:
Cómo Formato Número de valor de eje
El siguiente ejemplo de código muestra cómo cambiar el formato de los números en el eje de valor:
Cómo establecer libras de eje
El AxisBound
clase representa un límite mínimo o máximo de valores del eje. La montura se puede especificar como un valor numérico, de fecha o un “auto” especial.
El siguiente ejemplo de código muestra cómo establecer los límites de un eje:
Cómo establecer Unidad Interval entre etiquetas
El siguiente ejemplo de código muestra cómo establecer la unidad de intervalo entre etiquetas en un eje:
Cómo ocultar el eje de la gráfica
Si desea mostrar o ocultar el eje de la gráfica, simplemente puede lograrlo estableciendo el valor ChartAxis.Hidden
propiedad.
El siguiente ejemplo de código muestra cómo ocultar el eje Y del gráfico:
Cómo alinear Chart Label
Si desea establecer una alineación de texto para etiquetas multilínea, simplemente puede lograrlo estableciendo el valor de setTickLabelAlignment() propiedad.
El siguiente ejemplo de código muestra cómo marcar la alineación de etiquetas:
Cómo configurar el formato Fill y Stroke
El formato de relleno y trazo se puede configurar para series de gráficos, puntos de datos y marcadores. Para ello, es necesario utilizar las propiedades de las ChartFormat
tipo en las clases de ChartSeries, ChartDataPoint y ChartMarker, así como alias para algunas propiedades, como ForeColor, BackColor, Visible y Transparencia en Stroke
clase.
El siguiente ejemplo de código muestra cómo configurar el color de serie:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Create category names array.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };
// Adding new series. Value and category arrays must be the same size.
ChartSeries series1 = seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
ChartSeries series2 = seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
ChartSeries series3 = seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
// Set series color.
series1.Format.Fill.ForeColor = Color.Red;
series2.Format.Fill.ForeColor = Color.Yellow;
series3.Format.Fill.ForeColor = Color.Blue;
doc.Save("ColumnColor.docx");
El siguiente ejemplo de código muestra cómo configurar el color y el peso de la línea:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Adding new series.
ChartSeries series1 = seriesColl.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });
ChartSeries series2 = seriesColl.Add("AW Series 2", new double[] { 0.5, 1.5, 2.5 }, new double[] { 3, 1, 2 });
// Set series color.
series1.Format.Stroke.ForeColor = Color.Red;
series1.Format.Stroke.Weight = 5;
series2.Format.Stroke.ForeColor = Color.LightGreen;
series2.Format.Stroke.Weight = 5;
doc.Save("LineColorAndWeight.docx");