{"id":49843,"date":"2010-05-12T00:01:00","date_gmt":"2010-05-12T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2010\/05\/12\/hey-scripting-guy-can-i-add-a-new-slide-to-an-existing-microsoft-powerpoint-presentation\/"},"modified":"2010-05-12T00:01:00","modified_gmt":"2010-05-12T00:01:00","slug":"hey-scripting-guy-can-i-add-a-new-slide-to-an-existing-microsoft-powerpoint-presentation","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-can-i-add-a-new-slide-to-an-existing-microsoft-powerpoint-presentation\/","title":{"rendered":"Hey, Scripting Guy! Can I Add a New Slide to an Existing Microsoft PowerPoint Presentation?"},"content":{"rendered":"

\"Bookmark<\/a><\/p>\n

 <\/p>\n

\"Hey,<\/p>\n

Hey, Scripting Guy! I have been enjoying reading your Microsoft PowerPoint articles this week. I am curious however; can you use Windows PowerShell to add a slide to an existing presentation? I have searched on the Internet and can’t find an example of doing that. Is it not possible, or just too tough?<\/p>\n

— YF<\/p>\n

\n

 <\/p>\n<\/p>\n

\"Hey,Hello YF, <\/p>\n

Microsoft Scripting Guy Ed Wilson here. I am listening to Stevie Ray Vaughan<\/font><\/a> on my Zune HD, and sipping a cup of Lady Grey tea<\/font><\/a> this afternoon. Lady Grey tea is similar to Earl Grey tea, but it is more subtle. I like to sip it after I have my afternoon snack. I have been enjoying reading through the Microsoft PowerPoint object model documentation on MSDN this week. I have been surprised at how rich it actually is. It is also beginning to make sense to me after having spent the week poring over the documentation. <\/p>\n

YF, I decided to write a script to add a slide to an existing Microsoft PowerPoint presentation. In fact, it will add the same slide to all of the Microsoft PowerPoint presentations in a specified folder. This could be rather useful in certain circumstances. For example, when I gave my presentation on Windows PowerShell at Tech·<\/span>Ed 2009 in Los Angeles last year, there were several slides that each presentation was required to incorporate. Rather than relying on the speakers to add these slides, the slides could have been added via script. <\/p>\n

The complete AddPowerPointSlide.ps1 script is shown here.<\/p>\n

AddPowerPointSlide.ps1<\/p>\n

<\/strong><\/p>\n

Add-type -AssemblyName office
$Application = New-Object -ComObject powerpoint.application
$application.visible = [Microsoft.Office.Core.MsoTriState]::msoTrue
$slideType = “microsoft.office.interop.powerpoint.ppSlideLayout” -as [type]
$path = “c:fso”
Get-ChildItem -Path $path -Include “*.ppt”, “*.pptx” -Recurse |
ForEach-Object {
 <\/span>$presentation = $application.Presentations.open($_.fullname)
 <\/span>$customLayout = $presentation.Slides.item(2).customLayout
 <\/span>$slide = $presentation.slides.addSlide(2,$customLayout)
 <\/span>$slide.layout = $slideType::ppLayoutTitleOnly
 <\/span>$slide.Shapes.title.TextFrame.TextRange.Text = “New Title Text”
 <\/span>$presentation.Save()
 <\/span>$presentation.Close()
 <\/span>“Modifying $_.FullName”
}<\/p>\n

$application.quit()
$application = $null
[gc]::collect()
[gc]::WaitForPendingFinalizers()<\/p>\n

<\/font><\/font><\/p>\n

The first thing that must be done is to add the office<\/b> assembly, create the PowerPoint<\/b> application object, and make the application visible. This was discussed in Monday’s Hey, Scripting Guy! post<\/font><\/a>. The code that does this is shown here: <\/p>\n

Add-type -AssemblyName office
$Application = New-Object -ComObject powerpoint.application
$application.visible = [Microsoft.Office.Core.MsoTriState]::msoTrue<\/p>\n

<\/font><\/span><\/p>\n

To configure the slide layout, you will need to use an instance of the ppSlideLayout<\/b> enumeration. The  PpSlideLayout enumeration<\/font><\/a> is documented on MSDN, and contains all of the different slide layout styles that are available from within Microsoft PowerPoint. One thing to keep in mind is that all layout styles will not be available for all slide themes and templates. The code that creates the slide layout enumeration is shown here:<\/p>\n

$slideType = “microsoft.office.interop.powerpoint.ppSlideLayout” -as [type]<\/p>\n

<\/font><\/span><\/p>\n

After you have created the ppSlideLayout<\/b> enumeration, you will want to retrieve the Microsoft PowerPoint presentations that you wish to modify. In this script, all of the Microsoft PowerPoint files in the c:fso folder will be modified. The Get-ChildItem<\/b> cmdlet is used to retrieve files that have either a .ppt or a .pptx extension. The fileinfo<\/b> objects are then passed via the pipeline to the ForEach-Object<\/b> cmdlet:<\/p>\n

$path = “c:fso”
Get-ChildItem -Path $path -Include “*.ppt”, “*.pptx” -Recurse |
ForEach-Object {<\/p>\n

<\/font><\/span><\/p>\n

Next the fullname<\/b> of the fileinfo<\/b> object contains the complete path to the file. This is passed to the Open method<\/font><\/a> of the Presentations collection object<\/font><\/a> that is retrieved from the Presentations property<\/font><\/a> of the Application object<\/font><\/a>. The open<\/b> method returns a Presentation object<\/font><\/a>. Using the Slides property<\/font><\/a> from the presentation<\/b> object retrieves a Slides collection object<\/font><\/a>. The item<\/b> method from the collections<\/b> object is used to obtain a specific Slide object<\/font><\/a>. In this example, we retrieve the second slide in the deck. Because the slides begin numbering at 1, there is no need to add an offset number. The CustomLayout property<\/font><\/a> from the slide<\/b> object returns a CustomLayout object<\/font><\/a> that is stored in the $customLayout<\/b> variable. This section of the script is shown here:<\/p>\n

 <\/span>$presentation = $application.Presentations.open($_.fullname)
 <\/span>$customLayout = $presentation.Slides.item(2).customLayout<\/p>\n

<\/font><\/span><\/p>\n

The current Microsoft PowerPoint presentation is shown in the following image.<\/p>\n

\"Image<\/font><\/a><\/span><\/p>\n

\n

 <\/p>\n<\/p>\n

Retrieving the customLayout<\/b> object was necessary because the AddSlide method<\/font><\/a> from the slides collection object requires two parameters. The first is the index number that tells the script where to add the new slide, and the second is a customLayout<\/b> object. The addSlide<\/b> method returns a slide<\/b> object that is stored in the $slide<\/b> variable, as shown here:<\/p>\n

 <\/span>$slide = $presentation.slides.addSlide(2,$customLayout)<\/p>\n

<\/font><\/span><\/p>\n

The Layout property<\/font><\/a> of the slide<\/b> object is used to modify the layout of the newly added slide. This is where the PpSlideLayout<\/b> enumeration stored in the $slideType<\/b> variable comes into play. To modify the layout of the new slide to a title-only slide, use the PpLayoutTitleOnly<\/b> static property as shown here:<\/p>\n

 <\/span>$slide.layout = $slideType::ppLayoutTitleOnly<\/p>\n

<\/font><\/span><\/p>\n

It is time to add some text to the title block of the slide. To do this, you need to retrieve the Shapes collection object<\/font><\/a> from the Shapes property<\/font><\/a> of the slide<\/b> object. The shapes collection object has a Title property<\/font><\/a> that returns a Shape object<\/font><\/a>. The TextFrame property<\/font><\/a> returns a TextFrame object<\/font><\/a> that contains alignment and anchoring properties for the shape. The textFrame<\/b> object represents the text frame in a shape object. It contains the text, as well as the properties and methods that control alignment of the text frame. The TextRange property<\/font><\/a> of the TextFrame<\/b> object returns a TextRange object<\/font><\/a> that represents the text in the TextFrame<\/b>. Finally, we get to the text<\/b> property of the TextRange<\/b> object. The TextRange<\/b> object has a number of very interesting methods and properties<\/font><\/a> that allow you to manipulate the text in the TextFrame<\/b>. Here we simply assign a string to the Text property<\/font><\/a> of the TextRange<\/b> object. The code that adds the title to the slide is shown here:<\/p>\n

 <\/span>$slide.Shapes.title.TextFrame.TextRange.Text = “New Title Text”<\/p>\n

<\/font><\/span><\/p>\n

After you have added the new slide, set the format of the slide, and added a title to it, it is time to save the modified presentation. To do this, you use the save<\/b> method from the presentation<\/b> object:<\/p>\n

 <\/span>$presentation.Save()<\/p>\n

<\/font><\/span><\/p>\n

After the presentation has been saved, it is time to close it by calling the close<\/b>\nmethod from the presentation<\/b> object. A string is displayed that indicates the name of the presentation that was modified: <\/p>\n

 <\/span>$presentation.Close()
 <\/span>“Modifying $_.FullName”
}<\/p>\n

<\/font><\/span><\/p>\n

To clean up after the script, the quit<\/b> method from the application<\/b> object is called. The application variable is set to null and garbage collection is called: <\/p>\n

$application.quit()
$application = $null
[gc]::collect()
[gc]::WaitForPendingFinalizers()<\/p>\n

<\/font><\/span><\/p>\n

 <\/p>\n

After the script has run, the Microsoft PowerPoint presentation with the new slide is displayed, as shown in the following image.<\/p>\n

\"Image<\/font><\/a><\/span><\/p>\n

\n

 <\/p>\n<\/p>\n

YF, that is all there is to using Windows PowerShell to add a new slide to a Microsoft PowerPoint presentation. Microsoft PowerPoint Week will continue tomorrow. <\/p>\n

If you want to know exactly what we will be looking at tomorrow, follow us on Twitter<\/a> or Facebook<\/a>. If you have any questions, send e-mail to us at scripter@microsoft.com<\/font><\/a> or post your questions on the Official Scripting Guys Forum<\/font><\/a>. See you tomorrow. Until then, peace.<\/p>\n

<\/p>\n

 <\/p>\n

<\/span><\/p>\n

Ed Wilson and Craig Liebendorfer, Scripting Guys<\/p>\n

<\/span><\/b><\/p>\n

<\/p>\n

<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

  Hey, Scripting Guy! I have been enjoying reading your Microsoft PowerPoint articles this week. I am curious however; can you use Windows PowerShell to add a slide to an existing presentation? I have searched on the Internet and can’t find an example of doing that. Is it not possible, or just too tough? — […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[129,49,3,45],"class_list":["post-49843","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-microsoft-powerpoint","tag-office","tag-scripting-guy","tag-windows-powershell"],"acf":[],"blog_post_summary":"

  Hey, Scripting Guy! I have been enjoying reading your Microsoft PowerPoint articles this week. I am curious however; can you use Windows PowerShell to add a slide to an existing presentation? I have searched on the Internet and can’t find an example of doing that. Is it not possible, or just too tough? — […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/49843","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=49843"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/49843\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=49843"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=49843"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=49843"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}