Aspose.Slides for .NET 18.4 Release Notes

IMasterSlide ApplyExternalThemeToDependingSlides(string fname);

string pptxFileName = Path.Combine(baseDir, "SimplePresentation2.pptx");
string thmxFileName = Path.Combine(baseDir, "Theme1Word.thmx");
string outPptxFileName = Path.Combine(TestSettings.TestOutPath, "SimplePresentation2_out.pptx");

using (Presentation pres = new Presentation(pptxFileName))
{
  pres.Masters[0].ApplyExternalThemeToDependingSlides(thmxFileName);
  pres.Save(outPptxFileName, SaveFormat.Pptx);
}

PdfOptions options = new PdfOptions
{
  BestImagesCompressionRatio = true
};
using (Presentation pres = new Presentation("pres.pptx"))
{
  pres.Save("pres.pdf", SaveFormat.Pdf, options);
}

IMasterHandoutSlideHeaderFooterManager IMasterHandoutSlide.HeaderFooterManager { get; }
IMasterNotesSlideHeaderFooterManager IMasterNotesSlide.HeaderFooterManager { get; }
INotesSlideHeaderFooterManager INotesSlide.HeaderFooterManager { get; }

bool IsHeaderVisible { get; }

void SetHeaderVisibility(bool isVisible);

void SetHeaderText(string text);

void SetHeaderAndChildHeadersVisibility(bool isVisible);
void SetFooterAndChildFootersVisibility(bool isVisible);
void SetSlideNumberAndChildSlideNumbersVisibility(bool isVisible);
void SetDateTimeAndChildDateTimesVisibility(bool isVisible);

void SetHeaderAndChildHeadersText(string text);
void SetFooterAndChildFootersText(string text);
void SetDateTimeAndChildDateTimesText(string text);

void SetAllHeadersVisibility(bool isVisible);

void SetAllHeadersText(string text);

using (Presentation presentation = new Presentation(path + "presentation.pptx"))
{
  IMasterHandoutSlide masterHandoutSlide = presentation.MasterHandoutSlideManager.MasterHandoutSlide;
  if (masterHandoutSlide != null)
  {
    IBaseHandoutNotesSlideHeaderFooterManag headerFooterManager = masterHandoutSlide.HeaderFooterManager;
    if (!headerFooterManager.IsHeaderVisible)
      headerFooterManager.SetHeaderVisibility(true); // make the master handout slide Header placeholder visible
    
	if (!headerFooterManager.IsFooterVisible)
      headerFooterManager.SetFooterVisibility(true); // make the master handout slide Footer placeholder visible
	  
	if (!headerFooterManager.IsSlideNumberVisible)
	  headerFooterManager.SetSlideNumberVisibility(true); // make the master handout slide SlideNumber placeholder visible

    if (!headerFooterManager.IsDateTimeVisible)
	  headerFooterManager.SetDateTimeVisibility(true); // make the master handout slide Date-time placeholder visible

    headerFooterManager.SetHeaderText("New header text"); // set text to master handout slide Header placeholder
    headerFooterManager.SetFooterText("New footer text"); // set text to master handout slide Footer placeholder
	headerFooterManager.SetDateTimeText("New date and time text"); // set master handout to notes slide Date-time placeholder
  }
}

using (Presentation presentation = new Presentation(path + "presentation.pptx"))
{
  // Change Header and Footer settings for notes master and all notes slides
  IMasterNotesSlide masterNotesSlide = presentation.MasterNotesSlideManager.MasterNotesSlide;
  if (masterNotesSlide != null)
  {
    IMasterNotesSlideHeaderFooterManager headerFooterManager = masterNotesSlide.HeaderFooterManager;
	
	headerFooterManager.SetHeaderAndChildHeadersVisibility(true); // make the master notes slide and all child Footer placeholders visible
	headerFooterManager.SetFooterAndChildFootersVisibility(true); // make the master notes slide and all child Header placeholders visible
	headerFooterManager.SetSlideNumberAndChildSlideNumbersVisibility(true); // make the master notes slide and all child SlideNumber placeholders visible
	headerFooterManager.SetDateTimeAndChildDateTimesVisibility(true); // make the master notes slide and all child Date and time placeholders visible
	
	headerFooterManager.SetHeaderAndChildHeadersText("Header text"); // set text to master notes slide and all child Header placeholders
	headerFooterManager.SetFooterAndChildFootersText("Footer text"); // set text to master notes slide and all child Footer placeholders
	headerFooterManager.SetDateTimeAndChildDateTimesText("Date and time text"); // set text to master notes slide and all child Date and time placeholders
  }
  // Change Header and Footer settings for first notes slide only
  INotesSlide notesSlide = presentation.Slides[0].NotesSlideManager.NotesSlide;
  if (notesSlide != null)
  {
    INotesSlideHeaderFooterManager headerFooterManager = notesSlide.HeaderFooterManager;
	if (!headerFooterManager.IsHeaderVisible)
	  headerFooterManager.SetHeaderVisibility(true); // make this notes slide Header placeholder visible
	  
	if (!headerFooterManager.IsFooterVisible)
	  headerFooterManager.SetFooterVisibility(true); // make this notes slide Footer placeholder visible

    if (!headerFooterManager.IsSlideNumberVisible)
      headerFooterManager.SetSlideNumberVisibility(true); // make this notes slide SlideNumber placeholder visible

    if (!headerFooterManager.IsDateTimeVisible)
      headerFooterManager.SetDateTimeVisibility(true); // make this notes slide Date-time placeholder visible

	headerFooterManager.SetHeaderText("New header text"); // set text to notes slide Header placeholder
    headerFooterManager.SetFooterText("New footer text"); // set text to notes slide Footer placeholder
    headerFooterManager.SetDateTimeText("New date and time text"); // set text to notes slide Date-time placeholder
  }
}

