Android에서 프레젠테이션 표 관리

이 페이지의 내용

Aspose.Slides for Android를 사용하여 PowerPoint 슬라이드에서 표를 만들고 편집합니다. 표 작업 흐름을 간소화하는 간단한 Java 코드 예제를 확인하십시오.

소개

PowerPoint의 표는 정보를 행과 열로 정리하여 값을 읽고 비교하기 쉽게 합니다.

Aspose.Slides는 Table 클래스, ITable 인터페이스, Cell 클래스, ICell 인터페이스 및 기타 유형을 제공하여 프레젠테이션에서 표를 만들고, 업데이트하고, 관리할 수 있습니다.

처음부터 표 만들기

표의 위치, 열 너비 및 행 높이를 지정하여 표를 생성합니다. 슬라이드에 추가한 후 셀 테두리를 형식화하고, 셀을 병합하며, 텍스트를 삽입할 수 있습니다.

1. 새 Presentation 클래스 인스턴스를 생성합니다.
2. 인덱스로 슬라이드에 대한 참조를 가져옵니다.
3. 포인트 단위의 열 너비 배열을 정의합니다.
4. 포인트 단위의 행 높이 배열을 정의합니다.
5. 슬라이드에 ITable 객체를 addTable 메서드를 사용하여 추가합니다.
6. ICell 각각을 반복하여 상하좌우 테두리 서식을 적용합니다.
7. 표 첫 번째 행의 첫 두 셀을 병합합니다.
8. 병합된 셀에 getTextFrame 메서드로 접근합니다.
9. 병합된 셀에 텍스트를 설정합니다.
10. 수정된 프레젠테이션을 저장합니다.

