Zarządzanie akapitami tekstu PowerPoint w .NET

Wprowadzenie

Aspose.Slides dostarcza wszystkie interfejsy i klasy potrzebne do pracy z tekstami, akapitami i fragmentami PowerPoint w języku C#.

• Aspose.Slides udostępnia interfejs ITextFrame , który pozwala dodać obiekty reprezentujące akapit. Obiekt ITextFame może zawierać jeden lub wiele akapitów (każdy akapit tworzony jest poprzez znak powrotu karetki).
• Aspose.Slides udostępnia interfejs IParagraph , który pozwala dodać obiekty reprezentujące fragmenty. Obiekt IParagraph może zawierać jeden lub wiele fragmentów (kolekcja obiektów iPortions).
• Aspose.Slides udostępnia interfejs IPortion , który pozwala dodać obiekty reprezentujące teksty oraz ich właściwości formatowania.

Obiekt IParagraph jest w stanie obsługiwać teksty o różnych właściwościach formatowania poprzez swoje podstawowe obiekty IPortion.

Dodaj wiele akapitów zawierających wiele fragmentów

Te kroki pokazują, jak dodać ramkę tekstową zawierającą 3 akapity, a każdy akapit zawierający 3 fragmenty:

1. Utwórz instancję klasy Presentation.
2. Uzyskaj odwołanie do odpowiedniego slajdu poprzez jego indeks.
3. Dodaj prostokątną IAutoShape do slajdu.
4. Pobierz ITextFrame powiązany z IAutoShape.
5. Utwórz dwa obiekty IParagraph i dodaj je do kolekcji IParagraphs w ITextFrame.
6. Utwórz trzy obiekty IPortion dla każdego nowego IParagraph (dwa obiekty Portion dla domyślnego akapitu) i dodaj każdy obiekt IPortion do kolekcji IPortion odpowiedniego IParagraph.
7. Ustaw tekst dla każdego fragmentu.
8. Zastosuj preferowane opcje formatowania do każdego fragmentu, używając właściwości formatowania udostępnionych przez obiekt IPortion.
9. Zapisz zmodyfikowaną prezentację.

// Tworzy klasę Presentation reprezentującą plik PPTX
using (Presentation pres = new Presentation())
{
    // Uzyskuje dostęp do pierwszego slajdu
    ISlide slide = pres.Slides[0];

    // Dodaje prostokątną IAutoShape
    IAutoShape ashp = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 150, 300, 150);

    // Uzyskuje dostęp do TextFrame AutoShape
    ITextFrame tf = ashp.TextFrame;

    // Tworzy akapity i fragmenty o różnych formatach tekstu
    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].FillFormat.FillType = FillType.Solid;
                tf.Paragraphs[i].Portions[j].FillFormat.SolidFillColor.Color = Color.Blue;
                tf.Paragraphs[i].Portions[j].PortionFormat.FontItalic = NullableBool.True;
                tf.Paragraphs[i].Portions[j].PortionFormat.FontHeight = 18;
            }
        }
    // Zapisuje zmodyfikowaną prezentację
    pres.Save("multiParaPort_out.pptx", SaveFormat.Pptx);
}

Zarządzaj wypunktowaniem akapitu

Listy wypunktowane pomagają szybko i efektywnie organizować oraz prezentować informacje. Akapity z wypunktowaniem są zawsze łatwiejsze do odczytania i zrozumienia.

1. Utwórz instancję klasy Presentation.
2. Uzyskaj odwołanie do odpowiedniego slajdu poprzez jego indeks.
3. Dodaj autoshape do wybranego slajdu.
4. Uzyskaj dostęp do TextFrame autoshape.
5. Usuń domyślny akapit w TextFrame.
6. Utwórz pierwszą instancję akapitu przy użyciu klasy Paragraph.
7. Ustaw Type wypunktowania akapitu na Symbol i określ znak wypunktowania.
8. Ustaw Text akapitu.
9. Ustaw Indent akapitu dla wypunktowania.
10. Ustaw kolor wypunktowania.
11. Ustaw wysokość wypunktowania.
12. Dodaj nowy akapit do kolekcji akapitów TextFrame.
13. Dodaj drugi akapit i powtórz proces opisany w krokach 7‑13.
14. Zapisz prezentację.

