Class Presentation

Represents the PowerPoint presentation.

Inheritance

System.Object

Presentation

Implements

IPresentation

System.IDisposable

Inherited Members

System.Object.ToString()

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

Namespace: Syncfusion.Presentation

Assembly: Syncfusion.Presentation.Base.dll

Syntax

public sealed class Presentation : IPresentation, IDisposable

Properties

BuiltInDocumentProperties

Gets an IBuiltInDocumentProperties instance. Read-only.

Declaration

public IBuiltInDocumentProperties BuiltInDocumentProperties { get; }

Property Value

Type	Description
IBuiltInDocumentProperties

Examples

//Create a presentation.
Presentation presentation = Presentation.Create() as Presentation;        
//Retrieve the built-in document property, it is read only
IBuiltInDocumentProperties builtin = presentation.BuiltInDocumentProperties;
//Set the application name
builtin.ApplicationName = "Essential Presentation";
//Save the presentation
presentation.Save("Sample.pptx");
//Close the presentation
presentation.Close();

'Create a presentation.
Dim presentation__1 As Presentation = TryCast(Presentation.Create(), Presentation)
'Retrieve the built-in document property, it is read only
Dim builtin As IBuiltInDocumentProperties = presentation__1.BuiltInDocumentProperties
'Set the application name
builtin.ApplicationName = "Essential Presentation"
'Save the presentation
presentation__1.Save("Sample.pptx")
'Close the presentation
presentation__1.Close()

ChartToImageConverter

Gets an IOfficeChartToImageConverter instance.

Declaration

public IOfficeChartToImageConverter ChartToImageConverter { get; set; }

Property Value

Type	Description
IOfficeChartToImageConverter

Remarks

Initialize the ChartToImageConverter in-order to convert a chart in presentation to image.

Examples

//Create a new presentation.
Presentation presentation = Presentation.Create() as Presentation;
//Initialize the chart to image converter.
presentation.ChartToImageConverter = new ChartToImageConverter();
//Set the scaling mode for the chart.
presentation.ChartToImageConverter.ScalingMode = ScalingMode.Best;
//Add a blank slide for the chart.
ISlide slide = presentation.Slides.Add(SlideLayoutType.Blank);
//Add a chart to the slide.
IPresentationChart officeChart = slide.Charts.AddChart(100, 100, 600, 400);
//Set chart data
officeChart.ChartData.SetValue(1, 4, "Month");
officeChart.ChartData.SetValue(2, 4, "July");
officeChart.ChartData.SetValue(3, 4, "August");
officeChart.ChartData.SetValue(4, 4, "September");
officeChart.ChartData.SetValue(5, 4, "October");
officeChart.ChartData.SetValue(6, 4, "November");
officeChart.ChartData.SetValue(7, 4, "December");
officeChart.ChartData.SetValue(1, 1, "2013");
officeChart.ChartData.SetValue(2, 1, 35);
officeChart.ChartData.SetValue(3, 1, 37);
officeChart.ChartData.SetValue(4, 1, 30);
officeChart.ChartData.SetValue(5, 1, 29);
officeChart.ChartData.SetValue(6, 1, 25);
officeChart.ChartData.SetValue(7, 1, 30);
officeChart.ChartData.SetValue(1, 2, "2014");
officeChart.ChartData.SetValue(2, 2, 30);
officeChart.ChartData.SetValue(3, 2, 25);
officeChart.ChartData.SetValue(4, 2, 29);
officeChart.ChartData.SetValue(5, 2, 35);
officeChart.ChartData.SetValue(6, 2, 38);
officeChart.ChartData.SetValue(7, 2, 32);
officeChart.ChartData.SetValue(1, 3, "2015");
officeChart.ChartData.SetValue(2, 3, 35);
officeChart.ChartData.SetValue(3, 3, 37);
officeChart.ChartData.SetValue(4, 3, 30);
officeChart.ChartData.SetValue(5, 3, 50);
officeChart.ChartData.SetValue(6, 3, 25);
officeChart.ChartData.SetValue(7, 3, 30);
//Add chart serie.
IOfficeChartSerie serie1 = officeChart.Series.Add("2013");
//Set serie value.
serie1.Values = officeChart.ChartData[2, 1, 7, 1];
//Add chart serie.
IOfficeChartSerie serie2 = officeChart.Series.Add("2014");
//Set serie value.
serie2.Values = officeChart.ChartData[2, 2, 7, 2];
//Add chart serie.
IOfficeChartSerie serie3 = officeChart.Series.Add("2015");
//Set serie value.
serie3.Values = officeChart.ChartData[2, 3, 7, 3];
//Set category labels value for the primary category axis.
officeChart.PrimaryCategoryAxis.CategoryLabels = officeChart.ChartData[2, 4, 7, 4];
//Set the chart type.
officeChart.ChartType = OfficeChartType.Column_Clustered;
//Set the chart title.
officeChart.ChartTitle = "Mine Chart";
//Convert the chart to image.
Image[] chartImages = presentation.RenderAsImages(Syncfusion.Drawing.ImageType.Metafile);
foreach (Image image in chartImages)
{
//Save the image.
image.Save("ChartToImageConverter" + Guid.NewGuid() + ".png");
}
//Save the presentation.
presentation.Save("ChartToImageConverter.pptx");
//Close the presentation.
presentation.Close();

