VSTO之PowerPoint(PPT)外掛開發常用API彙總

傅小灰發表於2019-08-02
API

VSTO簡介

VSTO（Visual Studio Tools for Office ）是VBA的替代，使得開發Office應用程式更加簡單，並且用VSTO來開發office應用程式可以使用Visual studio開發環境中的眾多功能和CLR提供的記憶體管理，垃圾回收等功能

額。。。這個是百度的介紹，手動滑稽！說白了就是用來開發office外掛的。

Office外掛開發解決方案選擇

最近由於工作原因，一直在看開發自定義的Office外掛的解決方案，總共有如下幾種

  • VBA --- Visual Basic的一種巨集語言，基本放棄考慮
  • VSTO --- VB的替代品，目前主流office外掛的實現方式
  • Office add-ins --- 使用主流的web技術（HTML, CSS, and JavaScript）來操作office文件

這裡說下我最後選擇了用VSTO來實現需求。首先VBA肯定被排除了，表示不會VB。然後Office add-ins由於自身的特性不太符合需求所以也放棄了，介紹下Office add-ins是啥個玩意。

使用Visual Studio 2017建立一個Office add-ins專案，系統自動會建立一個包含兩個專案的解決方案。（傳送門）




專案描述
載入專案僅包含XML清單檔案，其中包含描述載入項的所有設定。這些設定可幫助Office主機確定何時應啟用載入項以及載入項應顯示的位置。
Web應用程式專案包含載入項的內容頁面，包括開發支援Office的HTML和JavaScript頁面所需的所有檔案和檔案引用。在開發載入項時，Visual Studio會在本地IIS伺服器上託管Web應用程式。當準備釋出載入項時，需要將此Web應用程式專案部署到Web伺服器。

這也就意味著使用者的外掛介面都是通過Http請求到伺服器上獲取的，如果有一些功能（例如統一字型，匯出圖片等）是需要離線狀態也可以執行，那這個解決方案就沒法滿足了。所以最後我選擇了VSTO。

VSTO開發PPT外掛之API簡介

最開始我只是想開一篇文章記錄下開發過程中常用的那些API（真的不好找啊！），最後囉裡囉嗦的扯了很多背景介紹，終於輪到我本來想記錄的東西了，希望後來踩坑的同學能夠開發的順暢些。

常用的獲取操作物件的API

//獲取當前ppt中所有的幻燈片
Globals.ThisAddIn.Application.ActivePresentation.Slides;
//獲取當前選中的ppt幻燈片
var activeSlide = (Slide)Globals.ThisAddIn.Application.ActiveWindow.View.Slide;
//獲取當前選中幻燈片的Index，預設從1開始
activeSlide.SlideIndex
//在當前選中幻燈片前插入新的幻燈片--程式碼提示中沒有F12進去才找到的方法
slides.Add(activeSlide.SlideIndex, PpSlideLayout.ppLayoutCustom);
//獲取當前窗體中的選定物件
Globals.ThisAddIn.Application.ActiveWindow.Selection;

複製貼上操作幻燈片

//選擇複製的silde（可以為陣列new int[2]{3,5}}）
Globals.ThisAddIn.Application.ActivePresentation.Slides.Range(1).Copy();
//在指定位置貼上slide
Globals.ThisAddIn.Application.ActivePresentation.Slides.Paste(1);

//複製別的文件中的slide
//在1位置插入指定路徑ppt的Index 2-5的幻燈片
Globals.ThisAddIn.Application.ActivePresentation.Slides.InsertFromFile("c:\ppt\sales.ppt", 1, 2, 5);

修改主題字型（統一字型功能）

//獲取主題
var master = Globals.ThisAddIn.Application.ActivePresentation.SlideMaster;

//修改中文字型
//“標題”中的中文字型
master.Theme.ThemeFontScheme.MajorFont.Item(Microsoft.Office.Core.MsoFontLanguageIndex.msoThemeEastAsian).Name = "新宋體";
//“內容”中的中文字型
master.Theme.ThemeFontScheme.MinorFont.Item(Microsoft.Office.Core.MsoFontLanguageIndex.msoThemeEastAsian).Name = "新宋體";

//修改英文字型
//“標題”中的英文字型
master.Theme.ThemeFontScheme.MajorFont.Item(Microsoft.Office.Core.MsoFontLanguageIndex.msoThemeLatin).Name = "新宋體";
//“內容”中的英文字型
master.Theme.ThemeFontScheme.MinorFont.Item(Microsoft.Office.Core.MsoFontLanguageIndex.msoThemeLatin).Name = "新宋體";

插入圖片

//在當前選中幻燈片左上角插入圖片，位置和大小可以調整
//activeSlide看我上面的獲取方式
//picUrl可以是網路地址或本機實體地址
activeSlide.Shapes.AddPicture(picUrl, Microsoft.Office.Core.MsoTriState.msoTrue, Microsoft.Office.Core.MsoTriState.msoTrue, 0, 0);

//選中一個文字框或圖片框，插入背景圖片
//獲取第一個選中的“形狀”
var shape = Globals.ThisAddIn.Application.ActiveWindow.Selection.ShapeRange[0];
sharp.Fill.UserPicture(picUrl);

未完待續！（其實我也還在摸索當中，之後會整理一個CommonHelper方法，封裝一下常用的獲取物件API。）

相關文章