PowerPoint Metin Paragraflarını PHP'de Yönetme

Giriş

Aspose.Slides, PowerPoint metinleri, paragrafları ve bölümleriyle çalışmak için ihtiyacınız olan tüm sınıfları sağlar.

  • Aspose.Slides, bir paragrafı temsil eden nesneler eklemenizi sağlayan TextFrame sınıfını sağlar. Bir TextFame nesnesi bir veya birden fazla paragraf içerebilir (her paragraf bir satır sonu ile oluşturulur).
  • Aspose.Slides, bölümleri temsil eden nesneler eklemenizi sağlayan Paragraph sınıfını sağlar. Bir Paragraph nesnesi bir veya birden fazla bölüm içerebilir (bölüm nesnelerinin koleksiyonu).
  • Aspose.Slides, metinleri ve bunların biçimlendirme özelliklerini temsil eden nesneler eklemenizi sağlayan Portion sınıfını sağlar.

Paragraph nesnesi, temel Portion nesneleri aracılığıyla farklı biçimlendirme özelliklerine sahip metinleri işleyebilir.

Birden Çok Bölüm İçeren Birden Çok Paragraf Ekleme

  1. Presentation sınıfının bir örneğini oluşturun.
  2. İlgili slaytın referansına indeksini kullanarak erişin.
  3. Slayta bir Dikdörtgen AutoShape ekleyin.
  4. AutoShape ile ilişkilendirilen ITextFrame’i alın.
  5. İki Paragraph nesnesi oluşturun ve bunları TextFrame nesnesinin paragraf koleksiyonuna ekleyin.
  6. Her yeni Paragraph için üç Portion nesnesi oluşturun (varsayılan Paragraph için iki Portion nesnesi) ve her Portion nesnesini ilgili Paragraph‘ın bölüm koleksiyonuna ekleyin.
  7. Her bölüm için metin belirleyin.
  8. Portion nesnesinin sunduğu biçimlendirme özelliklerini kullanarak her bölüme istediğiniz biçimlendirmeyi uygulayın.
  9. Değiştirilen sunumu kaydedin.

Bu PHP kodu, bölümler içeren paragraflar ekleme adımlarının bir uygulamasıdır:

# PPTX dosyasını temsil eden bir Presentation sınıfı oluştur
$pres = new Presentation();
try {
    # İlk slayta erişme
    $slide = $pres->getSlides()->get_Item(0);
    # Dikdörtgen tipinde bir AutoShape ekle
    $ashp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 150, 300, 150);
    # AutoShape'in TextFrame'ine eriş
    $tf = $ashp->getTextFrame();
    # Farklı metin biçimleriyle Paragraflar ve Bölümler oluştur
    $para0 = $tf->getParagraphs()->get_Item(0);
    $port01 = new Portion();
    $port02 = new Portion();
    $para0->getPortions()->add($port01);
    $para0->getPortions()->add($port02);
    $para1 = new Paragraph();
    $tf->getParagraphs()->add($para1);
    $port10 = new Portion();
    $port11 = new Portion();
    $port12 = new Portion();
    $para1->getPortions()->add($port10);
    $para1->getPortions()->add($port11);
    $para1->getPortions()->add($port12);
    $para2 = new Paragraph();
    $tf->getParagraphs()->add($para2);
    $port20 = new Portion();
    $port21 = new Portion();
    $port22 = new Portion();
    $para2->getPortions()->add($port20);
    $para2->getPortions()->add($port21);
    $para2->getPortions()->add($port22);
    for($i = 0; $i < 3; $i++) {
        for($j = 0; $j < 3; $j++) {
            $portion = $tf->getParagraphs()->get_Item($i)->getPortions()->get_Item($j);
            $portion->setText("Portion0" . $j);
            if ($j == 0) {
                $portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
                $portion->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
                $portion->getPortionFormat()->setFontBold(NullableBool::True);
                $portion->getPortionFormat()->setFontHeight(15);
            } else if ($j == 1) {
                $portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
                $portion->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLUE);
                $portion->getPortionFormat()->setFontItalic(NullableBool::True);
                $portion->getPortionFormat()->setFontHeight(18);
            }
        }
    }
    # PPTX'i diske kaydet
    $pres->save("multiParaPort_out.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($pres)) {
        $pres->dispose();
    }
}

Paragraf Madde İşaretlerini Yönetme