'Create a new presentation.
Dim presentation__1 As Presentation = TryCast(Presentation.Create(), Presentation)
'Initialize the chart to image converter.
presentation__1.ChartToImageConverter = New ChartToImageConverter()
'Set the scaling mode for the chart.
presentation__1.ChartToImageConverter.ScalingMode = ScalingMode.Best
'Add a blank slide for the chart.
Dim slide As ISlide = presentation__1.Slides.Add(SlideLayoutType.Blank)
'Add a chart to the slide.
Dim officeChart As IPresentationChart = slide.Charts.AddChart(100, 100, 600, 400)
'Set chart data
officeChart.ChartData.SetValue(1, 4, "Month")
officeChart.ChartData.SetValue(2, 4, "July")
officeChart.ChartData.SetValue(3, 4, "August")
officeChart.ChartData.SetValue(4, 4, "September")
officeChart.ChartData.SetValue(5, 4, "October")
officeChart.ChartData.SetValue(6, 4, "November")
officeChart.ChartData.SetValue(7, 4, "December")
officeChart.ChartData.SetValue(1, 1, "2013")
officeChart.ChartData.SetValue(2, 1, 35)
officeChart.ChartData.SetValue(3, 1, 37)
officeChart.ChartData.SetValue(4, 1, 30)
officeChart.ChartData.SetValue(5, 1, 29)
officeChart.ChartData.SetValue(6, 1, 25)
officeChart.ChartData.SetValue(7, 1, 30)
officeChart.ChartData.SetValue(1, 2, "2014")
officeChart.ChartData.SetValue(2, 2, 30)
officeChart.ChartData.SetValue(3, 2, 25)
officeChart.ChartData.SetValue(4, 2, 29)
officeChart.ChartData.SetValue(5, 2, 35)
officeChart.ChartData.SetValue(6, 2, 38)
officeChart.ChartData.SetValue(7, 2, 32)
officeChart.ChartData.SetValue(1, 3, "2015")
officeChart.ChartData.SetValue(2, 3, 35)
officeChart.ChartData.SetValue(3, 3, 37)
officeChart.ChartData.SetValue(4, 3, 30)
officeChart.ChartData.SetValue(5, 3, 50)
officeChart.ChartData.SetValue(6, 3, 25)
officeChart.ChartData.SetValue(7, 3, 30)
'Add chart serie.
Dim serie1 As IOfficeChartSerie = officeChart.Series.Add("2013")
'Set serie value.
serie1.Values = officeChart.ChartData(2, 1, 7, 1)
'Add chart serie.
Dim serie2 As IOfficeChartSerie = officeChart.Series.Add("2014")
'Set serie value.
serie2.Values = officeChart.ChartData(2, 2, 7, 2)
'Add chart serie.
Dim serie3 As IOfficeChartSerie = officeChart.Series.Add("2015")
'Set serie value.
serie3.Values = officeChart.ChartData(2, 3, 7, 3)
'Set category labels value for the primary category axis.
officeChart.PrimaryCategoryAxis.CategoryLabels = officeChart.ChartData(2, 4, 7, 4)
'Set the chart type.
officeChart.ChartType = OfficeChartType.Column_Clustered
'Set the chart title.
officeChart.ChartTitle = "Mine Chart"
'Convert the chart to image.
Dim chartImages As Image() = presentation__1.RenderAsImages(Syncfusion.Drawing.ImageType.Metafile)
For Each image As Image In chartImages
'Save the image.
image.Save("ChartToImageConverter" + Guid.NewGuid() + ".png")
Next
'Save the presentation.
presentation__1.Save("ChartToImageConverter.pptx")
'Close the presentation.
presentation__1.Close()

CustomDocumentProperties

Gets an ICustomDocumentProperties instance. Read-only.

Declaration

public ICustomDocumentProperties CustomDocumentProperties { get; }

