Merge branch 'main' into addTransitionToTheSlide

Author: lindalu-MSFT

docs/presentation/how-to-add-a-video-to-a-slide-in-a-presentation.md

@@ -0,0 +1,138 @@
+---
+
+api_name:
+- Microsoft.Office.DocumentFormat.OpenXML.Packaging
+api_type:
+- schema
+ms.assetid: 536c94b5-dd25-4173-ad6a-b72b95dd7f31
+title: 'How to: Add a video to a slide in a presentation'
+ms.suite: office
+
+ms.author: o365devx
+author: o365devx
+ms.topic: conceptual
+ms.date: 04/03/2025
+ms.localizationpriority: medium
+---
+
+# Add a video to a slide in a presentation
+
+This topic shows how to use the classes in the Open XML SDK for
+Office to add a video to the first slide in a presentation
+programmatically.
+
+## Getting a Presentation Object 
+
+In the Open XML SDK, the <xref:DocumentFormat.OpenXml.Packaging.PresentationDocument> class represents a
+presentation document package. To work with a presentation document,
+first create an instance of the **PresentationDocument** class, and then work with
+that instance. To create the class instance from the document call the
+<xref:DocumentFormat.OpenXml.Packaging.PresentationDocument.Open*> method that uses a file path, and a
+Boolean value as the second parameter to specify whether a document is
+editable. To open a document for read/write, specify the value `true` for this parameter as shown in the following
+`using` statement. In this code, the file
+parameter is a string that represents the path for the file from which
+you want to open the document.
+
+### [C#](#tab/cs-1)
+[!code-csharp[](../../samples/presentation/add_video/cs/Program.cs#snippet1)]
+
+### [Visual Basic](#tab/vb-1)
+[!code-vb[](../../samples/presentation/add_video/vb/Program.vb#snippet1)]
+***
+
+
+[!include[Using Statement](../includes/presentation/using-statement.md)] `ppt`.
+
+
+## The Structure of the Video From File
+
+The PresentationML document consists of a number of parts, among which is the Picture (`<pic/>`) element.
+
+The following text from the [!include[ISO/IEC 29500 URL](../includes/iso-iec-29500-link.md)] specification introduces the overall form of a `PresentationML` package.
+
+Video File (`<videoFile/>`) specifies the presence of a video file. It is defined within the non-visual properties of an object. The video shall be attached to an object as this is how it is represented within the document. The actual playing of the video however is done within the timing node list that is specified under the timing element.
+
+Consider the following `Picture` object that has a video attached to it.
+
+```xml
+<p:pic>  
+  <p:nvPicPr>  
+    <p:cNvPr id="7" name="Rectangle 6">  
+      <a:hlinkClick r:id="" action="ppaction://media"/>  
+    </p:cNvPr>  
+    <p:cNvPicPr>  
+      <a:picLocks noRot="1"/>  
+    </p:cNvPicPr>  
+    <p:nvPr>  
+      <a:videoFile r:link="rId1"/>  
+    </p:nvPr>  
+  </p:nvPicPr>  
+</p:pic>
+```
+
+In the above example, we see that there is a single videoFile element attached to this picture. This picture is placed within the document just as a normal picture or shape would be. The id of this picture, namely 7 in this case, is used to refer to this videoFile element from within the timing node list. The Linked relationship id is used to retrieve the actual video file for playback purposes. 
+
+&copy; [!include[ISO/IEC 29500 version](../includes/iso-iec-29500-version.md)]
+
+The following XML Schema fragment defines the contents of videoFile.
+
+```xml
+<xsd:complexType name="CT_TLMediaNodeVideo">
+	<xsd:sequence>
+		<xsd:element name="cMediaNode" type="CT_TLCommonMediaNodeData" minOccurs="1" maxOccurs="1"/>
+	</xsd:sequence>
+	<xsd:attribute name="fullScrn" type="xsd:boolean" use="optional" default="false"/>
+</xsd:complexType>
+```
+
+## How the Sample Code Works
+
+After opening the presentation file for read/write access in the `using` statement, the code gets the presentation
+part from the presentation document. Then it gets the relationship ID of
+the last slide, and gets the slide part from the relationship ID.
+
+
+### [C#](#tab/cs-2)
+[!code-csharp[](../../samples/presentation/add_video/cs/Program.cs#snippet2)]
+
+### [Visual Basic](#tab/vb-2)
+[!code-vb[](../../samples/presentation/add_video/vb/Program.vb#snippet2)]
+***
+
+The code first creates a media data part for the video file to be added. With the video file stream open, it feeds the media data part object. Next, video and media relationship references are added to the slide using the provided embedId for future reference to the video file and mediaEmbedId for media reference.
+
+An image part is then added with a sample picture to be used as a placeholder for the video. A picture object is created with various elements, such as Non-Visual Drawing Properties (`<cNvPr/>`), which specify non-visual canvas properties. This allows for additional information that does not affect the appearance of the picture to be stored. The `<videoFile/>` element, explained above, is also included. The HyperLinkOnClick (`<hlinkClick/>`) element specifies the on-click hyperlink information to be applied to a run of text or image. When the hyperlink text or image is clicked, the link is fetched. Non-Visual Picture Drawing Properties (`<cNvPicPr/>`) specify the non-visual properties for the picture canvas. For a detailed explanation of the elements used, please refer to [!include[ISO/IEC 29500 URL](../includes/iso-iec-29500-link.md)]
+
+### [C#](#tab/cs-3)
+[!code-csharp[](../../samples/presentation/add_video/cs/Program.cs#snippet3)]
+
+### [Visual Basic](#tab/vb-3)
+[!code-vb[](../../samples/presentation/add_video/vb/Program.vb#snippet3)]
+***
+
+Next Media(CT_Media) element is created with use of previously referenced mediaEmbedId(Embedded Picture Reference). The Blip element is also added; this element specifies the existence of an image (binary large image or picture) and contains a reference to the image data. Blip's Embed attribute is used to specify a placeholder image in the Image Part created previously.
+
+### [C#](#tab/cs-4)
+[!code-csharp[](../../samples/presentation/add_video/cs/Program.cs#snippet4)]
+
+### [Visual Basic](#tab/vb-4)
+[!code-vb[](../../samples/presentation/add_video/vb/Program.vb#snippet4)]
+***
+
+All other elements such Offset(`<off/>`), Stretch(`<stretch/>`), FillRectangle(`<fillRect/>`), are appended to the ShapeProperties(`<spPr/>`) and ShapeProperties are appended to the Picture element(`<pic/>`). Finally the picture element that incudes video is added to the ShapeTree(`<sp/>`) of the slide.
+
+Following is the complete sample code that you can use to add video to the slide.
+
+## Sample Code
+
+### [C#](#tab/cs)
+[!code-csharp[](../../samples/presentation/add_video/cs/Program.cs#snippet0)]
+
+### [Visual Basic](#tab/vb)
+[!code-vb[](../../samples/presentation/add_video/vb/Program.vb#snippet0)]
+***
+
+## See also
+
+- [Open XML SDK class library reference](/office/open-xml/open-xml-sdk)

…-from-all-the-slides-in-a-presentatio.md …from-all-the-slides-in-a-presentation.mddocs/presentation/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md renamed to docs/presentation/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentation.md docs/presentation/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md renamed to docs/presentation/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentation.md

@@ -20,8 +20,11 @@ This section provides how-to topics for working with presentation documents usin
 
 ## In this section
 
-- [Structure of a PresentationML document](structure-of-a-presentationml-document.md)  
+- [Structure of a PresentationML document](structure-of-a-presentationml-document.md)    
 
+
+- [Add an audio file to a slide in a presentation](how-to-add-an-audio-to-a-slide-in-a-presentation.md)
+
 - [Add a comment to a slide in a presentation](how-to-add-a-comment-to-a-slide-in-a-presentation.md)  
 
 - [Apply a theme to a presentation](how-to-apply-a-theme-to-a-presentation.md)  
@@ -30,7 +33,7 @@ This section provides how-to topics for working with presentation documents usin
 
 - [Create a presentation document by providing a file name](how-to-create-a-presentation-document-by-providing-a-file-name.md)  
 
-- [Delete all the comments by an author from all the slides in a presentation](how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md)  
+- [Delete all the comments by an author from all the slides in a presentation](how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentation.md)  
 
 - [Delete a slide from a presentation](how-to-delete-a-slide-from-a-presentation.md)  
 
@@ -40,7 +43,7 @@ This section provides how-to topics for working with presentation documents usin
 
 - [Get all the text in all slides in a presentation](how-to-get-all-the-text-in-all-slides-in-a-presentation.md)  
 
-- [Get the titles of all the slides in a presentation](how-to-get-the-titles-of-all-the-slides-in-a-presentation.md)  
+- [Get the titles of all the slides in a presentation](how-to-get-the-titles-of-all-the-slides-in-a-presentation.md)
 
 - [Insert a new slide into a presentation](how-to-insert-a-new-slide-into-a-presentation.md)  
 
@@ -50,7 +53,8 @@ This section provides how-to topics for working with presentation documents usin
 
 - [Open a presentation document for read-only access](how-to-open-a-presentation-document-for-read-only-access.md)  
 
-- [Retrieve the number of slides in a presentation document](how-to-retrieve-the-number-of-slides-in-a-presentation-document.md)  
+- [Retrieve the number of slides in a presentation document](how-to-retrieve-the-number-of-slides-in-a-presentation-document.md)
+ 
 - [Add a transition to a slides in a presentation](how-to-add-transitions-between-slides-in-a-presentation.md)
 
 - [Working with animation](working-with-animation.md)  

docs/presentation/overview.md

@@ -193,4 +193,4 @@ article.
 [About the Open XML SDK for Office](../about-the-open-xml-sdk.md)
 [How to: Create a Presentation by Providing a File Name](how-to-create-a-presentation-document-by-providing-a-file-name.md)
 [How to: Add a comment to a slide in a presentation](how-to-add-a-comment-to-a-slide-in-a-presentation.md)
-[How to: Delete all the comments by an author from all the slides in a presentation](how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md)  
+[How to: Delete all the comments by an author from all the slides in a presentation](how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentation.md)  

docs/presentation/working-with-comments.md

@@ -23,22 +23,12 @@ This section provides how-to topics for working with spreadsheet documents using
 
 - [Structure of a SpreadsheetML document](structure-of-a-spreadsheetml-document.md)
 
-- [Working with the calculation chain](working-with-the-calculation-chain.md)
-
-- [Working with conditional formatting](working-with-conditional-formatting.md)
-
-- [Working with formulas](working-with-formulas.md)
-
-- [Working with PivotTables](working-with-pivottables.md)
-
-- [Working with the shared string table](working-with-the-shared-string-table.md)
-
-- [Working with sheets](working-with-sheets.md)
-
-- [Working with SpreadsheetML tables](working-with-tables.md)
+- [Add custom UI to a spreadsheet document](how-to-add-custom-ui-to-a-spreadsheet-document.md)
 
 - [Calculate the sum of a range of cells in a spreadsheet document](how-to-calculate-the-sum-of-a-range-of-cells-in-a-spreadsheet-document.md)
 
+- [Copy a Worksheet Using SAX (Simple API for XML)](how-to-copy-a-worksheet-with-sax.md) 
+
 - [Create a spreadsheet document by providing a file name](how-to-create-a-spreadsheet-document-by-providing-a-file-name.md)
 
 - [Delete text from a cell in a spreadsheet document](how-to-delete-text-from-a-cell-in-a-spreadsheet.md)
@@ -69,6 +59,21 @@ This section provides how-to topics for working with spreadsheet documents using
 
 - [Retrieve the values of cells in a spreadsheet document](how-to-retrieve-the-values-of-cells-in-a-spreadsheet.md)
 
+- [Retrieve a list of the worksheets in a spreadsheet document](how-to-retrieve-a-list-of-the-worksheets-in-a-spreadsheet.md)
+
+- [Working with the calculation chain](working-with-the-calculation-chain.md)
+
+- [Working with conditional formatting](working-with-conditional-formatting.md)
+
+- [Working with formulas](working-with-formulas.md)
+
+- [Working with PivotTables](working-with-pivottables.md)
+
+- [Working with the shared string table](working-with-the-shared-string-table.md)
+
+- [Working with sheets](working-with-sheets.md)
+
+- [Working with SpreadsheetML tables](working-with-tables.md)
 
 ## Related sections
 

docs/spreadsheet/overview.md

@@ -48,14 +48,16 @@
         href: presentation/how-to-add-an-audio-to-a-slide-in-a-presentation.md
       - name: Add a comment to a slide in a presentation
         href: presentation/how-to-add-a-comment-to-a-slide-in-a-presentation.md
+      - name: Add a video to a slide in a presentation
+        href: presentation/how-to-add-a-video-to-a-slide-in-a-presentation.md
       - name: Apply a theme to a presentation
         href: presentation/how-to-apply-a-theme-to-a-presentation.md
       - name: Change the fill color of a shape in a presentation
         href: presentation/how-to-change-the-fill-color-of-a-shape-in-a-presentation.md
       - name: Create a presentation document by providing a file name
         href: presentation/how-to-create-a-presentation-document-by-providing-a-file-name.md
       - name: Delete all the comments by an author from all the slides in a presentation
-        href: presentation/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentatio.md
+        href: presentation/how-to-delete-all-the-comments-by-an-author-from-all-the-slides-in-a-presentation.md
       - name: Delete a slide from a presentation
         href: presentation/how-to-delete-a-slide-from-a-presentation.md
       - name: Get all the external hyperlinks in a presentation

docs/toc.yml

@@ -21,6 +21,8 @@ This section provides how-to topics for working with word processing documents u
 
 ## In this section 
 
+- [Structure of a WordprocessingML document](structure-of-a-wordprocessingml-document.md) 
+
 - [Accept all revisions in a word processing document](how-to-accept-all-revisions-in-a-word-processing-document.md)  
 
 - [Add tables to word processing documents](how-to-add-tables-to-word-processing-documents.md)  
@@ -59,13 +61,15 @@ This section provides how-to topics for working with word processing documents u
 
 - [Remove the headers and footers from a word processing document](how-to-remove-the-headers-and-footers-from-a-word-processing-document.md)  
 
+- [How to: Replace Text in a Word Document Using SAX (Simple API for XML)](how-to-replace-text-in-a-word-document-with-sax.md)  
+
 - [Replace the header in a word processing document](how-to-replace-the-header-in-a-word-processing-document.md)  
 
-- [Replace the styles parts in a word processing document](how-to-replace-the-styles-parts-in-a-word-processing-document.md)  
+- [Replace the styles parts in a word processing document](how-to-replace-the-styles-parts-in-a-word-processing-document.md) 
 
-- [Retrieve comments from a word processing document](how-to-retrieve-comments-from-a-word-processing-document.md)  
+- [Retrieve application property values from a Word document by using the Open XML API](how-to-retrieve-application-property-values-from-a-word-processing-document.md) 
 
-- [Retrieve property values from a Word document by using the Open XML API](how-to-retrieve-application-property-values-from-a-word-processing-document.md)
+- [Retrieve comments from a word processing document](how-to-retrieve-comments-from-a-word-processing-document.md)  
 
 - [Set a custom property in a word processing document](how-to-set-a-custom-property-in-a-word-processing-document.md)  
 
@@ -78,8 +82,7 @@ This section provides how-to topics for working with word processing documents u
 - [Working with runs](working-with-runs.md)  
 
 - [Working with WordprocessingML tables](working-with-wordprocessingml-tables.md)  
-
-- [Structure of a WordprocessingML document](structure-of-a-wordprocessingml-document.md)  
+ 
 
 ## Related sections 
 

docs/word/overview.md

@@ -10,13 +10,27 @@ To add a sample, run the the following:
 
 This will create an initial scaffold for a sample and add it to the solution file.
 
+## Steps to Complete Before Creating a Pull Request:
+1. **Test Both Code Samples**
+Verify the functionality of both the C# and Visual Basic samples. To accelerate the process, you can use Copilot to translate the C# sample into Visual Basic. When writing code samples, avoid using var; instead, explicitly declare variable types.
+
+2. **Validate Documentation with DocFX**
+Use the https://dotnet.github.io/docfx/ to ensure the generated documentation renders correctly and behaves as expected.
+
+3. **Update the Table of Contents**
+Add a new entry to the toc.yml file so the content appears in the Navigation Pane on the Microsoft Learn website.
+
+4. **Edit the Overview Page**
+Update the overview.md file with the new title and markdown file reference to ensure it appears in the overview section on Microsoft Learn. This file is located in one of the following directories: docs/presentation, docs/spreadsheet, or docs/word.
+
+
 ## Migrate old samples
 
 ```powershell
 ./migrate-sample.ps1 path-to-md-file
 ```
 
-This will do an inital extraction and clean up of the file, as well as add the code to the solution. Additional clean up will be necessary, but should be minimal.
+This will do an initial extraction and clean up of the file, as well as add the code to the solution. Additional clean up will be necessary, but should be minimal.
 
 General changes to move a sample: