Gestionar párrafos de texto de PowerPoint en .NET

Aspose.Slides proporciona todas las interfaces y clases que necesita para trabajar con textos, párrafos y porciones de PowerPoint en C#.

  • Aspose.Slides ofrece la interfaz ITextFrame para permitirle añadir objetos que representen un párrafo. Un objeto ITextFame puede contener uno o varios párrafos (cada párrafo se crea mediante un retorno de carro).
  • Aspose.Slides ofrece la interfaz IParagraph para permitirle añadir objetos que representen porciones. Un objeto IParagraph puede contener una o varias porciones (colección de objetos iPortions).
  • Aspose.Slides ofrece la interfaz IPortion para permitirle añadir objetos que representen textos y sus propiedades de formato.

Un objeto IParagraph es capaz de gestionar textos con diferentes propiedades de formato mediante sus objetos subyacentes IPortion.

Agregar varios párrafos que contengan varias porciones

Estos pasos le muestran cómo añadir un marco de texto que contenga 3 párrafos y cada párrafo contenga 3 porciones:

  1. Crear una instancia de la clase Presentation.
  2. Acceder a la referencia de la diapositiva correspondiente mediante su índice.
  3. Añadir un rectángulo IAutoShape a la diapositiva.
  4. Obtener el ITextFrame asociado al IAutoShape.
  5. Crear dos objetos IParagraph y añadirlos a la colección IParagraphs del ITextFrame.
  6. Crear tres objetos IPortion para cada nuevo IParagraph (dos objetos Portion para el párrafo predeterminado) y añadir cada objeto IPortion a la colección IPortion de cada IParagraph.
  7. Asignar texto a cada porción.
  8. Aplicar sus características de formato preferidas a cada porción mediante las propiedades de formato expuestas por el objeto IPortion.
  9. Guardar la presentación modificada.

Este código C# implementa los pasos para añadir párrafos que contienen porciones:

// Instancia una clase Presentation que representa un archivo PPTX
using (Presentation pres = new Presentation())
{
    // Accede a la primera diapositiva
    ISlide slide = pres.Slides[0];

    // Añade un IAutoShape tipo Rectángulo
    IAutoShape ashp = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 150, 300, 150);

    // Accede al TextFrame del AutoShape
    ITextFrame tf = ashp.TextFrame;

    // Crea párrafos y porciones con diferentes formatos de texto
    IParagraph para0 = tf.Paragraphs[0];
    IPortion port01 = new Portion();
    IPortion port02 = new Portion();
    para0.Portions.Add(port01);
    para0.Portions.Add(port02);

    IParagraph para1 = new Paragraph();
    tf.Paragraphs.Add(para1);
    IPortion port10 = new Portion();
    IPortion port11 = new Portion();
    IPortion port12 = new Portion();
    para1.Portions.Add(port10);
    para1.Portions.Add(port11);
    para1.Portions.Add(port12);

    IParagraph para2 = new Paragraph();
    tf.Paragraphs.Add(para2);
    IPortion port20 = new Portion();
    IPortion port21 = new Portion();
    IPortion port22 = new Portion();
    para2.Portions.Add(port20);
    para2.Portions.Add(port21);
    para2.Portions.Add(port22);

    for (int i = 0; i < 3; i++)
        for (int j = 0; j < 3; j++)
        {
            tf.Paragraphs[i].Portions[j].Text = "Portion0" + j.ToString();
            if (j == 0)
            {
                tf.Paragraphs[i].Portions[j].PortionFormat.FillFormat.FillType = FillType.Solid;
                tf.Paragraphs[i].Portions[j].PortionFormat.FillFormat.SolidFillColor.Color = Color.Red;
                tf.Paragraphs[i].Portions[j].PortionFormat.FontBold = NullableBool.True;
                tf.Paragraphs[i].Portions[j].PortionFormat.FontHeight = 15;
            }
            else if (j == 1)
            {
                tf.Paragraphs[i].Portions[j].PortionFormat.FillFormat.FillType = FillType.Solid;
                tf.Paragraphs[i].Portions[j].PortionFormat.FillFormat.SolidFillColor.Color = Color.Blue;
                tf.Paragraphs[i].Portions[j].PortionFormat.FontItalic = NullableBool.True;
                tf.Paragraphs[i].Portions[j].PortionFormat.FontHeight = 18;
            }
        }
    // Guarda la presentación modificada
    pres.Save("multiParaPort_out.pptx", SaveFormat.Pptx);
}

