Aspose.Slides for .NET 19.8 Release Notes

using (Presentation pres = new Presentation("MyPresentation.pptx"))
{
    IAutoShape shape = pres.Slides[0].Shapes[0] as IAutoShape;
    ITextFrameFormat localTextFrameFormat = shape.TextFrame.TextFrameFormat;
    ITextFrameFormatEffectiveData effectiveTextFrameFormat = localTextFrameFormat.GetEffective();
    IPortionFormat localPortionFormat = shape.TextFrame.Paragraphs[0].Portions[0].PortionFormat;
    IPortionFormatEffectiveData effectivePortionFormat = localPortionFormat.GetEffective();
}

using (Presentation pres = new Presentation())
{
    IAutoShape newShape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 400, 75, false);
    newShape.AddTextFrame("");
    newShape.TextFrame.Paragraphs[0].Portions.Clear();

    IPortion portion0 = new Portion("Sample text with first portion");
    IPortion portion1 = new Portion(" and second portion.");

    newShape.TextFrame.Paragraphs[0].Portions.Add(portion0);
    newShape.TextFrame.Paragraphs[0].Portions.Add(portion1);

    Console.WriteLine("Effective font height just after creation:");
    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);
    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);

    pres.DefaultTextStyle.GetLevel(0).DefaultPortionFormat.FontHeight = 24;
    Console.WriteLine("Effective font height after setting entire presentation default font height:");
    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);
    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);

    newShape.TextFrame.Paragraphs[0].ParagraphFormat.DefaultPortionFormat.FontHeight = 40;
    Console.WriteLine("Effective font height after setting paragraph default font height:");
    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);
    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);

    newShape.TextFrame.Paragraphs[0].Portions[0].PortionFormat.FontHeight = 55;
    Console.WriteLine("Effective font height after setting portion #0 font height:");
    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);
    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);

    newShape.TextFrame.Paragraphs[0].Portions[1].PortionFormat.FontHeight = 18;
    Console.WriteLine("Effective font height after setting portion #1 font height:");
    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);
    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);
}

// Output:
// Effective font height just after creation:
// Portion #0: 18
// Portion #1: 18
// Effective font height after setting entire presentation default font height:
// Portion #0: 24
// Portion #1: 24
// Effective font height after setting paragraph default font height:
// Portion #0: 40
// Portion #1: 40
// Effective font height after setting portion #0 font height:
// Portion #0: 55
// Portion #1: 40
// Effective font height after setting portion #1 font height:
// Portion #0: 55
// Portion #1: 18

using (Presentation pres = new Presentation(@"MyPresentation.pptx"))
{
    IThreeDFormatEffectiveData threeDEffectiveData = pres.Slides[0].Shapes[0].ThreeDFormat.GetEffective();
	
    Console.WriteLine("= Effective camera properties =");
    Console.WriteLine("Type: " + threeDEffectiveData.Camera.CameraType);
    Console.WriteLine("Field of view: " + threeDEffectiveData.Camera.FieldOfViewAngle);
    Console.WriteLine("Zoom: " + threeDEffectiveData.Camera.Zoom);

    Console.WriteLine("= Effective light rig properties =");
    Console.WriteLine("Type: " + threeDEffectiveData.LightRig.LightType);
    Console.WriteLine("Direction: " + threeDEffectiveData.LightRig.Direction);

    Console.WriteLine("= Effective shape's top face relief properties =");
    Console.WriteLine("Type: " + threeDEffectiveData.BevelTop.BevelType);
    Console.WriteLine("Width: " + threeDEffectiveData.BevelTop.Width);
    Console.WriteLine("Height: " + threeDEffectiveData.BevelTop.Height);
}

/// <summary>
/// Base interface for immutable objects which contain effective table formatting properties.
/// </summary>
public interface IBaseTableFormatEffectiveData
{
    /// <summary>
    /// Returns fill format effective value.
    /// Read-only <see cref="IFillFormatEffectiveData"/>.
    /// </summary>
    IFillFormatEffectiveData FillFormat { get; }
	
    /// <summary>
    /// Returns left border line format effective value.
    /// Read-only <see cref="ILineFormatEffectiveData"/>.
    /// </summary>
    ILineFormatEffectiveData BorderLeft { get; }