// Tworzy instancję klasy Presentation, która reprezentuje plik PPTX
using (Presentation pres = new Presentation())
{

    // Uzyskuje dostęp do pierwszego slajdu
    ISlide slide = pres.Slides[0];


    // Dodaje i uzyskuje dostęp do Autoshape
    IAutoShape aShp = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Uzyskuje dostęp do ramki tekstowej autoshape
    ITextFrame txtFrm = aShp.TextFrame;

    // Usuwa domyślny akapit
    txtFrm.Paragraphs.RemoveAt(0);

    // Tworzy akapit
    Paragraph para = new Paragraph();

    // Ustawia styl i symbol wypunktowania akapitu
    para.ParagraphFormat.Bullet.Type = BulletType.Symbol;
    para.ParagraphFormat.Bullet.Char = Convert.ToChar(8226);

    // Ustawia tekst akapitu
    para.Text = "Welcome to Aspose.Slides";

    // Ustawia wcięcie wypunktowania
    para.ParagraphFormat.Indent = 25;

    // Ustawia kolor wypunktowania
    para.ParagraphFormat.Bullet.Color.ColorType = ColorType.RGB;
    para.ParagraphFormat.Bullet.Color.Color = Color.Black;
    para.ParagraphFormat.Bullet.IsBulletHardColor = NullableBool.True; // ustaw IsBulletHardColor na true, aby używać własnego koloru wypunktowania

    // Ustawia wysokość wypunktowania
    para.ParagraphFormat.Bullet.Height = 100;

    // Dodaje akapit do ramki tekstowej
    txtFrm.Paragraphs.Add(para);

    // Tworzy drugi akapit
    Paragraph para2 = new Paragraph();

    // Ustawia typ i styl wypunktowania akapitu
    para2.ParagraphFormat.Bullet.Type = BulletType.Numbered;
    para2.ParagraphFormat.Bullet.NumberedBulletStyle = NumberedBulletStyle.BulletCircleNumWDBlackPlain;

    // Dodaje tekst akapitu
    para2.Text = "This is numbered bullet";

    // Ustawia wcięcie wypunktowania
    para2.ParagraphFormat.Indent = 25;

    para2.ParagraphFormat.Bullet.Color.ColorType = ColorType.RGB;
    para2.ParagraphFormat.Bullet.Color.Color = Color.Black;
    para2.ParagraphFormat.Bullet.IsBulletHardColor = NullableBool.True; // ustaw IsBulletHardColor na true, aby używać własnego koloru wypunktowania

    // Ustawia wysokość wypunktowania
    para2.ParagraphFormat.Bullet.Height = 100;

    // Dodaje akapit do ramki tekstowej
    txtFrm.Paragraphs.Add(para2);


    // Zapisuje zmodyfikowaną prezentację
    pres.Save("Bullet_out.pptx", SaveFormat.Pptx);

}

Zarządzaj wypunktowaniem obrazkowym

Listy wypunktowane pomagają szybko i efektywnie organizować oraz prezentować informacje. Akapity z obrazkami są łatwe do odczytania i zrozumienia.

1. Utwórz instancję klasy Presentation.
2. Uzyskaj odwołanie do odpowiedniego slajdu poprzez jego indeks.
3. Dodaj autoshape do slajdu.
4. Uzyskaj dostęp do TextFrame.
5. Usuń domyślny akapit w TextFrame.
6. Utwórz pierwszą instancję akapitu przy użyciu klasy Paragraph.
7. Wczytaj obraz przy użyciu IPPImage.
8. Ustaw typ wypunktowania na Picture i określ obraz.
9. Ustaw Text akapitu.
10. Ustaw Indent akapitu dla wypunktowania.
11. Ustaw kolor wypunktowania.
12. Ustaw wysokość wypunktowania.
13. Dodaj nowy akapit do kolekcji akapitów TextFrame.
14. Dodaj drugi akapit i powtórz proces na podstawie poprzednich kroków.
15. Zapisz zmodyfikowaną prezentację.

// Tworzy instancję klasy Presentation, która reprezentuje plik PPTX
Presentation presentation = new Presentation();

// Uzyskuje dostęp do pierwszego slajdu
ISlide slide = presentation.Slides[0];

// Tworzy obraz dla wypunktowania
IImage image = Images.FromFile("bullets.png");
IPPImage ippxImage = presentation.Images.AddImage(image);
image.Dispose();

