spire-presentation 10.6.4__py3-none-win_amd64.whl → 10.7.1__py3-none-win_amd64.whl

spire/presentation/{ShapeList.py → collections/ShapeList.py}

@@ -9,9 +9,25 @@ from ctypes import *
 import abc
 
 class ShapeList (SpireObject) :
+    """
+    Represents a collection of shapes on a presentation slide.
+    
+    This class provides methods to manage and manipulate shapes including adding, 
+    removing, accessing, and converting shapes. It supports various shape types 
+    including charts, images, videos, audio, tables, and smart art.
+    """
    
     @dispatch
     def __getitem__(self, key):
+        """
+        Gets the shape at the specified index.
+        
+        Args:
+            key: Index of the shape to retrieve
+            
+        Returns:
+            IShape: The shape object at the specified index
+        """
         if key >= self.Count:
             raise StopIteration
         GetDllLibPpt().ShapeList_get_Item.argtypes=[c_void_p ,c_int]
@@ -52,18 +68,13 @@ class ShapeList (SpireObject) :
 
         return ret
 
-    """
-    <summary>
-        Represents a collection of a shapes.
-    </summary>
-    """
 
     def GetEnumerator(self)->'IEnumerator':
         """
-    <summary>
-        Gets an enumerator for the entire collection.
-    </summary>
-    <returns>An <see cref="T:System.Collections.IEnumerator" /> for the entire collection.</returns>
+        Gets an enumerator that iterates through the paragraph collection.
+        
+        Returns:
+            IEnumerator: An enumerator that can be used to iterate through the collection
         """
         GetDllLibPpt().ShapeList_GetEnumerator.argtypes=[c_void_p]
         GetDllLibPpt().ShapeList_GetEnumerator.restype=c_void_p
@@ -76,10 +87,10 @@ class ShapeList (SpireObject) :
 
     def Parent(self)->'SpireObject':
         """
-    <summary>
-        Gets parent object for a Shapes collection.
-            Read-only <see cref="T:System.Object" />. See also <see cref="T:Spire.Presentation.IActivePresentation" />.
-    </summary>
+        Gets parent object for the shapes collection.
+        
+        Returns:
+            SpireObject: Parent object of the shape collection
         """
         GetDllLibPpt().ShapeList_get_Parent.argtypes=[c_void_p]
         GetDllLibPpt().ShapeList_get_Parent.restype=c_void_p
@@ -91,10 +102,10 @@ class ShapeList (SpireObject) :
 
     def AddFromHtml(self ,htmlText:str):
         """
-    <summary>
-        Adds text from specified html string.
-    </summary>
-    <param name="htmlText">HTML text.</param>
+        Adds text from specified HTML string.
+        
+        Args:
+            htmlText: HTML text to add as shapes
         """
         
         htmlTextPtr = StrToPtr(htmlText)
@@ -103,7 +114,11 @@ class ShapeList (SpireObject) :
 
     def AddFromSVG(self ,svgFilePath:str,rectangle:'RectangleF'):
         """
-    
+        Adds shapes from an SVG file.
+        
+        Args:
+            svgFilePath: Path to SVG file
+            rectangle: Bounding rectangle for the SVG content
         """
         
         svgFilePathPtr = StrToPtr(svgFilePath)
@@ -111,6 +126,19 @@ class ShapeList (SpireObject) :
         GetDllLibPpt().ShapeList_AddFromSVG.argtypes=[c_void_p ,c_char_p,c_void_p]
         CallCFunction(GetDllLibPpt().ShapeList_AddFromSVG,self.Ptr,svgFilePathPtr,intPtrrectangle)
 
+    
+    def AddFromSVGAsShapes(self ,svgFilePath:str):
+        """
+        Adds shapes from an SVG file.
+        
+        Args:
+            svgFilePath: Path to SVG file.
+        """
+        
+        svgFilePathPtr = StrToPtr(svgFilePath)
+        GetDllLibPpt().ShapeList_AddFromSVGAsShapes.argtypes=[c_void_p ,c_char_p]
+        CallCFunction(GetDllLibPpt().ShapeList_AddFromSVGAsShapes,self.Ptr,svgFilePathPtr)
+
 
     def Equals(self ,obj:'SpireObject')->bool:
         """
@@ -126,10 +154,8 @@ class ShapeList (SpireObject) :
     @property
     def Count(self)->int:
         """
-    <summary>
         Gets the number of elements actually contained in the collection.
-            Read-only <see cref="T:System.Int32" />.
-    </summary>
+           
         """
         GetDllLibPpt().ShapeList_get_Count.argtypes=[c_void_p]
         GetDllLibPpt().ShapeList_get_Count.restype=c_int
@@ -139,10 +165,8 @@ class ShapeList (SpireObject) :
 
     def get_Item(self ,index:int)->'IShape':
         """