    /// <summary>
    /// Returns top border line format effective value.
    /// Read-only <see cref="ILineFormatEffectiveData"/>.
    /// </summary>
    ILineFormatEffectiveData BorderTop { get; }

    /// <summary>
    /// Returns right border line format effective value.
    /// Read-only <see cref="ILineFormatEffectiveData"/>.
    /// </summary>
    ILineFormatEffectiveData BorderRight { get; }

    /// <summary>
    /// Returns bottom border line format effective value.
    /// Read-only <see cref="ILineFormatEffectiveData"/>.
    /// </summary>
    ILineFormatEffectiveData BorderBottom { get; }

    /// <summary>
    /// Returns down diagonal line format effective value.
    /// Read-only <see cref="ILineFormatEffectiveData"/>.
    /// </summary>
    ILineFormatEffectiveData BorderDiagonalDown { get; }

    /// <summary>
    /// Returns up diagonal line format effective value.
    /// Read-only <see cref="ILineFormatEffectiveData"/>.
    /// </summary>
    ILineFormatEffectiveData BorderDiagonalUp { get; }
}

/// <summary>
/// Immutable object which contains effective table formatting properties.
/// </summary>
public interface ITableFormatEffectiveData : IBaseTableFormatEffectiveData
{
}

/// <summary>
/// Immutable object which contains effective table row formatting properties.
/// </summary>
public interface IRowFormatEffectiveData : IBaseTableFormatEffectiveData
{
}

/// <summary>
/// Immutable object which contains effective table column formatting properties.
/// </summary>
public interface IColumnFormatEffectiveData : IBaseTableFormatEffectiveData
{
}

/// <summary>
/// Immutable object which contains effective table cell formatting properties.
/// </summary>
public interface ICellFormatEffectiveData : IBaseTableFormatEffectiveData
{
}

using (Presentation pres = new Presentation(@"MyPresentation.pptx"))
{
    ITable tbl = pres.Slides[0].Shapes[0] as ITable;
    ITableFormatEffectiveData tableFormatEffective = tbl.TableFormat.GetEffective();
    IRowFormatEffectiveData rowFormatEffective = tbl.Rows[0].RowFormat.GetEffective();
    IColumnFormatEffectiveData columnFormatEffective = tbl.Columns[0].ColumnFormat.GetEffective();
    ICellFormatEffectiveData cellFormatEffective = tbl[0, 0].CellFormat.GetEffective();
    
	IFillFormatEffectiveData tableFillFormatEffective = tableFormatEffective.FillFormat;
    IFillFormatEffectiveData rowFillFormatEffective = rowFormatEffective.FillFormat;
    IFillFormatEffectiveData columnFillFormatEffective = columnFormatEffective.FillFormat;
    IFillFormatEffectiveData cellFillFormatEffective = cellFormatEffective.FillFormat;
    /* Output and comparison */
}

using (Presentation pres = new Presentation(@"MyPresentation.pptx"))
{
    IAutoShape shape = pres.Slides[0].Shapes[0] as IAutoShape;
    ITextStyleEffectiveData effectiveTextStyle = shape.TextFrame.TextFrameFormat.TextStyle.GetEffective();
	
    for (int i = 0; i <= 8; i++)
    {
        IParagraphFormatEffectiveData effectiveStyleLevel = effectiveTextStyle.GetLevel(i);
        Console.WriteLine("= Effective paragraph formatting for style level #" + i + " =");

        Console.WriteLine("Depth: " + effectiveStyleLevel.Depth);
        Console.WriteLine("Indent: " + effectiveStyleLevel.Indent);
        Console.WriteLine("Alignment: " + effectiveStyleLevel.Alignment);
        Console.WriteLine("Font alignment: " + effectiveStyleLevel.FontAlignment);
    }
}

/// <summary>
/// Returns the CellFormat object that contains formatting properties for this cell.
/// Read-only <see cref="ICellFormat"/>.
/// </summary>
ICellFormat CellFormat { get; }

/// <summary>
/// Represents format of a table cell.
/// </summary>
public interface ICellFormat
{
    /// <summary>
    /// Returns a cell fill properties object.
    /// Read-only <see cref="IFillFormat"/>.
    /// </summary>
    IFillFormat FillFormat { get; }