Property Value

Type	Description
ICustomDocumentProperties

Examples

//Create a presentation.
IPresentation presentation = Presentation.Create();
//Retrieve the custom document property, it is read only
ICustomDocumentProperties custom = presentation.CustomDocumentProperties;
//Add custom document property
custom.Add("PropertyA");
//Set the boolean property
custom["PropertyA"].Boolean = true;
//Save the presentation
presentation.Save("Sample.pptx");
//Close the presentation
presentation.Close();

'Create a presentation.
Dim presentation__1 As IPresentation = Presentation.Create()
'Retrieve the custom document property, it is read only
Dim [custom] As ICustomDocumentProperties = presentation__1.CustomDocumentProperties
'Add custom document property
[custom].Add("PropertyA")
'Set the boolean property
[custom]("PropertyA").[Boolean] = True
'Save the presentation
presentation__1.Save("Sample.pptx")
'Close the presentation
presentation__1.Close()

Final

Gets or sets a value indicating whether the IPresentation instance is marked as final.

Declaration

public bool Final { get; set; }

Property Value

Type	Description
System.Boolean

FontSettings

Gets the font settings. Read Only.

Declaration

public FontSettings FontSettings { get; }

Property Value

Type	Description
FontSettings	The font settings in the PowerPoint document.

HasMacros

Gets or sets whether the presentation has macros.

Declaration

public bool HasMacros { get; }

Property Value

Type	Description
System.Boolean

IsWriteProtected

Gets whether the presentation is write Protected. Read-only.

Declaration

public bool IsWriteProtected { get; }

Property Value

Type	Description
System.Boolean

Examples

 //Create an instance for presentation
 IPresentation presentation = Presentation.Open("Sample.pptx");
 //Check whether the presentation is write protected.
 if (presentation.IsWriteProtected)
 {
    //Removes the write protection from presentation instance
    presentation.RemoveWriteProtection();
  }
 //Save the presentation
 presentation.Save("Output.pptx");
 //Close the presentation.
 presentation.Close();

'Create an instance for presentation
Dim presentation As IPresentation = Presentation.Open("Sample.pptx")
'Check whether the presentation is write protected.
if (presentation.IsWriteProtected)
{
   'Removes the write protection from presentation instance
   presentation.RemoveWriteProtection()
 }
'Save the presentation
presentation.Save("Output.pptx")
'Close the presentation.
presentation.Close()

Masters

Gets the IMasterSlides collection of the IPresentation instance. Read-only.

Declaration

public IMasterSlides Masters { get; }

Property Value

Type	Description
IMasterSlides

Examples

//Create a new presentation.
Presentation presentation = Presentation.Create() as Presentation;
//Retrieve the collection of layout Slide
IMasterSlides masterslides = presentation.Masters;
//Get a master by specifying the index in collection
IMasterSlide masterSlide = presentation.Masters[0];
//Add a group shape to master slide
masterSlide.GroupShapes.AddGroupShape(200,234,198,173);
//Add an autoshape - bevel to master slide
masterSlide.Shapes.AddShape(AutoShapeType.Bevel,237,45,187,120);
//Add master slide to the collection
masterslides.Add(masterSlide);
//Save the presentation
presentation.Save("Output.pptx");
//Close the presentation
presentation.Close();

'Create a new presentation.
Dim presentation__1 As Presentation = TryCast(Presentation.Create(), Presentation)
'Retrieve the collection of layout Slide
Dim masterslides As IMasterSlides = presentation__1.Masters
'Get a master by specifying the index in collection
Dim masterSlide As IMasterSlide = presentation__1.Masters(0)
'Add a group shape to master slide
masterSlide.GroupShapes.AddGroupShape(200, 234, 198, 173)
'Add an autoshape - bevel to master slide
masterSlide.Shapes.AddShape(AutoShapeType.Bevel, 237, 45, 187, 120)
'Add master slide to the collection
masterslides.Add(masterSlide)
'Save the presentation
presentation__1.Save("Output.pptx")
'Close the presentation
presentation__1.Close()

Sections

Returns a collection of ISection instances. Read-only.

Declaration

public ISections Sections { get; }

Property Value

Type	Description
ISections

Slides

Gets the slide collection of ISlides instance. Read-only.

Declaration

public ISlides Slides { get; }

Property Value

Type	Description
ISlides

Examples