아래 예제는 (100, 50) 포인트 위치에 3열 5행 표를 생성합니다. 테두리는 너비 5 포인트인 빨간색으로 적용하고, 첫 번째 행의 첫 두 셀을 병합한 뒤 결과를 table.pptx 로 저장합니다.

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

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

    double[] columnWidths = { 50, 50, 50 };
    double[] rowHeights = { 50, 30, 30, 30, 30 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    for (IRow row : table.getRows())
    {
        for (ICell cell : row)
        {
            ICellFormat cellFormat = cell.getCellFormat();
            cellFormat.getBorderTop().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderTop().setWidth(5);

            cellFormat.getBorderBottom().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderBottom().setWidth(5);

            cellFormat.getBorderLeft().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderLeft().setWidth(5);

            cellFormat.getBorderRight().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderRight().setWidth(5);
        }
    }

    table.mergeCells(table.get_Item(0, 0), table.get_Item(1, 0), false);
    table.get_Item(0, 0).getTextFrame().setText("Merged Cells");

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

표의 표준 번호 매기기

표준 표에서는 셀 인덱스가 0부터 시작하며 (열, 행) 순서로 사용됩니다. 첫 번째 셀은 (0, 0)으로 인덱싱됩니다.

예를 들어, 4열 4행 표의 셀은 다음과 같이 번호가 매겨집니다:

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

이 예제는 위에 표시된 4 × 4 표를 생성하며, 열 너비와 행 높이는 70 포인트이고 셀 테두리는 너비 5 포인트의 빨간색입니다. 좌표는 셀 인덱스를 나타냅니다; 예제는 셀을 비워두고 표를 StandardTables_out.pptx 로 저장합니다.

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

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

    double[] columnWidths = { 70, 70, 70, 70 };
    double[] rowHeights = { 70, 70, 70, 70 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    for (IRow row : table.getRows())
    {
        for (ICell cell : row)
        {
            ICellFormat cellFormat = cell.getCellFormat();
            cellFormat.getBorderTop().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderTop().setWidth(5);

            cellFormat.getBorderBottom().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderBottom().setWidth(5);

            cellFormat.getBorderLeft().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderLeft().setWidth(5);

            cellFormat.getBorderRight().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderRight().setWidth(5);
        }
    }

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

기존 표 접근

표는 슬라이드의 도형 컬렉션에 저장됩니다. 도형들을 반복하여 표를 찾은 다음, ITable 인터페이스를 사용해 셀을 읽거나 업데이트할 수 있습니다.

1. Presentation 클래스를 사용하여 프레젠테이션을 로드합니다.
2. 인덱스로 표가 포함된 슬라이드에 대한 참조를 가져옵니다.
3. IShape 객체들을 반복하며 표가 발견될 때까지 진행합니다. 슬라이드에 여러 표가 있는 경우, getAlternativeText 로 필요한 표를 식별합니다.
4. 대상 셀의 텍스트를 업데이트합니다.
5. 수정된 프레젠테이션을 저장합니다.

아래 예제는 UpdateExistingTable.pptx 를 열고 첫 번째 슬라이드의 첫 번째 표를 찾습니다. 열 0, 행 1 셀에 New 를 설정하고 결과를 table1_out.pptx 로 저장합니다. 입력에는 최소 하나의 슬라이드가 포함되어야 하며, 해당 슬라이드의 첫 번째 표는 최소 하나의 열과 두 개의 행을 가져야 합니다.

import com.aspose.slides.*;

Presentation presentation = new Presentation("UpdateExistingTable.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    ITable table = null;

    for (IShape shape : slide.getShapes()) {
        if (shape instanceof ITable) {
            table = (ITable) shape;
            break;
        }
    }

    if (table != null) {
        table.get_Item(0, 1).getTextFrame().setText("New");
        presentation.save("table1_out.pptx", SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

행 높이 제어

텍스트 프레임을 소유한 셀 찾기

일반 텍스트 처리 코드가 표에서 ITextFrame 을 받으면, ITextFrame.getParentCell 메서드를 사용해 소유자 ICell 를 가져옵니다. 표 셀의 텍스트 프레임의 경우, ITextFrame.getParentCell 은 소유자를 반환하고 ITextFrame.getParentShape 은 null 을 반환합니다(표 자체는 도형이지만).

셀 좌표는 읽기 전용 ICell.getFirstColumnIndex 및 ICell.getFirstRowIndex 메서드를 통해 확인할 수 있습니다. ITextFrame.getParentCell 은 또한 읽기 전용 탐색을 제공하며, 소유자를 반환하지만 소유권을 변경하지 않습니다. 사용하기 전에 반환된 셀이 null 인지 항상 확인하십시오.

텍스트 검색 및 교체

표의 텍스트 정렬

각 표 셀의 수직 고정 및 텍스트 방향을 제어할 수 있습니다. 이 섹션의 예제는 첫 번째 셀의 텍스트를 가운데 정렬하고 270도 회전시킵니다.

1. 새 Presentation 클래스 인스턴스를 생성합니다.
2. 인덱스로 슬라이드에 대한 참조를 가져옵니다.
3. 슬라이드에 ITable 객체를 추가합니다.
4. 표에서 ITextFrame 객체에 접근합니다.
5. 첫 번째 IParagraph 에 접근하여 텍스트와 색상을 설정합니다.
6. setTextAnchorType 과 setTextVerticalType 을 사용하여 셀의 수직 고정 및 텍스트 방향을 설정합니다.
7. 수정된 프레젠테이션을 저장합니다.

이 예제는 열 너비 120 포인트, 행 높이 100 포인트인 4 × 4 표를 생성합니다. 셀 (0, 0)의 텍스트를 서식화하고 첫 번째 행의 나머지 셀에 값을 추가한 뒤 결과를 Vertical_Align_Text_out.pptx 로 저장합니다.

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

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

    double[] columnWidths = { 120, 120, 120, 120 };
    double[] rowHeights = { 100, 100, 100, 100 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    table.get_Item(1, 0).getTextFrame().setText("10");
    table.get_Item(2, 0).getTextFrame().setText("20");
    table.get_Item(3, 0).getTextFrame().setText("30");

    ITextFrame textFrame = table.get_Item(0, 0).getTextFrame();
    IParagraph paragraph = textFrame.getParagraphs().get_Item(0);

    IPortion portion = paragraph.getPortions().get_Item(0);
    portion.setText("Text here");
    portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
    portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);

    ICell cell = table.get_Item(0, 0);
    cell.setTextAnchorType(TextAnchorType.Center);
    cell.setTextVerticalType(TextVerticalType.Vertical270);

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

표 수준에서 텍스트 서식 설정

setTextFormat 을 사용하여 표의 모든 셀에 텍스트 서식을 적용합니다. 이 메서드의 오버로드는 부분, 단락 및 텍스트 프레임 서식을 허용하므로 개별 셀을 반복하지 않고도 이러한 속성을 설정할 수 있습니다.

1. Presentation 클래스를 사용하여 프레젠테이션을 로드합니다.
2. 인덱스로 슬라이드에 대한 참조를 가져옵니다.
3. 슬라이드에서 ITable 객체에 접근합니다.
4. 텍스트에 대해 setFontHeight 으로 글꼴 크기를 설정합니다.
5. setAlignment 과 setMarginRight 로 단락 정렬 및 오른쪽 여백을 설정합니다.
6. setTextVerticalType 로 텍스트 방향을 설정합니다.
7. 수정된 프레젠테이션을 저장합니다.

아래 예제는 최소 하나의 슬라이드와 첫 번째 도형으로 표가 포함된 table.pptx 를 엽니다. 글꼴 크기를 25 포인트로 설정하고, 단락을 오른쪽 정렬하며 오른쪽 여백을 20 포인트로 지정하고, 텍스트를 수직으로 설정합니다. 서식이 적용된 프레젠테이션은 result.pptx 로 저장됩니다.

import com.aspose.slides.*;

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

    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(25);
    table.setTextFormat(portionFormat);

    ParagraphFormat paragraphFormat = new ParagraphFormat();
    paragraphFormat.setAlignment(TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    table.setTextFormat(paragraphFormat);

    TextFrameFormat textFrameFormat = new TextFrameFormat();
    textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
    table.setTextFormat(textFrameFormat);

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

표 스타일 속성 가져오기

getStylePreset 으로 표의 사전 설정 스타일을 읽고, setStylePreset 으로 지정합니다. 이 예제는 한 표에 TableStylePreset.DarkStyle1 을 적용하고, 사전 설정 값을 출력한 뒤 두 번째 표에 동일한 사전 설정을 할당합니다. 두 표는 table-style.pptx 로 저장됩니다.

import com.aspose.slides.*;

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

    double[] columnWidths = { 100, 150 };
    double[] rowHeights = { 5, 5, 5 };
    ITable table = slide.getShapes().addTable(10, 10, columnWidths, rowHeights);
    table.setStylePreset(TableStylePreset.DarkStyle1);

    int stylePreset = table.getStylePreset();
    System.out.println("Table style preset: " + stylePreset);

    ITable anotherTable = slide.getShapes().addTable(10, 100, columnWidths, rowHeights);
    anotherTable.setStylePreset(stylePreset);

    presentation.save("table-style.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

표의 가로세로 비율 고정

표의 가로세로 비율은 너비와 높이의 비율을 의미합니다. setAspectRatioLocked 을 사용하여 표의 가로세로 비율을 고정할 수 있습니다.

아래 예제는 최소 하나의 슬라이드와 첫 번째 도형으로 표가 포함된 pres.pptx 를 엽니다. 현재 잠금 상태를 출력하고, 가로세로 비율 잠금을 활성화한 뒤 업데이트된 상태(true)를 출력하고 결과를 pres-out.pptx 로 저장합니다.

import com.aspose.slides.*;

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

    ITable table = (ITable) slide.getShapes().get_Item(0);
    System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    table.getGraphicalObjectLock().setAspectRatioLocked(true);
    System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    presentation.save("pres-out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

전체 표와 셀 텍스트에 대해 오른쪽에서 왼쪽(RTL) 읽기 방향을 활성화할 수 있나요?

예. 표는 setRightToLeft 메서드를 제공하고, 단락에는 ParagraphFormat.setRightToLeft 이 있습니다. 두 메서드를 모두 사용하면 셀 내부의 RTL 순서와 렌더링이 올바르게 적용됩니다.

최종 파일에서 사용자가 표를 이동하거나 크기를 조정하는 것을 방지하려면 어떻게 해야 하나요?

예: shape locks 을 사용하여 이동, 크기 조정, 선택 등을 비활성화합니다. 이러한 잠금은 표에도 적용됩니다.

셀 내부에 이미지를 배경으로 삽입하는 것이 지원됩니까?

예. 셀에 picture fill 을 설정할 수 있으며, 선택한 모드(늘이기 또는 타일링)에 따라 이미지가 셀 영역을 덮습니다.