    /// <summary>
    /// Returns a left border line properties object.
    /// Read-only <see cref="ILineFormat"/>.
    /// </summary>
    ILineFormat BorderLeft { get; }

    /// <summary>
    /// Returns a top border line properties object.
    /// Read-only <see cref="ILineFormat"/>.
    /// </summary>
    ILineFormat BorderTop { get; }

    /// <summary>
    /// Returns a right border line properties object.
    /// Read-only <see cref="ILineFormat"/>.
    /// </summary>
    ILineFormat BorderRight { get; }

    /// <summary>
    /// Returns a bottom border line properties object.
    /// Read-only <see cref="ILineFormat"/>.
    /// </summary>
    ILineFormat BorderBottom { get; }

    /// <summary>
    /// Returns a top-left to bottom-right diagonal line properties object.
    /// Read-only <see cref="ILineFormat"/>.
    /// </summary>
    ILineFormat BorderDiagonalDown { get; }

    /// <summary>
    /// Returns a bottom-left to top-right diagonal line properties object.
    /// Read-only <see cref="ILineFormat"/>.
    /// </summary>
    ILineFormat BorderDiagonalUp { get; }

    /// <summary>
    /// Gets effective table cell formatting properties with inheritance and table styles applied.
    /// </summary>
    /// <returns>A <see cref="ICellFormatEffectiveData"/>.</returns>
    ICellFormatEffectiveData GetEffective();
}

/// <summary>
/// Returns the ColumnFormat object that contains formatting properties for this column.
/// Read-only <see cref="IColumnFormat"/>.
/// </summary>
IColumnFormat ColumnFormat{ get; }

/// <summary>
/// Represents format of a table column.
/// </summary>
public interface IColumnFormat
{
    /// <summary>
    /// Gets effective table column formatting properties with inheritance and table styles applied.
    /// </summary>
    /// <returns>A <see cref="IColumnFormatEffectiveData"/>.</returns>
    IColumnFormatEffectiveData GetEffective();
}

/// <summary>
/// Represents format of a table row.
/// </summary>
public interface IRowFormat
{
    /// <summary>
    /// Gets effective table row formatting properties with inheritance and table styles applied.
    /// </summary>
    /// <returns>A <see cref="IRowFormatEffectiveData"/>.</returns>
    IRowFormatEffectiveData GetEffective();
}

/// <summary>
/// Returns the RowFormat object that contains formatting properties for this row.
/// Read-only <see cref="IRowFormat"/>.
/// </summary>
IRowFormat RowFormat { get; }

/// <summary>
/// Represents format of a table.
/// </summary>
public interface ITableFormat
{
    /// <summary>
    /// Returns a table fill properties object.
    /// Read-only <see cref="IFillFormat"/>.
    /// </summary>
    IFillFormat FillFormat { get; }

    /// <summary>
    /// Gets effective table formatting properties with inheritance and table styles applied.
    /// </summary>
    /// <returns>A <see cref="ITableFormatEffectiveData"/>.</returns>
    ITableFormatEffectiveData GetEffective();
}

/// <summary>
/// Returns the TableFormat object that contains formatting properties for this table.
/// Read-only <see cref="ITableFormat"/>.
/// </summary>
ITableFormat TableFormat { get; }

/// <summary>
/// Represents embedded data info for OLE object.
/// </summary>
public interface IOleEmbeddedDataInfo
{
       /// <summary>
       /// Returns the file data of embedded OLE object
       /// Read only <see cref="T:byte[]"/>.
       /// </summary>
       byte[] EmbeddedFileData { get; }

       /// <summary>
       /// Returns the file extension for the current embedded OLE object
       /// Read only <see cref="string"/>.
       /// </summary>
       string EmbeddedFileExtension { get; }
}

/// <summary>
/// Adds a new OLE object to the end of a collection.
/// </summary>
/// <param name="x">X coordinate of a new OLE frame.</param>
/// <param name="y">Y coordinate of a new OLE frame.</param>
/// <param name="width">Width of a new OLE frame.</param>
/// <param name="height">Height of a new OLE frame.</param>
/// <param name="dataInfo">Embedded data info <see cref="IOleEmbeddedDataInfo"/>.</param>
/// <returns>Created OLE object.</returns>
IOleObjectFrame AddOleObjectFrame(float x, float y, float width, float height, IOleEmbeddedDataInfo dataInfo);

