# جعبه متن

> کار با جعبه‌های متن در Aspose.Slides برای Python از طریق Java: افزودن، قالب‌بندی، جستجو و حذف متن در ارائه‌های PowerPoint و OpenDocument.

Source: https://docs.aspose.com/slides/fa/python-java/examples/elements/text-box/
Updated: 2026-09-09

در **Aspose.Slides for Python via Java**, جعبه متن یک شکل خودکار است که متن را در بر می‌گیرد. تقریباً هر شکلی می‌تواند متن داشته باشد، اما یک جعبه متن معمولی پر یا حاشیه ندارد و فقط متن را نمایش می‌دهد.

این راهنما توضیح می‌دهد چگونه جعبه‌های متن را برنامه‌نویسی اضافه، دسترسی و حذف کنیم.

پکیج را همان‌طور که در [Installation](/slides/fa/python-java/installation/) توصیف شده است نصب کنید. هر مثال قبل از راه‌اندازی JVM، `asposeslides` را وارد می‌کند و سپس پس از اجرای JVM، API را وارد می‌نماید.

## **اضافه کردن جعبه متن**

یک مستطیل ایجاد کنید، پر و حاشیه آن را حذف کنید و متن قالب‌بندی‌شده را اختصاص دهید.

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, FillType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    # یک شکل مستطیل ایجاد کنید.
    text_box = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 75, 150, 100)

    # پر و حاشیه را حذف کنید تا فقط متن نمایش داده شود.
    text_box.getFillFormat().setFillType(FillType.NoFill)
    text_box.getLineFormat().getFillFormat().setFillType(FillType.NoFill)

    # قالب‌بندی پیش‌فرض متن را تنظیم کنید.
    paragraph = text_box.getTextFrame().getParagraphs().get_Item(0)
    text_format = paragraph.getParagraphFormat().getDefaultPortionFormat()
    text_format.getFillFormat().setFillType(FillType.Solid)
    text_format.getFillFormat().getSolidFillColor().setColor(Color.BLACK)

    text_box.getTextFrame().setText("Some text...")
finally:
    presentation.dispose()
```

## **دسترسی به جعبه‌های متن بر اساس محتوا**

یک جعبه متن نمونه اضافه کنید، سپس شکل‌هایی را پیدا کنید که متن آن‌ها شامل کلیدواژه "Slide" باشد.

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpde.startJVM()

from asposeslides.api import Presentation, ShapeType, FillType, AutoShape

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    text_box = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 75, 150, 100)
    text_box.getFillFormat().setFillType(FillType.NoFill)
    text_box.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
    text_box.getTextFrame().setText("Slide notes")

    for index in range(slide.getShapes().size()):
        shape = slide.getShapes().get_Item(index)
        if isinstance(shape, AutoShape):
            text_frame = shape.getTextFrame()
            if text_frame is not None and "Slide" in str(text_frame.getText()):
                # از جعبه متن مطابق استفاده کنید.
                print(text_frame.getText())
finally:
    presentation.dispose()
```

## **حذف جعبه‌های متن بر حسب محتوا**

جعبه‌های متنی را که در اسلاید اول هستند و شامل یک کلیدواژه خاص هستند، پیدا کنید و حذف کنید.

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, FillType, AutoShape

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    text_box = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 75, 150, 100)
    text_box.getFillFormat().setFillType(FillType.NoFill)
    text_box.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
    text_box.getTextFrame().setText("Slide notes")

    shapes_to_remove = []
    for index in range(slide.getShapes().size()):
        shape = slide.getShapes().get_Item(index)
        if isinstance(shape, AutoShape):
            text_frame = shape.getTextFrame()
            if text_frame is not None and "Slide" in str(text_frame.getText()):
                shapes_to_remove.append(shape)

    for shape in shapes_to_remove:
        slide.getShapes().remove(shape)
finally:
    presentation.dispose()
```

{{% alert color="success" title="Tip" %}}
قبل از حذف آن‌ها، شکل‌های منطبق را در یک لیست جداگانه جمع‌آوری کنید تا از تغییر مجموعه شکل‌ها در حین تکرار جلوگیری شود.
{{% /alert %}}