Android에서 PowerPoint 텍스트 단락 관리

개요

Aspose.Slides for Android via Java는 텍스트를 텍스트 프레임, 단락 및 부분의 계층 구조로 나타냅니다:

  • ITextFrame shape 안의 텍스트 컨테이너를 나타내며 해당 단락 컬렉션에 대한 접근을 제공합니다.
  • IParagraph 텍스트 프레임 내의 단락 하나를 나타내며 해당 부분 및 단락 수준 서식에 대한 접근을 제공합니다.
  • IPortion 단락 내의 텍스트 실행을 나타냅니다. 각 부분은 자체 텍스트와 문자 수준 서식을 가질 수 있습니다.

따라서 단락은 여러 부분을 사용하여 서로 다른 글꼴, 색상, 크기 및 기타 서식을 가진 텍스트를 포함할 수 있습니다.

단락 만들기 및 서식 지정

shape의 텍스트 프레임에 단락을 만들고 부분을 사용하여 개별 텍스트 실행에 서식을 적용합니다. 이 섹션에서는 각 단락 내에서 여러 부분을 결합하고 서로 다른 색상, 글꼴 크기 및 스타일을 적용하는 방법을 보여줍니다.

다중 부분이 있는 단락 만들기

다음 Android via Java 예제는 세 개의 단락을 생성하며, 각 단락은 IParagraph.getPortions에서 반환되는 컬렉션에 포함된 세 개의 텍스트 실행을 포함합니다. 기본 단락과 빈 부분을 재사용한 다음 나머지 단락 및 부분을 추가합니다. 서식은 IPortion.getPortionFormat를 통해 적용됩니다: 각 단락의 첫 번째 부분은 빨간색, 굵게, 15포인트이며, 두 번째는 파란색, 기울임꼴, 18포인트입니다. 세 번째 부분은 기본 서식을 유지합니다:

import com.aspose.slides.*;
import android.graphics.Color;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 300, 150);
    ITextFrame textFrame = shape.getTextFrame();

    IParagraph firstParagraph = textFrame.getParagraphs().get_Item(0);
    firstParagraph.getPortions().add(new Portion());
    firstParagraph.getPortions().add(new Portion());

    IParagraph secondParagraph = new Paragraph();
    secondParagraph.getPortions().add(new Portion());
    secondParagraph.getPortions().add(new Portion());
    secondParagraph.getPortions().add(new Portion());
    textFrame.getParagraphs().add(secondParagraph);

    IParagraph thirdParagraph = new Paragraph();
    thirdParagraph.getPortions().add(new Portion());
    thirdParagraph.getPortions().add(new Portion());
    thirdParagraph.getPortions().add(new Portion());
    textFrame.getParagraphs().add(thirdParagraph);

    int paragraphCount = textFrame.getParagraphs().getCount();
    for (int paragraphIndex = 0; paragraphIndex < paragraphCount; paragraphIndex++) {
        IParagraph paragraph = textFrame.getParagraphs().get_Item(paragraphIndex);
        int portionCount = paragraph.getPortions().getCount();
        for (int portionIndex = 0; portionIndex < portionCount; portionIndex++) {
            IPortion portion = paragraph.getPortions().get_Item(portionIndex);
            portion.setText("Portion " + (paragraphIndex + 1) + "." + (portionIndex + 1));

            if (portionIndex == 0) {
                portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
                portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.RED);
                portion.getPortionFormat().setFontBold(NullableBool.True);
                portion.getPortionFormat().setFontHeight(15);
            } else if (portionIndex == 1) {
                portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
                portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
                portion.getPortionFormat().setFontItalic(NullableBool.True);
                portion.getPortionFormat().setFontHeight(18);
            }
        }
    }

    presentation.save("paragraphs_with_portions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

글머리표 및 번호 매기기 목록 만들기

단락 텍스트를 기호, 번호 또는 사용자 지정 이미지가 있는 목록으로 구성합니다. 이 섹션의 예제는 글머리표 서식, 다단계 목록 및 사용자 지정 시작 번호를 다룹니다.

글머리표 또는 번호 매기기 목록 만들기

글머리표와 번호 매기기는 관련 항목을 더 쉽게 스캔할 수 있게 합니다. Aspose.Slides에서는 목록 설정이 IBulletFormat를 통해 정의됩니다.

이 Android via Java 예제는 동일한 텍스트 프레임에 기호 글머리표와 번호 매기기 항목을 추가합니다. IBulletFormat.setType는 글머리표 유형을 선택하고, IBulletFormat.setChar는 기호를 제공하며, IBulletFormat.setNumberedBulletStyle는 번호 매기기 스타일을 선택합니다. 두 항목 모두 높이가 100%이고 단락 들여쓰기가 25포인트인 검은색 글머리표를 사용합니다:

import com.aspose.slides.*;
import android.graphics.Color;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    Paragraph symbolParagraph = new Paragraph();
    symbolParagraph.setText("Welcome to Aspose.Slides");
    symbolParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    symbolParagraph.getParagraphFormat().getBullet().setChar((char) 0x2022);
    symbolParagraph.getParagraphFormat().setIndent(25);
    symbolParagraph.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    symbolParagraph.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    symbolParagraph.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True);
    symbolParagraph.getParagraphFormat().getBullet().setHeight(100);
    textFrame.getParagraphs().add(symbolParagraph);

    Paragraph numberedParagraph = new Paragraph();
    numberedParagraph.setText("This is a numbered item");
    numberedParagraph.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    numberedParagraph.getParagraphFormat().getBullet().setNumberedBulletStyle(NumberedBulletStyle.BulletCircleNumWDBlackPlain);
    numberedParagraph.getParagraphFormat().setIndent(25);
    numberedParagraph.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    numberedParagraph.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    numberedParagraph.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True);
    numberedParagraph.getParagraphFormat().getBullet().setHeight(100);
    textFrame.getParagraphs().add(numberedParagraph);

    presentation.save("bulleted_and_numbered_list.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

그림 글머리표 사용

그림 글머리표를 사용하면 기호나 번호 대신 사용자 지정 이미지를 사용할 수 있습니다.

이 Android via Java 예제는 프레젠테이션의 이미지 컬렉션에 이미지를 추가하여 IPPImage로 만들고 이를 단락 글머리표로 사용합니다. IBulletFormat.setType을 호출하여 그림 글머리표를 사용하고, 이미지를 IBulletFormat.getPicture로 지정합니다. IBulletFormat.setHeight를 100%로 설정하여 글머리표를 단락 텍스트에 비례하도록 크기 조정합니다:

import com.aspose.slides.*;

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

    IImage bulletImage = Images.fromFile("bullets.png");
    IPPImage presentationImage;
    try {
        presentationImage = presentation.getImages().addImage(bulletImage);
    } finally {
        bulletImage.dispose();
    }

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    Paragraph paragraph = new Paragraph();
    paragraph.setText("Welcome to Aspose.Slides");
    paragraph.getParagraphFormat().getBullet().setType(BulletType.Picture);
    paragraph.getParagraphFormat().getBullet().getPicture().setImage(presentationImage);
    paragraph.getParagraphFormat().getBullet().setHeight(100);
    textFrame.getParagraphs().add(paragraph);

    presentation.save("picture_bullet.pptx", SaveFormat.Pptx);
    presentation.save("picture_bullet.ppt", SaveFormat.Ppt);
} finally {
    presentation.dispose();
}

다중 단계 목록 만들기

IParagraphFormat.setDepth를 설정하여 목록의 서로 다른 수준에 단락을 배치합니다. 최상위 수준의 깊이는 0입니다.

다음 Android via Java 예제는 IParagraphFormat.setDepth 값을 0부터 3까지 네 개의 단락에 할당하여 한 텍스트 프레임 내에 계층 구조를 만듭니다. 각 단락은 기호 글머리표를 사용하며, IBulletFormat.setChar를 통해 원형 글머리표와 하이픈을 번갈아 사용해 인접 수준을 구분합니다:

import com.aspose.slides.*;
import android.graphics.Color;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    IParagraph firstParagraph = new Paragraph();
    firstParagraph.setText("Content");
    firstParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    firstParagraph.getParagraphFormat().getBullet().setChar((char) 0x2022);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    firstParagraph.getParagraphFormat().setDepth((short) 0);

    IParagraph secondParagraph = new Paragraph();
    secondParagraph.setText("Second level");
    secondParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    secondParagraph.getParagraphFormat().getBullet().setChar('-');
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    secondParagraph.getParagraphFormat().setDepth((short) 1);

    IParagraph thirdParagraph = new Paragraph();
    thirdParagraph.setText("Third level");
    thirdParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    thirdParagraph.getParagraphFormat().getBullet().setChar((char) 0x2022);
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    thirdParagraph.getParagraphFormat().setDepth((short) 2);

    IParagraph fourthParagraph = new Paragraph();
    fourthParagraph.setText("Fourth level");
    fourthParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    fourthParagraph.getParagraphFormat().getBullet().setChar('-');
    fourthParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    fourthParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    fourthParagraph.getParagraphFormat().setDepth((short) 3);

    textFrame.getParagraphs().add(firstParagraph);
    textFrame.getParagraphs().add(secondParagraph);
    textFrame.getParagraphs().add(thirdParagraph);
    textFrame.getParagraphs().add(fourthParagraph);

    presentation.save("multilevel_list.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

사용자 지정 값으로 번호 매기기 목록 시작

IBulletFormat.setNumberedBulletStartWith를 사용하여 번호 매기기 단락에 표시되는 초기 번호를 설정합니다.

다음 Android via Java 예제는 세 개의 단락에 번호 매기기를 사용하도록 IBulletFormat.setType을 설정하고, IBulletFormat.setNumberedBulletStartWith 값을 각각 2, 3, 7로 지정합니다. 시작 값이 각 단락별로 별도로 구성되어 표시되는 번호가 건너뛰게 됩니다:

import com.aspose.slides.*;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    Paragraph firstParagraph = new Paragraph();
    firstParagraph.setText("Start at 2");
    firstParagraph.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    firstParagraph.getParagraphFormat().getBullet().setNumberedBulletStartWith((short) 2);
    textFrame.getParagraphs().add(firstParagraph);

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.setText("Start at 3");
    secondParagraph.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    secondParagraph.getParagraphFormat().getBullet().setNumberedBulletStartWith((short) 3);
    textFrame.getParagraphs().add(secondParagraph);

    Paragraph thirdParagraph = new Paragraph();
    thirdParagraph.setText("Start at 7");
    thirdParagraph.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    thirdParagraph.getParagraphFormat().getBullet().setNumberedBulletStartWith((short) 7);
    textFrame.getParagraphs().add(thirdParagraph);

    presentation.save("custom_numbered_list.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

단락 레이아웃 및 끝 속성 제어

첫 줄과 줄 바꿈 라인의 위치를 제어하기 위해 단락 여백과 들여쓰기를 조정합니다. 보이는 텍스트 부분과 별도로 단락 끝 마크의 서식을 지정할 수도 있습니다.

첫 줄 들여쓰기 설정

IParagraphFormat.setIndent 메서드를 사용하여 단락의 첫 줄 들여쓰기를 제어합니다. 이 설정은 단락 왼쪽 여백에 대해 첫 줄만 이동시킵니다. 양수 값은 첫 줄을 오른쪽으로 이동시키고, 나머지 줄은 단락 본문에 맞춰 정렬됩니다.

전체 단락을 이동해야 할 때는 IParagraphFormat.setMarginLeft를 사용하고, 첫 줄만 이동해야 할 때는 IParagraphFormat.setIndent를 사용합니다.

다음 예제는 세 단락에 동일한 IParagraphFormat.setMarginLeft 20포인트와 IParagraphFormat.setIndent 값을 각각 0, 20, 40포인트 적용합니다. 첫 줄은 점점 더 큰 오프셋에서 시작하고, 줄 바꿈 라인은 동일한 왼쪽 여백을 유지합니다:

import com.aspose.slides.*;
import android.graphics.Color;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 420, 220);
    shape.getFillFormat().setFillType(FillType.NoFill);
    shape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);

    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.Shape);
    textFrame.getParagraphs().clear();

    Paragraph firstParagraph = new Paragraph();
    firstParagraph.setText("No first-line indent. Wrapped lines start at the same position as the first line.");
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    firstParagraph.getParagraphFormat().setMarginLeft(20f);
    firstParagraph.getParagraphFormat().setIndent(0f);

    Paragraph secondParagraph = new Paragraph();
    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().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    secondParagraph.getParagraphFormat().setMarginLeft(20f);
    secondParagraph.getParagraphFormat().setIndent(20f);

    Paragraph thirdParagraph = new Paragraph();
    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().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    thirdParagraph.getParagraphFormat().setMarginLeft(20f);
    thirdParagraph.getParagraphFormat().setIndent(40f);

    textFrame.getParagraphs().add(firstParagraph);
    textFrame.getParagraphs().add(secondParagraph);
    textFrame.getParagraphs().add(thirdParagraph);

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