// Dodaje i uzyskuje dostęp do Autoshape
IAutoShape autoShape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

// Uzyskuje dostęp do ramki tekstowej autoshape
ITextFrame textFrame = autoShape.TextFrame;

// Usuwa domyślny akapit
textFrame.Paragraphs.RemoveAt(0);

// Tworzy nowy akapit
Paragraph paragraph = new Paragraph();
paragraph.Text = "Welcome to Aspose.Slides";

// Ustawia styl i obraz wypunktowania akapitu
paragraph.ParagraphFormat.Bullet.Type = BulletType.Picture;
paragraph.ParagraphFormat.Bullet.Picture.Image = ippxImage;

// Ustawia wysokość wypunktowania
paragraph.ParagraphFormat.Bullet.Height = 100;

// Dodaje akapit do ramki tekstowej
textFrame.Paragraphs.Add(paragraph);

// Zapisuje prezentację jako plik PPTX
presentation.Save("ParagraphPictureBulletsPPTX_out.pptx", SaveFormat.Pptx);

// Zapisuje prezentację jako plik PPT
presentation.Save("ParagraphPictureBulletsPPT_out.ppt", SaveFormat.Ppt);

Zarządzaj wypunktowaniem wielopoziomowym

Listy wypunktowane pomagają szybko i efektywnie organizować oraz prezentować informacje. Wypunktowanie wielopoziomowe jest łatwe do odczytania i zrozumienia.

1. Utwórz instancję klasy Presentation.
2. Uzyskaj odwołanie do odpowiedniego slajdu poprzez jego indeks.
3. Dodaj autoshape na nowym slajdzie.
4. Uzyskaj dostęp do TextFrame.
5. Usuń domyślny akapit w TextFrame.
6. Utwórz pierwszą instancję akapitu przy użyciu klasy Paragraph i ustaw głębokość na 0.
7. Utwórz drugą instancję akapitu przy użyciu klasy Paragraph i ustaw głębokość na 1.
8. Utwórz trzecią instancję akapitu przy użyciu klasy Paragraph i ustaw głębokość na 2.
9. Utwórz czwartą instancję akapitu przy użyciu klasy Paragraph i ustaw głębokość na 3.
10. Dodaj nowe akapity do kolekcji akapitów TextFrame.
11. Zapisz zmodyfikowaną prezentację.

// Tworzy instancję klasy Presentation, która reprezentuje plik PPTX
using (Presentation pres = new Presentation())
{

    // Uzyskuje dostęp do pierwszego slajdu
    ISlide slide = pres.Slides[0];
    
    // Dodaje i uzyskuje dostęp do Autoshape
    IAutoShape aShp = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Uzyskuje dostęp do ramki tekstowej utworzonego autoshape
    ITextFrame text = aShp.AddTextFrame("");
    
    // Czyści domyślny akapit
    text.Paragraphs.Clear();

    // Dodaje pierwszy akapit
    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;
    // Ustawia poziom wypunktowania
    para1.ParagraphFormat.Depth = 0;

    // Dodaje drugi akapit
    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;
    // Ustawia poziom wypunktowania
    para2.ParagraphFormat.Depth = 1;

    // Dodaje trzeci akapit
    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;
    // Ustawia poziom wypunktowania
    para3.ParagraphFormat.Depth = 2;

    // Dodaje czwarty akapit
    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;
    // Ustawia poziom wypunktowania
    para4.ParagraphFormat.Depth = 3;

    // Dodaje akapity do kolekcji
    text.Paragraphs.Add(para1);
    text.Paragraphs.Add(para2);
    text.Paragraphs.Add(para3);
    text.Paragraphs.Add(para4);

    // Zapisuje prezentację jako plik PPTX
    pres.Save("MultilevelBullet.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

Zarządzaj akapitem z własną listą numerowaną

Interfejs IBulletFormat udostępnia właściwość NumberedBulletStartWith oraz inne, które pozwalają zarządzać akapitami z własnym numerowaniem lub formatowaniem.

1. Utwórz instancję klasy Presentation.
2. Uzyskaj dostęp do slajdu zawierającego akapit.
3. Dodaj autoshape do slajdu.
4. Uzyskaj dostęp do TextFrame.
5. Usuń domyślny akapit w TextFrame.
6. Utwórz pierwszą instancję akapitu przy użyciu klasy Paragraph i ustaw NumberedBulletStartWith na 2.
7. Utwórz drugą instancję akapitu przy użyciu klasy Paragraph i ustaw NumberedBulletStartWith na 3.
8. Utwórz trzecią instancję akapitu przy użyciu klasy Paragraph i ustaw NumberedBulletStartWith na 7.
9. Dodaj nowe akapity do kolekcji akapitów TextFrame.
10. Zapisz zmodyfikowaną prezentację.

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

	// Uzyskuje dostęp do ramki tekstowej utworzonego autoshape
	ITextFrame textFrame = shape.TextFrame;

	// Usuwa domyślny istniejący akapit
	textFrame.Paragraphs.RemoveAt(0);

	// Pierwsza 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);
}

Ustaw wcięcie pierwszej linii dla akapitu

Użyj właściwości IParagraphFormat.Indent, aby kontrolować wcięcie pierwszej linii akapitu. Ta właściwość przesuwa tylko pierwszą linię względem lewego marginesu akapitu. Dodatnia wartość przesuwa pierwszą linię w prawo, podczas gdy pozostałe linie pozostają wyrównane do treści akapitu.

Użyj IParagraphFormat.MarginLeft, gdy potrzebujesz przesunąć cały akapit. Użyj IParagraphFormat.Indent, gdy potrzebujesz przesunąć tylko pierwszą linię.

Poniższy przykład tworzy kilka akapitów i stosuje różne wartości Indent, aby pokazać, jak wcięcie pierwszej linii wpływa na układ akapitu.

1. Utwórz instancję klasy Presentation.
2. Uzyskaj dostęp do docelowego slajdu.
3. Dodaj prostokątną AutoShape do slajdu.
4. Dodaj pusty TextFrame do kształtu i usuń domyślny akapit.
5. Utwórz kilka akapitów i ustaw różne wartości Indent dla nich.
6. Dodaj akapity do ramki tekstowej.
7. Zapisz zmodyfikowaną prezentację.

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);
}

Ustaw wcięcie wiszące dla akapitu

Wcięcie wiszące to układ akapitu, w którym pierwsza linia zaczyna się po lewej stronie pozostałych linii. W Aspose.Slides efekt ten uzyskuje się przy użyciu właściwości IParagraphFormat.Indent. Ustaw Indent na wartość ujemną, aby przesunąć pierwszą linię w lewo względem treści akapitu.

W praktyce, IParagraphFormat.MarginLeft definiuje lewą pozycję treści akapitu, a IParagraphFormat.Indent określa pozycję pierwszej linii względem tego marginesu. Aby utworzyć wcięcie wiszące, ustaw dodatnią wartość MarginLeft oraz ujemną wartość Indent.

Takie formatowanie jest przydatne w bibliografiach, odnośnikach, hasłach słownika oraz innych akapitach, w których łamane wiersze muszą być wyrównane pod treścią akapitu, a nie pod pierwszym znakiem pierwszej linii.

1. Utwórz instancję klasy Presentation.
2. Uzyskaj dostęp do docelowego slajdu.
3. Dodaj prostokątną AutoShape do slajdu.
4. Dodaj pusty TextFrame do kształtu i usuń domyślny akapit.
5. Utwórz akapity i ustaw dodatnią wartość MarginLeft dla każdego akapitu.
6. Ustaw ujemną wartość Indent aby uzyskać efekt wcięcia wiszącego.
7. Dodaj akapity do ramki tekstowej.
8. Zapisz zmodyfikowaną prezentację.

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);
}

Zarządzaj właściwościami końcowego uruchomienia akapitu

1. Utwórz instancję klasy Presentation .
2. Uzyskaj odwołanie do slajdu zawierającego akapit poprzez jego pozycję.
3. Dodaj prostokątny autoshape do slajdu.
4. Dodaj TextFrame z dwoma akapitami do prostokąta.
5. Ustaw FontHeight i typ czcionki dla akapitów.
6. Ustaw właściwości End dla akapitów.
7. Zapisz zmodyfikowaną prezentację jako plik PPTX.

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);
}

Importuj tekst HTML do akapitów

Aspose.Slides zapewnia rozszerzone wsparcie dla importowania tekstu HTML do akapitów.

