مدیریت جعبه‌های متن در ارائه‌ها با استفاده از جاوا

معرفی

متن‌ها در اسلایدها معمولاً در جعبه‌های متن یا شکل‌ها وجود دارند. بنابراین برای افزودن متن به یک اسلاید، باید یک جعبه متن اضافه کنید و سپس متنی را داخل آن قرار دهید. Aspose.Slides for Java رابط IAutoShape را فراهم می‌کند که به شما امکان افزودن شکلی حاوی متن را می‌دهد.

Info

Aspose.Slides همچنین رابط IShape را فراهم می‌کند که به شما امکان افزودن اشکال به اسلایدها را می‌دهد. با این حال، همه اشکالی که از طریق رابط IShape اضافه می‌شوند نمی‌توانند متن نگه دارند. اما اشکالی که از طریق رابط IAutoShape اضافه می‌شوند می‌توانند متن داشته باشند.

Note

بنابراین، هنگام کار با شکلی که می‌خواهید به آن متن اضافه کنید، ممکن است بخواهید بررسی و تأیید کنید که از طریق رابط IAutoShape تبدیل شده است. تنها پس از آن می‌توانید با TextFrame کار کنید که یک ویژگی تحت IAutoShape است. بخش به‌روزرسانی متن را در این صفحه ببینید.

ایجاد جعبه متن بر روی اسلاید

برای ایجاد یک جعبه متن در یک اسلاید، این مراحل را دنبال کنید:

یک نمونه از کلاس Presentation ایجاد کنید.
یک مرجع برای اولین اسلاید در ارائهٔ تازه ایجاد شده به‌دست آورید.
یک شیء IAutoShape با ShapeType تنظیم‌شده به‌عنوان Rectangle در موقعیت مشخصی از اسلاید اضافه کنید و مرجع شیء IAutoShape جدید اضافه‌شده را به‌دست آورید.
یک ویژگی TextFrame به شیء IAutoShape اضافه کنید که متنی را در بر خواهد گرفت. در مثال زیر، این متن را اضافه کردیم: Aspose TextBox
در نهایت، فایل PPTX را از طریق شیء Presentation بنویسید.

این کد جاوا—امپلیمنتیشن مراحل بالا—نحوه افزودن متن به یک اسلاید را نشان می‌دهد:

// یک نمونه از Presentation ایجاد می‌کند
Presentation pres = new Presentation();
try {
    // اولین اسلاید در ارائه را دریافت می‌کند
    ISlide sld = pres.getSlides().get_Item(0);

    // یک AutoShape با نوع تنظیم‌شده به Rectangle اضافه می‌کند
    IAutoShape ashp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 150, 75, 150, 50);

    // یک TextFrame به Rectangle اضافه می‌کند
    ashp.addTextFrame(" ");

    // به فریم متن دسترسی پیدا می‌کند
    ITextFrame txtFrame = ashp.getTextFrame();

    // شیء Paragraph را برای فریم متن ایجاد می‌کند
    IParagraph para = txtFrame.getParagraphs().get_Item(0);

    // شیء Portion را برای پاراگراف ایجاد می‌کند
    IPortion portion = para.getPortions().get_Item(0);

    // متن را تنظیم می‌کند
    portion.setText("Aspose TextBox");

    // ارائه را بر روی دیسک ذخیره می‌کند
    pres.save("TextBox_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

بررسی وجود شکل جعبه متن

Aspose.Slides متد isTextBox را از رابط IAutoShape فراهم می‌کند که به شما امکان بررسی اشکال و شناسایی جعبه‌های متن را می‌دهد.

جعبه متن و شکل

این کد جاوا نشان می‌دهد چگونه بررسی کنید آیا یک شکل به‌عنوان جعبه متن ایجاد شده است یا خیر:

Presentation presentation = new Presentation("sample.pptx");
try {
    ForEach.shape(presentation, (shape, slide, index) -> {
        if (shape instanceof IAutoShape) {
            IAutoShape autoShape = (IAutoShape) shape;
            System.out.println(autoShape.isTextBox() ? "shape is a text box" : "shape is not a text box");
        }
    });
} finally {
    presentation.dispose();
}

توجه داشته باشید که اگر به‌سادگی یک autoshape را با استفاده از متد addAutoShape از رابط IShapeCollection اضافه کنید، متد isTextBox آن autoshape مقدار false را برمی‌گرداند. اما پس از افزودن متن به autoshape با استفاده از متد addTextFrame یا متد setText, ویژگی isTextBox مقدار true را برمی‌گرداند.

Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);

IAutoShape shape1 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 100, 40);
// shape1.isTextBox() مقدار false را بر می‌گرداند
shape1.addTextFrame("shape 1");
// shape1.isTextBox() مقدار true را بر می‌گرداند

IAutoShape shape2 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 110, 100, 40);
// shape2.isTextBox() مقدار false را بر می‌گرداند
shape2.getTextFrame().setText("shape 2");
// shape2.isTextBox() مقدار true را بر می‌گرداند