//Create a new presentation.
IPresentation presentation = Presentation.Create();
//Create instance to hold the slide collection
ISlides slides = presentation.Slides;
//Add slide to presentation
slides.Add();
//Add a blank slide to the presentation.
slides.Add(SlideLayoutType.Blank);
//Add slide to the collection by passing the slide instance
slides.Add(slides.Add(SlideLayoutType.Title));
//Retrieve the specific slide item, read only
ISlide _slide = slides[0];
//Set the slide name
_slide.Name = "My Slide";
//Save the presentation
presentation.Save("Sample.pptx");
//Close the presentation
presentation.Close();

'Create a new presentation.
IPresentation presentation = Presentation.Create();
'Create instance to hold the slide collection
ISlides slides = presentation.Slides;
'Add slide to presentation
slides.Add();
'Add a blank slide to the presentation.
slides.Add(SlideLayoutType.Blank);
'Add slide to the collection by passing the slide instance
slides.Add(slides.Add(SlideLayoutType.Title));
'Retrieve the specific slide item, read only
ISlide _slide = slides[0];
'Set the slide name
slide.Name = "My Slide";
'Save the presentation
presentation.Save("Sample.pptx");
'Close the presentation
presentation.Close();

SlideSize

Gets the slide size of ISlideSize instance. Read-only.

Declaration

public ISlideSize SlideSize { get; }

Property Value

Type	Description
ISlideSize

Examples

//Create a presentation.
Presentation presentation = Presentation.Create() as Presentation;
//Add a blank slide for the chart.
ISlide slide = presentation.Slides.Add(SlideLayoutType.Blank);
//Retrieve the slides size, read only
ISlideSize slidesize = presentation.SlideSize;
//Set the slide orientation of presentation
slidesize.SlideOrientation = SlideOrientation.Landscape;
//Save the presentation
presentation.Save("Sample.pptx");
//Close the presentation
presentation.Close();

'Create a presentation.
Dim presentation__1 As Presentation = TryCast(Presentation.Create(), Presentation)
'Add a blank slide for the chart.
Dim slide As ISlide = presentation.Slides.Add(SlideLayoutType.Blank)
'Retrieve the slides size, read only
Dim slidesize As ISlideSize = presentation__1.SlideSize
'Set the slide orientation of presentation
slidesize.SlideOrientation = SlideOrientation.Landscape
'Save the presentation
presentation__1.Save("Sample.pptx")
'Close the presentation
presentation__1.Close()

Methods

Clone()

Creates an independent copy of IPresentation instance.

Declaration

public IPresentation Clone()

Returns

Type	Description
IPresentation	Returns the cloned presentation instance.

Examples

 //Create an instance for presentation
 Presentation presentation = Presentation.Create() as Presentation;
 //Add a new slide of comparison slide layout type.
 ISlide slide = presentation.Slides.Add(SlideLayoutType.Comparison);            
 //Clone the entire presentation.
 IPresentation presentationClone = presentation.Clone();
 //Add a new slide of title layout type.
 slide = presentationClone.Slides.Add(SlideLayoutType.Title);
 //Add an auto shape of regular pentagon auto shape type.
 slide.Shapes.AddShape(AutoShapeType.RegularPentagon, 10, 20, 300, 400);
 //Save the cloned presentation
 presentationClone.Save("Sample.pptx");
 //Close the presentation.
 presentation.Close();
 //Close the cloned presentation.
 presentationClone.Close();

Dim presentation__1 As Presentation = TryCast(Presentation.Create(), Presentation)
'Add a new slide of comparison slide layout type.
Dim slide As ISlide = presentation__1.Slides.Add(SlideLayoutType.Comparison)
'Clone the entire presentation.
Dim presentationClone As IPresentation = presentation__1.Clone()
'Add a new slide of title layout type.
slide = presentationClone.Slides.Add(SlideLayoutType.Title)
'Add an auto shape of regular pentagon auto shape type.
slide.Shapes.AddShape(AutoShapeType.RegularPentagon, 10, 20, 300, 400)
'Save the cloned presentation
presentationClone.Save("Sample.pptx")
'Close the presentation.
presentation__1.Close()
'Close the cloned presentation.
presentationClone.Close()

Close()

Releases any resources associated with the presentation instance.

Declaration

public void Close()

Examples

//Create a new presentation.
Presentation presentation = Presentation.Create() as Presentation;
//Add a new slide of comparison slide layout type.
ISlide slide = presentation.Slides.Add(SlideLayoutType.Comparison);    
//Save the presentation.
presentation.Save("Sample.pptx");
//Close the presentation.
presentation.Close();

'Create a new presentation.
Dim presentation__1 As Presentation = TryCast(Presentation.Create(), Presentation)
'Add a new slide of comparison slide layout type.
Dim slide As ISlide = presentation__1.Slides.Add(SlideLayoutType.Comparison)
'Save the presentation.
presentation__1.Save("Sample.pptx")
'Close the presentation.
presentation__1.Close()

