Python/python-pptx 사용자 가이드 - 8. Placeholder 1

https://python-pptx.readthedocs.io/en/latest/user/placeholders-understanding.html

Understanding placeholders

Intuitively, a placeholder is a pre-formatted container into which content can be placed. By providing pre-set formatting to its content, it places many of the formatting choices in the hands of the template designer while allowing the end-user to concentrate on the actual content. This speeds the presentation development process while encouraging visual consistency in slides created from the same template.

While their typical end-user behaviors are relatively simple, the structures that support their operation are more complex. This page is for those who want to better understand the architecture of the placeholder subsystem and perhaps be less prone to confusion at its sometimes puzzling behavior. If you don’t care why they work and just want to know how to work with them, you may want to skip forward to the following page Working with placeholders.

직관적으로 자리 표시자는 콘텐츠를 배치할 수 있는 미리 형식화된 컨테이너이다. 콘텐츠에 사전 설정된 서식을 제공함으로써 최종 사용자가 실제 콘텐츠에 집중할 수 있도록 하면서 템플릿 디자이너가 다양한 서식 선택 사항을 선택할 수 있도록 한다. 이를 통해 프레젠테이션 개발 프로세스 속도가 빨라지고 동일한 템플릿으로 생성된 슬라이드의 시각적 일관성이 향상된다.

일반적인 최종 사용자 동작은 상대적으로 단순하지만 해당 작업을 지원하는 구조는 더 복잡하다. 이 페이지는 자리 표시자 하위 시스템의 아키텍처를 더 잘 이해하고 때로는 혼란스러운 동작으로 인한 혼란을 덜고 싶은 사람들을 위한 것이다. 왜 작동하는지 관심이 없고 단지 작업 방법만 알고 싶다면 다음 페이지인 자리 표시자 작업으로 건너뛰는 것이 좋다.

A placeholder is a shape

Placeholders are an orthogonal category of shape, which is to say multiple shape types can be placeholders. In particular, the auto shape (p:sp element), picture (p:pic element), and graphic frame (p:graphicFrame) shape types can be a placeholder. The group shape (p:grpSp), connector (p:cxnSp), and content part (p:contentPart) shapes cannot be a placeholder. A graphic frame placeholder can contain a table, a chart, or SmartArt.

자리 표시자는 도형의 직교 범주이다. 즉, 여러 도형 유형이 자리 표시자가 될 수 있다. 특히 자동 도형(p:sp 요소), 그림(p:pic 요소) 및 그래픽 프레임(p:graphicFrame) 도형 유형은 자리 표시자가 될 수 있다. 그룹 도형(p:grpSp), 연결선(p:cxnSp) 및 콘텐츠 부분(p:contentPart) 도형은 자리 표시자가 될 수 없다. 그래픽 프레임 개체 틀에는 표, 차트 또는 SmartArt가 포함될 수 있다.

Placeholder types

There are 18 types of placeholder.

Title, Center Title, Subtitle, Body

These placeholders typically appear on a conventional “word chart” containing text only, often organized as a title and a series of bullet points. All of these placeholders can accept text only.

Content

This multi-purpose placeholder is the most commonly used for the body of a slide. When unpopulated, it displays 6 buttons to allow insertion of a table, a chart, SmartArt, a picture, clip art, or a media clip.

Picture, Clip Art

These both allow insertion of an image. The insert button on a clip art placeholder brings up the clip art gallery rather than an image file chooser, but otherwise these behave the same.

Chart, Table, Smart Art

These three allow the respective type of rich graphical content to be inserted.

Media Clip

Allows a video or sound recording to be inserted.

Date, Footer, Slide Number

These three appear on most slide masters and slide layouts, but do not behave as most users would expect. These also commonly appear on the Notes Master and Handout Master.

Header

Only valid on the Notes Master and Handout Master.

Vertical Body, Vertical Object, Vertical Title

Used with vertically oriented languages such as Japanese.

18가지 유형의 자리 표시자가 있다.

제목, 중앙 제목, 부제, 본문

이러한 자리 표시자는 일반적으로 텍스트만 포함하는 일반적인 "단어 차트"에 나타나며 종종 제목과 일련의 글머리 기호로 구성된다. 이러한 자리 표시자는 모두 텍스트만 허용할 수 있다.

콘텐츠

이 다목적 자리 표시자는 슬라이드 본문에 가장 일반적으로 사용된다. 비어 있으면 표, 차트, SmartArt, 그림, 클립 아트 또는 미디어 클립을 삽입할 수 있는 6개의 버튼이 표시된다.

그림, 클립아트

둘 다 이미지 삽입을 허용한다. 클립 아트 자리 표시자의 삽입 버튼을 누르면 이미지 파일 선택기가 아닌 클립 아트 갤러리가 표시되지만 그렇지 않은 경우에는 동일하게 작동한다.

차트, 테이블, 스마트 아트

이 세 가지를 사용하면 각각의 유형의 풍부한 그래픽 콘텐츠를 삽입할 수 있다.

미디어 클립

비디오 또는 사운드 녹음을 삽입할 수 있다.

날짜, 바닥글, 슬라이드 번호

이 세 가지는 대부분의 슬라이드 마스터와 슬라이드 레이아웃에 나타나지만 대부분의 사용자가 기대하는 대로 작동하지 않다. 이는 일반적으로 Notes 마스터 및 유인물 마스터에도 나타난다.

머리글

Notes 마스터 및 유인물 마스터에서만 유효한다.

