Python'da Metin Nasıl Biçimlendirilir

Aspose.Slides FOSS for Python, PortionFormat sınıfı aracılığıyla ayrıntılı metin biçimlendirme sağlar. Portion, metnin en küçük bağımsız birimidir; bir paragrafta tek bir biçimlendirme çalışmasına karşılık gelir. Bu kılavuz, bir sunumdaki metne kalın, italik, yazı tipi boyutu ve renk biçimlendirmesinin nasıl uygulanacağını gösterir.

Adım Adım Kılavuz

Adım 1: Paketi Yükleyin

pip install aspose-slides-foss

Adım 2: Metin Çerçevesi Olan Bir Şekil Ekle

Metni biçimlendirmeden önce, bir şekil TextFrame içermelidir. Bir tane oluşturmak için shape.add_text_frame() kullanın.

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Default text: will be formatted")
    prs.save("output.pptx", SaveFormat.PPTX)

Adım 3: TextFrame’e Erişin

shape.add_text_frame(), TextFrame nesnesini döndürür. Ayrıca shape.text_frame aracılığıyla daha sonra alabilirsiniz.

tf = shape.text_frame          # if the frame already exists
tf = shape.add_text_frame("") # creates a new frame

Bir TextFrame, Paragraph nesnelerinin bir listesini (tf.paragraphs) içerir. Her Paragraph, Portion nesnelerini (paragraph.portions) içerir.

Adım 4: Kalın ve İtalik Biçimlendirme Uygula

portion_format.font_bold ve portion_format.font_italic kullanın. Bu özellikler NullableBool.TRUE, NullableBool.FALSE veya NullableBool.NOT_DEFINED (ana şablondan devralınır) kabul eder.

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Bold and italic text")

    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_bold = NullableBool.TRUE
    fmt.font_italic = NullableBool.TRUE

    prs.save("bold-italic.pptx", SaveFormat.PPTX)

Adım 5: Yazı Tipi Boyutunu ve Rengini Ayarla

Boyut (nokta cinsinden) için portion_format.font_height ayarlayın ve renk için fill_format kullanın.

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Large corporate-blue heading")

    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_height = 32                          # 32pt font
    fmt.font_bold = NullableBool.TRUE
    fmt.fill_format.fill_type = FillType.SOLID
    fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 70, 127)

    prs.save("colored-text.pptx", SaveFormat.PPTX)

Color.from_argb(alpha, red, green, blue) her kanal için 0–255 değerlerini kabul eder.

Adım 6: Tek Bir Paragrafta Birden Çok Bölüm

Tek bir paragraf, farklı biçimlendirmelere sahip birden fazla bölüm içerebilir. Bir paragrafın portions koleksiyonuna yeni bir Portion ekleyin:

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 600, 100)
    tf = shape.add_text_frame("")  # start with empty frame

    paragraph = tf.paragraphs[0]

    # First portion: normal text
    portion1 = paragraph.portions[0]
    portion1.text = "Normal text followed by "
    portion1.portion_format.font_height = 20

    # Second portion: bold red text
    portion2 = slides.Portion()
    portion2.text = "bold red text"
    portion2.portion_format.font_height = 20
    portion2.portion_format.font_bold = NullableBool.TRUE
    portion2.portion_format.fill_format.fill_type = FillType.SOLID
    portion2.portion_format.fill_format.solid_fill_color.color = Color.from_argb(255, 200, 0, 0)
    paragraph.portions.add(portion2)

    prs.save("mixed-format.pptx", SaveFormat.PPTX)

Yaygın Sorunlar ve Çözümler

Metin rengi ayarlandıktan sonra bile siyah görünüyor

Rengi atamadan önce fill_format.fill_type = FillType.SOLID ayarlandığından emin olun. Doldurma türü ayarlanmadan, renk değişikliği etkisiz kalabilir.

NullableBool.TRUE vs True

portion_format.font_bold, Python True yerine NullableBool.TRUE bekler. Python True atamak, bağlamaya bağlı olarak bir TypeError yükseltebilir veya sessizce hiçbir şey yapmayabilir.

Kaydedilen dosyada yazı tipi görünmüyor

latin_font özelliği Latin yazı tipi ailesini ayarlar. Ayarlanmamışsa, sunum teması yazı tipi kullanılır. Özel yazı tipleri gömülmüş olmalı veya görüntüleme makinesinde mevcut olmalıdır.

Sıkça Sorulan Sorular

Yazı tipi ailesini nasıl değiştiririm?

Ayarla portion_format.latin_font:

fmt.latin_font = slides.FontData("Arial")

FontData yazı tipi ailesi adını bir dize olarak kabul eder.

Paragraf hizalamasını nasıl ayarlarım?

Kullan paragraph_format.alignment:

from aspose.slides_foss import TextAlignment

tf.paragraphs[0].paragraph_format.alignment = TextAlignment.CENTER

Desteklenen değerler: LEFT, CENTER, RIGHT, JUSTIFY.

Satır aralığını nasıl ayarlarım?

paragraph_format.space_before (paragraftan önceki noktalar) veya paragraph_format.space_after (paragraftan sonraki noktalar) kullanın:

tf.paragraphs[0].paragraph_format.space_before = 12   # 12pt before
tf.paragraphs[0].paragraph_format.space_after = 6     # 6pt after