static void Run(Action<InterruptionToken> action, InterruptionToken token)
{
  Task.Run(() => { action(token); });
}

static void Main()
{
  Action<InterruptionToken> action = (InterruptionToken token) =>
  {
    using (Presentation pres = new Presentation("pres.pptx", new LoadOptions { InterruptionToken = token }))
    {
      pres.Slides[0].GetThumbnail(new Size(960, 720));
      pres.Save("pres.ppt", SaveFormat.Ppt);
    }
  };
  
  InterruptionTokenSource tokenSource = new InterruptionTokenSource();
  Run(action, tokenSource.Token); // run action in a separate thread from the pool

  Thread.Sleep(5000); // some work

  tokenSource.Interrupt(); // we don't need the result of an interruptable action
}

public bool IsFooterVisible
public bool IsSlideNumberVisible
public bool IsDateTimeVisible

public void SetAllFootersVisibility(bool isVisible)
public void SetAllSlideNumbersVisibility(bool isVisible)
public void SetAllDateTimesVisibility(bool isVisible)

public void SetFooterText(string text)
public void SetDateTimeText(string date)
public void SetVisibilityOnTitleSlide(bool isPlaceholdersVisible)

public void SetAllFootersText(string text)
public void SetAllDateTimesText(string text)
public void SetVisibilityOnAllTitleSlides(bool isVisible)

using (Presentation pres = new Presentation(path + "presentation.pptx"))
{
  IOleObjectFrame ole = (IOleObjectFrame)pres.Slides[0].Shapes[0];
  IEffect effect = pres.Slides[0].Timeline.MainSequence.AddEffect(ole, EffectType.OLEObjectOpen, EffectSubtype.None, EffectTriggerType.OnClick);
  
  pres.Save(path + "presentation-out.pptx", SaveFormat.Pptx);
}
using (Presentation pres = new Presentation(path + "presentation-out.pptx"))
{
  IShape shape = pres.Slides[0].Shapes[0];
  IEffect[] effects = pres.Slides[0].Timeline.MainSequence.GetEffectsByShape(shape);
  
  if (effects.Length > 0 && effects[0].PresetClassType == EffectPresetClassType.OLEActionVerbs)
    Console.WriteLine("This shape has the OLE Action Verb effect");
}

using (Presentation pres = new Presentation("presentation.pptx"))
{
  IOleObjectFrame ole = (IOleObjectFrame)pres.Slides[0].Shapes[0];
  IEffect effect = pres.Slides[0].Timeline.MainSequence.AddEffect(ole, EffectType.OLEObjectOpen, EffectSubtype.None, EffectTriggerType.OnClick);
}

using (Presentation pres = new Presentation())
{
  ISmartArt smartArt = pres.Slides[0].Shapes.AddSmartArt(0, 0, 400, 400, SmartArtLayoutType.PictureOrganizationChart);
}

/// <summary>
/// Save presentation in PPS format.
/// </summary>
Pps = 19

IChartDataPoint AddDataPointForBoxAndWhiskerSeries(IChartDataCell value);

QuartileMethodType QuartileMethod { get; set; }

bool ShowInnerPoints { get; set; }

bool ShowMeanLine { get; set; }

bool ShowMeanMarkers { get; set; }

bool ShowOutlierPoints { get; set; }