Madde işaretli listeler, bilgiyi hızlı ve verimli bir şekilde organize etmenize ve sunmanıza yardımcı olur. Madde işaretli paragraflar her zaman daha kolay okunur ve anlaşılır.

  1. Presentation sınıfının bir örneğini oluşturun.
  2. İlgili slaytın referansına indeksini kullanarak erişin.
  3. Seçilen slayta bir AutoShape ekleyin.
  4. AutoShape’in TextFrame’ine erişin.
  5. TextFrame içindeki varsayılan paragrafı kaldırın.
  6. Paragraph sınıfını kullanarak ilk paragraf örneğini oluşturun.
  7. Paragrafın madde işareti Typeını Symbol olarak ayarlayın ve madde işareti karakterini belirleyin.
  8. Paragrafın Text özelliğini ayarlayın.
  9. Madde işareti için paragrafın Indent özelliğini ayarlayın.
  10. Madde işareti için bir renk belirleyin.
  11. Madde işaretinin yüksekliğini ayarlayın.
  12. Yeni paragrafı TextFrame paragraf koleksiyonuna ekleyin.
  13. İkinci paragrafı ekleyin ve adım 7’den 13’e kadar verilen süreci tekrarlayın.
  14. Sunumu kaydedin.

Bu PHP kodu, bir paragraf madde işareti eklemeyi gösterir:

# PPTX dosyasını temsil eden bir Presentation sınıfı örnekler
$pres = new Presentation();
try {
    # İlk slayta erişir
    $slide = $pres->getSlides()->get_Item(0);
    # AutoShape ekler ve ona erişir
    $aShp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # AutoShape'in metin çerçevesine erişir
    $txtFrm = $aShp->getTextFrame();
    # Varsayılan paragrafı kaldırır
    $txtFrm->getParagraphs()->removeAt(0);
    # Bir paragraf oluşturur
    $para = new Paragraph();
    # Paragraf madde işareti stilini ve sembolünü ayarlar
    $para->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para->getParagraphFormat()->getBullet()->setChar(8226);
    # Paragraf metnini ayarlar
    $para->setText("Welcome to Aspose.Slides");
    # Madde işareti girintisini ayarlar
    $para->getParagraphFormat()->setIndent(25);
    # Madde işareti rengini ayarlar
    $para->getParagraphFormat()->getBullet()->getColor()->setColorType(ColorType::RGB);
    $para->getParagraphFormat()->getBullet()->getColor()->setColor(java("java.awt.Color")->BLACK);
    $para->getParagraphFormat()->getBullet()->setBulletHardColor(NullableBool::True);// kendi madde işareti rengini kullanmak için IsBulletHardColor'ı true olarak ayarla

    # Madde işareti yüksekliğini ayarlar
    $para->getParagraphFormat()->getBullet()->setHeight(100);
    # Paragrafı metin çerçevesine ekler
    $txtFrm->getParagraphs()->add($para);
    # İkinci paragrafı oluşturur
    $para2 = new Paragraph();
    # Paragraf madde işareti türünü ve stilini ayarlar
    $para2->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $para2->getParagraphFormat()->getBullet()->setNumberedBulletStyle(NumberedBulletStyle->BulletCircleNumWDBlackPlain);
    # Paragraf metnini ekler
    $para2->setText("This is numbered bullet");
    # Madde işareti girintisini ayarlar
    $para2->getParagraphFormat()->setIndent(25);
    $para2->getParagraphFormat()->getBullet()->getColor()->setColorType(ColorType::RGB);
    $para2->getParagraphFormat()->getBullet()->getColor()->setColor(java("java.awt.Color")->BLACK);
    $para2->getParagraphFormat()->getBullet()->setBulletHardColor(NullableBool::True);// kendi madde işareti rengini kullanmak için IsBulletHardColor'ı true olarak ayarla

    # Madde işareti yüksekliğini ayarlar
    $para2->getParagraphFormat()->getBullet()->setHeight(100);
    # Paragrafı metin çerçevesine ekler
    $txtFrm->getParagraphs()->add($para2);
    # Değiştirilmiş sunumu kaydeder
    $pres->save("Bullet_out.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($pres)) {
        $pres->dispose();
    }
}

Resim Madde İşaretlerini Yönetme

