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

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

@@ -8,17 +8,15 @@ import abc
 
 class ParagraphList (  IActiveSlide) :
     """
-    <summary>
-        Represents a collection of a paragraphs.
-    </summary>
+    Represents a collection of paragraphs in a presentation slide.
     """
 
     def AddFromHtml(self ,htmlText:str):
         """
-    <summary>
-        Adds text from specified html string.
-    </summary>
-    <param name="htmlText">HTML text.</param>
+        Adds text content to the collection from HTML-formatted text.
+        
+        Args:
+            htmlText: HTML-formatted string to add as paragraphs
         """
         
         htmlTextPtr = StrToPtr(htmlText)
@@ -28,9 +26,10 @@ class ParagraphList (  IActiveSlide) :
     @property
     def Count(self)->int:
         """
-    <summary>
-        Gets the number of elements actually contained in the collection.
-    </summary>
+        Gets the number of paragraphs contained in the collection.
+        
+        Returns:
+            int: The actual number of paragraphs in the collection
         """
         GetDllLibPpt().ParagraphList_get_Count.argtypes=[c_void_p]
         GetDllLibPpt().ParagraphList_get_Count.restype=c_int
@@ -39,6 +38,18 @@ class ParagraphList (  IActiveSlide) :
 
     @dispatch
     def __getitem__(self, index):
+        """
+        Gets the paragraph at the specified index position.
+        
+        Args:
+            index: Zero-based index of the paragraph to retrieve
+            
+        Returns:
+            TextParagraph: The paragraph at the specified index
+            
+        Raises:
+            StopIteration: If index is out of range
+        """
         if index >= self.Count:
             raise StopIteration
         GetDllLibPpt().ParagraphList_get_Item.argtypes=[c_void_p ,c_int]
@@ -49,9 +60,13 @@ class ParagraphList (  IActiveSlide) :
 
     def get_Item(self ,index:int)->'TextParagraph':
         """
-    <summary>
-        Gets the element at the specified index.
-    </summary>
+        Gets the paragraph at the specified index position.
+        
+        Args:
+            index: Zero-based index of the paragraph to retrieve
+            
+        Returns:
+            TextParagraph: The paragraph at the specified index
         """
         
         GetDllLibPpt().ParagraphList_get_Item.argtypes=[c_void_p ,c_int]
@@ -63,11 +78,13 @@ class ParagraphList (  IActiveSlide) :
     
     def Append(self ,value:'TextParagraph')->int:
         """
-    <summary>
-        Adds a Paragraph to the end of collection.
-    </summary>
-    <param name="value">The Paragraph </param>
-    <returns>The index at which the Paragraph has been added.</returns>
+        Adds a paragraph to the end of the collection.
+        
+        Args:
+            value: The paragraph to add to the collection
+            
+        Returns:
+            int: The index position where the paragraph was added
         """
         intPtrvalue:c_void_p = value.Ptr
 
@@ -79,11 +96,13 @@ class ParagraphList (  IActiveSlide) :
     
     def AppendCollection(self ,value:'ParagraphCollection')->int:
         """
-    <summary>
-        Adds a content of Paragraphs to the end of collection.
-    </summary>
-    <param name="value">The ParagraphCollection </param>
-    <returns>The index at which the Paragraph has been added or -1 if there are nothing to add.</returns>
+        Adds all paragraphs from another collection to the end of this collection.
+        
+        Args:
+            value: The source collection containing paragraphs to add
+            
+        Returns:
+            int: The starting index where paragraphs were added, or -1 if no paragraphs were added
         """
         intPtrvalue:c_void_p = value.Ptr
 
@@ -96,11 +115,11 @@ class ParagraphList (  IActiveSlide) :
 
     def Insert(self ,index:int,value:'TextParagraph'):
         """
-    <summary>
-        Inserts a Paragraph into the collection at the specified index.
-    </summary>
-    <param name="index">The zero-based index at which Paragraph should be inserted.</param>
-    <param name="value">The Paragraph to insert.</param>
+        Inserts a paragraph at the specified index position.
+        
+        Args:
+            index: Zero-based index at which to insert the paragraph
+            value: The paragraph to insert
         """
         intPtrvalue:c_void_p = value.Ptr
 
@@ -111,11 +130,11 @@ class ParagraphList (  IActiveSlide) :
 
     def InsertCollection(self ,index:int,value:'ParagraphCollection'):
         """
-    <summary>
-        Inserts a content of ParagraphExCollection into the collection at the specified index.
-    </summary>
-    <param name="index">The zero-based index at which paragraphs should be inserted.</param>
-    <param name="value">The paragraphs to insert.</param>
+        Inserts all paragraphs from another collection at the specified index position.
+        
+        Args:
+            index: Zero-based index at which to insert paragraphs
+            value: The source collection containing paragraphs to insert
         """
         intPtrvalue:c_void_p = value.Ptr
 
@@ -124,9 +143,7 @@ class ParagraphList (  IActiveSlide) :
 
     def Clear(self):
         """
-    <summary>
-        Removes all elements from the collection.
-    </summary>
+        Removes all paragraphs from the collection.
         """
         GetDllLibPpt().ParagraphList_Clear.argtypes=[c_void_p]
         CallCFunction(GetDllLibPpt().ParagraphList_Clear,self.Ptr)
