Aspose.Slides for .NET一種獨(dú)特的表示處理API，使應(yīng)用程序能夠讀取，編寫，修改和轉(zhuǎn)換PowerPoint演示文稿。支持大多數(shù)Microsoft PowerPoint格式進(jìn)行處理和操作。此外，API提供了許多高級(jí)功能，例如打印和渲染演示幻燈片到固定布局格式，HTML和圖像。

Aspose.Slides for .NET更新至v19.5，開(kāi)始評(píng)估PDF轉(zhuǎn)換的時(shí)間花費(fèi)，新增支持將SVG圖像轉(zhuǎn)換為形狀！

【下載Aspose.Slides for .NET最新試用版】

具體更新內(nèi)容

更多更新細(xì)則請(qǐng)參考：【Aspose.Slides for .NET v19.5更新說(shuō)明】

公共API更改

▲添加了IComment.ParentComment屬性

新的屬性ParentComment添加到IComment接口和Comment類中。它允許獲取或設(shè)置父注釋，從而以注釋和回復(fù)的層次結(jié)構(gòu)的形式創(chuàng)建對(duì)話框。

注意：如果設(shè)置ParentComment導(dǎo)致循環(huán)引用，則會(huì)拋出類型為PptxEditException的異常。

下面的代碼段顯示了添加一些注釋和一些回復(fù)的示例：

using (Presentation pres = new Presentation())
{
    // Add comment
    ICommentAuthor author1 = pres.CommentAuthors.AddAuthor("Author_1", "A.A.");
    IComment comment1 = author1.Comments.AddComment("comment1", pres.Slides[0], new PointF(10, 10), DateTime.Now);
  
    // Add reply for comment1
    ICommentAuthor author2 = pres.CommentAuthors.AddAuthor("Autror_2", "B.B.");
    IComment reply1 = author2.Comments.AddComment("reply 1 for comment 1", pres.Slides[0], new PointF(10, 10), DateTime.Now);
    reply1.ParentComment = comment1;
  
    // Add reply for comment1
    IComment reply2 = author2.Comments.AddComment("reply 2 for comment 1", pres.Slides[0], new PointF(10, 10), DateTime.Now);
    reply2.ParentComment = comment1;
  
    // Add reply to reply
    IComment subReply = author1.Comments.AddComment("subreply 3 for reply 2", pres.Slides[0], new PointF(10, 10), DateTime.Now);
    subReply.ParentComment = reply2;
  
    IComment comment2 = author2.Comments.AddComment("comment 2", pres.Slides[0], new PointF(10, 10), DateTime.Now);
    IComment comment3 = author2.Comments.AddComment("comment 3", pres.Slides[0], new PointF(10, 10), DateTime.Now);
  
    IComment reply3 = author1.Comments.AddComment("reply 4 for comment 3", pres.Slides[0], new PointF(10, 10), DateTime.Now);
    reply3.ParentComment = comment3;
  
    // Display hierarchy on console
    ISlide slide = pres.Slides[0];
    var comments = slide.GetSlideComments(null);
    for (int i = 0; i < comments.Length; i++)
    {
        IComment comment = comments[i];
        while (comment.ParentComment != null)
        {
            Console.Write("\t");
            comment = comment.ParentComment;
        }
  
        Console.Write("{0} : {1}", comments[i].Author.Name, comments[i].Text);
        Console.WriteLine();
    }
  
    // Remove comment1 and all its replies
    comment1.Remove();
}

▲添加了IViewProperties.NormalViewProperties，INormalViewRestoredProperties和相關(guān)成員，以提供對(duì)演示文稿的“常規(guī)視圖屬性”的訪問(wèn)。

普通視圖由三個(gè)內(nèi)容區(qū)域組成：幻燈片本身，側(cè)面內(nèi)容區(qū)域和底部?jī)?nèi)容區(qū)域。此信息允許應(yīng)用程序?qū)⑵湟晥D狀態(tài)保存到文件中，以便在重新打開(kāi)時(shí)視圖處于與上次保存演示文稿時(shí)相同的狀態(tài)。添加了屬性IViewProperties.NormalViewProperties以提供對(duì)演示文稿的普通視圖屬性的訪問(wèn)。添加了INormalViewProperties，INormalViewRestoredProperties 接口及其后代 SplitterBarStateType枚舉。

INormalViewProperties

• 屬性ShowOutlineIcons指定在正常視圖模式的任何內(nèi)容區(qū)域中顯示大綱內(nèi)容時(shí)應(yīng)用程序是否應(yīng)顯示圖標(biāo)。
• 屬性SnapVerticalSplitter指定當(dāng)側(cè)面區(qū)域足夠小時(shí)，垂直分割器是否應(yīng)捕捉到最小化狀態(tài)。
• 屬性PreferSingleView指定用戶是否更喜歡在具有三個(gè)內(nèi)容區(qū)域的標(biāo)準(zhǔn)普通視圖上看到全窗口單內(nèi)容區(qū)域。如果啟用，則應(yīng)用程序可以選擇在整個(gè)窗口中顯示一個(gè)內(nèi)容區(qū)域。
• 屬性VerticalBarState和HorizontalBarState指定應(yīng)顯示水平或垂直分割條的狀態(tài)。水平分割條將幻燈片與幻燈片下方的內(nèi)容區(qū)域分開(kāi)，垂直分割條將幻燈片與邊內(nèi)容區(qū)域分開(kāi)。
• 屬性SnapVerticalSplitter指定當(dāng)側(cè)面區(qū)域足夠小時(shí)，垂直分割器是否應(yīng)捕捉到最小化狀態(tài)。
• 屬性RestoredLeft和RestoredTop指定正常視圖的頂部或側(cè)面幻燈片區(qū)域的大小，當(dāng)SplitterBarStateType.Restored值相應(yīng)地應(yīng)用于  VerticalBarState  和  HorizontalBarState*.*時(shí)

INormalViewRestoredProperties

• 屬性DimensionSize   指定幻燈片區(qū)域的大小（restoredTop的子節(jié)點(diǎn)的寬度，restoredLeft的子節(jié)點(diǎn)的高度）。
• 屬性AutoAdjust指定在調(diào)整應(yīng)用程序中包含視圖的窗口大小時(shí)，旁邊內(nèi)容區(qū)域的大小是否應(yīng)該補(bǔ)償新大小。

using (Presentation pres = new Presentation())
{
    pres.ViewProperties.NormalViewProperties.HorizontalBarState = SplitterBarStateType.Restored;
    pres.ViewProperties.NormalViewProperties.VerticalBarState = SplitterBarStateType.Maximized;
  
    pres.ViewProperties.NormalViewProperties.RestoredTop.AutoAdjust = true;
    pres.ViewProperties.NormalViewProperties.RestoredTop.DimensionSize = 80;
    pres.ViewProperties.NormalViewProperties.ShowOutlineIcons = true;
  
    pres.Save("presentation.pptx", SaveFormat.Pptx);
}

▲添加了新的IOleObjectFrame .SubstitutePictureTitle屬性

新屬性SubstitutePictureTitle添加到IOleObjectFrame接口和OleObjectFrame類中。它允許獲取，設(shè)置或更改OLE圖標(biāo)的標(biāo)題：

////// Returns or set the title for OleObject icon.
/// Read/write.
///////// When IsObjectIcon == false this value is ignored.
/// The string can be truncated according to the size of the Ole icon.
///string SubstitutePictureTitle { get; set; }

下面的代碼片段顯示了創(chuàng)建Excel對(duì)象并設(shè)置其標(biāo)題的示例：

string oleSourceFile = "ExcelObject.xlsx";
string oleIconFile = "Image.png";
  
using (Presentation pres = new Presentation())
{
    IPPImage image = null;
    ISlide slide = pres.Slides[0];
  
    // Add Ole objects
    byte[] allbytes = File.ReadAllBytes(oleSourceFile);
    IOleObjectFrame oof = slide.Shapes.AddOleObjectFrame(20, 20, 50, 50, "Excel.Sheet.12", allbytes);
    oof.IsObjectIcon = true;
  
    // Add image object
    byte[] imgBuf = File.ReadAllBytes(oleIconFile);
    using (MemoryStream ms = new MemoryStream(imgBuf))
    {
        image = pres.Images.AddImage(new Bitmap(ms));
    }
    oof.SubstitutePictureFormat.Picture.Image = image;
  
    // Set caption to OLE icon
    oof.SubstitutePictureTitle = "Caption example";
}

▲增加了對(duì)氣泡大小值表示的支持

BubbleSizeRepresentation指定氣泡圖表中氣泡大小值的表示方式。可能的值有：BubbleSizeRepresentationType.Area和 BubbleSizeRepresentationType.Width。因此，添加了BubbleSizeRepresentationType枚舉以指定將數(shù)據(jù)表示為氣泡圖大小的可能方式。

using (Presentation pres = new Presentation())
{
    IChart chart = pres.Slides[0].Shapes.AddChart(ChartType.Bubble, 50, 50, 600, 400, true);
  
    chart.ChartData.SeriesGroups[0].BubbleSizeRepresentation = BubbleSizeRepresentationType.Width;
  
     pres.Save("Presentation.pptx", SaveFormat.Pptx);
}

▲添加了新的ISvgImage接口和SvgImage類

添加了新的ISvgImage接口來(lái)表示SVG圖像：

////// Represents an SVG image.
///[ComVisible(true), Guid("8BB43C22-78D1-4032-A149-82FCD3992F0F"), CsToCppPorter.CppVirtualInheritance("System.Object")]
public interface ISvgImage
{
       ////// Returns SVG content.
       /// Read-only.
       ///string SvgContent { get; }
  
       ////// Returns SVG data.
       /// Read-only.
       ///byte[] SvgData { get; }
  
       ////// Return callback interface used to resolve external resources during SVG documents import.
       /// Read-only.
       ///IExternalResourceResolver ExternalResourceResolver { get; }
  
       ////// Returns base URI of the specified SVG. Used to resolve relative links.
       /// Read-only.
       ///string BaseUri { get; }
}

▲AddImage方法已添加到IImageCollection接口和ImageCollection類中

IImageCollection接口和ImageCollection類中添加了新的AddImage方法：

////// Add an image to a presentation from SVG object.
//////Svg image object///Added image.///When svgImage parameter is null.IPPImage AddImage(ISvgImage svgImage);

這些方法提供了將Svg片段插入到演示文稿的圖像集合的功能：

using (var p = new Presentation())
{
    string svgContent = File.ReadAllText(svgPath);
    ISvgImage svgImage = new SvgImage(svgContent);
    IPPImage ppImage = p.Images.AddImage(svgImage);
    p.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 0, 0, ppImage.Width, ppImage.Height, ppImage);
    p.Save(outPptxPath, SaveFormat.Pptx);
}

using (var p = new Presentation())
{
    string svgContent = File.ReadAllText(new Uri(new Uri(baseDir), "image1.svg").AbsolutePath);
    ISvgImage svgImage = new SvgImage(svgContent, new ExternalResourceResolver(), baseDir);
    IPPImage ppImage = p.Images.AddImage(svgImage);
    p.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 0, 0, ppImage.Width, ppImage.Height, ppImage);
    p.Save(outPptxPath, SaveFormat.Pptx);
}

▲屬性SvgImage屬性添加到IPPImage接口和PPImage類

新屬性SvgImage已經(jīng)添加到IPPImage接口和PPImage類：

////// Returns or sets ISvgImage object//////This value indicates that this image has been created from svg.ISvgImage SvgImage { get; set; }

▲AddGroupShape方法添加到IShapeCollection接口和IShapeCollection類中

IShapeCollection接口和ShapeCollection類中添加了新的AddGroupShape方法：

////// Creates a new GroupShape, fills it with converted shapes from SVG and adds it to the end of the collection.
//////Svg image object///The X coordinate for the left side of the shape group frame.
///The Y coordinate for the top side of the shape group frame.///The width of the group of the shape group frame.
///The height of a group of the shape group frame.
///Created GroupShape object.
IGroupShape AddGroupShape(ISvgImage svgImage, float x, float y, float width, float height);

此方法允許將表示SVG數(shù)據(jù)的SvgImage對(duì)象轉(zhuǎn)換為形狀組：

using (Presentation pres = new Presentation(pptxFileName))
{
    PictureFrame pFrame = pres.Slides[0].Shapes[0] as PictureFrame;
    ISvgImage svgImage = pFrame.PictureFormat.Picture.Image.SvgImage;
    if (svgImage != null)
    {
        // Convert svg image into group of shapes
        IGroupShape groupShape = pres.Slides[0].Shapes.AddGroupShape(svgImage, pFrame.Frame.X, pFrame.Frame.Y,
            pFrame.Frame.Width, pFrame.Frame.Height);
        // remove source svg image from presentation
        pres.Slides[0].Shapes.Remove(pFrame);
    }
}

ASPOSE技術(shù)交流QQ群（642018183）已開(kāi)通，各類資源及時(shí)分享，歡迎交流討論！

慧都20萬(wàn)+用戶答謝惠，ASPOSE系列產(chǎn)品火熱促銷中，最高直降8萬(wàn)元！>>立即領(lǐng)取優(yōu)惠