/// <summary>
/// Creates a new OLE object and inserts it to a collection at the specified index.
/// </summary>
/// <param name="index">The zero-based index at which OLE object should be inserted.</param>
/// <param name="x">X coordinate of a new OLE frame.</param>
/// <param name="y">Y coordinate of a new OLE frame.</param>
/// <param name="width">Width of a new OLE frame.</param>
/// <param name="height">Height of a new OLE frame.</param>
/// <param name="dataInfo">Embedded data info <see cref="IOleEmbeddedDataInfo"/>.</param>
/// <returns>Created OLE object.</returns>
IOleObjectFrame InsertOleObjectFrame(int index, float x, float y, float width, float height, IOleEmbeddedDataInfo dataInfo);

using (Presentation pres = new Presentation())
{
    // Add known Ole objects
    byte[] fileBytes = File.ReadAllBytes("test.zip");
	
    // Create Ole embedded file info
    IOleEmbeddedDataInfo dataInfo = new OleEmbeddedDataInfo(fileBytes, "zip");
    
	// Create OLE object
    IOleObjectFrame oleFrame = pres.Slides[0].Shapes.AddOleObjectFrame(150, 20, 50, 50, dataInfo);
    oleFrame.IsObjectIcon = true;
}

IOleObjectFrame AddOleObjectFrame(float x, float y, float width, float height, string className, byte[] objectData);

IOleObjectFrame InsertOleObjectFrame(int index, float x, float y, float width, float height, string className, byte[] objectData);

/// <summary>
/// Specifies the method used to store properties of the ActiveX control.
/// </summary>
public enum PersistenceType
{
   /// <summary>
   /// Persistance id not specified.
   /// </summary>
   NotDefined = -1,

   ///<summary>
   /// Specifies that the ActiveX control is persisted using property-bag-based persistence. 
   /// Property-bag-based persistence stores an ActiveX control by means of a collection of name 
   /// and value pairs which specify the data persisted by the ActiveX control.
   ///</summary>
   PersistPropertyBag,

   ///<summary>
   /// Specifies that the ActiveX control is persisted using a stream-based persistence 
   /// that does not support initialization of the ActiveX control to a default state.
   ///</summary>
   PersistStream,

   ///<summary>
   /// Specifies that the ActiveX control is persisted using a stream-based persistence 
   /// that supports initialization of the ActiveX control to a default state.
   ///</summary>
   PersistStreamInit,

   ///<summary>
   /// Specifies that the ActiveX control is persisted using storage-based persistence.
   ///</summary>
   PersistStorage
}

/// <summary>
/// Gets the method used to store properties of the ActiveX control.
/// Read only <see cref="PersistenceType"/>.
/// </summary>
PersistenceType Persistence { get; }

/// <summary>
/// Specifies the persistence of an ActiveX control when the method used to persist is either PersistStream, PersistStreamInit or PersistStorage.
/// </summary>
byte[] ActiveXControlBinary { get; }

switch (control.Persistence)
{
        case PersistenceType.PersistPropertyBag:
               control.Properties["Value"] = value;
                break;
        case PersistenceType.PersistStorage:
              ManagePersistStorage_UserMethod(control.ActiveXControlBinary);
                break;
        case PersistenceType.PersistStream:
               ManagePersistStream_UserMethod(control.ActiveXControlBinary);
                break;
        case PersistenceType.PersistStreamInit:
               ManagePersistStreamInit_UserMethod(control.ActiveXControlBinary);
                break;
}

using (Presentation presentation = new Presentation())
{
   ISlide slide = presentation.Slides[0];
   IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 100, 600, 400);
   
   chart.PlotArea.AsILayoutable.X = 0.2f;
   chart.PlotArea.AsILayoutable.Y = 0.2f;
   chart.PlotArea.AsILayoutable.Width = 0.7f;
   chart.PlotArea.AsILayoutable.Height = 0.7f;
   
   chart.PlotArea.LayoutTargetType = LayoutTargetType.Inner;
   ...
}