Madde işaretli listeler, bilgiyi hızlı ve verimli bir şekilde organize etmenize ve sunmanıza yardımcı olur. Resim madde işaretli paragraflar kolay okunur ve anlaşılır.

  1. Presentation sınıfının bir örneğini oluşturun.
  2. İlgili slaytın referansına indeksini kullanarak erişin.
  3. Slayta bir AutoShape ekleyin.
  4. AutoShape‘in TextFrame’ine erişin.
  5. TextFrame içindeki varsayılan paragrafı kaldırın.
  6. Paragraph sınıfını kullanarak ilk paragraf örneğini oluşturun.
  7. PPImage ile görüntüyü yükleyin.
  8. Madde işareti tipini Picture olarak ayarlayın ve resmi belirleyin.
  9. Paragrafın Text özelliğini ayarlayın.
  10. Madde işareti için paragrafın Indent özelliğini ayarlayın.
  11. Madde işareti için bir renk belirleyin.
  12. Madde işaretinin yüksekliğini ayarlayın.
  13. Yeni paragrafı TextFrame paragraf koleksiyonuna ekleyin.
  14. İkinci paragrafı ekleyin ve önceki adımlara göre işlemi tekrarlayın.
  15. Değiştirilen sunumu kaydedin.

Bu PHP kodu, resim madde işaretlerini eklemeyi ve yönetmeyi gösterir:

# PPTX dosyasını temsil eden bir Presentation sınıfı örnekler
$presentation = new Presentation();
try {
    # İlk slayta erişir
    $slide = $presentation->getSlides()->get_Item(0);
    # Madde işaretleri için resmi örnekler
    $picture;
    $image = Images->fromFile("bullets.png");
    try {
        $picture = $presentation->getImages()->addImage($image);
    } finally {
        if (!java_is_null($image)) {
            $image->dispose();
        }
    }
    # AutoShape ekler ve ona erişir
    $autoShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # AutoShape'in metin çerçevesine erişir
    $textFrame = $autoShape->getTextFrame();
    # Varsayılan paragrafı kaldırır
    $textFrame->getParagraphs()->removeAt(0);
    # Yeni bir paragraf oluşturur
    $paragraph = new Paragraph();
    $paragraph->setText("Welcome to Aspose.Slides");
    # Paragraf madde işareti stilini ve resmi ayarlar
    $paragraph->getParagraphFormat()->getBullet()->setType(BulletType::Picture);
    $paragraph->getParagraphFormat()->getBullet()->getPicture()->setImage($picture);
    # Madde işareti yüksekliğini ayarlar
    $paragraph->getParagraphFormat()->getBullet()->setHeight(100);
    # Paragrafı metin çerçevesine ekler
    $textFrame->getParagraphs()->add($paragraph);
    # Sunumu PPTX dosyası olarak yazar
    $presentation->save("ParagraphPictureBulletsPPTX_out.pptx", SaveFormat::Pptx);
    # Sunumu PPT dosyası olarak yazar
    $presentation->save("ParagraphPictureBulletsPPT_out.ppt", SaveFormat::Ppt);
} catch (JavaException $e) {
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Çok Seviyeli Madde İşaretlerini Yönetme

Madde işaretli listeler, bilgiyi hızlı ve verimli bir şekilde organize etmenize ve sunmanıza yardımcı olur. Çok seviyeli madde işaretleri okunması ve anlaşılması kolaydır.

  1. Presentation sınıfının bir örneğini oluşturun.
  2. İlgili slaytın referansına indeksini kullanarak erişin.
  3. Yeni slayta bir AutoShape ekleyin.
  4. AutoShape’in TextFrame’ine erişin.
  5. TextFrame içindeki varsayılan paragrafı kaldırın.
  6. Paragraph sınıfı aracılığıyla ilk paragraf örneğini oluşturun ve derinliği 0 olarak ayarlayın.
  7. Paragraph sınıfı aracılığıyla ikinci paragraf örneğini oluşturun ve derinliği 1 olarak ayarlayın.
  8. Paragraph sınıfı aracılığıyla üçüncü paragraf örneğini oluşturun ve derinliği 2 olarak ayarlayın.
  9. Paragraph sınıfı aracılığıyla dördüncü paragraf örneğini oluşturun ve derinliği 3 olarak ayarlayın.
  10. Yeni paragrafları TextFrame paragraf koleksiyonuna ekleyin.
  11. Değiştirilen sunumu kaydedin.

Bu PHP kodu, çok seviyeli madde işaretlerini eklemeyi ve yönetmeyi gösterir:

# PPTX dosyasını temsil eden bir Presentation sınıfı örnekler
$pres = new Presentation();
try {
    # İlk slayta erişir
    $slide = $pres->getSlides()->get_Item(0);
    # AutoShape ekler ve ona erişir
    $aShp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # Oluşturulan autoShape'in metin çerçevesine erişir
    $text = $aShp->addTextFrame("");
    # Varsayılan paragrafı temizler
    $text->getParagraphs()->clear();
    # İlk paragrafı ekler
    $para1 = new Paragraph();
    $para1->setText("Content");
    $para1->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para1->getParagraphFormat()->getBullet()->setChar(8226);
    $para1->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para1->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Madde işareti seviyesini ayarlar
    $para1->getParagraphFormat()->setDepth(0);
    # İkinci paragrafı ekler
    $para2 = new Paragraph();
    $para2->setText("Second Level");
    $para2->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para2->getParagraphFormat()->getBullet()->setChar('-');
    $para2->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para2->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Madde işareti seviyesini ayarlar
    $para2->getParagraphFormat()->setDepth(1);
    # Üçüncü paragrafı ekler
    $para3 = new Paragraph();
    $para3->setText("Third Level");
    $para3->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para3->getParagraphFormat()->getBullet()->setChar(8226);
    $para3->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para3->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Madde işareti seviyesini ayarlar
    $para3->getParagraphFormat()->setDepth(2);
    # Dördüncü paragrafı ekler
    $para4 = new Paragraph();
    $para4->setText("Fourth Level");
    $para4->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para4->getParagraphFormat()->getBullet()->setChar('-');
    $para4->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para4->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Madde işareti seviyesini ayarlar
    $para4->getParagraphFormat()->setDepth(3);
    # Paragrafları koleksiyona ekler
    $text->getParagraphs()->add($para1);
    $text->getParagraphs()->add($para2);
    $text->getParagraphs()->add($para3);
    $text->getParagraphs()->add($para4);
    # Sunumu PPTX dosyası olarak yazar
    $pres->save("MultilevelBullet.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($pres)) {
        $pres->dispose();
    }
}

Özel Numaralı Liste ile Bir Paragrafı Yönetme

BulletFormat sınıfı, paragrafları özel numaralandırma veya biçimlendirme ile yönetmenizi sağlayan setNumberedBulletStartWith yöntemi ve diğerlerini sunar.

  1. Presentation sınıfının bir örneğini oluşturun.
  2. Paragrafı içeren slayta erişin.
  3. Slayta bir AutoShape ekleyin.
  4. AutoShape’in TextFrame’ine erişin.
  5. TextFrame içindeki varsayılan paragrafı kaldırın.
  6. Paragraph sınıfı aracılığıyla ilk paragraf örneğini oluşturun ve NumberedBulletStartWith değerini 2 olarak ayarlayın.
  7. Paragraph sınıfı aracılığıyla ikinci paragraf örneğini oluşturun ve NumberedBulletStartWith değerini 3 olarak ayarlayın.
  8. Paragraph sınıfı aracılığıyla üçüncü paragraf örneğini oluşturun ve NumberedBulletStartWith değerini 7 olarak ayarlayın.
  9. Yeni paragrafları TextFrame paragraf koleksiyonuna ekleyin.
  10. Değiştirilen sunumu kaydedin.

Bu PHP kodu, özel numaralı liste ile paragrafları eklemeyi ve yönetmeyi gösterir:

$presentation = new Presentation();
try {
    $shape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # Oluşturulan autoshape'in metin çerçevesine erişir
    $textFrame = $shape->getTextFrame();
    # Varsayılan mevcut paragrafı kaldırır
    $textFrame->getParagraphs()->removeAt(0);
    # İlk liste
    $paragraph1 = new Paragraph();
    $paragraph1->setText("bullet 2");
    $paragraph1->getParagraphFormat()->setDepth(4);
    $paragraph1->getParagraphFormat()->getBullet()->setNumberedBulletStartWith(2);
    $paragraph1->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $textFrame->getParagraphs()->add($paragraph1);
    $paragraph2 = new Paragraph();
    $paragraph2->setText("bullet 3");
    $paragraph2->getParagraphFormat()->setDepth(4);
    $paragraph2->getParagraphFormat()->getBullet()->setNumberedBulletStartWith(3);
    $paragraph2->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $textFrame->getParagraphs()->add($paragraph2);
    $paragraph5 = new Paragraph();
    $paragraph5->setText("bullet 7");
    $paragraph5->getParagraphFormat()->setDepth(4);
    $paragraph5->getParagraphFormat()->getBullet()->setNumberedBulletStartWith(7);
    $paragraph5->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $textFrame->getParagraphs()->add($paragraph5);
    $presentation->save("SetCustomBulletsNumber-slides.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Bir Paragraf İçin İlk Satır Girintisi Ayarlama

ParagraphFormat::setIndent metodunu kullanarak bir paragrafın ilk satır girintisini kontrol edebilirsiniz. Bu metod sadece paragrafın sol kenar boşluğuna göre ilk satırı hareket ettirir. Pozitif bir değer ilk satırı sağa kaydırırken, kalan satırlar paragraf gövdesine hizalı kalır.

Bütün paragrafı taşımak istediğinizde ParagraphFormat::setMarginLeft metodunu kullanın. Sadece ilk satırı taşımak istediğinizde ise ParagraphFormat::setIndent metodunu kullanın.

Aşağıdaki örnek, birkaç paragraf oluşturur ve farklı girinti değerleri uygulayarak ilk satır girintisinin paragraf düzenine nasıl etki ettiğini gösterir.

  1. Presentation sınıfının bir örneğini oluşturun.
  2. Hedef slayta erişin.
  3. Slayta dikdörtgen bir AutoShape ekleyin.
  4. Şekle boş bir TextFrame ekleyin ve varsayılan paragrafı kaldırın.
  5. Birkaç paragraf oluşturun ve onlara farklı Indent değerleri ayarlayın.
  6. Paragrafları metin çerçevesine ekleyin.
  7. Değiştirilen sunumu kaydedin.

Bu kod, bir paragraf girintisinin nasıl ayarlanacağını gösterir:

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $rectangleShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle,50,50,420,220);
    $rectangleShape->getFillFormat()->setFillType(FillType::NoFill);
    $rectangleShape->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $rectangleShape->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->GRAY);

    $textFrame = $rectangleShape->addTextFrame("");
    $textFrame->getTextFrameFormat()->setAutofitType(TextAutofitType::Shape);
    $textFrame->getParagraphs()->removeAt(0);

    $firstParagraph = new Paragraph();
    $firstParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $firstParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $firstParagraph->setText("No first-line indent. Wrapped lines start at the same position as the first line.");
    $firstParagraph->getParagraphFormat()->setMarginLeft(20.0);
    $firstParagraph->getParagraphFormat()->setIndent(0.0);

    $secondParagraph = new Paragraph();
    $secondParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $secondParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $secondParagraph->setText("First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body.");
    $secondParagraph->getParagraphFormat()->setMarginLeft(20.0);
    $secondParagraph->getParagraphFormat()->setIndent(20.0);

    $thirdParagraph = new Paragraph();
    $thirdParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $thirdParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $thirdParagraph->setText("First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see.");
    $thirdParagraph->getParagraphFormat()->setMarginLeft(20.0);
    $thirdParagraph->getParagraphFormat()->setIndent(40.0);

    $textFrame->getParagraphs()->add($firstParagraph);
    $textFrame->getParagraphs()->add($secondParagraph);
    $textFrame->getParagraphs()->add($thirdParagraph);

    $presentation->save("paragraph_indent.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Paragrafların ilk satır girintisi

Bir Paragraf İçin Asılı Girinti Ayarlama

Asılı girinti, ilk satırın kalan satırların solunda başladığı bir paragraf düzenidir. Aspose.Slides’te bu etkiyi ParagraphFormat::setIndent metodu ile oluşturabilirsiniz. İlk satırı paragraf gövdesine göre sola taşımak için girintiyi negatif bir değere ayarlayın.

Uygulamada, ParagraphFormat::setMarginLeft paragraf gövdesinin sol konumunu, ParagraphFormat::setIndent ise ilk satırın bu marjaya göre konumunu tanımlar. Asılı girinti oluşturmak için pozitif bir MarginLeft ve negatif bir Indent değeri ayarlayın.

Bu biçimlendirme, bibliyografyalar, referanslar, sözlük girişleri ve satırların paragraf gövdesinin altında hizalanması gereken diğer paragraflar için yararlıdır.

  1. Presentation sınıfının bir örneğini oluşturun.
  2. Hedef slayta erişin.
  3. Slayta dikdörtgen bir AutoShape ekleyin.
  4. Şekle boş bir TextFrame ekleyin ve varsayılan paragrafı kaldırın.
  5. Paragraflar oluşturun ve her paragraf için pozitif bir MarginLeft değeri ayarlayın.
  6. Asılı girinti etkisini oluşturmak için negatif bir Indent değeri ayarlayın.
  7. Paragrafları metin çerçevesine ekleyin.
  8. Değiştirilen sunumu kaydedin.

Bu kod, bir paragraf için asılı girintinin nasıl ayarlanacağını gösterir:

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $rectangleShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle,50,50,420,220);
    $rectangleShape->getFillFormat()->setFillType(FillType::NoFill);
    $rectangleShape->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $rectangleShape->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->GRAY);

    $textFrame = $rectangleShape->addTextFrame("");
    $textFrame->getTextFrameFormat()->setAutofitType(TextAutofitType::Shape);
    $textFrame->getParagraphs()->removeAt(0);

    $firstParagraph = new Paragraph();
    $firstParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $firstParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $firstParagraph->setText("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->getParagraphFormat()->setMarginLeft(40.0);
    $firstParagraph->getParagraphFormat()->setIndent(-20.0);

    $secondParagraph = new Paragraph();
    $secondParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $secondParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $secondParagraph->setText("This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare.");
    $secondParagraph->getParagraphFormat()->setMarginLeft(60.0);
    $secondParagraph->getParagraphFormat()->setIndent(-30.0);

    $textFrame->getParagraphs()->add($firstParagraph);
    $textFrame->getParagraphs()->add($secondParagraph);

    $presentation->save("hanging_indent.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Paragrafların asılı girintisi

Paragraf Sonu Çalıştırma Özelliklerini Yönetme

  1. Presentation sınıfının bir örneğini oluşturun.
  2. Paragrafı içeren slaydın referansını konumuna göre alın.
  3. Slayta dikdörtgen bir AutoShape ekleyin.
  4. Dikdörtgene iki paragraf içeren bir TextFrame ekleyin.
  5. Paragraflar için yazı tipi boyutunu ve yazı tipi tipini ayarlayın.
  6. Paragraflar için End özelliklerini ayarlayın.
  7. Değiştirilen sunumu PPTX dosyası olarak yazın.

Bu PHP kodu, PowerPoint’te paragraflar için End özelliklerini nasıl ayarlayacağınızı gösterir:

$pres = new Presentation();
try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 10, 200, 250);
    $para1 = new Paragraph();
    $para1->getPortions()->add(new Portion("Sample text"));
    $para2 = new Paragraph();
    $para2->getPortions()->add(new Portion("Sample text 2"));
    $portionFormat = new PortionFormat();
    $portionFormat::setFontHeight(48);
    $portionFormat::setLatinFont(new FontData("Times New Roman"));
    $para2->setEndParagraphPortionFormat($portionFormat);
    $shape->getTextFrame()->getParagraphs()->add($para1);
    $shape->getTextFrame()->getParagraphs()->add($para2);
    $pres->save($resourcesOutputPath . "pres.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($pres)) {
        $pres->dispose();
    }
}