IAutoShape shape3 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 210, 100, 40);
// shape3.isTextBox() مقدار false را بر می‌گرداند
shape3.addTextFrame("");
// shape3.isTextBox() مقدار false را بر می‌گرداند

IAutoShape shape4 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 310, 100, 40);
// shape4.isTextBox() مقدار false را بر می‌گرداند
shape4.getTextFrame().setText("");
// shape4.isTextBox() مقدار false را بر می‌گرداند

افزودن ستون‌ها به جعبه متن

Aspose.Slides ویژگی‌های ColumnCount و ColumnSpacing (از رابط ITextFrameFormat و کلاس TextFrameFormat) را فراهم می‌کند که به شما امکان افزودن ستون‌ها به جعبه‌های متن را می‌دهد. شما می‌توانید تعداد ستون‌ها در جعبه متن را تعیین کنید و فاصله بین ستون‌ها را بر حسب پوینت تنظیم کنید.

این کد در جاوا عملیات توضیح‌داده‌شده را نشان می‌دهد:

Presentation pres = new Presentation();
try {
    // اولین اسلاید در ارائه را دریافت می‌کند
    ISlide slide = pres.getSlides().get_Item(0);

    // یک AutoShape با نوع تنظیم‌شده به Rectangle اضافه می‌کند
    IAutoShape aShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);

    // یک TextFrame به Rectangle اضافه می‌کند
    aShape.addTextFrame("All these columns are limited to be within a single text container -- " +
            "you can add or delete text and the new or remaining text automatically adjusts " +
            "itself to flow within the container. You cannot have text flow from one container " +
            "to other though -- we told you PowerPoint's column options for text are limited!");

    // قالب متن TextFrame را دریافت می‌کند
    ITextFrameFormat format = aShape.getTextFrame().getTextFrameFormat();

    // تعداد ستون‌ها در TextFrame را مشخص می‌کند
    format.setColumnCount(3);

    // فاصله بین ستون‌ها را مشخص می‌کند
    format.setColumnSpacing(10);

    // ارائه را ذخیره می‌کند
    pres.save("ColumnCount.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

افزودن ستون‌ها به فریم متن

Aspose.Slides برای جاوا ویژگی ColumnCount (از رابط ITextFrameFormat) را فراهم می‌کند که به شما امکان افزودن ستون‌ها در فریم‌های متن را می‌دهد. با استفاده از این ویژگی می‌توانید تعداد ستون‌های دلخواه خود را در یک فریم متن مشخص کنید.

این کد جاوا نشان می‌دهد چگونه یک ستون داخل فریم متن اضافه کنید:

String outPptxFileName = "ColumnsTest.pptx";
Presentation pres = new Presentation();
try {
    IAutoShape shape1 = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);
    TextFrameFormat format = (TextFrameFormat)shape1.getTextFrame().getTextFrameFormat();

    format.setColumnCount(2);
    shape1.getTextFrame().setText("All these columns are forced to stay within a single text container -- " +
            "you can add or delete text - and the new or remaining text automatically adjusts " +
            "itself to stay within the container. You cannot have text spill over from one container " +
            "to other, though -- because PowerPoint's column options for text are limited!");
    pres.save(outPptxFileName, SaveFormat.Pptx);

    Presentation test = new Presentation(outPptxFileName);
    try {
        IAutoShape autoShape = ((AutoShape)test.getSlides().get_Item(0).getShapes().get_Item(0));
        Assert.assertTrue(2 == autoShape.getTextFrame().getTextFrameFormat().getColumnCount());
        Assert.assertTrue(Double.NaN == autoShape.getTextFrame().getTextFrameFormat().getColumnSpacing());
    } finally {
        if (test != null) test.dispose();
    }

    format.setColumnSpacing(20);
    pres.save(outPptxFileName, SaveFormat.Pptx);

    Presentation test1 = new Presentation(outPptxFileName);
    try {
        IAutoShape autoShape = ((AutoShape)test1.getSlides().get_Item(0).getShapes().get_Item(0));
        Assert.assertTrue(2 == autoShape.getTextFrame().getTextFrameFormat().getColumnCount());
        Assert.assertTrue(20 == autoShape.getTextFrame().getTextFrameFormat().getColumnSpacing());
    } finally {
        if (test1 != null) test1.dispose();
    }

    format.setColumnCount(3);
    format.setColumnSpacing(15);
    pres.save(outPptxFileName, SaveFormat.Pptx);

    Presentation test2 = new Presentation(outPptxFileName);
    try {
        IAutoShape autoShape = ((AutoShape)test2.getSlides().get_Item(0).getShapes().get_Item(0));
        Assert.assertTrue(3 == autoShape.getTextFrame().getTextFrameFormat().getColumnCount());
        Assert.assertTrue(15 == autoShape.getTextFrame().getTextFrameFormat().getColumnSpacing());
    } finally {
        if (test2 != null) test2.dispose();
    }
} finally {
    if (pres != null) pres.dispose();
}

به‌روزرسانی متن