결과:

단락의 첫 줄 들여쓰기

걸이 들여쓰기 설정

걸이 들여쓰기는 첫 줄이 나머지 줄보다 왼쪽에서 시작되는 단락 레이아웃입니다. Aspose.Slides에서는 IParagraphFormat.setIndent 속성을 사용하여 이 효과를 만듭니다. Indent를 음수 값으로 설정하면 첫 줄이 단락 본문에 대해 왼쪽으로 이동합니다.

실제로는 IParagraphFormat.setMarginLeft가 단락 본문의 왼쪽 위치를 정의하고, IParagraphFormat.setIndent가 해당 여백에 대해 첫 줄의 위치를 정의합니다. 걸이 들여쓰기를 만들려면 양수 MarginLeft 값과 음수 Indent 값을 지정합니다.

이 서식은 참고문헌, 인용, 용어 설명 등 줄 바꿈 라인이 첫 줄 첫 문자 아래가 아니라 단락 본문 아래에 정렬되어야 할 경우에 유용합니다.

다음 Android via Java 예제는 IParagraphFormat.setMarginLeft 값을 40과 60포인트로, IParagraphFormat.setIndent 값을 각각 -20과 -30포인트로 지정합니다. 각 단락에서 첫 줄은 줄 바꿈 라인보다 왼쪽에서 시작하며, 두 번째 단락은 더 깊은 걸이 들여쓰기를 가집니다:

import com.aspose.slides.*;
import android.graphics.Color;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 420, 220);
    shape.getFillFormat().setFillType(FillType.NoFill);
    shape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);

    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.Shape);
    textFrame.getParagraphs().clear();

    Paragraph firstParagraph = new Paragraph();
    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().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    firstParagraph.getParagraphFormat().setMarginLeft(40f);
    firstParagraph.getParagraphFormat().setIndent(-20f);

    Paragraph secondParagraph = new Paragraph();
    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().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    secondParagraph.getParagraphFormat().setMarginLeft(60f);
    secondParagraph.getParagraphFormat().setIndent(-30f);

    textFrame.getParagraphs().add(firstParagraph);
    textFrame.getParagraphs().add(secondParagraph);

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

결과:

단락의 걸이 들여쓰기

단락 끝 실행 속성 설정

IParagraph.setEndParagraphPortionFormat 메서드는 단락 끝 마크의 서식을 제어합니다. 다음 예제는 PortionFormat을 생성하고 IBasePortionFormat.setFontHeight을 48포인트, IBasePortionFormat.setLatinFont을 Times New Roman으로 설정합니다. 이 서식을 두 번째 단락의 끝 마크에 적용하여 보이는 텍스트 부분은 변경하지 않습니다:

import com.aspose.slides.*;