1. Utwórz instancję klasy Presentation.
2. Uzyskaj odwołanie do odpowiedniego slajdu poprzez jego indeks.
3. Dodaj autoshape do slajdu.
4. Dodaj i uzyskaj dostęp do ITextFrame autoshape.
5. Usuń domyślny akapit w ITextFrame.
6. Wczytaj źródłowy plik HTML przy użyciu TextReader.
7. Utwórz pierwszą instancję akapitu przy użyciu klasy Paragraph.
8. Dodaj zawartość pliku HTML odczytaną przez TextReader do ParagraphCollection ramki tekstowej.
9. Zapisz zmodyfikowaną prezentację.

// Tworzy pustą instancję prezentacji
using (Presentation pres = new Presentation())
{
    // Uzyskuje dostęp do domyślnego pierwszego slajdu prezentacji
    ISlide slide = pres.Slides[0];

    // Dodaje AutoShape, aby pomieścić treść 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;

    // Dodaje ramkę tekstową do kształtu
    ashape.AddTextFrame("");

    // Czyści wszystkie akapity w dodanej ramce tekstowej
    ashape.TextFrame.Paragraphs.Clear();

    // Ładuje plik HTML przy użyciu StreamReader
    TextReader tr = new StreamReader("file.html");

    // Dodaje tekst z czytnika strumienia HTML do ramki tekstowej
    ashape.TextFrame.Paragraphs.AddFromHtml(tr.ReadToEnd());

    // Zapisuje prezentację
    pres.Save("output_out.pptx", Aspose.Slides.Export.SaveFormat.Pptx);
}

Eksportuj tekst akapitu do HTML

Aspose.Slides zapewnia rozszerzone wsparcie dla eksportowania tekstów (zawartych w akapitach) do HTML.

1. Utwórz instancję klasy Presentation i wczytaj żądaną prezentację.
2. Uzyskaj odwołanie do odpowiedniego slajdu poprzez jego indeks.
3. Uzyskaj dostęp do kształtu zawierającego tekst, który zostanie wyeksportowany do HTML.
4. Uzyskaj dostęp do TextFrame kształtu.
5. Utwórz instancję StreamWriter i dodaj nowy plik HTML.
6. Podaj początkowy indeks do StreamWriter i wyeksportuj wybrane akapity.

// Ładuje plik prezentacji
using (Presentation pres = new Presentation("ExportingHTMLText.pptx"))
{

    // Uzyskuje dostęp do domyślnego pierwszego slajdu prezentacji
    ISlide slide = pres.Slides[0];

    // Uzyskuje dostęp do wymaganego  index
    int index = 0;

    // Uzyskuje dostęp do dodanego kształtu
    IAutoShape ashape = (IAutoShape)slide.Shapes[index];

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

    // Zapisuje dane akapitów do HTML, określając indeks początkowy akapitu i liczbę akapitów do skopiowania
    sw.Write(ashape.TextFrame.Paragraphs.ExportToHtml(0, ashape.TextFrame.Paragraphs.Count, null));

    sw.Close();
}

Zapisz akapit jako obraz

W tej sekcji przedstawimy dwa przykłady ilustrujące, jak zapisać akapit tekstowy, reprezentowany przez interfejs IParagraph, jako obraz. Oba przykłady obejmują uzyskanie obrazu kształtu zawierającego akapit przy użyciu metod GetImage z interfejsu IShape, obliczenie granic akapitu w obrębie kształtu oraz wyeksportowanie go jako obrazu bitmapowego. Takie podejścia umożliwiają wyodrębnienie konkretnych fragmentów tekstu z prezentacji PowerPoint i zapisanie ich jako oddzielnych obrazów, co może być przydatne w różnych scenariuszach.

Załóżmy, że mamy plik prezentacji o nazwie sample.pptx z jednym slajdem, gdzie pierwszy kształt jest polem tekstowym zawierającym trzy akapity.

Przykład 1

W tym przykładzie uzyskujemy drugi akapit jako obraz. W tym celu wyodrębniamy obraz kształtu z pierwszego slajdu prezentacji, a następnie obliczamy granice drugiego akapitu w ramce tekstowej kształtu. Akapit jest następnie rysowany na nowym obrazie bitmapowym, który jest zapisywany w formacie PNG. Ta metoda jest szczególnie przydatna, gdy trzeba zapisać określony akapit jako oddzielny obraz, zachowując dokładne wymiary i formatowanie tekstu.

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