HTML Metnini Paragraflara Aktarma

Aspose.Slides, HTML metnini paragraflara aktarmak için geliştirilmiş destek sağlar.

  1. Presentation sınıfının bir örneğini oluşturun.
  2. İlgili slaytın referansına indeksini kullanarak erişin.
  3. Slayta bir AutoShape ekleyin.
  4. AutoShape‘in TextFrame ekleyin ve ona erişin.
  5. TextFrame içindeki varsayılan paragrafı kaldırın.
  6. Kaynak HTML dosyasını bir TextReader ile okuyun.
  7. Paragraph sınıfı aracılığıyla ilk paragraf örneğini oluşturun.
  8. Okunan TextReader içindeki HTML dosyası içeriğini TextFrame’in ParagraphCollection’ına ekleyin.
  9. Değiştirilen sunumu kaydedin.

Bu PHP kodu, HTML metinlerini paragraflara aktarma adımlarının bir uygulamasıdır:

# Boş bir sunum örneği oluştur
$pres = new Presentation();
try {
    # Sunumun varsayılan ilk slaytına eriş
    $slide = $pres->getSlides()->get_Item(0);
    # HTML içeriğini barındırmak için AutoShape ekle
    $ashape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 10, $pres->getSlideSize()->getSize()->getWidth() - 20, $pres->getSlideSize()->getSize()->getHeight() - 10);
    $ashape->getFillFormat()->setFillType(FillType::NoFill);
    # Şekle metin çerçevesi ekle
    $ashape->addTextFrame("");
    # Eklenen metin çerçevesindeki tüm paragrafları temizle
    $ashape->getTextFrame()->getParagraphs()->clear();
    # StreamReader kullanarak HTML dosyasını yükle
    $tr = new StreamReader("file.html");
    # HTML stream reader'dan metni metin çerçevesine ekle
    $ashape->getTextFrame()->getParagraphs()->addFromHtml($tr->readToEnd());
    # Sunumu kaydet
    $pres->save("output_out.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($pres)) {
        $pres->dispose();
    }
}

