Python을 사용하여 프레젠테이션에서 텍스트 상자 관리

소개

슬라이드의 텍스트는 일반적으로 텍스트 상자나 도형에 존재합니다. 따라서 슬라이드에 텍스트를 추가하려면 텍스트 상자를 추가한 다음 텍스트 상자 안에 텍스트를 넣어야 합니다. Aspose.Slides for Python은 텍스트를 포함하는 도형을 추가할 수 있는 AutoShape 클래스를 제공합니다.

Info

Aspose.Slides는 또한 Shape 클래스를 제공합니다. 그러나 모든 도형이 텍스트를 보유할 수 있는 것은 아닙니다.

Note

따라서 텍스트를 추가하려는 도형을 다룰 때는 해당 도형이 AutoShape 클래스로 캐스팅되었는지 확인하고 확인하고 싶을 수 있습니다. 그래야만 AutoShape 아래의 속성인 TextFrame을 사용할 수 있습니다. 이 페이지의 Update Text 섹션을 확인하세요.

슬라이드에 텍스트 상자 만들기

슬라이드에 텍스트 상자를 만들려면:

Presentation 클래스의 인스턴스를 생성합니다.
첫 번째 슬라이드에 대한 참조를 가져옵니다.
원하는 위치에 ShapeType.RECTANGLE 를 사용하여 AutoShape을 추가합니다.
도형의 TextFrame에 텍스트를 설정합니다.
프레젠테이션을 PPTX 파일로 저장합니다.

다음 Python 예제가 이러한 단계를 구현합니다:

import aspose.slides as slides

# 프레젠테이션 클래스를 인스턴스화합니다.
with slides.Presentation() as presentation:

    # 프레젠테이션의 첫 번째 슬라이드를 가져옵니다.
    slide = presentation.slides[0]

    # 유형이 RECTANGLE인 AutoShape를 추가합니다.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 75, 150, 50)

    shape.text_frame.text = "Aspose TextBox"

    # 프레젠테이션을 디스크에 저장합니다.
    presentation.save("TextBox.pptx", slides.export.SaveFormat.PPTX)

도형이 텍스트 상자인지 확인하기

Aspose.Slides는 AutoShape 클래스에 is_text_box 속성을 제공하며, 이를 통해 도형이 텍스트 상자인지 여부를 판단할 수 있습니다.

텍스트 상자와 도형

다음 Python 예제는 도형이 텍스트 상자로 생성되었는지 확인하는 방법을 보여줍니다:

import aspose.slides as slides

with slides.Presentation("Sample.pptx") as presentation:
    for slide in presentation.slides:
        for shape in slide.shapes:
            if isinstance(shape, slides.AutoShape):
                print("shape is a text box" if shape.is_text_box else "shape is not a text box")

참고로 ShapeCollection 클래스를 사용하여 AutoShape을 추가하면 해당 도형의 is_text_box 속성은 False를 반환합니다. 그러나 add_text_frame 메서드로 텍스트를 추가하거나 text 속성을 설정하면 is_text_box는 True를 반환합니다.

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape1 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 100, 40)
    # shape1.is_text_box는 false
    shape1.add_text_frame("shape 1")
    # shape1.is_text_box는 true

    shape2 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 110, 100, 40)
    # shape2.is_text_box는 false
    shape2.text_frame.text = "shape 2"
    # shape2.is_text_box는 true

    shape3 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 210, 100, 40)
    # shape3.is_text_box는 false
    shape3.add_text_frame("")
    # shape3.is_text_box는 false

    shape4 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 310, 100, 40)
    # shape4.is_text_box는 false
    shape4.text_frame.text = ""
    # shape4.is_text_box는 false

텍스트 상자에 열 추가

Aspose.Slides는 텍스트 상자에 열을 추가하기 위해 TextFrameFormat 클래스에 column_count와 column_spacing 속성을 제공합니다. 열의 수를 지정하고 열 사이의 간격을 포인트 단위로 설정할 수 있습니다.

다음 Python 코드가 이 작업을 시연합니다:

import aspose.slides as slides