Create()

Creates a new IPresentation instance.

Declaration

public static IPresentation Create()

Returns

Type	Description
IPresentation	Returns the newly created presentation instance.

Examples

//Create a new presentation.
Presentation presentation = Presentation.Create() as Presentation;
//Add a new slide of comparison slide layout type.
ISlide slide = presentation.Slides.Add(SlideLayoutType.Comparison);    
//Save the presentation.
presentation.Save("Sample.pptx");
//Close the presentation.
presentation.Close();

'Create a new presentation.
Dim presentation__1 As Presentation = TryCast(Presentation.Create(), Presentation)
'Add a new slide of comparison slide layout type.
Dim slide As ISlide = presentation__1.Slides.Add(SlideLayoutType.Comparison)
'Save the presentation.
presentation__1.Save("Sample.pptx")
'Close the presentation.
presentation__1.Close()

Dispose()

Releases all resources used by the Presentation instance.

Declaration

public void Dispose()

Encrypt(String)

Declaration

public void Encrypt(string password)

Parameters

Type	Name	Description
System.String	password

Open(Stream)

Opens the presentation from the specified stream.

Declaration

public static IPresentation Open(Stream fileStream)

Parameters

Type	Name	Description
System.IO.Stream	fileStream	The stream instance that represents the presentation.

Returns

Type	Description
IPresentation	Returns a IPresentation object that represents the opened presentation.

Examples

//Create instance for memory stream
MemoryStream fileStream = new MemoryStream();
//Open a presentation
IPresentation presentation = Presentation.Open(fileStream);
presentation.Save("Sample.pptx");
//Close the presentation.
presentation.Close();
//Dispose the filestream
fileStream.Dispose();

'Create instance for memory stream
Dim fileStream As New MemoryStream()
'Open a presentation
Dim presentation__1 As IPresentation = Presentation.Open(fileStream)
presentation__1.Save("Sample.pptx")
'Close the presentation.
presentation__1.Close()
'Dispose the filestream
fileStream.Dispose()

Open(Stream, String)

Opens the encrypted presentation from the specified stream and password.

Declaration

public static IPresentation Open(Stream stream, string password)

Parameters

Type	Name	Description
System.IO.Stream	stream	The System.IO.Stream instance of the presentation.
System.String	password	The password required to open the presentation.

Returns

Type	Description
IPresentation	Returns the IPresentation object that represents the opened presentation.

Examples

//Create instance for memory stream
MemoryStream fileStream = new MemoryStream();
//Open a presentation
string InputPath = "";
IPresentation presentation = Presentation.Open(fileStream,InputPath);
presentation.Save("Sample.pptx");
//Close the presentation.
presentation.Close();
//Dispose the filestream
fileStream.Dispose();

'Create instance for memory stream
Dim fileStream As New MemoryStream()
'Open a presentation
Dim presentation__1 As IPresentation = Presentation.Open(fileStream, Input.pptx)
presentation__1.Save("Sample.pptx")
'Close the presentation.
presentation__1.Close()
'Dispose the filestream
fileStream.Dispose()

Open(String)

Opens the presentation from the specified file name.

Declaration

public static IPresentation Open(string fileName)

Parameters

Type	Name	Description
System.String	fileName	Specifies the file name of the presentation to open.

Returns

Type	Description
IPresentation	Returns a IPresentation object that represents the opened presentation.

Examples

//Open a presentation.
Presentation presentation = Presentation.Open("Input.pptx") as Presentation;
//Add a new slide of comparison slide layout type.
ISlide slide = presentation.Slides.Add(SlideLayoutType.Comparison);    
//Save the presentation.
presentation.Save("Sample.pptx");
//Close the presentation.
presentation.Close();

'Open a presentation.
Dim presentation__1 As Presentation = TryCast(Presentation.Open("Input.pptx"), Presentation)
'Add a new slide of comparison slide layout type.
Dim slide As ISlide = presentation__1.Slides.Add(SlideLayoutType.Comparison)
'Save the presentation.
presentation__1.Save("Sample.pptx")
'Close the presentation
presentation__1.Close()

Open(String, String)

Opens the encrypted presentation from the specified file name and password.

Declaration

public static IPresentation Open(string fileName, string password)

Parameters

Type	Name	Description
System.String	fileName	Path of the presentation file.
System.String	password	Password required to open the presentation file.

Returns

Type	Description
IPresentation	Returns a IPresentation object that represents the opened presentation.