-    <summary>
         Gets the element at the specified index.
-            Read-only <see cref="T:Spire.Presentation.Shape" />.
-    </summary>
+           
         """
         
         GetDllLibPpt().ShapeList_get_Item.argtypes=[c_void_p ,c_int]
@@ -153,12 +177,17 @@ class ShapeList (SpireObject) :
 
     def SaveAsImage(self ,shapeIndex:int, dpiX:int = 96,dpiY:int=96)->'Stream':
         """
-    <summary>
-        Save shapes to Image.
-    </summary>
-    <param name="shapeIndex">Represents the shape index in the indicated slide's shapes collection</param>
-    <returns></returns>
+        Saves shapes to an image stream.
+        
+        Args:
+            shapeIndex: Index of the shape to save
+            dpiX: Horizontal DPI (default 96)
+            dpiY: Vertical DPI (default 96)
+            
+        Returns:
+            Stream: Image data stream
         """
+
         GetDllLibPpt().ShapeList_SaveAsImageDpi.argtypes=[c_void_p ,c_int,c_int,c_int]
         GetDllLibPpt().ShapeList_SaveAsImageDpi.restype=c_void_p
         intPtr = CallCFunction(GetDllLibPpt().ShapeList_SaveAsImageDpi,self.Ptr, shapeIndex,dpiX,dpiY)
@@ -169,12 +198,11 @@ class ShapeList (SpireObject) :
 
     def SaveAsEMF(self ,shapeIndex:int,filePath:str):
         """
-    <summary>
-        Save shapes to EMF.
-    </summary>
-    <param name="shapeIndex">Represents the shape index in the indicated slide's shapes collection</param>
-    <param name="filePahth">Represents the save path</param>
-    <returns></returns>
+        Saves shapes to EMF format.
+        
+        Args:
+            shapeIndex: Index of the shape to save
+            filePath: Output file path
         """
         
         filePathPtr = StrToPtr(filePath)
@@ -184,13 +212,15 @@ class ShapeList (SpireObject) :
 
     def CreateChart(self ,baseChart:'IChart',rectangle:'RectangleF',nIndex:int)->'IChart':
         """
-    <summary>
-        clone basechart and insert into shapes
-    </summary>
-    <param name="baseChart">source chart</param>
-    <param name="rectangle">Rectangle should be inserted</param>
-    <param name="nIndex">index should be inserted.-1 mean append at the last.</param>
-    <returns></returns>
+        Clones a chart and inserts it into shapes.
+        
+        Args:
+            baseChart: Source chart to clone
+            rectangle: Bounding rectangle for new chart
+            nIndex: Insertion index (-1 for append)
+            
+        Returns:
+            IChart: Newly created chart
         """
         intPtrbaseChart:c_void_p = baseChart.Ptr
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -204,13 +234,15 @@ class ShapeList (SpireObject) :
     
     def AppendChartInit(self ,type:ChartType,rectangle:RectangleF,init:bool)->'IChart':
         """
-    <summary>
-        Adds a new chart.
-    </summary>
-    <param name="type">Chart type</param>
-    <param name="rectangle">rectangle should be inserted.</param>
-    <param name="init">init chart use default data .</param>
-    <returns></returns>
+        Adds a new chart with initialization option.
+        
+        Args:
+            type: Type of chart to create
+            rectangle: Bounding rectangle for chart
+            init: Initialize with default data
+            
+        Returns:
+            IChart: New chart instance
         """
         enumtype:c_int = type.value
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -223,12 +255,14 @@ class ShapeList (SpireObject) :
 
     def AppendChart(self ,type:ChartType,rectangle:RectangleF)->'IChart':
         """
-    <summary>
-        Adds a new chart.init chart use default data
-    </summary>
-    <param name="type">Chart type</param>
-    <param name="rectangle">rectangle should be inserted.</param>
-    <returns></returns>
+        Adds a new chart with default initialization.
+        
+        Args:
+            type: Type of chart to create
+            rectangle: Bounding rectangle for chart
+            
+        Returns:
+            IChart: New chart instance
         """
         enumtype:c_int = type.value
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -243,7 +277,17 @@ class ShapeList (SpireObject) :
 
     def AppendSmartArt(self ,x:float,y:float,width:float,height:float,layoutType:'SmartArtLayoutType')->'ISmartArt':
         """