with slides.Presentation() as presentation:

	# 프레젠테이션의 첫 번째 슬라이드를 가져옵니다.
	slide = presentation.slides[0]

	# 유형이 RECTANGLE인 AutoShape를 추가합니다.
	shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 300, 300)

	# 사각형에 TextFrame을 추가합니다.
	shape.add_text_frame("All of these columns are confined to a single text container—" +
	"you can add or delete text, and any new or remaining text automatically reflows " +
	"within the container. You cannot have text flow from one container to another, " +
	"though—PowerPoint’s column options for text are limited!")

	# TextFrame의 텍스트 형식을 가져옵니다.
	format = shape.text_frame.text_frame_format

	# TextFrame의 열 수를 지정합니다.
	format.column_count = 3

	# 열 사이의 간격을 지정합니다.
	format.column_spacing = 10

	# 프레젠테이션을 저장합니다.
	presentation.save("ColumnCount.pptx", slides.export.SaveFormat.PPTX)

텍스트 업데이트

Aspose.Slides를 사용하면 단일 텍스트 상자 또는 전체 프레젠테이션의 텍스트를 업데이트할 수 있습니다.

다음 Python 예제는 프레젠테이션의 모든 텍스트를 업데이트하는 방법을 보여줍니다:

import aspose.slides as slides

with slides.Presentation("Sample.pptx") as presentation:
    for slide in presentation.slides:
        for shape in slide.shapes:
            if type(shape) is slides.AutoShape:
                for paragraph in shape.text_frame.paragraphs:
                    for portion in paragraph.portions:
                        portion.text = portion.text.replace("years", "months")
                        portion.portion_format.font_bold = 1
  
    # 수정된 프레젠테이션을 저장합니다.
    presentation.save("TextChanged.pptx", slides.export.SaveFormat.PPTX)

하이퍼링크가 있는 텍스트 상자 추가

텍스트 상자에 링크를 삽입할 수 있습니다. 텍스트 상자를 클릭하면 링크가 열립니다.

하이퍼링크가 포함된 텍스트 상자를 추가하려면 다음 단계를 따르세요:

Presentation 클래스의 인스턴스를 생성합니다.
첫 번째 슬라이드에 대한 참조를 가져옵니다.
원하는 위치에 ShapeType.RECTANGLE 를 사용하여 AutoShape을 추가합니다.
도형의 TextFrame에 텍스트를 설정합니다.
HyperlinkManager에 대한 참조를 얻습니다.
hyperlink_manager 속성을 사용하여 외부 클릭 하이퍼링크를 설정합니다.
프레젠테이션을 PPTX 파일로 저장합니다.

다음 Python 예제는 슬라이드에 하이퍼링크가 있는 텍스트 상자를 추가하는 방법을 보여줍니다:

import aspose.slides as slides

# Presentation 클래스를 인스턴스화합니다.
with slides.Presentation() as presentation:

    # 프레젠테이션의 첫 번째 슬라이드를 가져옵니다.
    slide = presentation.slides[0]

    # 유형이 RECTANGLE인 AutoShape를 추가합니다.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 150, 150, 50)

    text_portion = shape.text_frame.paragraphs[0].portions[0]

    # 프레임에 텍스트를 추가합니다.
    text_portion.text = "Aspose.Slides"

    # 해당 텍스트 부분에 하이퍼링크를 설정합니다.
    hyperlink_manager = text_portion.portion_format.hyperlink_manager
    hyperlink_manager.set_external_hyperlink_click("http://www.aspose.com")

    # 프레젠테이션을 PPTX 파일로 저장합니다.
    presentation.save("Hyperlink.pptx", slides.export.SaveFormat.PPTX)

자주 묻는 질문

마스터 슬라이드를 사용할 때 텍스트 상자와 텍스트 자리표시자(placeholder)의 차이점은 무엇인가요?

placeholder는 master에서 스타일/위치를 상속받으며 layouts에서 재정의할 수 있는 반면, 일반 텍스트 상자는 특정 슬라이드에 독립적인 객체로 레이아웃을 전환해도 변경되지 않습니다.

차트, 표, SmartArt 내부의 텍스트는 건드리지 않고 프레젠테이션 전체에서 대량 텍스트 교체를 수행하려면 어떻게 해야 하나요?

텍스트 프레임을 가진 자동 도형만 반복하고, 포함된 객체인 (charts, tables, SmartArt)는 별도로 컬렉션을 탐색하거나 해당 객체 유형을 건너뛰어 제외하십시오.

Python으로 프레젠테이션에서 플레이스홀더 관리 Python에서 AutoFit을 사용하여 프레젠테이션 향상하기