Examples

 //Open the encrypted presentation.
 Presentation presentation = Presentation.Open("Input.pptx", "MYPASSWORD!@#$%") as Presentation; 
 //Save the presentation.
 presentation.Save("Sample.pptx");
 //Close the presentation.
 presentation.Close();

'Open the encrypted presentation.
Dim presentation__1 As Presentation = TryCast(Presentation.Open("Input.pptx", "MYPASSWORD!@#$%"), Presentation)       
'Save the presentation.
presentation__1.Save("Sample.pptx")
'Close the presentation.
presentation__1.Close()

RemoveEncryption()

Removes the encryption from presentation.

Declaration

public void RemoveEncryption()

Remarks

To remove the encryption we must have opened the presentation with password.

Examples

//Open the encrypted presentation.
Presentation presentation = Presentation.Open("Input.pptx", "MYPASSWORD!@#$%") as Presentation;          
//Remove the encryption.
presentation.RemoveEncryption();
//Save the presentation.
presentation.Save("Sample.pptx");
//Close the presentation.
presentation.Close();

'Open the encrypted presentation.
Dim presentation__1 As Presentation = TryCast(Presentation.Open("Input.pptx", "MYPASSWORD!@#$%"), Presentation)
'Remove the encryption.
presentation__1.RemoveEncryption()
'Save the presentation.
presentation__1.Save("Sample.pptx")
'Close the presentation.
presentation__1.Close()

RemoveMacros()

Removes the macros from the presentation instance.

Declaration

public void RemoveMacros()

RemoveWriteProtection()

Removes the write Protection from presentation instance

Declaration

public void RemoveWriteProtection()

Examples

 //Create an instance for presentation
 IPresentation presentation = Presentation.Open("Sample.pptx");
 //Check whether the presentation is write protected.
 if (presentation.IsWriteProtected)
 {
    //Removes the write protection from presentation instance
    presentation.RemoveWriteProtection();
  }
 //Save the presentation
 presentation.Save("Output.pptx");
 //Close the presentation.
 presentation.Close();

'Create an instance for presentation
Dim presentation As IPresentation = Presentation.Open("Sample.pptx")
'Check whether the presentation is write protected.
if (presentation.IsWriteProtected)
{
   'Removes the write protection from presentation instance
   presentation.RemoveWriteProtection()
 }
'Save the presentation
presentation.Save("Output.pptx")
'Close the presentation.
presentation.Close()

RenderAsImages(ImageFormat)

Converts the slides in presentation to images using the specified image format.

Declaration

public Stream[] RenderAsImages(ImageFormat imageFormat)

Parameters

Type	Name	Description
ImageFormat	imageFormat	Specifies the image format in which you want to convert slides.

Returns

Type	Description
System.IO.Stream[]	Returns the System.IO.Stream array of the converted images.

Examples

 //Create a new presentation.
 Presentation presentation = Presentation.Create() as Presentation;
 //Add a content with caption slide to the presentation.
 ISlide slide = presentation.Slides.Add(SlideLayoutType.ContentWithCaption);
 //Add a table to the slide.
 ITable table = slide.Tables.AddTable(5, 5, 0, 0, 500, 500);
 //Set the built in table style.
 table.BuiltInStyle = BuiltInTableStyle.DarkStyle2Accent3Accent4;
 //Iterate through the row collection.
 foreach (IRow row in table.Rows)
 {
 //Iterate through the cell collection.
 foreach (ICell cell in row.Cells)
 {
 //Add a paragraph to the cell.
 cell.TextBody.AddParagraph("New Paragraph");
 }
 }
 //Converts the each and every slide in the presentation to image of stream array type.
 Stream[] imageStreamArray = presentation.RenderAsImages(Syncfusion.Drawing.ImageFormat.Jpeg);
 //Iterate the stream array.
 foreach (Stream stream in imageStreamArray)
 {
 //Save the stream in image of .jpg format.
 Image.FromStream(stream).Save("RenderAsImage" + Guid.NewGuid() + ".jpg");
 } 
 //Close the presentation.
 presentation.Close();