-
+        Adds a new SmartArt graphic.
+        
+        Args:
+            x: X-coordinate of bounding rectangle
+            y: Y-coordinate of bounding rectangle
+            width: Width of bounding rectangle
+            height: Height of bounding rectangle
+            layoutType: SmartArt layout type
+            
+        Returns:
+            ISmartArt: New SmartArt instance
         """
         enumlayoutType:c_int = layoutType.value
 
@@ -257,12 +301,13 @@ class ShapeList (SpireObject) :
 
     def InsertChart(self ,index:int,type:'ChartType',rectangle:'RectangleF',init:bool):
         """
-    <summary>
-        Add a new chart to collection.
-    </summary>
-    <param name="index">Index should be inserted.</param>
-    <param name="type">Chart type</param>
-    <param name="rectangle">Rectangle should inserted.</param>
+        Inserts a new chart at specified position.
+        
+        Args:
+            index: Insertion index
+            type: Type of chart to create
+            rectangle: Bounding rectangle for chart
+            init: Initialize with default data
         """
         enumtype:c_int = type.value
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -272,13 +317,15 @@ class ShapeList (SpireObject) :
 
     def AppendOleObject(self ,objectName:str,objectData:'Stream',rectangle:RectangleF)->IOleObject:
         """
-    <summary>
-        Add a new OleObject to Collection
-    </summary>
-    <param name="objectName">Object Name</param>
-    <param name="objectData">Object Data</param>
-    <param name="rectangle">Rectangle should be inserted.</param>
-    <returns></returns>
+        Adds a new OLE object.
+        
+        Args:
+            objectName: Name of the OLE object
+            objectData: Data stream for the object
+            rectangle: Bounding rectangle
+            
+        Returns:
+            IOleObject: New OLE object instance
         """
         intPtrobjectData:c_void_p = objectData.Ptr
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -323,13 +370,13 @@ class ShapeList (SpireObject) :
 
     def InsertOleObject(self ,index:int,objectName:str,objectData:'Stream',rectangle:RectangleF):
         """
-    <summary>
-        Insert a object to collection.
-    </summary>
-    <param name="index">Index should be inserted.</param>
-    <param name="objectName">Object name</param>
-    <param name="objectData">Object data</param>
-    <param name="rectangle">Rectangle should be inserted</param>
+        Inserts an OLE object at specified position.
+        
+        Args:
+            index: Insertion index
+            objectName: Name of the OLE object
+            objectData: Data stream for the object
+            rectangle: Bounding rectangle
         """
         intPtrobjectData:c_void_p = objectData.Ptr
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -366,12 +413,14 @@ class ShapeList (SpireObject) :
    
     def AppendVideoMedia(self ,filePath:str,rectangle:RectangleF)->'IVideo':
         """
-    <summary>
-        Add a new video to collection. innerLink mode
-    </summary>
-    <param name="filePath"></param>
-    <param name="rectangle"></param>
-    <returns></returns>
+        Adds a new video (internal link mode).
+        
+        Args:
+            filePath: Path to video file
+            rectangle: Bounding rectangle
+            
+        Returns:
+            IVideo: New video object
         """
         intPtrrectangle:c_void_p = rectangle.Ptr
 
@@ -384,13 +433,15 @@ class ShapeList (SpireObject) :
     
     def AppendVideoMediaLink(self ,filePath:str,rectangle:RectangleF,isInnerLink:bool)->'IVideo':
         """
-    <summary>
-        Add a new video to collection.
-    </summary>
-    <param name="filePath"></param>
-    <param name="rectangle"></param>
-    <param name="isInnerLink"></param>
-    <returns></returns>
+        Adds a new video with link option.
+        
+        Args:
+            filePath: Path to video file
+            rectangle: Bounding rectangle
+            isInnerLink: Use internal link
+            
+        Returns:
+            IVideo: New video object
         """
         intPtrrectangle:c_void_p = rectangle.Ptr
 
@@ -404,13 +455,14 @@ class ShapeList (SpireObject) :
 
     def AppendVideoMediaByStream(self ,stream:Stream,rectangle:RectangleF)->'IVideo':
         """
-    <summary>
-        Add a new video to collection by stream.
-    </summary>
-    <param name="stream">video stream object</param>
-    <param name="rectangle">rectangle for placing video</param>
-    <param name="isInnerLink"></param>
-    <returns></returns>
+        Adds a new video from stream.
+        
+        Args:
+            stream: Video data stream
+            rectangle: Bounding rectangle
+            
+        Returns:
+            IVideo: New video object
         """
         intPtrstream:c_void_p = stream.Ptr
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -425,12 +477,12 @@ class ShapeList (SpireObject) :
 
     def InsertVideoMedia(self ,index:int,filePath:str,rectangle:'RectangleF'):
         """