Aspose.Slides به شما امکان تغییر یا به‌روزرسانی متنی که در جعبه متن یا تمام متون موجود در یک ارائه وجود دارد را می‌دهد.

این کد جاوا عملیاتی را نشان می‌دهد که در آن تمام متون یک ارائه به‌روزرسانی یا تغییر می‌کنند:

Presentation pres = new Presentation("text.pptx");
try {
    for (ISlide slide : pres.getSlides())
    {
        for (IShape shape : slide.getShapes())
        {
            if (shape instanceof IAutoShape) //بررسی می‌کند که آیا شکل از فریم متن (IAutoShape) پشتیبانی می‌کند.
            {
                IAutoShape autoShape = (IAutoShape)shape; 
                for (IParagraph paragraph : autoShape.getTextFrame().getParagraphs()) //تکرار بر پاراگراف‌ها در فریم متن
                {
                    for (IPortion portion : paragraph.getPortions()) //تکرار بر هر بخش (portion) در پاراگراف
                    {
                        portion.setText(portion.getText().replace("years", "months")); //تغییر متن
                        portion.getPortionFormat().setFontBold(NullableBool.True); //تغییر قالب‌بندی
                    }
                }
            }
        }
    }

    //ذخیره ارائهٔ تغییر یافته
    pres.save("text-changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

افزودن جعبه متن با پیوند

می‌توانید یک پیوند را داخل جعبه متن وارد کنید. وقتی بر روی جعبه متن کلیک شود، کاربران به باز کردن پیوند هدایت می‌شوند.

برای افزودن جعبه متنی که حاوی پیوند باشد، این مراحل را دنبال کنید:

یک نمونه از کلاس Presentation ایجاد کنید.
یک مرجع برای اولین اسلاید در ارائه تازه ایجاد شده به‌دست آورید.
یک شیء AutoShape با ShapeType تنظیم‌شده به‌عنوان Rectangle در موقعیت مشخصی از اسلاید اضافه کنید و مرجع شیء AutoShape جدید اضافه‌شده را به‌دست آورید.
یک TextFrame به شیء AutoShape اضافه کنید که Aspose TextBox را به‌عنوان متن پیش‌فرض خود داشته باشد.
کلاس IHyperlinkManager را نمونه‌سازی کنید.
شیء IHyperlinkManager را به ویژگی HyperlinkClick مرتبط با بخش دلخواه شما از TextFrame اختصاص دهید.
در نهایت، فایل PPTX را از طریق شیء Presentation بنویسید.

این کد جاوا—امپلیمنتیشن مراحل بالا—نقش افزودن جعبه متن با پیوند به یک اسلاید را نشان می‌دهد:

// یک شیء از کلاس Presentation که نمایانگر یک فایل PPTX است را ایجاد می‌کند
Presentation pres = new Presentation();
try {
    // اولین اسلاید در ارائه را دریافت می‌کند
    ISlide slide = pres.getSlides().get_Item(0);

    // یک شیء AutoShape با نوع تنظیم‌شده به Rectangle اضافه می‌کند
    IShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 150, 150, 150, 50);

    // تبدیل شیء shape به AutoShape
    IAutoShape pptxAutoShape = (IAutoShape)shape;

    // دسترسی به ویژگی ITextFrame مرتبط با AutoShape
    pptxAutoShape.addTextFrame("");

    ITextFrame textFrame = pptxAutoShape.getTextFrame();

    // افزودن متنی به فریم
    textFrame.getParagraphs().get_Item(0).getPortions().get_Item(0).setText("Aspose.Slides");

    // تنظیم پیوند فراخوانی برای متن portion
    IHyperlinkManager hyperlinkManager = textFrame.getParagraphs().get_Item(0).getPortions().get_Item(0).
            getPortionFormat().getHyperlinkManager();
    hyperlinkManager.setExternalHyperlinkClick("http://www.aspose.com");

    // ذخیره ارائهٔ PPTX
    pres.save("hLink_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

سؤالات متداول

تفاوت جعبه متن و جای‌گیر متن در کار با اسلایدهای اصلی چیست؟

یک جای‌گیر سبک/موقعیت خود را از قالب اصلی به ارث می‌برد و می‌تواند در طرح‌بندی‌ها بازنویسی شود، در حالی که یک جعبه متن معمولی یک شیء مستقل در اسلاید خاصی است و هنگام تغییر طرح‌بندی‌ها تغییر نمی‌کند.

چگونه می‌توانم جایگزینی گروهی متن را در سراسر ارائه انجام دهم بدون اینکه به متن داخل نمودارها، جداول و SmartArt دست بزنم؟

تکرار خود را به auto‑shapes‌هایی که فریم متن دارند محدود کنید و اشیاء تعبیه‌شده (charts, tables, SmartArt) را از طریق عبور از مجموعه‌هایشان به‌صورت جداگانه یا صرف‌نظر از آن نوع اشیاء حذف کنید.

مدیریت متغیرهای ارائه در جاوا بهبود ارائه‌های شما با AutoFit در Java