Paragraf Metnini HTML’e Dışa Aktarma

Aspose.Slides, metinleri (paragraflarda bulunan) HTML’e dışa aktarmak için geliştirilmiş destek sağlar.

  1. Presentation sınıfının bir örneğini oluşturun ve istediğiniz sunumu yükleyin.
  2. İlgili slaydın referansına indeksini kullanarak erişin.
  3. HTML’e dışa aktarılacak metni içeren şekle erişin.
  4. Şeklin TextFrame’ine erişin.
  5. StreamWriter‘ın bir örneğini oluşturun ve yeni HTML dosyasını ekleyin.
  6. StreamWriter’a bir başlangıç indeksi sağlayın ve istediğiniz paragrafları dışa aktarın.

Bu PHP kodu, PowerPoint paragraf metinlerini HTML’e nasıl dışa aktaracağınızı gösterir:

# Sunum dosyasını yükle
$pres = new Presentation("ExportingHTMLText.pptx");
try {
    # Sunumun varsayılan ilk slaytına eriş
    $slide = $pres->getSlides()->get_Item(0);
    # İstenen indeks
    $index = 0;
    # Eklenen şekle eriş
    $ashape = $slide->getShapes()->get_Item($index);
    # Çıktı HTML dosyası oluştur
    $os = new Java("java.io.FileOutputStream", "output.html");
    $writer = new OutputStreamWriter($os, "UTF-8");
    # İlk paragrafı HTML olarak çıkar
    # Paragrafların verisini HTML'ye yazarak paragraf başlangıç indeksini ve kopyalanacak toplam paragraf sayısını sağlar
    $writer->write($ashape->getTextFrame()->getParagraphs()->exportToHtml(0, $ashape->getTextFrame()->getParagraphs()->getCount(), null));
    $writer->close();
} catch (JavaException $e) {
} finally {
    if (!java_is_null($pres)) {
        $pres->dispose();
    }
}