'Create a new presentation.
Dim presentation__1 As Presentation = TryCast(Presentation.Create(), Presentation)
'Add a content with caption slide to the presentation.
Dim slide As ISlide = presentation__1.Slides.Add(SlideLayoutType.ContentWithCaption)
'Add a table to the slide.
Dim table As ITable = slide.Tables.AddTable(5, 5, 0, 0, 500, 500)
'Set the built in table style.
table.BuiltInStyle = BuiltInTableStyle.DarkStyle2Accent3Accent4
'Iterate through the row collection.
For Each row As IRow In table.Rows
'Iterate through the cell collection.
For Each cell As ICell In row.Cells
'Add a paragraph to the cell.
cell.TextBody.AddParagraph("New Paragraph")
Next
Next
'Converts the each and every slide in the presentation to image of stream array type.
Dim imageStreamArray As Stream() = presentation__1.RenderAsImages(Syncfusion.Drawing.ImageFormat.Jpeg)
'Iterate the stream array.
For Each stream As Stream In imageStreamArray
'Save the stream in image of .jpg format.
Image.FromStream(stream).Save("RenderAsImage" + Guid.NewGuid() + ".jpg")
Next
'Close the presentation.
presentation__1.Close()

RenderAsImages(ImageType)

Converts the slides in presentation to images using the specified image type.

Declaration

public Image[] RenderAsImages(ImageType imageType)

Parameters

Type	Name	Description
ImageType	imageType	Specifies the image type in which you want to convert slides.

Returns

Type	Description
System.Drawing.Image[]	Returns the System.Drawing.Image array of the converted images.

Examples

 //Create a new presentation.
 Presentation presentation = Presentation.Create() as Presentation;
 //Add a content with caption slide to the presentation.
 ISlide slide = presentation.Slides.Add(SlideLayoutType.ContentWithCaption);
 //Add a table to the slide.
 ITable table = slide.Tables.AddTable(5, 5, 0, 0, 500, 500);
 //Set the built in table style.
 table.BuiltInStyle = BuiltInTableStyle.DarkStyle2Accent3Accent4;
 //Iterate through the row collection.
 foreach (IRow row in table.Rows)
 {
 //Iterate through the cell collection.
 foreach (ICell cell in row.Cells)
 {
 //Add a paragraph to the cell.
 cell.TextBody.AddParagraph("New Paragraph");
 }
 }
 //Converts the each and every slide in the presentation to image of System.Drawing.Image type array.
 Image[] imageArray = presentation.RenderAsImages(Syncfusion.Drawing.ImageType.Metafile);
 //Iterate the image array.
 foreach (Image image in imageArray)
 {
 //Save the image of .bmp format.
 image.Save("RenderAsImage" + Guid.NewGuid() + ".bmp");
 }
 //Close the presentation.
 presentation.Close();

'Create a new presentation.
Dim presentation__1 As Presentation = TryCast(Presentation.Create(), Presentation)
'Add a content with caption slide to the presentation.
Dim slide As ISlide = presentation__1.Slides.Add(SlideLayoutType.ContentWithCaption)
'Add a table to the slide.
Dim table As ITable = slide.Tables.AddTable(5, 5, 0, 0, 500, 500)
'Set the built in table style.
table.BuiltInStyle = BuiltInTableStyle.DarkStyle2Accent3Accent4
'Iterate through the row collection.
For Each row As IRow In table.Rows
'Iterate through the cell collection.
For Each cell As ICell In row.Cells
'Add a paragraph to the cell.
cell.TextBody.AddParagraph("New Paragraph")
Next
Next
'Converts the each and every slide in the presentation to image of System.Drawing.Image type array.
Dim imageArray As Image() = presentation__1.RenderAsImages(Syncfusion.Drawing.ImageType.Metafile)
'Iterate the image array.
For Each image As Image In imageArray
'Save the image of .bmp format.
image.Save("RenderAsImage" + Guid.NewGuid() + ".bmp")
Next
'Close the presentation.
presentation__1.Close()

Save(Stream)

Declaration

public void Save(Stream stream)

Parameters

Type	Name	Description
System.IO.Stream	stream

Remarks

At present, the Essential Presentation library only supports the PPTX file format.

Examples

//Create instance for memory stream
MemoryStream fileStream = new MemoryStream();
//Create an instance of presentation
Presentation presentation = Presentation.Create() as Presentation;
//Save the presentation using stream
presentation.Save(fileStream);
//Close the presentation.
presentation.Close();
//Dispose the filestream
fileStream.Dispose();

'Create instance for memory stream
Dim fileStream As New MemoryStream()
'Create an instance of presentation
Dim presentation__1 As Presentation = TryCast(Presentation.Create(), Presentation)
'Save the presentation using stream
presentation__1.Save(fileStream)
'Close the presentation.
presentation__1.Close()
'Dispose the filestream
fileStream.Dispose()

Save(String)

Saves the presentation to the specified file name.

Declaration

public void Save(string fileName)

Parameters

Type	Name	Description
System.String	fileName	Specifies the file name to save the presentation.

