`PowerPoint` .NET 구성 요소

using IronPPT;

// Initialize a new presentation
var ppt = new PresentationDocument();

// Add Text to the new presentation
// TextBoxes[0] typically represents the title placeholder
ppt.Slides[0].TextBoxes[0].AddText("Welcome to IronPPT");

// TextBoxes[1] typically represents the subtitle or content area
ppt.Slides[0].TextBoxes[1].AddText("This slide was generated using IronPPT!");

// Save the presentation with a descriptive filename
ppt.Save("new_presentation.pptx");

using IronPPT;

// Initialize a new presentation
var ppt = new PresentationDocument();

// Add Text to the new presentation
// TextBoxes[0] typically represents the title placeholder
ppt.Slides[0].TextBoxes[0].AddText("Welcome to IronPPT");

// TextBoxes[1] typically represents the subtitle or content area
ppt.Slides[0].TextBoxes[1].AddText("This slide was generated using IronPPT!");

// Save the presentation with a descriptive filename
ppt.Save("new_presentation.pptx");

이 예제는 프레젠테이션을 생성하는 기본 패턴을 보여줍니다. API가 슬라이드 및 텍스트 상자에 접근하기 위해 익숙한 인덱싱을 사용하는 방법을 확인하세요. 새로운 PresentationDocument을 인스턴스화하면 첫 번째 슬라이드(인덱스 0)가 자동으로 생성됩니다. 각 슬라이드는 레이아웃에 기반하여 미리 정의된 텍스트 상자를 포함하고 있으며, 여기에는 콘텐츠를 채울 수 있습니다.

산출

using IronPPT;

// Load the existing pptx file
// The constructor accepts a file path to an existing presentation
var ppt = new PresentationDocument("new_presentation.pptx");

// Edit the existing text by accessing the Texts collection
// Texts[0] refers to the first text element in the text box
ppt.Slides[0].TextBoxes[0].Texts[0].Text = "Hello World!";

// Save the changes to a new file to preserve the original
ppt.Save("updated.pptx");

using IronPPT;

// Load the existing pptx file
// The constructor accepts a file path to an existing presentation
var ppt = new PresentationDocument("new_presentation.pptx");

// Edit the existing text by accessing the Texts collection
// Texts[0] refers to the first text element in the text box
ppt.Slides[0].TextBoxes[0].Texts[0].Text = "Hello World!";

// Save the changes to a new file to preserve the original
ppt.Save("updated.pptx");

기존 프레젠테이션을 편집할 때, IronPPT는 모든 서식 및 수정되지 않은 콘텐츠를 보존합니다. 이 예제는 프레젠테이션을 로드하고, 특정 텍스트 요소를 수정하며, 변경 사항을 저장하는 방법을 보여줍니다. Texts 컬렉션은 텍스트 상자 내 개별 텍스트 실행에 대한 접근을 제공하여 콘텐츠 업데이트에 대해 정확한 제어를 할 수 있도록 합니다.

산출

using IronPPT;
using IronPPT.Models;

// Load an existing presentation
var ppt = new PresentationDocument("updated.pptx");

// Create a new Image object
Image img = new Image();

// Load image from file - supports common formats (JPG, PNG, etc.)
img.LoadFromFile("IronPPT.png");

// Add the image to the presentation on slide 0
// The method returns a reference to the added image for further manipulation
var newImg = ppt.AddImage(img, 0);

// Position the image using coordinates (left, top)
newImg.Position = (150, 50);

// Set dimensions - maintain aspect ratio manually if needed
newImg.Width = 400;
newImg.Height = 150;

// Save the presentation with the embedded image
ppt.Save("image.pptx");

using IronPPT;
using IronPPT.Models;

// Load an existing presentation
var ppt = new PresentationDocument("updated.pptx");

// Create a new Image object
Image img = new Image();

// Load image from file - supports common formats (JPG, PNG, etc.)
img.LoadFromFile("IronPPT.png");

// Add the image to the presentation on slide 0
// The method returns a reference to the added image for further manipulation
var newImg = ppt.AddImage(img, 0);