Bir Paragrafı Görüntü Olarak Kaydetme

Bu bölümde, Paragraph sınıfı ile temsil edilen bir metin paragrafının nasıl bir görüntü olarak kaydedileceğini gösteren iki örnek inceleyeceğiz. Her iki örnek de paragrafı içeren şeklin görüntüsünü Shape sınıfının getImage metodlarıyla almayı, paragrafın şekil içindeki sınırlarını hesaplamayı ve bitmap görüntüsü olarak dışa aktarmayı içerir. Bu yaklaşımlar, PowerPoint sunumlarından metnin belirli bölümlerini ayırıp ayrı görüntüler olarak kaydetmenizi sağlar; bu da çeşitli senaryolarda kullanım için faydalı olabilir.

Üç paragraf içeren metin kutusu

Örnek 1

Bu örnekte, ikinci paragrafı bir görüntü olarak elde ediyoruz. Bunu yapmak için, sunumun ilk slaydındaki şeklin görüntüsünü çıkarıp, şeklin metin çerçevesindeki ikinci paragrafın sınırlarını hesaplıyoruz. Paragraf daha sonra yeni bir bitmap görüntüsüne yeniden çizilir ve PNG formatında kaydedilir. Bu yöntem, belirli bir paragrafı tam boyut ve biçimlendirmesini koruyarak ayrı bir görüntü olarak kaydetmeniz gerektiğinde özellikle faydalıdır.

$imageIO = new Java("javax.imageio.ImageIO");

$presentation = new Presentation("sample.pptx");
try {
    $firstShape = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0);

    // Şekli bellekte bitmap olarak kaydet.
    $shapeImage = $firstShape->getImage();
    $shapeImageStream = new Java("java.io.ByteArrayOutputStream");
    $shapeImage->save($shapeImageStream, ImageFormat::Png);
    $shapeImage->dispose();

    // Bellekten bir şekil bitmap'i oluştur.
    $shapeImageInputStream = new Java("java.io.ByteArrayInputStream", $shapeImageStream->toByteArray());
    $shapeBitmap = $imageIO->read($shapeImageInputStream);

    // İkinci paragrafın sınırlarını hesapla.
    $secondParagraph = $firstShape->getTextFrame()->getParagraphs()->get_Item(1);
    $paragraphRectangle = $secondParagraph->getRect();

    // Çıktı görüntüsü için koordinatları ve boyutu hesapla (minimum boyut - 1x1 piksel).
    $imageX = floor(java_values($paragraphRectangle->getX()));
    $imageY = floor(java_values($paragraphRectangle->getY()));
    $imageWidth = max(1, ceil(java_values($paragraphRectangle->getWidth())));
    $imageHeight = max(1, ceil(java_values($paragraphRectangle->getHeight())));

    // Sadece paragraf bitmap'ini almak için şekil bitmap'ini kırp.
    $paragraphBitmap = $shapeBitmap->getSubimage($imageX, $imageY, $imageWidth, $imageHeight);

    $imageIO->write($paragraphBitmap, "png", new Java("java.io.File", "paragraph.png"));
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Paragraf görüntüsü

