.NET에서 프레젠테이션 슬라이드에 접근
개요
이 문서는 Aspose.Slides를 사용하여 프레젠테이션의 슬라이드에 접근하고 관리하는 방법을 설명합니다. Slides 컬렉션에서 0부터 시작하는 인덱스로 슬라이드를 가져오는 방법과 GetSlideById 메서드를 사용하여 고유 ID로 슬라이드에 접근하는 방법을 보여줍니다.
또한 SlideNumber 속성을 설정하여 슬라이드 위치를 변경하는 방법과 FirstSlideNumber 속성으로 프레젠테이션의 시작 슬라이드 번호를 정의하는 방법을 배웁니다. 예제에서는 프레젠테이션을 로드하고, 슬라이드 참조를 가져오며, 슬라이드 순서 또는 번호를 업데이트하고, 수정된 프레젠테이션을 저장하는 과정을 보여줍니다.
인덱스로 슬라이드에 접근
프레젠테이션의 모든 슬라이드는 슬라이드 위치를 기준으로 0부터 시작하는 숫자로 배열됩니다. 첫 번째 슬라이드는 인덱스 0으로 접근할 수 있고, 두 번째 슬라이드는 인덱스 1로 접근합니다; 기타 슬라이드도 마찬가지입니다.
프레젠테이션 파일을 나타내는 Presentation 클래스는 모든 슬라이드를 ISlideCollection 컬렉션(ISlide 객체의 컬렉션)으로 노출합니다. 다음 C# 코드에서는 인덱스로 슬라이드에 접근하는 방법을 보여줍니다:
// 프레젠테이션 파일을 나타내는 Presentation 객체를 인스턴스화합니다
Presentation presentation = new Presentation("AccessSlides.pptx");
// 인덱스를 사용하여 슬라이드 참조를 가져옵니다
ISlide slide = presentation.Slides[0];
ID로 슬라이드에 접근
프레젠테이션의 각 슬라이드에는 고유한 ID가 할당됩니다. 해당 ID를 대상으로 하려면 Presentation 클래스에서 제공하는 GetSlideById 메서드를 사용할 수 있습니다. 다음 C# 코드는 유효한 슬라이드 ID를 제공하고 GetSlideById 메서드를 통해 해당 슬라이드에 접근하는 방법을 보여줍니다:
// 프레젠테이션 파일을 나타내는 Presentation 객체를 인스턴스화합니다
Presentation presentation = new Presentation("AccessSlides.pptx");
// 슬라이드 ID를 가져옵니다
uint id = presentation.Slides[0].SlideId;
// ID를 통해 슬라이드에 접근합니다
IBaseSlide slide = presentation.GetSlideById(id);
슬라이드 위치 변경
Aspose.Slides를 사용하면 슬라이드 위치를 변경할 수 있습니다. 예를 들어 첫 번째 슬라이드를 두 번째 슬라이드로 지정할 수 있습니다.
- Presentation 클래스의 인스턴스를 생성합니다.
- 인덱스를 사용하여 위치를 변경하려는 슬라이드의 참조를 가져옵니다.
- SlideNumber 속성을 사용하여 슬라이드의 새 위치를 설정합니다.
- 수정된 프레젠테이션을 저장합니다.
다음 C# 코드는 위치 1에 있는 슬라이드를 위치 2로 이동하는 작업을 보여줍니다:
// 프레젠테이션 파일을 나타내는 Presentation 객체를 인스턴스화합니다
using (Presentation pres = new Presentation("ChangePosition.pptx"))
{
// 위치가 변경될 슬라이드를 가져옵니다
ISlide sld = pres.Slides[0];
// 슬라이드의 새 위치를 설정합니다
sld.SlideNumber = 2;
// 수정된 프레젠테이션을 저장합니다
pres.Save("Aspose_out.pptx", SaveFormat.Pptx);
}
첫 번째 슬라이드가 두 번째가 되고, 두 번째 슬라이드가 첫 번째가 됩니다. 슬라이드 위치를 변경하면 다른 슬라이드가 자동으로 조정됩니다.
슬라이드 번호 설정
Presentation 클래스에서 제공하는 FirstSlideNumber 속성을 사용하면 프레젠테이션의 첫 번째 슬라이드에 새 번호를 지정할 수 있습니다. 이 작업으로 다른 슬라이드 번호가 다시 계산됩니다.
- Presentation 클래스의 인스턴스를 생성합니다.
- 슬라이드 번호를 가져옵니다.
- 슬라이드 번호를 설정합니다.
- 수정된 프레젠테이션을 저장합니다.
다음 C# 코드는 첫 번째 슬라이드 번호를 10으로 설정하는 작업을 보여줍니다:
// 프레젠테이션 파일을 나타내는 Presentation 객체를 인스턴스화합니다
using (Presentation presentation = new Presentation("HelloWorld.pptx"))
{
// 슬라이드 번호를 가져옵니다
int firstSlideNumber = presentation.FirstSlideNumber;
// 슬라이드 번호를 설정합니다
presentation.FirstSlideNumber=10;
// 수정된 프레젠테이션을 저장합니다
presentation.Save("Set_Slide_Number_out.pptx", SaveFormat.Pptx);
}
첫 번째 슬라이드를 건너뛰고 싶다면, 두 번째 슬라이드부터 번호를 시작하고(첫 번째 슬라이드의 번호는 숨기는) 다음과 같이 할 수 있습니다:
using (var presentation = new Presentation())
{
var layoutSlide = presentation.LayoutSlides.GetByType(SlideLayoutType.Blank);
presentation.Slides.AddEmptySlide(layoutSlide);
presentation.Slides.AddEmptySlide(layoutSlide);
presentation.Slides.AddEmptySlide(layoutSlide);
// 첫 번째 프레젠테이션 슬라이드의 번호를 설정합니다
presentation.FirstSlideNumber = 0;
// 모든 슬라이드에 슬라이드 번호를 표시합니다
presentation.HeaderFooterManager.SetAllSlideNumbersVisibility(true);
// 첫 번째 슬라이드의 슬라이드 번호를 숨깁니다
presentation.Slides[0].HeaderFooterManager.SetSlideNumberVisibility(false);
// 수정된 프레젠테이션을 저장합니다
presentation.Save("output.pptx", SaveFormat.Pptx);
}
FAQ
사용자가 보는 슬라이드 번호가 컬렉션의 0 기반 인덱스와 일치합니까?
슬라이드에 표시되는 번호는 임의의 값(예: 10)부터 시작할 수 있으며 인덱스와 일치할 필요가 없습니다. 이 관계는 프레젠테이션의 first slide number 설정에 의해 제어됩니다.
숨겨진 슬라이드가 인덱싱에 영향을 줍니까?
예. 숨겨진 슬라이드도 컬렉션에 남아 있으며 인덱싱 시 계산됩니다. “숨김"은 표시 여부를 의미할 뿐 컬렉션 내 위치와는 관계가 없습니다.
다른 슬라이드를 추가하거나 제거하면 슬라이드의 인덱스가 변경됩니까?
예. 인덱스는 항상 현재 슬라이드 순서를 반영하며 삽입, 삭제, 이동 작업 시 다시 계산됩니다.