Merge pull request #591 from BiDuang/master

Add `IPath` interface to store `XPath` infomation

src/ShapeCrawler/Extensions/CompositeElementExtensions.cs

@@ -34,4 +34,6 @@ internal static P.ApplicationNonVisualDrawingProperties GetPNvPr(this OpenXmlCom
             _ => throw new SCException()
         };
     }
+
+    internal static string GetXPath(this OpenXmlCompositeElement compositeElement) => new XmlPath(compositeElement).XPath;
 }

src/ShapeCrawler/Shapes/IPath.cs

@@ -0,0 +1,13 @@
+// ReSharper disable CheckNamespace
+namespace ShapeCrawler;
+
+/// <summary>
+///     Represents path information of the shape.
+/// </summary>
+public interface IPath
+{
+    /// <summary>
+    ///     Gets the shape's XPath in the slide.
+    /// </summary>
+    public string SDKXPath { get; }
+}

src/ShapeCrawler/Shapes/IShape.cs

@@ -8,7 +8,7 @@ namespace ShapeCrawler;
 /// <summary>
 ///     Represents a shape on a slide.
 /// </summary>
-public interface IShape
+public interface IShape : IPath
 {
     /// <summary>
     ///     Gets or sets x-coordinate of the upper-left corner of the shape.

src/ShapeCrawler/Shapes/SCShape.cs

@@ -40,6 +40,8 @@ internal abstract class SCShape : IShape
 
     public string Name => this.PShapeTreeChild.GetNonVisualDrawingProperties().Name!;
 
+    public string SDKXPath => this.PShapeTreeChild.GetXPath();
+
     public bool Hidden =>
         this.DefineHidden(); // TODO: the Shape is inherited by LayoutShape, hence do we need this property?
 

src/ShapeCrawler/Texts/ITextFrame.cs

@@ -6,6 +6,7 @@
 using DocumentFormat.OpenXml;
 using ShapeCrawler.Constants;
 using ShapeCrawler.Exceptions;
+using ShapeCrawler.Extensions;
 using ShapeCrawler.Services;
 using ShapeCrawler.Shared;
 using ShapeCrawler.Texts;
@@ -17,7 +18,7 @@ namespace ShapeCrawler;
 /// <summary>
 ///     Represents a text frame.
 /// </summary>
-public interface ITextFrame
+public interface ITextFrame : IPath
 {
     /// <summary>
     ///     Gets collection of paragraphs.
@@ -89,6 +90,8 @@ internal sealed class SCTextFrame : ITextFrame
     internal event Action? TextChanged;
 
     public IParagraphCollection Paragraphs => this.paragraphs.Value;
+
+    public string SDKXPath => this.TextBodyElement.GetXPath();
 
     public string Text
     {