// Position the image using coordinates (left, top)
newImg.Position = (150, 50);

// Set dimensions - maintain aspect ratio manually if needed
newImg.Width = 400;
newImg.Height = 150;

// Save the presentation with the embedded image
ppt.Save("image.pptx");

이 예제는 IronPPT의 이미지 처리 기능을 강조합니다. Image 클래스는 다양한 소스에서 이미지를 로드하는 방법을 제공하며, 위치 지정 시스템은 표준 PowerPoint 단위를 사용합니다. 다른 디스플레이 시나리오에서 이미지가 올바르게 나타나도록 위치와 크기를 설정할 때 대상 슬라이드 크기를 고려하는 것을 잊지 마세요.

산출

먼저, 다음 코드 예제를 통해 프레젠테이션에 슬라이드를 추가해 봅시다:

using IronPPT;
using IronPPT.Models;

// Load the existing presentation
var ppt = new PresentationDocument("updated.pptx");

// Create a new slide object
Slide slide = new Slide();

// Add text to the new slide
// This creates a simple slide with a title
slide.AddText("Slide Two");

// Add the slide to the presentation
// The slide is appended to the end of the presentation
ppt.AddSlide(slide);

// Create another slide for demonstration
Slide slide3 = new Slide();
slide3.AddText("Slide Three");
ppt.AddSlide(slide3);

// Save the updated presentation
ppt.Save("updated.pptx");

using IronPPT;
using IronPPT.Models;

// Load the existing presentation
var ppt = new PresentationDocument("updated.pptx");

// Create a new slide object
Slide slide = new Slide();

// Add text to the new slide
// This creates a simple slide with a title
slide.AddText("Slide Two");

// Add the slide to the presentation
// The slide is appended to the end of the presentation
ppt.AddSlide(slide);

// Create another slide for demonstration
Slide slide3 = new Slide();
slide3.AddText("Slide Three");
ppt.AddSlide(slide3);

// Save the updated presentation
ppt.Save("updated.pptx");

슬라이드를 추가할 때, IronPPT는 내부 프레젠테이션 구조를 자동으로 처리합니다. 새 슬라이드는 기본 레이아웃을 갖게 됩니다. AddSlide 메소드는 프레젠테이션 끝에 슬라이드를 추가하지만, 쉽게 순서를 바꿀 수 있습니다.

산출

이제 여러 슬라이드가 있는 프레젠테이션으로 쉽게 슬라이드를 재정렬할 수 있습니다:

using IronPPT;

// Configure your license key to remove trial limitations
IronPPT.License.LicenseKey = "YOUR-LICENSE-KEY";

// Load the presentation with multiple slides
var ppt = new PresentationDocument("updated.pptx");

// Reorder slides by changing their Index property
// This moves the third slide (index 2) to the second position (index 1)
ppt.Slides[2].Index = 1;

// The library automatically adjusts other slide indices
// Original order: [0, 1, 2] -> New order: [0, 2, 1]

// Save the reordered presentation
ppt.Save("updated.pptx");

using IronPPT;

// Configure your license key to remove trial limitations
IronPPT.License.LicenseKey = "YOUR-LICENSE-KEY";

// Load the presentation with multiple slides
var ppt = new PresentationDocument("updated.pptx");

// Reorder slides by changing their Index property
// This moves the third slide (index 2) to the second position (index 1)
ppt.Slides[2].Index = 1;

// The library automatically adjusts other slide indices
// Original order: [0, 1, 2] -> New order: [0, 2, 1]

// Save the reordered presentation
ppt.Save("updated.pptx");

슬라이드 재정렬 기능은 특히 프레젠테이션을 동적으로 만들 때 유용합니다. 생성된 순서대로 슬라이드를 추가한 후, 비즈니스 로직이나 사용자의 선호에 따라 재정렬할 수 있습니다. 인덱스 속성은 이 프로세스를 직관적이고 효율적으로 만듭니다.

산출

이제 'Slide Two' 텍스트가 포함된 슬라이드가 프레젠테이션에서 두 번째 슬라이드로 제대로 자리 잡았습니다.