Administrar gráficos de propiedades en diapositivas de Java

Introducción a la gestión de propiedades y gráficos en diapositivas Java utilizando Aspose.Slides

En este tutorial, exploraremos cómo administrar propiedades y crear gráficos en diapositivas Java usando Aspose.Slides. Aspose.Slides es una potente API de Java para trabajar con presentaciones de PowerPoint. Revisaremos el proceso paso a paso, incluidos ejemplos de código fuente.

Requisitos previos

Antes de comenzar, asegúrese de tener la biblioteca Aspose.Slides para Java instalada y configurada en su proyecto. Puedes descargarlo desdeaquí.

Agregar un gráfico a una diapositiva

Para agregar un gráfico a una diapositiva, siga estos pasos:

  1. Importe las clases necesarias y cree una instancia de la clase Presentación.
// Crear una instancia de la clase Presentación
Presentation presentation = new Presentation();
  1. Accede a la diapositiva donde deseas agregar el gráfico. En este ejemplo accedemos a la primera diapositiva.
// Acceder a la primera diapositiva
ISlide slide = presentation.getSlides().get_Item(0);
  1. Agregue un gráfico con datos predeterminados. En este caso, estamos agregando un gráfico StackedColumn3D.
// Agregar gráfico con datos predeterminados
IChart chart = slide.getShapes().addChart(ChartType.StackedColumn3D, 0, 0, 500, 500);

Configuración de datos del gráfico

Para configurar los datos del gráfico, necesitamos crear un libro de trabajo de datos del gráfico y agregar series y categorías. Sigue estos pasos:

  1. Establezca el índice de la hoja de datos del gráfico.
// Configuración del índice de la hoja de datos del gráfico
int defaultWorksheetIndex = 0;
  1. Obtenga el libro de trabajo de datos del gráfico.
// Obtener la hoja de trabajo de datos del gráfico
IChartDataWorkbook fact = chart.getChartData().getChartDataWorkbook();
  1. Añade series al gráfico. En este ejemplo, agregamos dos series denominadas “Serie 1” y “Serie 2”.
chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 1, "Series 1"), chart.getType());
chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 2, "Series 2"), chart.getType());
  1. Agregue categorías al gráfico. Aquí, agregamos tres categorías.
chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 1, 0, "Category 1"));
chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 2, 0, "Category 2"));
chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 3, 0, "Category 3"));

Configuración de propiedades de rotación 3D

Ahora, configuremos las propiedades de rotación 3D para el gráfico:

  1. Establezca los ejes en ángulo recto.
chart.getRotation3D().setRightAngleAxes(true);
  1. Establezca los ángulos de rotación para los ejes X e Y. En este ejemplo, rotamos X 40 grados e Y 270 grados.
chart.getRotation3D().setRotationX((byte) 40);
chart.getRotation3D().setRotationY(270);
  1. Establezca el porcentaje de profundidad en 150.
chart.getRotation3D().setDepthPercents(150);

Completar datos de series

  1. Tome la segunda serie de gráficos y complétela con puntos de datos.
IChartSeries series = chart.getChartData().getSeries().get_Item(1);

// Rellenar datos de series
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 1, 20));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 1, 50));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 1, 30));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 2, 30));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 2, 10));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 2, 60));

Ajustar la superposición

  1. Establezca el valor de superposición para las series. Por ejemplo, puede configurarlo en 100 para que no se superponga.
series.getParentSeriesGroup().setOverlap((byte) 100);

Guardar la presentación

Finalmente, guarde la presentación en el disco.

presentation.save(dataDir + "Rotation3D_out.pptx", SaveFormat.Pptx);

¡Eso es todo! Ha creado con éxito un gráfico de columnas apiladas en 3D con propiedades personalizadas utilizando Aspose.Slides en Java.

Código fuente completo para administrar gráficos de propiedades en diapositivas de Java

// La ruta al directorio de documentos.
String dataDir = "Your Document Directory";
// Crear una instancia de la clase Presentación
Presentation presentation = new Presentation();
// Acceder a la primera diapositiva
ISlide slide = presentation.getSlides().get_Item(0);
// Agregar gráfico con datos predeterminados
IChart chart = slide.getShapes().addChart(ChartType.StackedColumn3D, 0, 0, 500, 500);
// Configuración del índice de la hoja de datos del gráfico
int defaultWorksheetIndex = 0;
// Obtener la hoja de trabajo de datos del gráfico
IChartDataWorkbook fact = chart.getChartData().getChartDataWorkbook();
// Agregar serie
chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 1, "Series 1"), chart.getType());
chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 2, "Series 2"), chart.getType());
// Agregar categorías
chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 1, 0, "Caetegoty 1"));
chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 2, 0, "Caetegoty 2"));
chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 3, 0, "Caetegoty 3"));
// Establecer propiedades de Rotación 3D
chart.getRotation3D().setRightAngleAxes(true);
chart.getRotation3D().setRotationX((byte) 40);
chart.getRotation3D().setRotationY(270);
chart.getRotation3D().setDepthPercents(150);
// Tome la segunda serie de gráficos
IChartSeries series = chart.getChartData().getSeries().get_Item(1);
// Ahora completando datos de series
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 1, 20));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 1, 50));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 1, 30));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 2, 30));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 2, 10));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 2, 60));
// Establecer valor de superposición
series.getParentSeriesGroup().setOverlap((byte) 100);
// Escribir presentación en disco
presentation.save(dataDir + "Rotation3D_out.pptx", SaveFormat.Pptx);

Conclusión

En este tutorial, profundizamos en el mundo de la administración de propiedades y la creación de gráficos en diapositivas Java usando Aspose.Slides. Aspose.Slides es una sólida API de Java que permite a los desarrolladores trabajar con presentaciones de PowerPoint de manera eficiente. Cubrimos los pasos esenciales y proporcionamos ejemplos de código fuente para guiarlo a través del proceso.

Preguntas frecuentes

¿Cómo puedo cambiar el tipo de gráfico?

Puede cambiar el tipo de gráfico modificando elChartType parámetro al agregar el gráfico. Consulte la documentación de Aspose.Slides para conocer los tipos de gráficos disponibles.

¿Puedo personalizar los colores del gráfico?

Sí, puede personalizar los colores del gráfico configurando las propiedades de relleno de las categorías o puntos de datos de la serie.

¿Cómo agrego más puntos de datos a una serie?

Puede agregar más puntos de datos a una serie usando elseries.getDataPoints().addDataPointForBarSeries() método y especificando la celda que contiene el valor de los datos.

¿Cómo puedo establecer un ángulo de rotación diferente?

Para establecer un ángulo de rotación diferente para los ejes X e Y, utilicechart.getRotation3D().setRotationX() ychart.getRotation3D().setRotationY() con los valores de ángulo deseados.

¿Qué otras propiedades 3D puedo personalizar?

Puede explorar otras propiedades 3D del gráfico, como profundidad, perspectiva e iluminación, consultando la documentación de Aspose.Slides.