-    <summary>
-        Adds a new video to collection.
-    </summary>
-    <param name="index">Index should be inserted.</param>
-    <param name="filePath">Video file path.</param>
-    <param name="rectangle">Rectangle should be inserted.</param>
+        Inserts a video at specified position.
+        
+        Args:
+            index: Insertion index
+            filePath: Path to video file
+            rectangle: Bounding rectangle
         """
         intPtrrectangle:c_void_p = rectangle.Ptr
 
@@ -442,11 +494,13 @@ class ShapeList (SpireObject) :
 
     def AppendAudioMediaByRect(self ,rectangle:RectangleF)->'IAudio':
         """
-    <summary>
-        Adds an Audio from CD
-    </summary>
-    <param name="rectangle">Rectangle should be inserted</param>
-    <returns></returns>
+        Adds an audio placeholder (CD audio).
+        
+        Args:
+            rectangle: Bounding rectangle
+            
+        Returns:
+            IAudio: New audio object
         """
         intPtrrectangle:c_void_p = rectangle.Ptr
 
@@ -461,11 +515,11 @@ class ShapeList (SpireObject) :
 
     def InsertAudioMedia(self ,index:int,rectangle:RectangleF):
         """
-    <summary>
-        Insert an Audio From CD.
-    </summary>
-    <param name="index">Index should be inserted.</param>
-    <param name="rectangle">Rectangle should be inserted.</param>
+        Inserts an audio placeholder (CD audio).
+        
+        Args:
+            index: Insertion index
+            rectangle: Bounding rectangle
         """
         intPtrrectangle:c_void_p = rectangle.Ptr
 
@@ -476,14 +530,16 @@ class ShapeList (SpireObject) :
 
     def AppendAudioMediaByPathXYEmbed(self ,filePath:str,X:float,Y:float,isEmbed:bool)->'IAudio':
         """
-    <summary>
-        Adds a new audio to list.
-    </summary>
-    <param name="filePath">Audio file name</param>
-    <param name="X">X Position</param>
-    <param name="Y">Y Position</param>
-    <param name="isEmbed">Whether embed or not</param>
-    <returns></returns>
+        Adds a new audio file with embedding option.
+        
+        Args:
+            filePath: Path to audio file
+            X: X-coordinate
+            Y: Y-coordinate
+            isEmbed: Embed audio in presentation
+            
+        Returns:
+            IAudio: New audio object
         """
         
         filePathPtr = StrToPtr(filePath)
@@ -498,13 +554,15 @@ class ShapeList (SpireObject) :
 
     def AppendAudioMediaByPathXY(self ,filePath:str,X:float,Y:float)->'IAudio':
         """
-    <summary>
-        Adds a new audio to list.
-    </summary>
-    <param name="filePath">Audio file name</param>
-    <param name="X">X Position</param>
-    <param name="Y">Y Position</param>
-    <returns></returns>
+        Adds a new audio file.
+        
+        Args:
+            filePath: Path to audio file
+            X: X-coordinate
+            Y: Y-coordinate
+            
+        Returns:
+            IAudio: New audio object
         """
         
         filePathPtr = StrToPtr(filePath)
@@ -518,13 +576,15 @@ class ShapeList (SpireObject) :
 
     def AppendAudioMediaEmbed(self ,filePath:str,rectangle:RectangleF,isEmbed:bool)->'IAudio':
         """
-    <summary>
-        Adds a new audio to list.
-    </summary>
-    <param name="filePath">Audio file name</param>
-    <param name="rectangle">Rectangle should be inserted</param>
-    <param name="isEmbed">Whether embed or not,default not</param>
-    <returns></returns>
+        Adds a new audio file with rectangle and embed option.
+        
+        Args:
+            filePath: Path to audio file
+            rectangle: Bounding rectangle
+            isEmbed: Embed audio in presentation
+            
+        Returns:
+            IAudio: New audio object
         """
         filePathPtr = StrToPtr(filePath)
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -536,12 +596,14 @@ class ShapeList (SpireObject) :
     
     def AppendAudioMedia(self ,filePath:str,rectangle:RectangleF)->'IAudio':
         """
-    <summary>
-        Adds a new audio to list.
-    </summary>
-    <param name="filePath">Audio file name</param>
-    <param name="rectangle">Rectangle should be inserted</param>
-    <returns></returns>
+        Adds a new audio file with rectangle.
+        
+        Args:
+            filePath: Path to audio file
+            rectangle: Bounding rectangle
+            
+        Returns:
+            IAudio: New audio object
         """
         intPtrrectangle:c_void_p = rectangle.Ptr
 
@@ -557,12 +619,13 @@ class ShapeList (SpireObject) :
 
     def InsertAudioMedia(self ,index:int,filePath:str,rectangle:RectangleF,isEmbed:bool):
         """
-    <summary>
-        Insert an audio to collection.
-    </summary>
-    <param name="filePath">Audio file path</param>
-    <param name="rectangle">Rectangle should be inserted.</param>
-    <param name="isEmbed">Whether embed or not,default not</param>
+        Inserts an audio file with embed option.
+        
+        Args:
+            index: Insertion index
+            filePath: Path to audio file
+            rectangle: Bounding rectangle
+            isEmbed: Embed audio in presentation
         """
         intPtrrectangle:c_void_p = rectangle.Ptr
 
@@ -574,11 +637,12 @@ class ShapeList (SpireObject) :
 
     def InsertAudioMedia(self ,index:int,filePath:str,rectangle:RectangleF):
         """
-    <summary>
-        Insert an audio to collection.
-    </summary>
-    <param name="filePath">Audio file path</param>
-    <param name="rectangle">Rectangle should be inserted.</param>
+        Inserts an audio file.
+        
+        Args:
+            index: Insertion index
+            filePath: Path to audio file
+            rectangle: Bounding rectangle
         """
         intPtrrectangle:c_void_p = rectangle.Ptr
 
@@ -590,15 +654,15 @@ class ShapeList (SpireObject) :
 
     def InsertAudioMedia(self ,index:int,filePath:str,X:float,Y:float,isEmbed:bool):
         """
-    <summary>
-        Insert an audio to collection.
-    </summary>
-    <param name="filePath">Audio file path</param>
-    <param name="X">X Position</param>
-    <param name="Y">Y Position</param>
-    <param name="isEmbed">Whether embed or not,default not</param>
-        """
+        Inserts an audio file with coordinates and embed option.
         
+        Args:
+            index: Insertion index
+            filePath: Path to audio file
+            X: X-coordinate
+            Y: Y-coordinate
+            isEmbed: Embed audio in presentation
+        """
         filePathPtr = StrToPtr(filePath)
         GetDllLibPpt().ShapeList_InsertAudioMediaIFXYI.argtypes=[c_void_p ,c_int,c_char_p,c_float,c_float,c_bool]
         CallCFunction(GetDllLibPpt().ShapeList_InsertAudioMediaIFXYI,self.Ptr, index,filePathPtr,X,Y,isEmbed)
@@ -607,12 +671,13 @@ class ShapeList (SpireObject) :
 
     def InsertAudioMedia(self ,index:int,filePath:str,X:float,Y:float):
         """
-    <summary>
-        Insert an audio to collection.
-    </summary>
-    <param name="filePath">Audio file path</param>
-    <param name="X">X Position</param>
-    <param name="Y">Y Position</param>
+        Inserts an audio file with coordinates.
+        
+        Args:
+            index: Insertion index
+            filePath: Path to audio file
+            X: X-coordinate
+            Y: Y-coordinate
         """
         
         filePathPtr = StrToPtr(filePath)
@@ -622,12 +687,14 @@ class ShapeList (SpireObject) :
 
     def AppendAudioMediaByStreamRect(self ,stream:Stream,rectangle:RectangleF)->'IAudio':
         """
-    <summary>
-        Adds a new audio to list.
-    </summary>
-    <param name="stream">Audio stream</param>
-    <param name="rectangle">Rectangle should be inserted</param>
-    <returns></returns>
+        Adds a new audio from stream with rectangle.
+        
+        Args:
+            stream: Audio data stream
+            rectangle: Bounding rectangle
+            
+        Returns:
+            IAudio: New audio object
         """
         intPtrstream:c_void_p = stream.Ptr
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -641,12 +708,15 @@ class ShapeList (SpireObject) :
 
     def AppendAudioMediaByStreamFloat(self ,stream:Stream,X:float,Y:float)->'IAudio':
         """
-    <summary>
-        Adds a new audio to list.
-    </summary>
-    <param name="stream">Audio stream</param>
-    <param name="rectangle">Rectangle should be inserted</param>
-    <returns></returns>
+        Adds a new audio from stream with coordinates.
+        
+        Args:
+            stream: Audio data stream
+            X: X-coordinate
+            Y: Y-coordinate
+            
+        Returns:
+            IAudio: New audio object
         """
         intPtrstream:c_void_p = stream.Ptr
 