세로 본문, 세로 개체, 세로 제목

일본어와 같은 수직 지향 언어에 사용된다.

Unpopulated vs. populated

A placeholder on a slide can be empty or filled. This is most evident with a picture placeholder. When unpopulated, a placeholder displays customizable prompt text. A rich content placeholder will also display one or more content insertion buttons when empty.

A text-only placeholder enters “populated” mode when the first character of text is entered and returns to “unpopulated” mode when the last character of text is removed. A rich-content placeholder enters populated mode when content such as a picture is inserted and returns to unpopulated mode when that content is deleted. In order to delete a populated placeholder, the shape must be deleted twice. The first delete removes the content and restores the placeholder to unpopulated mode. An additional delete will remove the placeholder itself. A deleted placeholder can be restored by reapplying the layout.

슬라이드의 자리 표시자는 비어 있거나 채워질 수 있다. 이는 그림 자리 표시자에서 가장 분명하게 나타난다. 채워지지 않은 경우 자리 표시자는 사용자 정의 가능한 프롬프트 텍스트를 표시한다. 서식 있는 콘텐츠 자리 표시자는 비어 있는 경우 하나 이상의 콘텐츠 삽입 버튼도 표시한다.

텍스트 전용 자리 표시자는 텍스트의 첫 번째 문자가 입력되면 "채워짐" 모드로 들어가고 텍스트의 마지막 문자가 제거되면 "채워지지 않음" 모드로 돌아간다. 서식 있는 콘텐츠 자리 표시자는 그림과 같은 콘텐츠가 삽입되면 채워진 모드로 들어가고 해당 콘텐츠가 삭제되면 채워지지 않는 모드로 돌아간다. 채워진 자리 표시자를 삭제하려면 도형을 두 번 삭제해야 한다. 첫 번째 삭제는 콘텐츠를 제거하고 자리 표시자를 채워지지 않은 모드로 복원한다. 추가로 삭제하면 자리 표시자 자체가 제거된다. 삭제된 자리 표시자는 레이아웃을 다시 적용하여 복원할 수 있다.

Placholders inherit

A placeholder appearing on a slide is only part of the overall placeholder mechanism. Placeholder behavior requires three different categories of placeholder shape; those that exist on a slide master, those on a slide layout, and those that ultimately appear on a slide in a presentation.

These three categories of placeholder participate in a property inheritance hierarchy, either as an inheritor, an inheritee, or both. Placeholder shapes on masters are inheritees only. Conversely placeholder shapes on slides are inheritors only. Placeholders on slide layouts are both, a possible inheritor from a slide master placeholder and an inheritee to placeholders on slides linked to that layout.

A layout inherits from its master differently than a slide inherits from its layout. A layout placeholder inherits from the master placeholder sharing the same type. A slide placeholder inherits from the layout placeholder having the same idx value.

In general, all formatting properties are inherited from the “parent” placeholder. This includes position and size as well as fill, line, and font. Any directly applied formatting overrides the corresponding inherited value. Directly applied formatting can be removed be reapplying the layout.

슬라이드에 나타나는 자리 표시자는 전체 자리 표시자 메커니즘의 일부일 뿐이다. 자리 표시자 동작에는 세 가지 범주의 자리 표시자 도형이 필요하다. 슬라이드 마스터에 있는 항목, 슬라이드 레이아웃에 있는 항목, 최종적으로 프레젠테이션의 슬라이드에 나타나는 항목이다.

이러한 세 가지 범주의 자리 표시자는 상속자, 상속자 또는 둘 다로서 속성 상속 계층 구조에 참여한다. 마스터의 자리 표시자 셰이프는 상속자 전용이다. 반대로 슬라이드의 자리 표시자 도형은 상속자일 뿐이다. 슬라이드 레이아웃의 자리 표시자는 슬라이드 마스터 자리 표시자의 가능한 상속자이자 해당 레이아웃에 연결된 슬라이드의 자리 표시자에 대한 상속자이다.

레이아웃은 슬라이드가 레이아웃에서 상속하는 것과는 다르게 마스터에서 상속된다. 레이아웃 자리 표시자는 동일한 유형을 공유하는 마스터 자리 표시자에서 상속된다. 슬라이드 자리 표시자는 동일한 idx 값을 갖는 레이아웃 자리 표시자에서 상속된다.

일반적으로 모든 서식 속성은 "상위" 자리 표시자에서 상속된다. 여기에는 채우기, 선 및 글꼴뿐만 아니라 위치와 크기도 포함된다. 직접 적용된 서식은 해당 상속된 값을 재정의한다. 직접 적용된 서식은 레이아웃을 다시 적용하여 제거할 수 있다.

Glossary

placeholder shape

A shape on a slide that inherits from a layout placeholder.

layout placeholder

a shorthand name for the placeholder shape on the slide layout from which a particular placeholder on a slide inherits shape properties

master placeholder

the placeholder shape on the slide master which a layout placeholder inherits from, if any.

자리 표시자 도형

레이아웃 자리 표시자에서 상속되는 슬라이드의 도형이다.

레이아웃 자리 표시자

슬라이드의 특정 자리 표시자가 도형 속성을 상속하는 슬라이드 레이아웃의 자리 표시자 도형에 대한 약식 이름이다.

마스터 자리 표시자

레이아웃 자리 표시자가 상속되는 슬라이드 마스터의 자리 표시자 도형(있는 경우)

 

Python/python-pptx 사용자 가이드