Administrar viñetas de párrafo

Las listas con viñetas le ayudan a organizar y presentar la información de forma rápida y eficaz. Los párrafos con viñetas siempre son más fáciles de leer y comprender.

  1. Crear una instancia de la clase Presentation.
  2. Acceder a la referencia de la diapositiva correspondiente mediante su índice.
  3. Añadir una autoshape a la diapositiva seleccionada.
  4. Acceder al TextFrame de la autoshape.
  5. Eliminar el párrafo predeterminado del TextFrame.
  6. Crear la primera instancia de párrafo usando la clase Paragraph.
  7. Establecer el Type de la viñeta del párrafo a Symbol y definir el carácter de la viñeta.
  8. Definir el Text del párrafo.
  9. Establecer la Indent del párrafo para la viñeta.
  10. Asignar un color a la viñeta.
  11. Definir una altura para la viñeta.
  12. Añadir el nuevo párrafo a la colección de párrafos del TextFrame.
  13. Añadir el segundo párrafo y repetir el proceso descrito en los pasos 7 a 13.
  14. Guardar la presentación.

Este código C# muestra cómo añadir una viñeta de párrafo:

// Instancia una clase Presentation que representa un archivo PPTX
using (Presentation pres = new Presentation())
{

    // Accede a la primera diapositiva
    ISlide slide = pres.Slides[0];


    // Añade y accede a la Autoshape
    IAutoShape aShp = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Accede al marco de texto de la autoshape
    ITextFrame txtFrm = aShp.TextFrame;

    // Elimina el párrafo predeterminado
    txtFrm.Paragraphs.RemoveAt(0);

    // Crea un párrafo
    Paragraph para = new Paragraph();

    // Define el estilo y el símbolo de la viñeta del párrafo
    para.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    para.ParagraphFormat.Bullet.Char = Convert.ToChar(8226);

    // Define el texto del párrafo
    para.Text = "Welcome to Aspose.Slides";

    // Define el sangrado de la viñeta
    para.ParagraphFormat.Indent = 25;

    // Define el color de la viñeta
    para.ParagraphFormat.Bullet.Color.ColorType = ColorType.RGB;
    para.ParagraphFormat.Bullet.Color.Color = Color.Black;
    para.ParagraphFormat.Bullet.IsBulletHardColor = NullableBool.True; // establecer IsBulletHardColor a true para usar el color propio de la viñeta

    // Define la altura de la viñeta
    para.ParagraphFormat.Bullet.Height = 100;

    // Añade el párrafo al marco de texto
    txtFrm.Paragraphs.Add(para);

    // Crea el segundo párrafo
    Paragraph para2 = new Paragraph();

    // Define el tipo y estilo de la viñeta del párrafo
    para2.ParagraphFormat.Bullet.Type = BulletType.Numbered;
    para2.ParagraphFormat.Bullet.NumberedBulletStyle = NumberedBulletStyle.BulletCircleNumWDBlackPlain;

    // Añade el texto del párrafo
    para2.Text = "This is numbered bullet";

    // Define el sangrado de la viñeta
    para2.ParagraphFormat.Indent = 25;

    para2.ParagraphFormat.Bullet.Color.ColorType = ColorType.RGB;
    para2.ParagraphFormat.Bullet.Color.Color = Color.Black;
    para2.ParagraphFormat.Bullet.IsBulletHardColor = NullableBool.True; // establecer IsBulletHardColor a true para usar el color propio de la viñeta

    // Define la altura de la viñeta
    para2.ParagraphFormat.Bullet.Height = 100;

    // Añade el párrafo al marco de texto
    txtFrm.Paragraphs.Add(para2);


    // Guarda la presentación modificada
    pres.Save("Bullet_out.pptx", SaveFormat.Pptx);

}

Administrar viñetas de imagen