Remarks

At present, the Essential Presentation library only supports the PPTX file format.

Examples

//Create an instance of presentation
Presentation presentation = Presentation.Create() as Presentation;
//Add slide to the presentation
ISlide slide = presentation.Slides.Add(SlideLayoutType.Blank);
//Add table to the slide
ITable table = slide.Shapes.AddTable(3, 3, 100, 120, 300, 200);
//Save the presentation
presentation.Save("Output.pptx");
//Close the presentation
presentation.Close();

'Create an instance of presentation
Dim presentation__1 As Presentation = TryCast(Presentation.Create(), Presentation)
'Add slide to the presentation
Dim slide As ISlide = presentation__1.Slides.Add(SlideLayoutType.Blank)
'Add table to the slide
Dim table As ITable = slide.Shapes.AddTable(3, 3, 100, 120, 300, 200)
'Save the presentation
presentation__1.Save("Output.pptx")
'Close the presentation
presentation__1.Close()

Save(String, FormatType, HttpResponse)

Saves the presentation to the specified HttpResponse instance.

Declaration

public void Save(string fileName, FormatType formatType, HttpResponse response)

Parameters

Type	Name	Description
System.String	fileName	The name of the file in HttpResponse.
FormatType	formatType	The format type of the presentation.
System.Web.HttpResponse	response	The HttpResponse to save the presentation.

Remarks

At present, the Essential Presentation library only supports the PPTX file format.

Examples

 //Create a presentation
 Presentation presentation = Presentation.Create() as Presentation;
 //Save the presentation to the specified HttpResponse
 presentation.Save("Sample.pptx", FormatType.Pptx, HttpContext.Current.Response);

'Create a presentation
Dim presentation__1 As Presentation = TryCast(Presentation.Create(), Presentation)
'Save the presentation to the specified HttpResponse
presentation__1.Save("Sample.pptx", FormatType.Pptx, Response)

SetWriteProtection(String)

Sets the write protection for the presentation instance

Declaration

public void SetWriteProtection(string password)

Parameters

Type	Name	Description
System.String	password	Password to enforce protection.

Remarks

Maximum length of password should be 15. If it exceeds 15, first 15 characters will be considered for protection, remaining will be ignored.

Examples

//Create an instance for presentation
IPresentation presentation = Presentation.Create();
//Add a new slide of comparison slide layout type.
ISlide slide = presentation.Slides.Add(SlideLayoutType.Comparison);            
//Add an auto shape of regular pentagon auto shape type.
slide.Shapes.AddShape(AutoShapeType.RegularPentagon, 10, 20, 300, 400);
//Set the write protection for Presentation instance with password.
presentation.SetWriteProtection("MYPASSWORD");
//Save the presentation
presentation.Save("Sample.pptx");
//Close the presentation.
presentation.Close();

'Create an instance for presentation
Dim presentation As IPresentation = Presentation.Create()
'Add a new slide of comparison slide layout type.
Dim slide As ISlide = presentation.Slides.Add(SlideLayoutType.Comparison)
'Add an auto shape of regular pentagon auto shape type.
slide.Shapes.AddShape(AutoShapeType.RegularPentagon, 10, 20, 300, 400)
'Set the write protection for Presentation instance with password.
presentation.SetWriteProtection("MYPASSWORD")
'Save the presentation
presentation.Save("Sample.pptx")
'Close the presentation.
presentation.Close()

Implements

IPresentation

System.IDisposable

WinForms- v19.1.0.54

Class Presentation

Inheritance

Implements

Inherited Members

Namespace: Syncfusion.Presentation

Assembly: Syncfusion.Presentation.Base.dll

Syntax

Properties

BuiltInDocumentProperties

Declaration

Property Value

Examples

ChartToImageConverter

Declaration

Property Value

Remarks

Examples

CustomDocumentProperties

Declaration

Property Value

Examples

Final

Declaration

Property Value

FontSettings

Declaration

Property Value

HasMacros

Declaration

Property Value

IsWriteProtected

Declaration

Property Value

Examples

Masters

Declaration

Property Value

Examples

Sections

Declaration

Property Value

Slides

Declaration

Property Value

Examples

SlideSize

Declaration

Property Value

Examples

Methods

Clone()

Declaration

Returns

Examples

Close()

Declaration

Examples

Create()

Declaration

Returns

Examples

Dispose()

Declaration

Encrypt(String)

Declaration

Parameters

Open(Stream)

Declaration

Parameters

Returns

Examples

Open(Stream, String)

Declaration

Parameters

Returns

Examples

Open(String)

Declaration

Parameters