@@ -134,10 +151,10 @@ class ParagraphList (  IActiveSlide) :
 
     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 paragraph at the specified index position.
+        
+        Args:
+            index: Zero-based index of the paragraph to remove
         """
         
         GetDllLibPpt().ParagraphList_RemoveAt.argtypes=[c_void_p ,c_int]
@@ -146,10 +163,10 @@ class ParagraphList (  IActiveSlide) :
 
     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().ParagraphList_GetEnumerator.argtypes=[c_void_p]
         GetDllLibPpt().ParagraphList_GetEnumerator.restype=c_void_p
@@ -161,7 +178,13 @@ class ParagraphList (  IActiveSlide) :
 
     def Equals(self ,obj:'SpireObject')->bool:
         """
-
+        Determines whether the specified object is equal to the current object.
+        
+        Args:
+            obj: The object to compare with the current object
+            
+        Returns:
+            bool: True if the specified object is equal to the current object; otherwise False
         """
         intPtrobj:c_void_p = obj.Ptr
 

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

@@ -8,31 +8,17 @@ import abc
 
 class ShapeAdjustCollection (  ShapeAdjustmentList, ICollection, IEnumerable) :
     """
-    <summary>
-        Reprasents a collection of shape's adjustments.
-    </summary>
+    Represents a collection of shape adjustments.
+    Inherits from ShapeAdjustmentList and implements collection interfaces.
     """
-#
-#    def CopyTo(self ,array:'Array',index:int):
-#        """
-#    <summary>
-#        Copies all elements from the collection to the specified array.
-#    </summary>
-#    <param name="array">Target array.</param>
-#    <param name="index">Starting index in the target array.</param>
-#        """
-#        intPtrarray:c_void_p = array.Ptr
-#
-#        GetDllLibPpt().ShapeAdjustCollection_CopyTo.argtypes=[c_void_p ,c_void_p,c_int]
-#        CallCFunction(GetDllLibPpt().ShapeAdjustCollection_CopyTo,self.Ptr, intPtrarray,index)
-
 
     @property
     def IsSynchronized(self)->bool:
         """
-    <summary>
-        Gets a value indicating whether access to the collection is synchronized (thread-safe).
-    </summary>
+        Indicates whether access to the collection is thread-safe.
+
+        Returns:
+            bool: True if collection access is synchronized, False otherwise
         """
         GetDllLibPpt().ShapeAdjustCollection_get_IsSynchronized.argtypes=[c_void_p]
         GetDllLibPpt().ShapeAdjustCollection_get_IsSynchronized.restype=c_bool
@@ -43,10 +29,9 @@ class ShapeAdjustCollection (  ShapeAdjustmentList, ICollection, IEnumerable) :
 
     def SyncRoot(self)->'SpireObject':
         """
-    <summary>
-        Gets a synchronization root.
-            Readonly <see cref="T:System.Object" />.
-    </summary>
+        Gets an object that can be used to synchronize access to the collection.
+        Returns:
+            SpireObject: An object that can be used for synchronization
         """
         GetDllLibPpt().ShapeAdjustCollection_get_SyncRoot.argtypes=[c_void_p]
         GetDllLibPpt().ShapeAdjustCollection_get_SyncRoot.restype=c_void_p
@@ -58,9 +43,10 @@ class ShapeAdjustCollection (  ShapeAdjustmentList, ICollection, IEnumerable) :
 
     def GetEnumerator(self)->'IEnumerator':
         """
-    <summary>
-        Gets an enumerator for the entire collection.
-    </summary>
+        Returns an enumerator that iterates through the collection.
+
+        Returns:
+            IEnumerator: An enumerator object for the collection
         """
         GetDllLibPpt().ShapeAdjustCollection_GetEnumerator.argtypes=[c_void_p]
         GetDllLibPpt().ShapeAdjustCollection_GetEnumerator.restype=c_void_p

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

@@ -8,16 +8,15 @@ import abc
 
 class ShapeAdjustmentList (SpireObject) :
     """
-    <summary>
-        Reprasents a collection of shape's adjustments.
-    </summary>
+    Represents a collection of shape adjustments.
     """
     @property
     def Count(self)->int:
         """
-    <summary>
-        Return a number of adjustments.
-    </summary>
+        Gets the number of adjustments in the collection.
+
+        Returns:
+            int: Total number of adjustments
         """
         GetDllLibPpt().ShapeAdjustmentList_get_Count.argtypes=[c_void_p]
         GetDllLibPpt().ShapeAdjustmentList_get_Count.restype=c_int
@@ -27,12 +26,12 @@ class ShapeAdjustmentList (SpireObject) :
 
     def get_Item(self ,index:int)->'ShapeAdjust':
         """
-    <summary>
-        Gets adjustment by index.
-    </summary>
-    <param name="index">adjustment's index.</param>
-    <returns>
-  <see cref="T:Spire.Presentation.ShapeAdjust" />.</returns>
+        Retrieves a shape adjustment by its index in the collection.
+
+        Args:
+            index (int): The zero-based index of the adjustment
+        Returns:
+            ShapeAdjust: The adjustment object at the specified index
         """
         
         GetDllLibPpt().ShapeAdjustmentList_get_Item.argtypes=[c_void_p ,c_int]