Presentation presentation = new Presentation("Test.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 200, 250);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    Paragraph firstParagraph = new Paragraph();
    firstParagraph.getPortions().add(new Portion("Sample text"));

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.getPortions().add(new Portion("Sample text 2"));

    PortionFormat endParagraphFormat = new PortionFormat();
    endParagraphFormat.setFontHeight(48);
    endParagraphFormat.setLatinFont(new FontData("Times New Roman"));
    secondParagraph.setEndParagraphPortionFormat(endParagraphFormat);

    textFrame.getParagraphs().add(firstParagraph);
    textFrame.getParagraphs().add(secondParagraph);

    presentation.save("end_paragraph_format.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

렌더링된 라인 수 세기

자동 줄 나누기 및 줄 끝 구두점에 영향을 주는 단락 규칙에 대해서는 라인 나누기 제어 및 걸이 구두점 제어를 참조하십시오.

IParagraph.getLinesCount을 사용하여 텍스트 레이아웃 후 단락이 차지하는 라인 수(자동 줄 바꿈 포함)를 셉니다. 프레젠테이션 템플릿에서 텍스트 길이와 레이아웃을 확인할 때 유용합니다.

단락은 ITextFrame.getParagraphs의 항목 하나이며 여러 렌더링 라인을 차지할 수 있습니다. 단락 내에 명시적인 줄 바꿈이 있으면 새로운 라인을 강제로 만들지만 새로운 단락을 생성하지는 않습니다. 자동 줄 바꿈은 텍스트에 명시적인 줄 바꿈 문자를 삽입하지 않고 가용 너비에 따라 라인을 생성합니다. 따라서 단락 수나 줄 바꿈 문자를 세는 것으로는 실제 렌더링 라인 수를 알 수 없습니다.

다음 예제는 텍스트 도형을 만들고, 라인 수를 셈니다; 도형을 좁게 만들고, 텍스트를 짧은 문자열로 교체합니다. 예제는 ITextFrameFormat.setWrapText로 래핑을 활성화하고, ITextFrameFormat.setAutofitType으로 자동 맞춤을 비활성화하여 도형 너비가 텍스트를 자동으로 축소하거나 도형 크기를 조정하지 않고 래핑을 제어하도록 합니다. 각 측정은 IParagraph.getLinesCount을 사용합니다. 도형 크기는 포인트 단위입니다. 마지막으로 예제는 또 다른 단락을 추가하고 텍스트 프레임 전체의 라인 수를 합산합니다:

import com.aspose.slides.*;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getTextFrameFormat().setWrapText(NullableBool.True);
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.None);

    IParagraph paragraph = textFrame.getParagraphs().get_Item(0);
    paragraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(20);
    paragraph.setText("This text demonstrates how automatic wrapping changes the number of rendered lines.");
    System.out.println("Original width: " + paragraph.getLinesCount());

    shape.setWidth(150);
    System.out.println("Narrower shape: " + paragraph.getLinesCount());

    paragraph.setText("Short text.");
    System.out.println("Shorter text: " + paragraph.getLinesCount());

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.setText("Another paragraph.");
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(20);
    textFrame.getParagraphs().add(secondParagraph);

    int totalLineCount = 0;
    for (IParagraph currentParagraph : textFrame.getParagraphs()) {
        totalLineCount += currentParagraph.getLinesCount();
    }
    System.out.println("Total lines in the text frame: " + totalLineCount);
} finally {
    presentation.dispose();
}

이 텍스트와 크기로 도형을 좁히면 라인 수가 증가하고, 짧은 문자열로 교체하면 감소합니다. 정확한 라인 수는 글꼴 가용성 및 대체, 글꼴 크기, 여백, 들여쓰기, 래핑 및 자동 맞춤 설정에 따라 달라질 수 있습니다. 템플릿을 확인할 때는 대상 환경에 맞는 글꼴 및 레이아웃 설정을 사용하십시오.

라인 수만으로 텍스트가 컨테이너를 초과하는지 여부를 판단할 수 없습니다. 사용 가능한 높이, 라인 높이, 단락 및 라인 간격, 자동 맞춤 동작도 영향을 미치며, 래핑이 비활성화된 경우 단일 라인이라도 가용 너비를 초과할 수 있습니다.

단락 내용 가져오기 및 내보내기

HTML을 사용하여 텍스트를 프레젠테이션에 가져오거나 기존 단락을 외부에서 사용할 수 있도록 내보낼 수 있습니다. 이 섹션에서는 표 셀 내부의 단락을 포함하여 개별 단락을 이미지로 렌더링하는 방법도 보여줍니다.

HTML 텍스트를 단락으로 가져오기

ParagraphCollection.addFromHtml을 사용하여 HTML 마크업을 텍스트 프레임의 단락 및 부분으로 변환합니다.

다음 Android via Java 예제는 파일에서 HTML을 읽고 마크업을 ParagraphCollection.addFromHtml에 전달합니다. 텍스트 프레임의 기본 단락을 지워 프레임에 가져온 내용만 포함되도록 합니다. 사각형 도형은 슬라이드 각 면에 10포인트 여백을 남깁니다:

import com.aspose.slides.*;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    float shapeWidth = (float) presentation.getSlideSize().getSize().getWidth() - 20;
    float shapeHeight = (float) presentation.getSlideSize().getSize().getHeight() - 20;
    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, shapeWidth, shapeHeight);
    shape.getFillFormat().setFillType(FillType.NoFill);
    shape.getTextFrame().getParagraphs().clear();

    try {
        byte[] htmlBytes = Files.readAllBytes(Paths.get("file.html"));
        String html = new String(htmlBytes, StandardCharsets.UTF_8);
        shape.getTextFrame().getParagraphs().addFromHtml(html);
        presentation.save("html_text.pptx", SaveFormat.Pptx);
    } catch (IOException exception) {
        System.out.println("The HTML file could not be read: " + exception.getMessage());
    }
} finally {
    presentation.dispose();
}

단락 텍스트를 HTML로 내보내기

ParagraphCollection.exportToHtml을 사용하여 선택된 범위의 단락을 HTML로 내보냅니다. 웹사이트에서 프레젠테이션 텍스트를 재사용할 때 프레젠테이션의 글꼴, 크기 또는 텍스트 상자 스타일을 그대로 전달하지 않고 로컬 강조만 유지하고 싶을 수 있습니다. TextToHtmlConversionOptions.setTextInheritanceLimit을 설정하여 변환기가 서식 상속을 따르는 깊이를 제어합니다.

the sample presentation을 다운로드하여 애플리케이션 작업 디렉터리에 배치합니다. 첫 번째 슬라이드에는 텍스트 “Inherited text; explicit red 18pt"가 있는 텍스트 도형 하나가 포함됩니다. 입력은 의도적으로 여러 서식 수준을 사용합니다:

  • 프레젠테이션의 기본 텍스트 스타일은 Calibri와 28pt 크기를 제공합니다.
  • 텍스트 프레임의 1단계 텍스트 스타일은 파란색 텍스트와 기울임꼴을 제공합니다.
  • 단락은 굵은 텍스트를 명시적으로 설정합니다.
  • 두 번째 부분인 “explicit red 18pt"는 빨간색 텍스트와 18pt 크기를 명시적으로 설정합니다.

다음 완전한 예제는 동일한 단락을 세 번 내보냅니다. TextToHtmlConversionOptions을 내보내기 메서드에 전달하고 각 결과를 별도의 UTF-8 HTML 파일로 기록합니다:

import com.aspose.slides.*;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;

Presentation presentation = new Presentation("text-inheritance.pptx");
try {
    IShape shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    if (shape instanceof IAutoShape) {
        IAutoShape textShape = (IAutoShape) shape;
        ITextFrame textFrame = textShape.getTextFrame();
        if (textFrame != null) {
            IParagraphCollection paragraphs = textFrame.getParagraphs();
            
            int[] modes = { TextInheritanceLimit.All, TextInheritanceLimit.TextBox, TextInheritanceLimit.ParagraphOnly };
            String[] fileNames = { "All.html", "TextBox.html", "ParagraphOnly.html" };

            for (int i = 0; i < modes.length; i++) {
                TextToHtmlConversionOptions options = new TextToHtmlConversionOptions();
                options.setTextInheritanceLimit(modes[i]);

                String html = paragraphs.exportToHtml(0, paragraphs.getCount(), options);
                byte[] htmlBytes = html.getBytes(StandardCharsets.UTF_8);
                try {
                    Files.write(Paths.get(fileNames[i]), htmlBytes);
                } catch (IOException exception) {
                    System.out.println("The HTML file could not be written: " + exception.getMessage());
                }
            }
        } else {
            System.out.println("The first shape does not contain a text frame.");
        }
    } else {
        System.out.println("The first shape is not a text shape.");
    }
} finally {
    presentation.dispose();
}

생성된 HTML은 첫 번째 부분인 “Inherited text; “에 대한 다음 CSS를 포함합니다. 표는 관련 선언을 나열하고, 다른 생성 속성은 명확성을 위해 생략되었습니다.