Las listas con viñetas le ayudan a organizar y presentar la información de forma rápida y eficaz. Los párrafos con imágenes son fáciles de leer y comprender.

  1. Crear una instancia de la clase Presentation.
  2. Acceder a la referencia de la diapositiva correspondiente mediante su índice.
  3. Añadir una autoshape a la diapositiva.
  4. Acceder al TextFrame de la autoshape.
  5. Eliminar el párrafo predeterminado del TextFrame.
  6. Crear la primera instancia de párrafo usando la clase Paragraph.
  7. Cargar la imagen en IPPImage.
  8. Establecer el tipo de viñeta a Picture y definir la imagen.
  9. Definir el Text del párrafo.
  10. Establecer la Indent del párrafo para la viñeta.
  11. Asignar un color a la viñeta.
  12. Definir una altura para la viñeta.
  13. Añadir el nuevo párrafo a la colección de párrafos del TextFrame.
  14. Añadir el segundo párrafo y repetir el proceso basado en los pasos anteriores.
  15. Guardar la presentación modificada.

Este código C# muestra cómo añadir y administrar viñetas de imagen:

// Instancia una clase Presentation que representa un archivo PPTX
Presentation presentation = new Presentation();

// Accede a la primera diapositiva
ISlide slide = presentation.Slides[0];

// Instancia la imagen para las viñetas
IImage image = Images.FromFile("bullets.png");
IPPImage ippxImage = presentation.Images.AddImage(image);
image.Dispose();

// Añade y accede a la Autoshape
IAutoShape autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

// Accede al marco de texto de la autoshape
ITextFrame textFrame = autoShape.TextFrame;

// Elimina el párrafo predeterminado
textFrame.Paragraphs.RemoveAt(0);

// Crea un nuevo párrafo
Paragraph paragraph = new Paragraph();
paragraph.Text = "Welcome to Aspose.Slides";

// Define el estilo y la imagen de la viñeta del párrafo
paragraph.ParagraphFormat.Bullet.Type = BulletType.Picture;
paragraph.ParagraphFormat.Bullet.Picture.Image = ippxImage;

// Define la altura de la viñeta
paragraph.ParagraphFormat.Bullet.Height = 100;

// Añade el párrafo al marco de texto
textFrame.Paragraphs.Add(paragraph);

// Guarda la presentación como archivo PPTX
presentation.Save("ParagraphPictureBulletsPPTX_out.pptx", SaveFormat.Pptx);

// Guarda la presentación como archivo PPT
presentation.Save("ParagraphPictureBulletsPPT_out.ppt", SaveFormat.Ppt);

Administrar viñetas multinivel

Las listas con viñetas le ayudan a organizar y presentar la información de forma rápida y eficaz. Las viñetas multinivel son fáciles de leer y comprender.

  1. Crear una instancia de la clase Presentation .
  2. Acceder a la referencia de la diapositiva correspondiente mediante su índice.
  3. Añadir una autoshape en la nueva diapositiva.
  4. Acceder al TextFrame de la autoshape.
  5. Eliminar el párrafo predeterminado del TextFrame.
  6. Crear la primera instancia de párrafo mediante la clase Paragraph y establecer la profundidad a 0.
  7. Crear la segunda instancia de párrafo mediante la clase Paragraph y establecer la profundidad a 1.
  8. Crear la tercera instancia de párrafo mediante la clase Paragraph y establecer la profundidad a 2.
  9. Crear la cuarta instancia de párrafo mediante la clase Paragraph y establecer la profundidad a 3.
  10. Añadir los nuevos párrafos a la colección de párrafos del TextFrame.
  11. Guardar la presentación modificada.

Este código C# muestra cómo añadir y administrar viñetas multinivel:

// Instancia una clase Presentation que representa un archivo PPTX
using (Presentation pres = new Presentation())
{

    // Accede a la primera diapositiva
    ISlide slide = pres.Slides[0];
    
    // Añade y accede a la Autoshape
    IAutoShape aShp = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Accede al marco de texto de la autoshape creada
    ITextFrame text = aShp.AddTextFrame("");
    
    // Elimina el párrafo predeterminado
    text.Paragraphs.Clear();

    // Añade el primer párrafo
    IParagraph para1 = new Paragraph();
    para1.Text = "Content";
    para1.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    para1.ParagraphFormat.Bullet.Char = Convert.ToChar(8226);
    para1.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    para1.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    // Define el nivel de viñeta
    para1.ParagraphFormat.Depth = 0;

    // Añade el segundo párrafo
    IParagraph para2 = new Paragraph();
    para2.Text = "Second Level";
    para2.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    para2.ParagraphFormat.Bullet.Char = '-';
    para2.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    para2.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    // Define el nivel de viñeta
    para2.ParagraphFormat.Depth = 1;

    // Añade el tercer párrafo
    IParagraph para3 = new Paragraph();
    para3.Text = "Third Level";
    para3.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    para3.ParagraphFormat.Bullet.Char = Convert.ToChar(8226);
    para3.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    para3.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    // Define el nivel de viñeta
    para3.ParagraphFormat.Depth = 2;

    // Añade el cuarto párrafo
    IParagraph para4 = new Paragraph();
    para4.Text = "Fourth Level";
    para4.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    para4.ParagraphFormat.Bullet.Char = '-';
    para4.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    para4.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    // Define el nivel de viñeta
    para4.ParagraphFormat.Depth = 3;

    // Añade los párrafos a la colección
    text.Paragraphs.Add(para1);
    text.Paragraphs.Add(para2);
    text.Paragraphs.Add(para3);
    text.Paragraphs.Add(para4);

    // Guarda la presentación como archivo PPTX
    pres.Save("MultilevelBullet.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

Administrar un párrafo con una lista numerada personalizada

La interfaz IBulletFormat proporciona la propiedad NumberedBulletStartWith y otras que le permiten gestionar párrafos con numeración o formato personalizado.

  1. Crear una instancia de la clase Presentation .
  2. Acceder a la diapositiva que contiene el párrafo.
  3. Añadir una autoshape a la diapositiva.
  4. Acceder al TextFrame de la autoshape.
  5. Eliminar el párrafo predeterminado del TextFrame.
  6. Crear la primera instancia de párrafo mediante la clase Paragraph y establecer NumberedBulletStartWith a 2.
  7. Crear la segunda instancia de párrafo mediante la clase Paragraph y establecer NumberedBulletStartWith a 3.
  8. Crear la tercera instancia de párrafo mediante la clase Paragraph y establecer NumberedBulletStartWith a 7.
  9. Añadir los nuevos párrafos a la colección de párrafos del TextFrame.
  10. Guardar la presentación modificada.

Este código C# muestra cómo añadir y administrar párrafos con numeración o formato personalizado:

using (var presentation = new Presentation())
{
	var shape = presentation.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

	// Accede al marco de texto de la autoshape creada
	ITextFrame textFrame = shape.TextFrame;

	// Elimina el párrafo predeterminado existente
	textFrame.Paragraphs.RemoveAt(0);

	// Primera lista
	var paragraph1 = new Paragraph { Text = "bullet 2" };
	paragraph1.ParagraphFormat.Depth = 4; 
	paragraph1.ParagraphFormat.Bullet.NumberedBulletStartWith = 2;
	paragraph1.ParagraphFormat.Bullet.Type = BulletType.Numbered;
	textFrame.Paragraphs.Add(paragraph1);

	var paragraph2 = new Paragraph { Text = "bullet 3" };
	paragraph2.ParagraphFormat.Depth = 4;
	paragraph2.ParagraphFormat.Bullet.NumberedBulletStartWith = 3; 
	paragraph2.ParagraphFormat.Bullet.Type = BulletType.Numbered;  
	textFrame.Paragraphs.Add(paragraph2);


	var paragraph5 = new Paragraph { Text = "bullet 7" };
	paragraph5.ParagraphFormat.Depth = 4;
	paragraph5.ParagraphFormat.Bullet.NumberedBulletStartWith = 7;
	paragraph5.ParagraphFormat.Bullet.Type = BulletType.Numbered;
	textFrame.Paragraphs.Add(paragraph5);

	presentation.Save("SetCustomBulletsNumber-slides.pptx", SaveFormat.Pptx);
}

Establecer sangrado de primera línea para un párrafo

Utilice la propiedad IParagraphFormat.Indent para controlar el sangrado de la primera línea de un párrafo. Esta propiedad desplaza solo la primera línea respecto al margen izquierdo del párrafo. Un valor positivo desplaza la primera línea a la derecha, mientras que las líneas restantes permanecen alineadas con el cuerpo del párrafo.

Use IParagraphFormat.MarginLeft cuando necesite mover todo el párrafo. Use IParagraphFormat.Indent cuando necesite mover solo la primera línea.

El ejemplo a continuación crea varios párrafos y aplica diferentes valores de Indent para demostrar cómo el sangrado de primera línea afecta la distribución del párrafo.

  1. Crear una instancia de la clase Presentation .
  2. Acceder a la diapositiva objetivo.
  3. Añadir una AutoShape rectangular a la diapositiva.
  4. Añadir un TextFrame vacío a la forma y eliminar el párrafo predeterminado.
  5. Crear varios párrafos y establecer diferentes valores de Indent para ellos.
  6. Añadir los párrafos al marco de texto.
  7. Guardar la presentación modificada.

Este código muestra cómo establecer el sangrado de un párrafo:

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    IAutoShape rectangleShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 420, 220);
    rectangleShape.FillFormat.FillType = FillType.NoFill;
    rectangleShape.LineFormat.FillFormat.FillType = FillType.Solid;
    rectangleShape.LineFormat.FillFormat.SolidFillColor.Color = Color.Gray;

    ITextFrame textFrame = rectangleShape.AddTextFrame(string.Empty);
    textFrame.TextFrameFormat.AutofitType = TextAutofitType.Shape;
    textFrame.Paragraphs.RemoveAt(0);

    Paragraph firstParagraph = new Paragraph();
    firstParagraph.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    firstParagraph.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    firstParagraph.Text = "No first-line indent. Wrapped lines start at the same position as the first line.";
    firstParagraph.ParagraphFormat.MarginLeft = 20f;
    firstParagraph.ParagraphFormat.Indent = 0f;

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    secondParagraph.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    secondParagraph.Text = "First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body.";
    secondParagraph.ParagraphFormat.MarginLeft = 20f;
    secondParagraph.ParagraphFormat.Indent = 20f;

    Paragraph thirdParagraph = new Paragraph();
    thirdParagraph.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    thirdParagraph.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    thirdParagraph.Text = "First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see.";
    thirdParagraph.ParagraphFormat.MarginLeft = 20f;
    thirdParagraph.ParagraphFormat.Indent = 40f;

    textFrame.Paragraphs.Add(firstParagraph);
    textFrame.Paragraphs.Add(secondParagraph);
    textFrame.Paragraphs.Add(thirdParagraph);

    presentation.Save("paragraph_indent.pptx", SaveFormat.Pptx);
}