@@ -661,12 +731,12 @@ class ShapeList (SpireObject) :
 
     def InsertAudioMedia(self ,index:int,stream:Stream,rectangle:RectangleF):
         """
-    <summary>
-        Insert an audio to collection.
-    </summary>
-    <param name="index">Index to inserted.</param>
-    <param name="stream">Audio stream</param>
-    <param name="rectangle">Rectangle should be inserted.</param>
+        Inserts an audio from stream.
+        
+        Args:
+            index: Insertion index
+            stream: Audio data stream
+            rectangle: Bounding rectangle
         """
         intPtrstream:c_void_p = stream.Ptr
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -677,11 +747,13 @@ class ShapeList (SpireObject) :
 
     def IndexOf(self ,shape:'IShape')->int:
         """
-    <summary>
-        Gets the index of the first occurrence of a shape in the collection.
-    </summary>
-    <param name="shape">Shape to found.</param>
-    <returns>Index of the first occurrence of shape </returns>
+        Gets the index of the first occurrence of a shape.
+        
+        Args:
+            shape: Shape to find
+            
+        Returns:
+            int: Index of the shape in the collection
         """
         intPtrshape:c_void_p = shape.Ptr
 
@@ -690,48 +762,14 @@ class ShapeList (SpireObject) :
         ret = CallCFunction(GetDllLibPpt().ShapeList_IndexOf,self.Ptr, intPtrshape)
         return ret
 
-#    @dispatch
-#
-#    def ToArray(self)->List[IShape]:
-#        """
-#    <summary>
-#        Creates and returns an array with all shapse in it.
-#    </summary>
-#    <returns>Array of <see cref="T:Spire.Presentation.Shape" /></returns>
-#        """
-#        GetDllLibPpt().ShapeList_ToArray.argtypes=[c_void_p]
-#        GetDllLibPpt().ShapeList_ToArray.restype=IntPtrArray
-#        intPtrArray = CallCFunction(GetDllLibPpt().ShapeList_ToArray,self.Ptr)
-#        ret = GetVectorFromArray(intPtrArray, IShape)
-#        return ret
-
-
-#    @dispatch
-#
-#    def ToArray(self ,startIndex:int,count:int)->List[IShape]:
-#        """
-#    <summary>
-#        Creates and returns an array with all shapes from the specified range in it.
-#                <param name="startIndex">An index of a first shape to return.</param>    <param name="count">A number of shapes to return.</param></summary>
-#    <returns>Array of <see cref="T:Spire.Presentation.Shape" /></returns>
-#        """
-#        
-#        GetDllLibPpt().ShapeList_ToArraySC.argtypes=[c_void_p ,c_int,c_int]
-#        GetDllLibPpt().ShapeList_ToArraySC.restype=IntPtrArray
-#        intPtrArray = CallCFunction(GetDllLibPpt().ShapeList_ToArraySC,self.Ptr, startIndex,count)
-#        ret = GetObjVectorFromArray(intPtrArray, IShape)
-#        return ret
-
-
     @dispatch
 
     def ZOrder(self ,index:int,shape:IShape):
         """
-    <summary>
         Change a shape's zorder.
-    </summary>
-    <param name="index">Target index.</param>
-    <param name="shape">Shape to move.</param>
+        Args:
+            index:Target index.
+            shape:Shape to move.
         """
         intPtrshape:c_void_p = shape.Ptr
 
@@ -764,12 +802,14 @@ class ShapeList (SpireObject) :
 
     def AppendShape(self ,shapeType:ShapeType,rectangle:RectangleF)->'IAutoShape':
         """
-    <summary>
-        Adds a new shape to list.
-    </summary>
-    <param name="shapeType">Shape type</param>
-    <param name="rectangle">Rectangle should be inserted.</param>
-    <returns></returns>
+        Adds a new shape to the collection.
+        
+        Args:
+            shapeType: Type of shape to create
+            rectangle: Bounding rectangle
+            
+        Returns:
+            IAutoShape: New shape instance
         """
         enumshapeType:c_int = shapeType.value
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -785,7 +825,15 @@ class ShapeList (SpireObject) :
 
     def AppendShapeByPoint(self ,shapeType:ShapeType,start:PointF,end:PointF)->'IAutoShape':
         """
-
+        Adds a new shape defined by start and end points.
+        
+        Args:
+            shapeType: Type of shape to create
+            start: Starting point
+            end: Ending point
+            
+        Returns:
+            IAutoShape: New shape instance
         """
         enumshapeType:c_int = shapeType.value
         intPtrstart:c_void_p = start.Ptr
@@ -801,14 +849,17 @@ class ShapeList (SpireObject) :
 
     def AppendRoundRectangle(self ,x:float,y:float,width:float,height:float,radius:float)->'IAutoShape':
         """
-    <summary>
-        Adds a roundrectangle to list.
-    </summary>
-    <param name="x">X-coordinates of rectangle</param>
-    <param name="y">Y-coordinates of rectangle</param>
-    <param name="width">Width of rectangle</param>
-    <param name="height">Height of rectangle</param>
-    <param name="radius">Radius of rectangle</param>
+        Adds a round rectangle shape.
+        
+        Args:
+            x: X-coordinate
+            y: Y-coordinate
+            width: Width of rectangle
+            height: Height of rectangle
+            radius: Corner radius
+            
+        Returns:
+            IAutoShape: New shape instance
         """
         
         GetDllLibPpt().ShapeList_AppendRoundRectangle.argtypes=[c_void_p ,c_float,c_float,c_float,c_float,c_float]
