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

مقدمه

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

Info

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

Note

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

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

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

یک نمونه از کلاس 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();
}

توجه داشته باشید اگر به سادگی یک شکل خودکار را با استفاده از روش addAutoShape از رابط IShapeCollection اضافه کنید، متد isTextBox برای آن شکل خودکار مقدار false برمی‌گرداند. اما پس از اینکه متن را به شکل خودکار با استفاده از روش 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 برای Android از طریق Java ویژگی 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);

    // تبدیل شکل به 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");

    // پیوند (Hyperlink) را برای متن بخش تنظیم می‌کند
    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();
}

پرسش‌های متداول

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

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

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

تکرار خود را به auto‑shapesهایی که چارچوب متن دارند محدود کنید و اشیای توکار مثل charts، tables، SmartArt را از طریق پیمایش مجموعه‌های آن‌ها به‌صورت جداگانه حذف کنید یا آن نوع اشیا را نادیده بگیرید.

مدیریت نگهدارنده‌های ارائه در اندروید بهبود ارائه‌های شما با AutoFit در اندروید