El resultado:

The first-line indent of the paragraphs

Establecer sangrado colgante para un párrafo

Un sangrado colgante es una disposición de párrafo en la que la primera línea comienza a la izquierda de las líneas restantes. En Aspose.Slides, crea este efecto con la propiedad IParagraphFormat.Indent. Establezca Indent a un valor negativo para mover la primera línea a la izquierda respecto al cuerpo del párrafo.

En la práctica, IParagraphFormat.MarginLeft define la posición izquierda del cuerpo del párrafo, y IParagraphFormat.Indent define la posición de la primera línea respecto a ese margen. Para crear un sangrado colgante, establezca un valor positivo en MarginLeft y un valor negativo en Indent.

Este formato es útil para bibliografías, referencias, entradas de glosario y otros párrafos donde las líneas envueltas deben alinearse bajo el cuerpo del párrafo en lugar de bajo el primer carácter de la primera línea.

  1. Crear una instancia de la clase Presentation .
  2. Acceder a la diapositiva objetivo.
  3. Añadir una AutoShape rectangular a la diapositiva.
  4. Añadir un TextFrame vacío a la forma y eliminar el párrafo predeterminado.
  5. Crear párrafos y establecer un valor positivo de MarginLeft para cada párrafo.
  6. Establecer un valor negativo de Indent para crear el efecto de sangrado colgante.
  7. Añadir los párrafos al marco de texto.
  8. Guardar la presentación modificada.

Este código muestra cómo establecer un sangrado colgante para un párrafo:

using (Presentation presentation = new Presentation())
{
    ISlide slide = presentation.Slides[0];

    IAutoShape rectangleShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 420, 220);
    rectangleShape.FillFormat.FillType = FillType.NoFill;
    rectangleShape.LineFormat.FillFormat.FillType = FillType.Solid;
    rectangleShape.LineFormat.FillFormat.SolidFillColor.Color = Color.Gray;

    ITextFrame textFrame = rectangleShape.AddTextFrame(string.Empty);
    textFrame.TextFrameFormat.AutofitType = TextAutofitType.Shape;
    textFrame.Paragraphs.RemoveAt(0);

    Paragraph firstParagraph = new Paragraph();
    firstParagraph.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    firstParagraph.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    firstParagraph.Text = "A hanging indent is created by combining a positive left margin with a negative indent. The first line starts to the left, while wrapped lines align with the paragraph body.";
    firstParagraph.ParagraphFormat.MarginLeft = 40f;
    firstParagraph.ParagraphFormat.Indent = -20f;

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.ParagraphFormat.DefaultPortionFormat.FillFormat.FillType = FillType.Solid;
    secondParagraph.ParagraphFormat.DefaultPortionFormat.FillFormat.SolidFillColor.Color = Color.Black;
    secondParagraph.Text = "This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare.";
    secondParagraph.ParagraphFormat.MarginLeft = 60f;
    secondParagraph.ParagraphFormat.Indent = -30f;

    textFrame.Paragraphs.Add(firstParagraph);
    textFrame.Paragraphs.Add(secondParagraph);

    presentation.Save("hanging_indent.pptx", SaveFormat.Pptx);
}

El resultado:

The hanging indent of the paragraphs

Administrar propiedades de ejecución al final del párrafo

  1. Crear una instancia de Presentation clase.
  2. Obtener la referencia de la diapositiva que contiene el párrafo mediante su posición.
  3. Añadir un rectángulo autoshape a la diapositiva.
  4. Añadir un TextFrame con dos párrafos al rectángulo.
  5. Establecer FontHeight y el tipo de fuente para los párrafos.
  6. Establecer las propiedades End para los párrafos.
  7. Guardar la presentación modificada como archivo PPTX.

Este código C# muestra cómo establecer las propiedades End para los párrafos en PowerPoint:

using (Presentation pres = new Presentation("Test.pptx"))
{
	IAutoShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, 200, 250);

	Paragraph para1 = new Paragraph();
	para1.Portions.Add(new Portion("Sample text"));

	Paragraph para2 = new Paragraph();
	para2.Portions.Add(new Portion("Sample text 2"));
	PortionFormat endParagraphPortionFormat = new PortionFormat();
	endParagraphPortionFormat.FontHeight = 48;
	endParagraphPortionFormat.LatinFont = new FontData("Times New Roman");
	para2.EndParagraphPortionFormat = endParagraphPortionFormat;

	shape.TextFrame.Paragraphs.Add(para1);
	shape.TextFrame.Paragraphs.Add(para2);

	pres.Save("pres.pptx", SaveFormat.Pptx);
}

Importar texto HTML en párrafos

Aspose.Slides proporciona soporte mejorado para importar texto HTML en párrafos.

  1. Crear una instancia de la clase Presentation.
  2. Acceder a la referencia de la diapositiva correspondiente mediante su índice.
  3. Añadir una autoshape a la diapositiva.
  4. Añadir y acceder a autoshape ITextFrame.
  5. Eliminar el párrafo predeterminado en el ITextFrame.
  6. Leer el archivo HTML fuente en un TextReader.
  7. Crear la primera instancia de párrafo mediante la clase Paragraph.
  8. Añadir el contenido del archivo HTML leído con el TextReader a la ParagraphCollection del TextFrame.
  9. Guardar la presentación modificada.

Este código C# implementa los pasos para importar textos HTML en párrafos:

// Crea una instancia vacía de presentación
using (Presentation pres = new Presentation())
{
    // Accede a la primera diapositiva predeterminada de la presentación
    ISlide slide = pres.Slides[0];

    // Añade la AutoShape para contener el contenido HTML
    IAutoShape ashape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 10, 10, pres.SlideSize.Size.Width - 20, pres.SlideSize.Size.Height - 10);

    ashape.FillFormat.FillType = FillType.NoFill;

    // Añade un marco de texto a la forma
    ashape.AddTextFrame("");

    // Borra todos los párrafos del marco de texto añadido
    ashape.TextFrame.Paragraphs.Clear();

    // Carga el archivo HTML usando un lector de flujo
    TextReader tr = new StreamReader("file.html");

    // Añade el texto del lector de flujo HTML al marco de texto
    ashape.TextFrame.Paragraphs.AddFromHtml(tr.ReadToEnd());

    // Guarda la presentación
    pres.Save("output_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

Exportar texto de párrafo a HTML

Aspose.Slides proporciona soporte mejorado para exportar textos (contenidos en párrafos) a HTML.

  1. Crear una instancia de la clase Presentation y cargar la presentación deseada.
  2. Acceder a la referencia de la diapositiva correspondiente mediante su índice.
  3. Acceder a la forma que contiene el texto que se exportará a HTML.
  4. Acceder al TextFrame de la forma.
  5. Crear una instancia de StreamWriter y añadir el nuevo archivo HTML.
  6. Proporcionar un índice inicial a StreamWriter y exportar los párrafos deseados.

Este código C# muestra cómo exportar textos de párrafo de PowerPoint a HTML:

// Carga el archivo de presentación
using (Presentation pres = new Presentation("ExportingHTMLText.pptx"))
{

    // Accede a la primera diapositiva predeterminada de la presentación
    ISlide slide = pres.Slides[0];

    // Accede al índice requerido
    int index = 0;

    // Accede a la forma añadida
    IAutoShape ashape = (IAutoShape)slide.Shapes[index];

    StreamWriter sw = new StreamWriter("output_out.html", false, Encoding.UTF8);

    // Escribe los datos de los párrafos a HTML especificando el índice de inicio del párrafo y el número de párrafos a copiar
    sw.Write(ashape.TextFrame.Paragraphs.ExportToHtml(0, ashape.TextFrame.Paragraphs.Count, null));

    sw.Close();
}

Guardar un párrafo como imagen

En esta sección exploraremos dos ejemplos que demuestran cómo guardar un párrafo de texto, representado por la interfaz IParagraph, como una imagen. Ambos ejemplos incluyen la obtención de la imagen de una forma que contiene el párrafo mediante los métodos GetImage de la interfaz IShape, el cálculo de los límites del párrafo dentro de la forma y su exportación como una imagen bitmap. Estos enfoques le permiten extraer partes específicas del texto de presentaciones PowerPoint y guardarlas como imágenes independientes, lo que puede ser útil para su uso posterior en diversos escenarios.

Supongamos que disponemos de un archivo de presentación llamado sample.pptx con una diapositiva, donde la primera forma es un cuadro de texto que contiene tres párrafos.

The text box with three paragraphs

Ejemplo 1

En este ejemplo obtenemos el segundo párrafo como imagen. Para ello, extraemos la imagen de la forma de la primera diapositiva de la presentación y luego calculamos los límites del segundo párrafo en el marco de texto de la forma. El párrafo se vuelve a dibujar sobre una nueva imagen bitmap, que se guarda en formato PNG. Este método es especialmente útil cuando necesita guardar un párrafo concreto como una imagen separada manteniendo las dimensiones y el formato exactos del texto.

using var presentation = new Presentation("sample.pptx");
var firstShape = presentation.Slides[0].Shapes[0] as IAutoShape;

// Save the shape in memory as a bitmap.
using var shapeImage = firstShape.GetImage();
using var shapeImageStream = new MemoryStream();
shapeImage.Save(shapeImageStream, ImageFormat.Png);

// Create a shape bitmap from memory.
shapeImageStream.Seek(0, SeekOrigin.Begin);
using var shapeBitmap = Image.FromStream(shapeImageStream);

// Calculate the boundaries of the second paragraph.
var secondParagraph = firstShape.TextFrame.Paragraphs[1];
var paragraphRectangle = secondParagraph.GetRect();

// Calculate the size for the output image (minimum size - 1x1 pixel).
var imageWidth = Math.Max(1, (int)Math.Ceiling(paragraphRectangle.Width));
var imageHeight = Math.Max(1, (int)Math.Ceiling(paragraphRectangle.Height));

// Prepare a bitmap for the paragraph.
using var paragraphBitmap = new Bitmap(imageWidth, imageHeight);

// Redraw the paragraph from the shape bitmap to the paragraph bitmap.
using var imageGraphics = Graphics.FromImage(paragraphBitmap);
var drawingRectangle = new RectangleF(0, 0, paragraphRectangle.Width, paragraphRectangle.Height);
imageGraphics.DrawImage(shapeBitmap, drawingRectangle, paragraphRectangle, GraphicsUnit.Pixel);

paragraphBitmap.Save("paragraph.png", System.Drawing.Imaging.ImageFormat.Png);

El resultado:

The paragraph image

Ejemplo 2

En este ejemplo ampliamos el enfoque anterior añadiendo factores de escala a la imagen del párrafo. La forma se extrae de la presentación y se guarda como imagen con un factor de escala de 2. Esto permite obtener una salida de mayor resolución al exportar el párrafo. Los límites del párrafo se calculan considerando la escala. El escalado puede ser particularmente útil cuando se necesita una imagen más detallada, por ejemplo, para su uso en materiales impresos de alta calidad.

var imageScaleX = 2f;
var imageScaleY = imageScaleX;

using var presentation = new Presentation("sample.pptx");
var firstShape = presentation.Slides[0].Shapes[0] as IAutoShape;

// Save the shape in memory as a bitmap with scaling.
using var shapeImage = firstShape.GetImage(ShapeThumbnailBounds.Shape, imageScaleX, imageScaleY);
using var shapeImageStream = new MemoryStream();
shapeImage.Save(shapeImageStream, ImageFormat.Png);

// Create a shape bitmap from memory.
shapeImageStream.Seek(0, SeekOrigin.Begin);
using var shapeBitmap = Image.FromStream(shapeImageStream);

// Calculate the boundaries of the second paragraph.
var secondParagraph = firstShape.TextFrame.Paragraphs[1];
var paragraphRectangle = secondParagraph.GetRect();
paragraphRectangle.X *= imageScaleX;
paragraphRectangle.Y *= imageScaleY;
paragraphRectangle.Width *= imageScaleX;
paragraphRectangle.Height *= imageScaleY;

// Calculate the size for the output image (minimum size - 1x1 pixel).
var imageWidth = Math.Max(1, (int)Math.Ceiling(paragraphRectangle.Width));
var imageHeight = Math.Max(1, (int)Math.Ceiling(paragraphRectangle.Height));

// Prepare a bitmap for the paragraph.
using var paragraphBitmap = new Bitmap(imageWidth, imageHeight);

// Redraw the paragraph from the shape bitmap to the paragraph bitmap.
using var imageGraphics = Graphics.FromImage(paragraphBitmap);
var drawingRectangle = new RectangleF(0, 0, paragraphRectangle.Width, paragraphRectangle.Height);
imageGraphics.DrawImage(shapeBitmap, drawingRectangle, paragraphRectangle, GraphicsUnit.Pixel);

paragraphBitmap.Save("paragraph.png", System.Drawing.Imaging.ImageFormat.Png);

FAQ

¿Puedo desactivar completamente el ajuste de línea dentro de un marco de texto?

Sí. Utilice la configuración de ajuste del marco de texto (WrapText) para desactivar el ajuste y que las líneas no se dividan en los bordes del marco.

¿Cómo puedo obtener los límites exactos en la diapositiva de un párrafo concreto?

Puede obtener el rectángulo delimitador del párrafo (e incluso de una única porción) para conocer su posición y tamaño precisos en la diapositiva.

¿Dónde se controla la alineación de párrafo (izquierda/derecha/centro/justificado)?

Alignment es una configuración a nivel de párrafo en ParagraphFormat; se aplica a todo el párrafo independientemente del formato de las porciones individuales.

¿Puedo establecer un idioma de revisión ortográfica solo para una parte del párrafo (por ejemplo, una palabra)?

Sí. El idioma se establece a nivel de porción (PortionFormat.LanguageId), por lo que pueden coexistir varios idiomas dentro de un mismo párrafo.

Mejora tus presentaciones con AutoFit en .NET Formato de texto de presentación en .NET