Örnek 2

Bu örnek, önceki yaklaşımı paragraf görüntüsüne ölçek faktörleri ekleyerek genişletir. Şekil sunumdan çıkarılır ve 2 ölçek faktörüyle bir görüntü olarak kaydedilir. Bu, paragrafı dışa aktarırken daha yüksek çözünürlüklü bir çıktı sağlar. Paragraf sınırları ölçeği dikkate alarak hesaplanır. Ölçeklendirme, özellikle yüksek kaliteli basılı materyallerde kullanmak üzere daha detaylı bir görüntü gerektiğinde faydalıdır.

$imageIO = new Java("javax.imageio.ImageIO");

$imageScaleX = 2;
$imageScaleY = $imageScaleX;

$presentation = new Presentation("sample.pptx");
try {
    $firstShape = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0);

    // Şekli ölçekli olarak bellekte bitmap olarak kaydet.
    $shapeImage = $firstShape->getImage(ShapeThumbnailBounds::Shape, $imageScaleX, $imageScaleY);
    $shapeImageStream = new Java("java.io.ByteArrayOutputStream");
    $shapeImage->save($shapeImageStream, ImageFormat::Png);
    $shapeImage->dispose();

    // Bellekten bir şekil bitmap'i oluştur.
    $shapeImageInputStream = new Java("java.io.ByteArrayInputStream", $shapeImageStream->toByteArray());
    $shapeBitmap = $imageIO->read($shapeImageInputStream);

    // İkinci paragrafın sınırlarını hesapla.
    $secondParagraph = $firstShape->getTextFrame()->getParagraphs()->get_Item(1);
    $paragraphRectangle = $secondParagraph->getRect();
    $paragraphRectangle->setRect(
            java_values($paragraphRectangle->getX()) * $imageScaleX,
            java_values($paragraphRectangle->getY()) * $imageScaleY,
            java_values($paragraphRectangle->getWidth()) * $imageScaleX,
            java_values($paragraphRectangle->getHeight()) * $imageScaleY
    );

    // Çıktı görüntüsü için koordinatları ve boyutu hesapla (minimum boyut - 1x1 piksel).
    $imageX = floor(java_values($paragraphRectangle->getX()));
    $imageY = floor(java_values($paragraphRectangle->getY()));
    $imageWidth = max(1, ceil(java_values($paragraphRectangle->getWidth())));
    $imageHeight = max(1, ceil(java_values($paragraphRectangle->getHeight())));

    // Sadece paragraf bitmap'ini almak için şekil bitmap'ini kırp.
    $paragraphBitmap = $shapeBitmap->getSubimage($imageX, $imageY, $imageWidth, $imageHeight);

    $imageIO->write($paragraphBitmap, "png", new Java("java.io.File", "paragraph.png"));
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

SSS

Metin çerçevesinde satır kaydırmayı tamamen devre dışı bırakabilir miyim?

Evet. Satır kaydırmayı kapatmak için metin çerçevesinin kaydırma ayarını (setWrapText) kullanabilirsiniz; böylece satırlar çerçevenin kenarlarında kesilmez.

Belirli bir paragrafın slayt üzerindeki tam sınırlarını nasıl alabilirim?

Paragrafın (ve hatta tek bir bölümün) sınırlayıcı dikdörtgenini alarak slayttaki kesin konumunu ve boyutunu öğrenebilirsiniz.

Paragraf hizalaması (sol/sağ/ortala/iki yana yasla) nerede kontrol edilir?

Alignment bir paragraf düzeyinde ayardır ve ParagraphFormat içinde bulunur; tek tek bölüm biçimlendirmesinden bağımsız olarak tüm paragrafı etkiler.

Paragrafın sadece bir kısmı (örneğin bir kelime) için imla kontrol dili ayarlayabilir miyim?

Evet. Dil, bölüm düzeyinde (PortionFormat::setLanguageId) ayarlandığı için tek bir paragrafta birden fazla dil birlikte bulunabilir.

PHP'de AutoFit ile Sunumlarınızı Geliştirin PHP ile Sunumlardan Paragraf Sınırlarını Al