출력 첫 번째 부분에 대한 관련 CSS 모양
All.html font-family:'Calibri'; font-size:28pt; color:#0000ff; font-style:italic; font-weight:bold Calibri가 사용 가능하면 28pt에서 파란색, 굵게, 기울임꼴 텍스트
TextBox.html color:#0000ff; font-style:italic; font-weight:bold 파란색, 굵게, 기울임꼴 텍스트; 주변 페이지나 브라우저가 글꼴 패밀리와 크기를 제공합니다
ParagraphOnly.html font-weight:bold 굵은 텍스트; 주변 페이지나 브라우저가 글꼴 패밀리, 크기, 색상 및 기울임 스타일을 제공합니다

두 번째 부분은 세 출력 모두에서 color:#ff0000, font-size:18pt, font-weight:bold를 유지합니다. All과 TextBox에서는 이탤릭도 유지되지만 ParagraphOnly에서는 유지되지 않습니다. 따라서 상속 제한을 설정해도 단락이나 부분에 명시적으로 지정된 서식은 제거되지 않습니다.

같은 브라우저에서 파일을 열어 비교하십시오. 제한된 두 모드에서는 생략된 CSS 속성이 대상 페이지의 스타일이나 브라우저 기본값으로 해결되므로 최종 모양은 HTML이 사용되는 위치에 따라 달라집니다.

HTML 클립보드 조각 생성

TextToHtmlConversionOptions.setAddClipboardFragmentHeader을 사용하여 IParagraphCollection.exportToHtml의 출력을 선택합니다. false이면 일반 HTML을 반환하고, true이면 반환 문자열이 Windows 클립보드 헤더로 시작합니다. StartHTML과 EndHTML 필드는 HTML의 UTF-8 바이트 오프셋을 제공하고, StartFragment와 EndFragment는 붙여넣을 내용을 식별합니다.

이 예제는 두 개의 서식이 있는 단락을 일반 HTML(html)과 HTML 클립보드 조각(clipboardHtml)으로 내보냅니다. Windows HTML 클립보드 형식을 수용하는 애플리케이션은 조각을 직접 사용할 수 있습니다. 클립보드 API가 원시 바이트를 기대한다면 BOM 없이 UTF-8로 인코딩하십시오.

import com.aspose.slides.*;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 0, 0, 400, 100);
    IParagraphCollection paragraphs = shape.getTextFrame().getParagraphs();
    paragraphs.clear();
    paragraphs.addFromHtml("<p>Status: <b>Ready</b></p><p><i>Next steps</i></p>");

    TextToHtmlConversionOptions options = new TextToHtmlConversionOptions();
    options.setAddClipboardFragmentHeader(false);
    String html = paragraphs.exportToHtml(0, paragraphs.getCount(), options);

    options.setAddClipboardFragmentHeader(true);
    String clipboardHtml = paragraphs.exportToHtml(0, paragraphs.getCount(), options);
} finally {
    presentation.dispose();
}

단락을 이미지로 렌더링

IParagraph.getImage은 개별 단락을 직접 렌더링하고 IImage를 반환합니다. 결과를 파일이나 스트림에 저장하려면 IImage.save를 사용합니다. 포함된 도형을 렌더링하거나 비트를 수동으로 자를 필요가 없습니다.

IParagraph.getImage은 단락을 상위 컬렉션에서 찾을 수 없거나 유효한 렌더링 경계가 없거나 렌더링할 수 없는 경우 null을 반환할 수 있습니다. 저장하기 전에 결과를 확인하고 사용 후 반환된 이미지를 해제하십시오.

기본 스케일로 단락 렌더링

예제는 하나의 슬라이드가 있는 프레젠테이션을 사용하며, 첫 번째 도형은 세 개의 단락을 포함한 텍스트 상자입니다.

세 개의 단락이 있는 텍스트 상자

다음 예제는 인덱스 1에 있는 두 번째 단락을 선택하고 스케일 매개변수 없이 IParagraph.getImage을 호출합니다. 도형에 필요한 단락이 포함되어 있는지와 렌더링이 이미지를 반환하는지를 확인한 후 IImage.save를 사용해 PNG 형식으로 저장합니다. finally 블록에서 사용 후 이미지를 해제합니다.

import com.aspose.slides.*;

