Formato de Gráficos
Formatear Entidades de Gráficos
Aspose.Slides para Java permite a los desarrolladores agregar gráficos personalizados a sus diapositivas desde cero. Este artículo explica cómo formatear diferentes entidades de gráficos, incluyendo el eje de categoría y el eje de valores.
Aspose.Slides para Java proporciona una API simple para gestionar diferentes entidades de gráficos y formatearlas utilizando valores personalizados:
- Cree una instancia de la clase Presentation.
- Obtenga una referencia de la diapositiva por su índice.
- Agregue un gráfico con datos predeterminados junto con el tipo deseado (en este ejemplo utilizaremos ChartType.LineWithMarkers).
- Acceda al Eje de Valores del gráfico y configure las siguientes propiedades:
- Estableciendo Formato de Línea para las Líneas de Cuadrícula Mayores del Eje de Valores
- Estableciendo Formato de Línea para las Líneas de Cuadrícula Menores del Eje de Valores
- Estableciendo Formato de Número para el Eje de Valores
- Estableciendo Mínimo, Máximo, Unidades Mayores y Menores para el Eje de Valores
- Estableciendo Propiedades de Texto para los datos del Eje de Valores
- Estableciendo Título para el Eje de Valores
- Estableciendo Formato de Línea para el Eje de Valores
- Acceda al Eje de Categoría del gráfico y configure las siguientes propiedades:
- Estableciendo Formato de Línea para las Líneas de Cuadrícula Mayores del Eje de Categoría
- Estableciendo Formato de Línea para las Líneas de Cuadrícula Menores del Eje de Categoría
- Estableciendo Propiedades de Texto para los datos del Eje de Categoría
- Estableciendo Título para el Eje de Categoría
- Estableciendo Posicionamiento de Etiquetas para el Eje de Categoría
- Estableciendo Ángulo de Rotación para las etiquetas del Eje de Categoría
- Acceda a la Leyenda del gráfico y configure las Propiedades de Texto para ellas
- Establezca mostrar las Leyendas de gráficos sin superponerse al gráfico
- Acceda al Eje Secundario de Valores del gráfico y configure las siguientes propiedades:
- Habilitar el Eje Secundario de Valores
- Estableciendo Formato de Línea para el Eje Secundario de Valores
- Estableciendo Formato de Número para el Eje Secundario de Valores
- Estableciendo Mínimo, Máximo, Unidades Mayores y Menores para el Eje Secundario de Valores
- Ahora trace la primera serie de gráficos en el Eje Secundario de Valores
- Establezca el color de relleno de la pared trasera del gráfico
- Establezca el color de relleno del área de trama del gráfico
- Escriba la presentación modificada en un archivo PPTX
// Crear una instancia de la clase Presentation
Presentation pres = new Presentation();
try {
// Accediendo a la primera diapositiva
ISlide slide = pres.getSlides().get_Item(0);
// Agregando el gráfico de muestra
IChart chart = slide.getShapes().addChart(ChartType.LineWithMarkers, 50, 50, 500, 400);
// Estableciendo el Título del Gráfico
chart.hasTitle();
chart.getChartTitle().addTextFrameForOverriding("");
IPortion chartTitle = chart.getChartTitle().getTextFrameForOverriding().getParagraphs().get_Item(0).getPortions().get_Item(0);
chartTitle.setText("Gráfico de Muestra");
chartTitle.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
chartTitle.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);
chartTitle.getPortionFormat().setFontHeight(20);
chartTitle.getPortionFormat().setFontBold(NullableBool.True);
chartTitle.getPortionFormat().setFontItalic(NullableBool.True);
// Estableciendo el formato de las líneas de cuadrícula mayores para el eje de valores
chart.getAxes().getVerticalAxis().getMajorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.Solid);
chart.getAxes().getVerticalAxis().getMajorGridLinesFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
chart.getAxes().getVerticalAxis().getMajorGridLinesFormat().getLine().setWidth(5);
chart.getAxes().getVerticalAxis().getMajorGridLinesFormat().getLine().setDashStyle(LineDashStyle.DashDot);
// Estableciendo el formato de las líneas de cuadrícula menores para el eje de valores
chart.getAxes().getVerticalAxis().getMinorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.Solid);
chart.getAxes().getVerticalAxis().getMinorGridLinesFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.RED);
chart.getAxes().getVerticalAxis().getMinorGridLinesFormat().getLine().setWidth(3);
// Estableciendo el formato de número del eje de valores
chart.getAxes().getVerticalAxis().isNumberFormatLinkedToSource();
chart.getAxes().getVerticalAxis().setDisplayUnit(DisplayUnitType.Thousands);
chart.getAxes().getVerticalAxis().setNumberFormat("0.0%");
// Estableciendo los valores máximos y mínimos del gráfico
chart.getAxes().getVerticalAxis().isAutomaticMajorUnit();
chart.getAxes().getVerticalAxis().isAutomaticMaxValue();
chart.getAxes().getVerticalAxis().isAutomaticMinorUnit();
chart.getAxes().getVerticalAxis().isAutomaticMinValue();
chart.getAxes().getVerticalAxis().setMaxValue(15f);
chart.getAxes().getVerticalAxis().setMinValue(-2f);
chart.getAxes().getVerticalAxis().setMinorUnit(0.5f);
chart.getAxes().getVerticalAxis().setMajorUnit(2.0f);
// Estableciendo las Propiedades de Texto del Eje de Valores
IChartPortionFormat txtVal = chart.getAxes().getVerticalAxis().getTextFormat().getPortionFormat();
txtVal.setFontBold(NullableBool.True);
txtVal.setFontHeight(16);
txtVal.setFontItalic(NullableBool.True);
txtVal.getFillFormat().setFillType(FillType.Solid);
txtVal.getFillFormat().getSolidFillColor().setColor(new Color(PresetColor.DarkGreen));
txtVal.setLatinFont(new FontData("Times New Roman"));
// Estableciendo el título del eje de valores
chart.getAxes().getVerticalAxis().hasTitle();
chart.getAxes().getVerticalAxis().getTitle().addTextFrameForOverriding("");
IPortion valtitle = chart.getAxes().getVerticalAxis().getTitle().getTextFrameForOverriding().getParagraphs().get_Item(0).getPortions().get_Item(0);
valtitle.setText("Eje Primario");
valtitle.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
valtitle.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);
valtitle.getPortionFormat().setFontHeight(20);
valtitle.getPortionFormat().setFontBold(NullableBool.True);
valtitle.getPortionFormat().setFontItalic(NullableBool.True);
// Estableciendo el formato de las líneas de cuadrícula mayores para el eje de categoría
chart.getAxes().getHorizontalAxis().getMajorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.Solid);
chart.getAxes().getHorizontalAxis().getMajorGridLinesFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.GREEN);
chart.getAxes().getHorizontalAxis().getMajorGridLinesFormat().getLine().setWidth(5);
// Estableciendo el formato de las líneas de cuadrícula menores para el eje de categoría
chart.getAxes().getHorizontalAxis().getMinorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.Solid);
chart.getAxes().getHorizontalAxis().getMinorGridLinesFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.YELLOW);
chart.getAxes().getHorizontalAxis().getMinorGridLinesFormat().getLine().setWidth(3);
// Estableciendo las Propiedades de Texto del Eje de Categoría
IChartPortionFormat txtCat = chart.getAxes().getHorizontalAxis().getTextFormat().getPortionFormat();
txtCat.setFontBold(NullableBool.True);
txtCat.setFontHeight(16);
txtCat.setFontItalic(NullableBool.True);
txtCat.getFillFormat().setFillType(FillType.Solid);
txtCat.getFillFormat().getSolidFillColor().setColor(Color.BLUE);
txtCat.setLatinFont(new FontData("Arial"));
// Estableciendo el Título de la Categoría
chart.getAxes().getHorizontalAxis().hasTitle();
chart.getAxes().getHorizontalAxis().getTitle().addTextFrameForOverriding("");
IPortion catTitle = chart.getAxes().getHorizontalAxis().getTitle().getTextFrameForOverriding().getParagraphs().get_Item(0).getPortions().get_Item(0);
catTitle.setText("Categoría de Muestra");
catTitle.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
catTitle.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);
catTitle.getPortionFormat().setFontHeight(20);
catTitle.getPortionFormat().setFontBold(NullableBool.True);
catTitle.getPortionFormat().setFontItalic(NullableBool.True);
// Estableciendo la posición de las etiquetas del eje de categoría
chart.getAxes().getHorizontalAxis().setTickLabelPosition(TickLabelPositionType.Low);
// Estableciendo el ángulo de rotación de las etiquetas del eje de categoría
chart.getAxes().getHorizontalAxis().setTickLabelRotationAngle(45);
// Estableciendo las Propiedades de Texto de las Leyendas
IChartPortionFormat txtleg = chart.getLegend().getTextFormat().getPortionFormat();
txtleg.setFontBold(NullableBool.True);
txtleg.setFontHeight(16);
txtleg.setFontItalic(NullableBool.True);
txtleg.getFillFormat().setFillType(FillType.Solid);
txtleg.getFillFormat().getSolidFillColor().setColor(new Color(PresetColor.DarkRed));
// Establecer mostrar leyendas de gráficos sin superponerse al gráfico
chart.getLegend().setOverlay(true);
// chart.ChartData.Series[0].PlotOnSecondAxis=true;
chart.getChartData().getSeries().get_Item(0).setPlotOnSecondAxis(true);
// Estableciendo el eje secundario de valores
chart.getAxes().getSecondaryVerticalAxis().isVisible();
chart.getAxes().getSecondaryVerticalAxis().getFormat().getLine().setStyle(LineStyle.ThickBetweenThin);
chart.getAxes().getSecondaryVerticalAxis().getFormat().getLine().setWidth(20);
// Estableciendo el formato de número del eje secundario de valores
chart.getAxes().getSecondaryVerticalAxis().isNumberFormatLinkedToSource();
chart.getAxes().getSecondaryVerticalAxis().setDisplayUnit(DisplayUnitType.Hundreds);
chart.getAxes().getSecondaryVerticalAxis().setNumberFormat("0.0%");
// Estableciendo los valores máximos y mínimos del gráfico
chart.getAxes().getSecondaryVerticalAxis().isAutomaticMajorUnit();
chart.getAxes().getSecondaryVerticalAxis().isAutomaticMaxValue();
chart.getAxes().getSecondaryVerticalAxis().isAutomaticMinorUnit();
chart.getAxes().getSecondaryVerticalAxis().isAutomaticMinValue();
chart.getAxes().getSecondaryVerticalAxis().setMaxValue(20f);
chart.getAxes().getSecondaryVerticalAxis().setMinValue(-5f);
chart.getAxes().getSecondaryVerticalAxis().setMinorUnit(0.5f);
chart.getAxes().getSecondaryVerticalAxis().setMajorUnit(2.0f);
// Estableciendo el color de la pared trasera del gráfico
chart.getBackWall().setThickness(1);
chart.getBackWall().getFormat().getFill().setFillType(FillType.Solid);
chart.getBackWall().getFormat().getFill().getSolidFillColor().setColor(Color.ORANGE);
chart.getFloor().getFormat().getFill().setFillType(FillType.Solid);
chart.getFloor().getFormat().getFill().getSolidFillColor().setColor(Color.RED);
// Estableciendo el color del área de trazo
chart.getPlotArea().getFormat().getFill().setFillType(FillType.Solid);
chart.getPlotArea().getFormat().getFill().getSolidFillColor().setColor(new Color(PresetColor.LightCyan));
// Guardar la Presentación
pres.save("FormattedChart.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
Establecer Propiedades de Fuente para el Gráfico
Aspose.Slides para Java proporciona soporte para establecer las propiedades relacionadas con la fuente para el gráfico. Siga los pasos a continuación para establecer las propiedades de la fuente para el gráfico.
- Instanciar el objeto de la clase Presentation.
- Agregue un gráfico en la diapositiva.
- Establezca la altura de la fuente.
- Guarde la presentación modificada.
A continuación se muestra un ejemplo de muestra.
// Crear una instancia de la clase Presentation
Presentation pres = new Presentation();
try {
IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 100, 100, 500, 400);
chart.getTextFormat().getPortionFormat().setFontHeight(20);
chart.getChartData().getSeries().get_Item(0).getLabels().getDefaultDataLabelFormat().setShowValue(true);
pres.save("FontPropertiesForChart.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
Establecer Formato de Números
Aspose.Slides para Java proporciona una API simple para gestionar el formato de datos de gráficos:
- Cree una instancia de la clase Presentation.
- Obtenga una referencia de la diapositiva por su índice.
- Agregue un gráfico con datos predeterminados junto con el tipo deseado (este ejemplo utiliza ChartType.ClusteredColumn).
- Establezca el formato de número preestablecido de los posibles valores preestablecidos.
- Recorra cada celda de datos del gráfico en cada serie del gráfico y establezca el formato de número de los datos del gráfico.
- Guarde la presentación.
- Establezca el formato de número personalizado.
- Recorra cada celda de datos dentro de cada serie de gráficos y establezca un formato de número de datos de gráfico diferente.
- Guarde la presentación.
// Crear una instancia de la clase Presentation
Presentation pres = new Presentation();
try {
// Accediendo a la primera diapositiva de la presentación
ISlide slide = pres.getSlides().get_Item(0);
// Agregando un gráfico de columnas agrupadas por defecto
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 500, 400);
// Accediendo a la colección de series del gráfico
IChartSeriesCollection series = chart.getChartData().getSeries();
// Recorrer cada serie del gráfico
for (IChartSeries ser : series)
{
// Recorrer cada celda de datos en la serie
for (IChartDataPoint cell : ser.getDataPoints())
{
// Estableciendo el formato de número
cell.getValue().getAsCell().setPresetNumberFormat((byte) 10); // 0.00%
}
}
// Guardando la presentación
pres.save("PresetNumberFormat.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
Los posibles valores de formato de número preestablecidos, junto con su índice preestablecido que se puede utilizar, se indican a continuación:
0 | General |
---|---|
1 | 0 |
2 | 0.00 |
3 | #,##0 |
4 | #,##0.00 |
5 | $#,##0;$-#,##0 |
6 | $#,##0;Red$-#,##0 |
7 | $#,##0.00;$-#,##0.00 |
8 | $#,##0.00;Red$-#,##0.00 |
9 | 0% |
10 | 0.00% |
11 | 0.00E+00 |
12 | # ?/? |
13 | # / |
14 | m/d/yy |
15 | d-mmm-yy |
16 | d-mmm |
17 | mmm-yy |
18 | h:mm AM/PM |
19 | h:mm:ss AM/PM |
20 | h:mm |
21 | h:mm:ss |
22 | m/d/yy h:mm |
37 | #,##0;-#,##0 |
38 | #,##0;Red-#,##0 |
39 | #,##0.00;-#,##0.00 |
40 | #,##0.00;Red-#,##0.00 |
41 | _ * #,##0_ ;_ * “_ ;_ @_ |
42 | _ $* #,##0_ ;_ $* “_ ;_ @_ |
43 | _ * #,##0.00_ ;_ * “??_ ;_ @_ |
44 | _ $* #,##0.00_ ;_ $* “??_ ;_ @_ |
45 | mm:ss |
46 | h :mm:ss |
47 | mm:ss.0 |
48 | ##0.0E+00 |
49 | @ |
Establecer Bordes Redondeados en el Área del Gráfico
Aspose.Slides para Java proporciona soporte para establecer el área del gráfico. Los métodos hasRoundedCorners y setRoundedCorners se han añadido a la interfaz IChart y a la clase Chart.
- Instanciar el objeto de la clase Presentation.
- Agregar un gráfico en la diapositiva.
- Establecer el tipo de relleno y el color de relleno del gráfico.
- Establecer la propiedad de borde redondeado en Verdadero.
- Guardar la presentación modificada.
A continuación se muestra un ejemplo de muestra.
// Crear una instancia de la clase Presentation
Presentation pres = new Presentation();
try {
ISlide slide = pres.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 100, 600, 400);
chart.getLineFormat().getFillFormat().setFillType(FillType.Solid);
chart.getLineFormat().setStyle(LineStyle.Single);
chart.setRoundedCorners(true);
pres.save("output.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}