@@ -821,12 +872,12 @@ class ShapeList (SpireObject) :
 
     def InsertShape(self ,index:int,shapeType:'ShapeType',rectangle:'RectangleF'):
         """
-    <summary>
-        Insert a new shape to collection.
-    </summary>
-    <param name="index">Index should be inserted.</param>
-    <param name="shapeType">Shape type</param>
-    <param name="rectangle">Rectangle shoud be inserted.</param>
+        Inserts a new shape at specified position.
+        
+        Args:
+            index: Insertion index
+            shapeType: Type of shape to create
+            rectangle: Bounding rectangle
         """
         enumshapeType:c_int = shapeType.value
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -837,15 +888,15 @@ class ShapeList (SpireObject) :
 
     def InsertRoundRectangle(self ,index:int,x:float,y:float,width:float,height:float,radius:float):
         """
-    <summary>
-        Insert a roundrectangle to collection.
-    </summary>
-    <param name="index">Index should be inserted.</param>
-    <param name="x">X-coordinates of rectangle</param>
-    <param name="y">Y-coordinates of rectangle</param>
-    <param name="width">Width of rectangle</param>
-    <param name="height">Height of rectangle</param>
-    <param name="radius">Radius of rectangle</param>
+        Inserts a round rectangle shape.
+        
+        Args:
+            index: Insertion index
+            x: X-coordinate
+            y: Y-coordinate
+            width: Width of rectangle
+            height: Height of rectangle
+            radius: Corner radius
         """
         
         GetDllLibPpt().ShapeList_InsertRoundRectangle.argtypes=[c_void_p ,c_int,c_float,c_float,c_float,c_float,c_float]
@@ -854,12 +905,14 @@ class ShapeList (SpireObject) :
 
     def AppendShapeConnector(self ,shapeType:'ShapeType',rectangle:'RectangleF')->'IShape':
         """
-    <summary>
-        Add new shape connector to collection.
-    </summary>
-    <param name="shapeType">Shape type</param>
-    <param name="rectangle">Rectangle should be inserted.</param>
-    <returns>Created shape</returns>
+        Adds a new connector shape.
+        
+        Args:
+            shapeType: Type of connector
+            rectangle: Bounding rectangle
+            
+        Returns:
+            IShape: New connector shape
         """
         enumshapeType:c_int = shapeType.value
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -874,12 +927,12 @@ class ShapeList (SpireObject) :
 
     def InsertShapeConnector(self ,index:int,shapeType:'ShapeType',rectangle:'RectangleF'):
         """
-    <summary>
-        Insert a new shape connector to collection.
-    </summary>
-    <param name="index">Index should be inserted.</param>
-    <param name="shapeType">Shape type.</param>
-    <param name="rectangle">Rectangle should be inserted.</param>
+        Inserts a new connector shape.
+        
+        Args:
+            index: Insertion index
+            shapeType: Type of connector
+            rectangle: Bounding rectangle
         """
         enumshapeType:c_int = shapeType.value
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -889,13 +942,15 @@ class ShapeList (SpireObject) :
 
     def AppendEmbedImageByImageData(self ,shapeType:ShapeType,embedImage:'IImageData',rectangle:RectangleF)->'IEmbedImage':
         """
-    <summary>
-        Add a new embed image to List.
-    </summary>
-    <param name="shapeType"></param>
-    <param name="embedImage"></param>
-    <param name="rectangle"></param>
-    <returns></returns>
+        Adds a new embedded image from image data.
+        
+        Args:
+            shapeType: Type of image shape
+            embedImage: Image data object
+            rectangle: Bounding rectangle
+            
+        Returns:
+            IEmbedImage: New image shape
         """
         enumshapeType:c_int = shapeType.value
         intPtrembedImage:c_void_p = embedImage.Ptr
