Añadir formas de línea a presentaciones en PHP
Crear una línea simple
Para añadir una línea simple a una diapositiva seleccionada de la presentación, siga los pasos a continuación:
- Cree una instancia de la clase Presentation.
- Obtenga la referencia de una diapositiva usando su índice.
- Añada una AutoShape del tipo Línea mediante el método addAutoShape expuesto por el objeto ShapeCollection.
- Guarde la presentación modificada como un archivo PPTX.
En el ejemplo que se muestra a continuación, hemos añadido una línea a la primera diapositiva de la presentación.
# Instanciar la clase PresentationEx que representa el archivo PPTX
$pres = new Presentation();
try {
# Obtener la primera diapositiva
$sld = $pres->getSlides()->get_Item(0);
# Agregar una AutoShape de tipo línea
$sld->getShapes()->addAutoShape(ShapeType::Line, 50, 150, 300, 0);
# Grabar el PPTX en disco
$pres->save("LineShape.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Crear una línea con forma de flecha
Aspose.Slides for PHP via Java también permite a los desarrolladores configurar algunas propiedades de la línea para que resulte más atractiva. Intentemos configurar algunas propiedades de una línea para que tenga forma de flecha. Siga los pasos a continuación para lograrlo:
- Cree una instancia de la clase Presentation.
- Obtenga la referencia de una diapositiva usando su índice.
- Añada una AutoShape del tipo Línea mediante el método addAutoShape expuesto por el objeto ShapeCollection.
- Establezca el Line Style a uno de los estilos ofrecidos por Aspose.Slides for PHP via Java.
- Establezca el ancho de la línea.
- Establezca el Dash Style de la línea a uno de los estilos ofrecidos por Aspose.Slides for PHP via Java.
- Establezca el Arrow Head Style y la Length del punto de inicio de la línea.
- Establezca el Arrow Head Style y la Length del punto final de la línea.
- Guarde la presentación modificada como un archivo PPTX.
# Instanciar la clase PresentationEx que representa el archivo PPTX
$pres = new Presentation();
try {
# Obtener la primera diapositiva
$sld = $pres->getSlides()->get_Item(0);
# Añadir una AutoShape de tipo línea
$shp = $sld->getShapes()->addAutoShape(ShapeType::Line, 50, 150, 300, 0);
# Aplicar algo de formato a la línea
$shp->getLineFormat()->setStyle(LineStyle->ThickBetweenThin);
$shp->getLineFormat()->setWidth(10);
$shp->getLineFormat()->setDashStyle(LineDashStyle->DashDot);
$shp->getLineFormat()->setBeginArrowheadLength(LineArrowheadLength->Short);
$shp->getLineFormat()->setBeginArrowheadStyle(LineArrowheadStyle->Oval);
$shp->getLineFormat()->setEndArrowheadLength(LineArrowheadLength->Long);
$shp->getLineFormat()->setEndArrowheadStyle(LineArrowheadStyle->Triangle);
$shp->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
$shp->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(new java("java.awt.Color", PresetColor->Maroon));
# Guardar el PPTX en disco
$pres->save("LineShape.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Preguntas frecuentes
¿Puedo convertir una línea normal en un conector para que se “ajuste” a las formas?
No. Una línea normal (una AutoShape de tipo Line) no se convierte automáticamente en un conector. Para que se ajuste a las formas, utilice el tipo Connector dedicado y las APIs correspondientes para conexiones.
¿Qué debo hacer si las propiedades de una línea se heredan del tema y es difícil determinar los valores finales?
Lea las propiedades efectivas a través de LineFormatEffectiveData/LineFillFormatEffectiveData—estas ya tienen en cuenta la herencia y los estilos del tema.
¿Puedo bloquear una línea para que no se pueda editar (mover, redimensionar)?
Sí. Las formas proporcionan lock objects que le permiten impedir operaciones de edición.