using (Presentation pres = new Presentation())
{
  IChart chart = pres.Slides[0].Shapes.AddChart(ChartType.BoxAndWhisker, 50, 50, 500, 400);
  chart.ChartData.Categories.Clear();
  chart.ChartData.Series.Clear();
  
  IChartDataWorkbook wb = chart.ChartData.ChartDataWorkbook;
  
  wb.Clear(0);
  
  chart.ChartData.Categories.Add(wb.GetCell(0, "A1", "Category 1"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A2", "Category 1"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A3", "Category 1"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A4", "Category 1"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A5", "Category 1"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A6", "Category 1"));
  
  IChartSeries series = chart.ChartData.Series.Add(ChartType.BoxAndWhisker);
  
  series.QuartileMethod = QuartileMethodType.Exclusive;
  series.ShowMeanLine = true;
  series.ShowMeanMarkers = true;
  series.ShowInnerPoints = true;
  series.ShowOutlierPoints = true;
  
  series.DataPoints.AddDataPointForBoxAndWhiskerSeries(wb.GetCell(0, "B1", 15));
  series.DataPoints.AddDataPointForBoxAndWhiskerSeries(wb.GetCell(0, "B2", 41));
  series.DataPoints.AddDataPointForBoxAndWhiskerSeries(wb.GetCell(0, "B3", 16));
  series.DataPoints.AddDataPointForBoxAndWhiskerSeries(wb.GetCell(0, "B4", 10));
  series.DataPoints.AddDataPointForBoxAndWhiskerSeries(wb.GetCell(0, "B5", 23));
  series.DataPoints.AddDataPointForBoxAndWhiskerSeries(wb.GetCell(0, "B6", 16));
  
  pres.Save("BoxAndWhisker.pptx", SaveFormat.Pptx);
}

using (Presentation pres = new Presentation())
{
  IChart chart = pres.Slides[0].Shapes.AddChart(ChartType.Funnel, 50, 50, 500, 400);
  chart.ChartData.Categories.Clear();
  chart.ChartData.Series.Clear();

  IChartDataWorkbook wb = chart.ChartData.ChartDataWorkbook;

  wb.Clear(0);

  chart.ChartData.Categories.Add(wb.GetCell(0, "A1", "Category 1"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A2", "Category 2"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A3", "Category 3"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A4", "Category 4"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A5", "Category 5"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A6", "Category 6"));

  IChartSeries series = chart.ChartData.Series.Add(ChartType.Funnel);

  series.DataPoints.AddDataPointForFunnelSeries(wb.GetCell(0, "B1", 50));
  series.DataPoints.AddDataPointForFunnelSeries(wb.GetCell(0, "B2", 100));
  series.DataPoints.AddDataPointForFunnelSeries(wb.GetCell(0, "B3", 200));
  series.DataPoints.AddDataPointForFunnelSeries(wb.GetCell(0, "B4", 300));
  series.DataPoints.AddDataPointForFunnelSeries(wb.GetCell(0, "B5", 400));
  series.DataPoints.AddDataPointForFunnelSeries(wb.GetCell(0, "B6", 500));

  pres.Save("Funnel.pptx", SaveFormat.Pptx)
}

AxisAggregationType AggregationType { get; set; }

double BinWidth { get; set; }

bool IsAutomaticOverflowBin { get; set; }

bool IsAutomaticUnderflowBin { get; set; }

bool IsOverflowBin { get; set; }

bool IsUnderflowBin { get; set; }

uint NumberOfBins { get; set; }

double OverflowBin { get; set; }

double UnderflowBin { get; set; }

using (Presentation pres = new Presentation())
{
  IChart chart = pres.Slides[0].Shapes.AddChart(ChartType.Histogram, 50, 50, 500, 400);
  chart.ChartData.Categories.Clear();
  chart.ChartData.Series.Clear();

  IChartDataWorkbook wb = chart.ChartData.ChartDataWorkbook;

  wb.Clear(0);

  IChartSeries series = chart.ChartData.Series.Add(ChartType.Histogram);
  series.DataPoints.AddDataPointForHistogramSeries(wb.GetCell(0, "A1", 15));
  series.DataPoints.AddDataPointForHistogramSeries(wb.GetCell(0, "A2", -41));
  series.DataPoints.AddDataPointForHistogramSeries(wb.GetCell(0, "A3", 16));
  series.DataPoints.AddDataPointForHistogramSeries(wb.GetCell(0, "A4", 10));
  series.DataPoints.AddDataPointForHistogramSeries(wb.GetCell(0, "A5", -23));
  series.DataPoints.AddDataPointForHistogramSeries(wb.GetCell(0, "A6", 16));

  chart.Axes.HorizontalAxis.AggregationType = AxisAggregationType.Automatic;

  pres.Save("Histogram.pptx", SaveFormat.Pptx);
}

using (Presentation pres = new Presentation())
{
  IChart chart = pres.Slides[0].Shapes.AddChart(ChartType.Histogram, 50, 50, 500, 400);
  
  chart.ChartData.Series.Add(ChartType.ParetoLine);
  
  chart.Axes.SecondaryVerticalAxis.NumberFormat = "0%";
  chart.Axes.SecondaryVerticalAxis.MaxValue = 1;
  chart.Axes.SecondaryVerticalAxis.IsAutomaticMaxValue = false;

  pres.Save("HistogramPareto.pptx", SaveFormat.Pptx);
}

IDoubleChartValue SizeValue { get; }

using (Presentation pres = new Presentation())
{
  IChart chart = pres.Slides[0].Shapes.AddChart(ChartType.Sunburst, 50, 50, 500, 400);
  chart.ChartData.Categories.Clear();
  chart.ChartData.Series.Clear();

  IChartDataWorkbook wb = chart.ChartData.ChartDataWorkbook;

  wb.Clear(0);

  //branch 1
  IChartCategory leaf = chart.ChartData.Categories.Add(wb.GetCell(0, "C1", "Leaf1"));
  leaf.GroupingLevels.SetGroupingItem(1, "Stem1");
  leaf.GroupingLevels.SetGroupingItem(2, "Branch1");

  chart.ChartData.Categories.Add(wb.GetCell(0, "C2", "Leaf2"));
  
  leaf = chart.ChartData.Categories.Add(wb.GetCell(0, "C3", "Leaf3"));
  leaf.GroupingLevels.SetGroupingItem(1, "Stem2");

  chart.ChartData.Categories.Add(wb.GetCell(0, "C4", "Leaf4"));

  //branch 2
  leaf = chart.ChartData.Categories.Add(wb.GetCell(0, "C5", "Leaf5"));
  leaf.GroupingLevels.SetGroupingItem(1, "Stem3");
  leaf.GroupingLevels.SetGroupingItem(2, "Branch2");

  chart.ChartData.Categories.Add(wb.GetCell(0, "C6", "Leaf6"));

  leaf = chart.ChartData.Categories.Add(wb.GetCell(0, "C7", "Leaf7"));
  leaf.GroupingLevels.SetGroupingItem(1, "Stem4");

  chart.ChartData.Categories.Add(wb.GetCell(0, "C8", "Leaf8"));

  IChartSeries series = chart.ChartData.Series.Add(ChartType.Sunburst);
  series.Labels.DefaultDataLabelFormat.ShowCategoryName = true;
  series.DataPoints.AddDataPointForSunburstSeries(wb.GetCell(0, "D1", 4));
  series.DataPoints.AddDataPointForSunburstSeries(wb.GetCell(0, "D2", 5));
  series.DataPoints.AddDataPointForSunburstSeries(wb.GetCell(0, "D3", 3));
  series.DataPoints.AddDataPointForSunburstSeries(wb.GetCell(0, "D4", 6));
  series.DataPoints.AddDataPointForSunburstSeries(wb.GetCell(0, "D5", 9));
  series.DataPoints.AddDataPointForSunburstSeries(wb.GetCell(0, "D6", 9));
  series.DataPoints.AddDataPointForSunburstSeries(wb.GetCell(0, "D7", 4));
  series.DataPoints.AddDataPointForSunburstSeries(wb.GetCell(0, "D8", 3));

  pres.Save("Sunburst.pptx", SaveFormat.Pptx);
}

IDoubleChartValue SizeValue { get; }

ParentLabelLayoutType ParentLabelLayout { get; set; }

IChartDataPoint AddDataPointForTreemapSeries(IChartDataCell sizeValue);

using (Presentation pres = new Presentation())
{
  IChart chart = pres.Slides[0].Shapes.AddChart(ChartType.Treemap, 50, 50, 500, 400);
  chart.ChartData.Categories.Clear();
  chart.ChartData.Series.Clear();

  IChartDataWorkbook wb = chart.ChartData.ChartDataWorkbook;
  wb.Clear(0);

  //branch 1
  IChartCategory leaf = chart.ChartData.Categories.Add(wb.GetCell(0, "C1", "Leaf1"));
  leaf.GroupingLevels.SetGroupingItem(1, "Stem1");
  leaf.GroupingLevels.SetGroupingItem(2, "Branch1");

  chart.ChartData.Categories.Add(wb.GetCell(0, "C2", "Leaf2"));

  leaf = chart.ChartData.Categories.Add(wb.GetCell(0, "C3", "Leaf3"));
  leaf.GroupingLevels.SetGroupingItem(1, "Stem2");

  chart.ChartData.Categories.Add(wb.GetCell(0, "C4", "Leaf4"));

  //branch 2
  leaf = chart.ChartData.Categories.Add(wb.GetCell(0, "C5", "Leaf5"));
  leaf.GroupingLevels.SetGroupingItem(1, "Stem3");
  leaf.GroupingLevels.SetGroupingItem(2, "Branch2");
  
  chart.ChartData.Categories.Add(wb.GetCell(0, "C6", "Leaf6"));
  
  leaf = chart.ChartData.Categories.Add(wb.GetCell(0, "C7", "Leaf7"));
  leaf.GroupingLevels.SetGroupingItem(1, "Stem4");

  chart.ChartData.Categories.Add(wb.GetCell(0, "C8", "Leaf8"));

  IChartSeries series = chart.ChartData.Series.Add(ChartType.Treemap);
  series.Labels.DefaultDataLabelFormat.ShowCategoryName = true;
  series.DataPoints.AddDataPointForTreemapSeries(wb.GetCell(0, "D1", 4));
  series.DataPoints.AddDataPointForTreemapSeries(wb.GetCell(0, "D2", 5));
  series.DataPoints.AddDataPointForTreemapSeries(wb.GetCell(0, "D3", 3));
  series.DataPoints.AddDataPointForTreemapSeries(wb.GetCell(0, "D4", 6));
  series.DataPoints.AddDataPointForTreemapSeries(wb.GetCell(0, "D5", 9));
  series.DataPoints.AddDataPointForTreemapSeries(wb.GetCell(0, "D6", 9));
  series.DataPoints.AddDataPointForTreemapSeries(wb.GetCell(0, "D7", 4));
  series.DataPoints.AddDataPointForTreemapSeries(wb.GetCell(0, "D8", 3));
  series.ParentLabelLayout = ParentLabelLayoutType.Overlapping;
  
  pres.Save("Treemap.pptx", SaveFormat.Pptx);
}

bool SetAsTotal { get; set; }

bool ShowConnectorLines { get; set; }

IChartDataPoint AddDataPointForWaterfallSeries(IChartDataCell value);

using (Presentation pres = new Presentation())
{
  IChart chart = pres.Slides[0].Shapes.AddChart(ChartType.Waterfall, 50, 50, 500, 400);
  chart.ChartData.Categories.Clear();
  chart.ChartData.Series.Clear();

  IChartDataWorkbook wb = chart.ChartData.ChartDataWorkbook;

  wb.Clear(0);

  chart.ChartData.Categories.Add(wb.GetCell(0, "A1", "Category 1"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A2", "Category 2"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A3", "Category 3"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A4", "Category 4"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A5", "Category 5"));
  chart.ChartData.Categories.Add(wb.GetCell(0, "A6", "Category 6"));
  
  IChartSeries series = chart.ChartData.Series.Add(ChartType.Waterfall);
  series.Labels.DefaultDataLabelFormat.ShowValue = true;
  series.DataPoints.AddDataPointForWaterfallSeries(wb.GetCell(0, "B1", 15));
  series.DataPoints.AddDataPointForWaterfallSeries(wb.GetCell(0, "B2", -41));
  series.DataPoints.AddDataPointForWaterfallSeries(wb.GetCell(0, "B3", 16));
  series.DataPoints.AddDataPointForWaterfallSeries(wb.GetCell(0, "B4", 10));
  series.DataPoints.AddDataPointForWaterfallSeries(wb.GetCell(0, "B5", -23));
  series.DataPoints.AddDataPointForWaterfallSeries(wb.GetCell(0, "B6", 16));
  
  series.DataPoints[5].SetAsTotal = true;
  
  series.ShowConnectorLines = false;

  pres.Save("Waterfall.pptx", SaveFormat.Pptx);
}

void WriteAsSvg(Stream stream);
void WriteAsSvg(Stream stream, ISVGOptions svgOptions);

string pptxFileName = "Presentation.pptx";
string outSvgFileName = "SingleShape.svg";
using (Presentation pres = new Presentation(pptxFileName))
{
  using (Stream stream = new FileStream(outSvgFileName, FileMode.Create, FileAccess.Write))
  {
    pres.Slides[0].Shapes[0].WriteAsSvg(stream);
  }
}