@@ -910,13 +965,15 @@ class ShapeList (SpireObject) :
 
     def AppendEmbedImageByPath(self ,shapeType:ShapeType,fileName:str,rectangle:RectangleF)->'IEmbedImage':
         """
-    <summary>
-        Add a new embed image to List.
-    </summary>
-    <param name="shapeType"></param>
-    <param name="fileName"></param>
-    <param name="rectangle"></param>
-    <returns></returns>
+        Adds a new embedded image from file.
+        
+        Args:
+            shapeType: Type of image shape
+            fileName: Path to image file
+            rectangle: Bounding rectangle
+            
+        Returns:
+            IEmbedImage: New image shape
         """
         enumshapeType:c_int = shapeType.value
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -930,13 +987,15 @@ class ShapeList (SpireObject) :
 
     def AppendEmbedImageByStream(self ,shapeType:ShapeType,stream:Stream,rectangle:RectangleF)->'IEmbedImage':
         """
-    <summary>
-        Add a new embed image to List.
-    </summary>
-    <param name="shapeType"></param>
-    <param name="embedImage"></param>
-    <param name="rectangle"></param>
-    <returns></returns>
+        Adds a new embedded image from stream.
+        
+        Args:
+            shapeType: Type of image shape
+            stream: Image data stream
+            rectangle: Bounding rectangle
+            
+        Returns:
+            IEmbedImage: New image shape
         """
         enumshapeType:c_int = shapeType.value
         intPtrstream:c_void_p = stream.Ptr
@@ -952,13 +1011,13 @@ class ShapeList (SpireObject) :
 
     def InsertEmbedImage(self ,index:int,shapeType:'ShapeType',rectangle:'RectangleF',embedImage:'IImageData'):
         """
-    <summary>
-        Insert a embed image to collection.
-    </summary>
-    <param name="index">Index should be inserted.</param>
-    <param name="shapeType">Shape type.</param>
-    <param name="rectangle">Rectangle should be inserted.</param>
-    <param name="embedImage">Embed image object.</param>
+        Inserts an embedded image.
+        
+        Args:
+            index: Insertion index
+            shapeType: Type of image shape
+            rectangle: Bounding rectangle
+            embedImage: Image data object
         """
         enumshapeType:c_int = shapeType.value
         intPtrrectangle:c_void_p = rectangle.Ptr
@@ -970,10 +1029,10 @@ class ShapeList (SpireObject) :
 
     def AddShape(self ,shape:'Shape'):
         """
-    <summary>
-        Add a shape to collection from slide.
-    </summary>
-    <param name="index">shape should be inserted.</param>
+        Adds an existing shape to the collection.
+        
+        Args:
+            shape: Shape to add
         """
         intPtrshape:c_void_p = shape.Ptr
 
@@ -983,14 +1042,16 @@ class ShapeList (SpireObject) :
 
     def AppendTable(self ,x:float,y:float,widths:List[float],heights:List[float])->'ITable':
         """
-    <summary>
-        Add a new table to collection.
-    </summary>
-    <param name="x"></param>
-    <param name="y"></param>
-    <param name="widths"></param>
-    <param name="heights"></param>
-    <returns></returns>
+        Adds a new table to the collection.
+        
+        Args:
+            x: X-coordinate
+            y: Y-coordinate
+            widths: List of column widths
+            heights: List of row heights
+            
+        Returns:
+            ITable: New table instance
         """
         #arraywidths:ArrayTypewidths = ""
         countwidths = len(widths)
@@ -1017,14 +1078,14 @@ class ShapeList (SpireObject) :
 
     def InsertTable(self ,index:int,x:float,y:float,columnWidths:List[float],rowHeights:List[float]):
         """
-    <summary>
-        Adds a new Table to collection.
-    </summary>
-    <param name="index">Index should be inserted.</param>
-    <param name="x">Left side of shape.</param>
-    <param name="y">Top side of shape.</param>
-    <param name="columnWidths">Widths of columns in the table.</param>
-    <param name="rowHeights">Heights of rows in the table.</param>
+        Inserts a new table at specified position.
+        
+        Args:
+            index: Insertion index
+            x: X-coordinate
+            y: Y-coordinate
+            columnWidths: List of column widths
+            rowHeights: List of row heights
         """
         #arraycolumnWidths:ArrayTypecolumnWidths = ""
         countcolumnWidths = len(columnWidths)
@@ -1047,10 +1108,10 @@ class ShapeList (SpireObject) :
 
     def RemoveAt(self ,index:int):
         """
-    <summary>
-        Removes the element at the specified index of the collection.
-    </summary>
-    <param name="index">The zero-based index of the element to remove.</param>
+        Removes the shape at the specified index.
+        
+        Args:
+            index: Index of shape to remove
         """
         
         GetDllLibPpt().ShapeList_RemoveAt.argtypes=[c_void_p ,c_int]
@@ -1059,10 +1120,10 @@ class ShapeList (SpireObject) :
 
     def Remove(self ,shape:'IShape'):
         """
-    <summary>
-        Removes the first occurrence of a specific shape from the collection.
-    </summary>
-    <param name="shape">The shape to remove from the collection.</param>
+        Removes a specific shape from the collection.
+        
+        Args:
+            shape: Shape to remove
         """
         intPtrshape:c_void_p = shape.Ptr