// Zapisz kształt w pamięci jako bitmapę.
using var shapeImage = firstShape.GetImage();
using var shapeImageStream = new MemoryStream();
shapeImage.Save(shapeImageStream, ImageFormat.Png);

// Utwórz bitmapę kształtu z pamięci.
shapeImageStream.Seek(0, SeekOrigin.Begin);
using var shapeBitmap = Image.FromStream(shapeImageStream);

// Oblicz granice drugiego akapitu.
var secondParagraph = firstShape.TextFrame.Paragraphs[1];
var paragraphRectangle = secondParagraph.GetRect();

// Oblicz rozmiar obrazu wyjściowego (minimalny rozmiar - 1x1 piksel).
var imageWidth = Math.Max(1, (int)Math.Ceiling(paragraphRectangle.Width));
var imageHeight = Math.Max(1, (int)Math.Ceiling(paragraphRectangle.Height));

// Przygotuj bitmapę dla akapitu.
using var paragraphBitmap = new Bitmap(imageWidth, imageHeight);

// Przerysuj akapit z bitmapy kształtu do bitmapy akapitu.
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);

Przykład 2

W tym przykładzie rozszerzamy poprzednie podejście o dodanie czynników skalowania do obrazu akapitu. Kształt jest wyodrębniany z prezentacji i zapisywany jako obraz ze współczynnikiem skalowania 2. Dzięki temu uzyskuje się wyjście o wyższej rozdzielczości przy eksportowaniu akapitu. Granice akapitu są następnie obliczane z uwzględnieniem skali. Skalowanie może być szczególnie przydatne, gdy potrzebny jest bardziej szczegółowy obraz, na przykład do zastosowań w wysokiej jakości materiałach drukowanych.

var imageScaleX = 2f;
var imageScaleY = imageScaleX;

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

// Zapisz kształt w pamięci jako bitmapę z skalowaniem.
using var shapeImage = firstShape.GetImage(ShapeThumbnailBounds.Shape, imageScaleX, imageScaleY);
using var shapeImageStream = new MemoryStream();
shapeImage.Save(shapeImageStream, ImageFormat.Png);

// Utwórz bitmapę kształtu z pamięci.
shapeImageStream.Seek(0, SeekOrigin.Begin);
using var shapeBitmap = Image.FromStream(shapeImageStream);

// Oblicz granice drugiego akapitu.
var secondParagraph = firstShape.TextFrame.Paragraphs[1];
var paragraphRectangle = secondParagraph.GetRect();
paragraphRectangle.X *= imageScaleX;
paragraphRectangle.Y *= imageScaleY;
paragraphRectangle.Width *= imageScaleX;
paragraphRectangle.Height *= imageScaleY;

// Oblicz rozmiar obrazu wyjściowego (minimalny rozmiar - 1x1 piksel).
var imageWidth = Math.Max(1, (int)Math.Ceiling(paragraphRectangle.Width));
var imageHeight = Math.Max(1, (int)Math.Ceiling(paragraphRectangle.Height));

// Przygotuj bitmapę dla akapitu.
using var paragraphBitmap = new Bitmap(imageWidth, imageHeight);

// Przerysuj akapit z bitmapy kształtu do bitmapy akapitu.
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

Czy mogę całkowicie wyłączyć zawijanie linii wewnątrz ramki tekstowej?

Tak. Użyj ustawienia zawijania ramki tekstowej (WrapText), aby wyłączyć zawijanie, dzięki czemu linie nie będą łamane przy krawędziach ramki.

Jak mogę uzyskać dokładne granice konkretnego akapitu na slajdzie?

Możesz pobrać prostokąt ograniczający akapit (a nawet pojedynczy fragment), aby poznać jego dokładną pozycję i rozmiar na slajdzie.

Gdzie kontrolowane jest wyrównanie akapitu (lewo/prawo/środek/wyjustowanie)?

Alignment jest ustawieniem na poziomie akapitu w ParagraphFormat; stosuje się do całego akapitu, niezależnie od formatowania poszczególnych fragmentów.

Czy mogę ustawić język sprawdzania pisowni tylko dla części akapitu (np. jednego słowa)?

Tak. Język jest ustawiany na poziomie fragmentu (PortionFormat.LanguageId), więc w jednym akapicie mogą współistnieć różne języki.