Presentation presentation = new Presentation("sample.pptx");
try {
    IShape shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    if (shape instanceof IAutoShape) {
        IAutoShape textShape = (IAutoShape) shape;
        ITextFrame textFrame = textShape.getTextFrame();
        if (textFrame != null && textFrame.getParagraphs().getCount() > 1) {
            IParagraph paragraph = textFrame.getParagraphs().get_Item(1);
            IImage paragraphImage = paragraph.getImage();

            if (paragraphImage != null) {
                try {
                    paragraphImage.save("paragraph.png", ImageFormat.Png);
                } finally {
                    paragraphImage.dispose();
                }
            } else {
                System.out.println("The paragraph could not be rendered.");
            }
        } else {
            System.out.println("The expected paragraph was not found.");
        }
    } else {
        System.out.println("The first shape is not a text shape.");
    }
} finally {
    presentation.dispose();
}

결과:

단락 이미지

표 셀에서 스케일링으로 단락 렌더링

float scaleX와 float scaleY 매개변수를 받는 IParagraph.getImage 오버로드를 사용하여 가로 및 세로 스케일 팩터를 설정합니다. 다음 예제는 표를 만들고, 첫 번째 셀에서 단락을 기본 너비와 높이의 두 배로 렌더링한 뒤 PNG 이미지로 저장합니다.

import com.aspose.slides.*;

float scaleX = 2f;
float scaleY = 2f;

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

    ITable table = slide.getShapes().addTable(50, 50, new double[] { 300 }, new double[] { 80 });
    IParagraph paragraph = table.get_Item(0, 0).getTextFrame().getParagraphs().get_Item(0);
    paragraph.setText("Text in a table cell");

    IImage paragraphImage = paragraph.getImage(scaleX, scaleY);
    if (paragraphImage != null) {
        try {
            paragraphImage.save("table_paragraph.png", ImageFormat.Png);
        } finally {
            paragraphImage.dispose();
        }
    } else {
        System.out.println("The paragraph could not be rendered.");
    }
} finally {
    presentation.dispose();
}

스케일 팩터 1은 해당 축을 기본 픽셀 크기로 유지합니다. 예를 들어 두 팩터 모두 2이면 이미지의 너비와 높이가 기본 치수의 약 두 배가 되어 픽셀 수가 네 배가 됩니다. 큰 팩터는 일반적으로 확대하거나 고해상도 출력 시 텍스트를 더 선명하게 만들지만 메모리 사용량과 파일 크기도 증가합니다. 1 이하의 팩터는 상세도가 낮은 더 작은 이미지를 생성합니다. 가로와 세로 비율을 동일하게 유지하려면 같은 팩터를 사용하고, 서로 다른 팩터를 사용하면 출력이 독립적으로 늘어나게 됩니다.

출력에 도형의 채우기, 테두리 또는 기타 시각적 맥락이 포함되어야 할 경우 IShape.getImage을 사용해 전체 도형을 렌더링하는 것이 유용합니다. 단락 전용 이미지는 IParagraph.getImage를 사용하십시오.

FAQ

텍스트 프레임 안에서 줄 바꿈을 완전히 비활성화할 수 있나요?

예. ITextFrameFormat.setWrapText를 설정하여 래핑을 비활성화하면 라인이 텍스트 프레임 가장자리에서 끊기지 않습니다.

특정 단락의 슬라이드 상 정확한 경계를 어떻게 얻을 수 있나요?

IParagraph.getRect를 사용하여 단락의 경계 사각형을 가져옵니다. IPortion.getRect는 개별 부분의 경계를 제공합니다.

단락 정렬(왼쪽, 오른쪽, 가운데 또는 양쪽 맞춤)은 어디에서 제어되나요?

IParagraphFormat.setAlignment은 단락 수준 설정이며 개별 부분 서식과 무관하게 전체 단락에 적용됩니다. 각 라인 내에서 서로 다른 글꼴 크기의 부분을 수직 정렬하려면 라인 내 폰트 정렬을 참조하십시오.

단락의 일부에 맞춤 언어를 설정할 수 있나요?

예. 개별 부분에 대해 IBasePortionFormat.setLanguageId를 설정하면 하나의 단락에 여러 언어의 텍스트를 포함시킬 수 있습니다.