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

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

@@ -8,14 +8,20 @@ import abc
 
 class FillStyleCollection (  FillStyleList, ICollection) :
     """
-    <summary>
-        Represents the collection of fill styles.
-    </summary>
+    Represents a thread-safe collection of fill styles used in presentation themes.
+    
+    Implements additional synchronization capabilities for multi-threaded access.
     """
 
     def Equals(self ,obj:'SpireObject')->bool:
         """
-
+        Determines whether the current collection is equal to another object.
+        
+        Args:
+            obj: The object to compare with
+        
+        Returns:
+            bool: True if the objects are equal, otherwise False
         """
         intPtrobj:c_void_p = obj.Ptr
 
@@ -42,9 +48,10 @@ class FillStyleCollection (  FillStyleList, ICollection) :
     @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 synchronized (thread-safe), otherwise False
         """
         GetDllLibPpt().FillStyleCollection_get_IsSynchronized.argtypes=[c_void_p]
         GetDllLibPpt().FillStyleCollection_get_IsSynchronized.restype=c_bool
@@ -55,10 +62,10 @@ class FillStyleCollection (  FillStyleList, ICollection) :
 
     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: Synchronization root object
         """
         GetDllLibPpt().FillStyleCollection_get_SyncRoot.argtypes=[c_void_p]
         GetDllLibPpt().FillStyleCollection_get_SyncRoot.restype=c_void_p

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

@@ -8,14 +8,20 @@ import abc
 
 class FillStyleList (  FillListBase) :
     """
-    <summary>
-        Represents the collection of fill styles.
-    </summary>
+    Represents a collection of fill styles used in presentation themes.
+    
+    Provides base functionality for accessing and managing fill style elements.
     """
 
     def Equals(self ,obj:'SpireObject')->bool:
         """
-
+        Determines whether the current collection is equal to another object.
+        
+        Args:
+            obj: The object to compare with
+        
+        Returns:
+            bool: True if the objects are equal, otherwise False
         """
         intPtrobj:c_void_p = obj.Ptr
 

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

@@ -8,31 +8,16 @@ import abc
 
 class GradientStopCollection (  GradientStopList) :
     """
-    <summary>
-        Represnts a collection of gradient stops.
-    </summary>
+    Represents a collection of gradient stops.
+
     """
-#
-#    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().GradientStopCollection_CopyTo.argtypes=[c_void_p ,c_void_p,c_int]
-#        CallCFunction(GetDllLibPpt().GradientStopCollection_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>
+    
         """
         GetDllLibPpt().GradientStopCollection_get_IsSynchronized.argtypes=[c_void_p]
         GetDllLibPpt().GradientStopCollection_get_IsSynchronized.restype=c_bool
@@ -43,10 +28,8 @@ class GradientStopCollection (  GradientStopList) :
 
     def SyncRoot(self)->'SpireObject':
         """
-    <summary>
         Gets a synchronization root.
-            Readonly <see cref="T:System.Object" />.
-    </summary>
+            
         """
         GetDllLibPpt().GradientStopCollection_get_SyncRoot.argtypes=[c_void_p]
         GetDllLibPpt().GradientStopCollection_get_SyncRoot.restype=c_void_p

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

@@ -8,17 +8,14 @@ import abc
 
 class GradientStopDataCollection (  ICollection, IEnumerable) :
     """
-    <summary>
-        Represents a collection of GradientStopData objects.
-    </summary>
+    Represents a collection of GradientStopData objects.
+    
     """
     @property
     def Count(self)->int:
         """
-    <summary>
         Gets the number of gradient stops in a collection.
-            Read-only <see cref="T:System.Int32" />.
-    </summary>
+            
         """
         GetDllLibPpt().GradientStopDataCollection_get_Count.argtypes=[c_void_p]
         GetDllLibPpt().GradientStopDataCollection_get_Count.restype=c_int
@@ -28,9 +25,8 @@ class GradientStopDataCollection (  ICollection, IEnumerable) :
 
     def get_Item(self ,index:int)->'GradientStopData':
         """
-    <summary>
         Gets the gradient stop by index.
-    </summary>
+ 
         """
         
         GetDllLibPpt().GradientStopDataCollection_get_Item.argtypes=[c_void_p ,c_int]
@@ -43,10 +39,8 @@ class GradientStopDataCollection (  ICollection, IEnumerable) :
 
     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>
+   
         """
         GetDllLibPpt().GradientStopDataCollection_GetEnumerator.argtypes=[c_void_p]
         GetDllLibPpt().GradientStopDataCollection_GetEnumerator.restype=c_void_p
@@ -55,27 +49,11 @@ class GradientStopDataCollection (  ICollection, IEnumerable) :
         return ret
 
 
-#
-#    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().GradientStopDataCollection_CopyTo.argtypes=[c_void_p ,c_void_p,c_int]
-#        CallCFunction(GetDllLibPpt().GradientStopDataCollection_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>
+   
         """
         GetDllLibPpt().GradientStopDataCollection_get_IsSynchronized.argtypes=[c_void_p]
         GetDllLibPpt().GradientStopDataCollection_get_IsSynchronized.restype=c_bool
@@ -86,10 +64,8 @@ class GradientStopDataCollection (  ICollection, IEnumerable) :
 
     def SyncRoot(self)->'SpireObject':
         """
-    <summary>
         Gets a synchronization root.
-            Readonly <see cref="T:System.Object" />.
-    </summary>
+           
         """
         GetDllLibPpt().GradientStopDataCollection_get_SyncRoot.argtypes=[c_void_p]
         GetDllLibPpt().GradientStopDataCollection_get_SyncRoot.restype=c_void_p

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

@@ -8,9 +8,8 @@ import abc
 
 class GradientStopList ( IActiveSlide) :
     """
-    <summary>
-        Represnts a collection of gradient stops.
-    </summary>
+    Represnts a collection of gradient stops.
+    
     """
 
     @dispatch
@@ -26,10 +25,8 @@ class GradientStopList ( IActiveSlide) :
     @property
     def Count(self)->int:
         """
-    <summary>
         Gets the number of gradient stops in a collection.
-            Read-only <see cref="T:System.Int32" />.
-    </summary>
+          
         """
         GetDllLibPpt().GradientStopList_get_Count.argtypes=[c_void_p]
         GetDllLibPpt().GradientStopList_get_Count.restype=c_int
@@ -39,9 +36,8 @@ class GradientStopList ( IActiveSlide) :
 
     def get_Item(self ,index:int)->'GradientStop':
         """
-    <summary>
         Gets the gradient stop by index.
-    </summary>
+    
         """
         
         GetDllLibPpt().GradientStopList_get_Item.argtypes=[c_void_p ,c_int]
@@ -53,12 +49,12 @@ class GradientStopList ( IActiveSlide) :
 
     def AppendByColor(self ,position:float,color:Color)->int:
         """
-    <summary>
-        Creates the new gradient stop.
-    </summary>
-    <param name="position">Position of the new gradient stop.</param>
-    <param name="color">Color of the new radient stop.</param>
-    <returns>Index of the new gradient stop in the collection.</returns>
+        Creates a new gradient stop with the specified color.
+        Args:
+            position: Stop position (0.0 to 1.0)
+            color: Stop color
+        Returns:
+            Index of the new gradient stop
         """
         intPtrcolor:c_void_p = color.Ptr
 
@@ -69,12 +65,12 @@ class GradientStopList ( IActiveSlide) :
 
     def AppendByKnownColors(self ,position:float,knownColor:KnownColors)->int:
         """
-    <summary>
-        Creates the new gradient stop and adds it to the collection.
-    </summary>
-    <param name="position">Position of the new gradient stop.</param>
-    <param name="knownColor">Color of the new radient stop.</param>
-    <returns>Index of the new gradient stop in the collection.</returns>
+        Creates a new gradient stop with a predefined color.
+        Args:
+            position: Stop position (0.0 to 1.0)
+            knownColor: Predefined color value
+        Returns:
+            Index of the new gradient stop
         """
         enumknownColor:c_int = knownColor.value
 
@@ -86,12 +82,12 @@ class GradientStopList ( IActiveSlide) :
 
     def AppendBySchemeColor(self ,position:float,schemeColor:SchemeColor)->int:
         """
-    <summary>
-        Creates the new gradient stop.
-    </summary>
-    <param name="position">Position of the new gradient stop.</param>
-    <param name="schemeColor">Color of the new radient stop.</param>
-    <returns>Index of the new gradient stop in the collection.</returns>
+        Creates a new gradient stop with a scheme color.
+        Args:
+            position: Stop position (0.0 to 1.0)
+            schemeColor: Color scheme value
+        Returns:
+            Index of the new gradient stop
         """
         enumschemeColor:c_int = schemeColor.value
 
@@ -103,12 +99,11 @@ class GradientStopList ( IActiveSlide) :
   
     def InsertByColor(self ,index:int,position:float,color:Color):
         """
-    <summary>
-        Creates the new gradient stop.
-    </summary>
-    <param name="index">Index in the collection where new gradient stop will be inserted.</param>
-    <param name="position">Position of the new gradient stop.</param>
-    <param name="color">Color of the new radient stop.</param>
+        Inserts a new gradient stop at the specified index.
+        Args:
+            index: Insertion position
+            position: Stop position (0.0 to 1.0)
+            color: Stop color
         """
         intPtrcolor:c_void_p = color.Ptr
 
@@ -118,12 +113,11 @@ class GradientStopList ( IActiveSlide) :
    
     def InsertByKnownColors(self ,index:int,position:float,knownColor:KnownColors):
         """
-    <summary>
-        Creates the new gradient stop.
-    </summary>
-    <param name="index">Index in the collection where new gradient stop will be inserted.</param>
-    <param name="position">Position of the new gradient stop.</param>
-    <param name="knownColor">Color of the new radient stop.</param>
+        Creates a new gradient stop with a predefined color.
+        Args:
+            index: Insertion position
+            position: Stop position (0.0 to 1.0)
+            knownColor: Predefined color value.
         """
         enumknownColor:c_int = knownColor.value
 
@@ -133,12 +127,11 @@ class GradientStopList ( IActiveSlide) :
     
     def InsertBySchemeColor(self ,index:int,position:float,schemeColor:SchemeColor):
         """
-    <summary>
-        Creates the new gradient stop.
-    </summary>
-    <param name="index">Index in the collection where new gradient stop will be inserted.</param>
-    <param name="position">Position of the new gradient stop.</param>
-    <param name="schemeColor">Color of the new radient stop.</param>
+        Creates a new gradient stop with a scheme color.
+        Args:
+            index: Insertion position
+            position: Stop position (0.0 to 1.0)
+            schemeColor: Color scheme value.
         """
         enumschemeColor:c_int = schemeColor.value
 
@@ -148,10 +141,7 @@ class GradientStopList ( IActiveSlide) :
 
     def RemoveAt(self ,index:int):
         """
-    <summary>
-        Removes a gradient stop at the specified index.
-    </summary>
-    <param name="index">Index of a gradient stop that should be deleted.</param>
+        Removes the gradient stop at the specified index.
         """
         
         GetDllLibPpt().GradientStopList_RemoveAt.argtypes=[c_void_p ,c_int]
@@ -159,9 +149,8 @@ class GradientStopList ( IActiveSlide) :
 
     def RemoveAll(self):
         """
-    <summary>
         Removes all gradient stops from a collection.
-    </summary>
+   
         """
         GetDllLibPpt().GradientStopList_RemoveAll.argtypes=[c_void_p]
         CallCFunction(GetDllLibPpt().GradientStopList_RemoveAll,self.Ptr)
@@ -169,10 +158,9 @@ class GradientStopList ( 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>
+        Returns:
+            IEnumerator for the entire collection.
         """
         GetDllLibPpt().GradientStopList_GetEnumerator.argtypes=[c_void_p]
         GetDllLibPpt().GradientStopList_GetEnumerator.restype=c_void_p

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

@@ -8,14 +8,17 @@ import abc
 
 class IMasterLayouts (SpireObject) :
     """
-
+    Represents a collection of layout slides associated with a master slide.
+    
+    This class provides access to different layout slides in a presentation.
     """
     @property
     def Count(self)->int:
         """
-    <summary>
-        Gets the number of layout slides in a collection.
-    </summary>
+        Gets the number of layout slides in the collection.
+        
+        Returns:
+            int: Total number of layout slides
         """
         GetDllLibPpt().IMasterLayouts_get_Count.argtypes=[c_void_p]
         GetDllLibPpt().IMasterLayouts_get_Count.restype=c_int
@@ -25,7 +28,13 @@ class IMasterLayouts (SpireObject) :
 
     def get_Item(self ,index:int)->'ILayout':
         """
-
+        Gets a layout slide by its index.
+        
+        Args:
+            index (int): Zero-based index of the layout slide
+        
+        Returns:
+            ILayout: The layout slide at the specified index
         """
         
         GetDllLibPpt().IMasterLayouts_get_Item.argtypes=[c_void_p ,c_int]
@@ -38,7 +47,13 @@ class IMasterLayouts (SpireObject) :
 
     def GetByType(self ,type:'SlideLayoutType')->'ILayout':
         """
-
+        Gets a layout slide by its predefined layout type.
+        
+        Args:
+            type (SlideLayoutType): The predefined layout type
+        
+        Returns:
+            ILayout: The matching layout slide
         """
         enumtype:c_int = type.value
 
@@ -52,7 +67,10 @@ class IMasterLayouts (SpireObject) :
 
     def RemoveMasterLayout(self ,index:int):
         """
-
+        Removes a layout slide from the collection by index.
+        
+        Args:
+            index (int): Zero-based index of the layout to remove
         """
         
         GetDllLibPpt().IMasterLayouts_RemoveMasterLayout.argtypes=[c_void_p ,c_int]

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

@@ -8,31 +8,15 @@ import abc
 
 class ImageCollection (  EmbedImageList) :
     """
-    <summary>
-        Represents collection of Image.
-    </summary>
+    Represents collection of Image.
+    
     """
-#
-#    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().ImageCollection_CopyTo.argtypes=[c_void_p ,c_void_p,c_int]
-#        CallCFunction(GetDllLibPpt().ImageCollection_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>
+   
         """
         GetDllLibPpt().ImageCollection_get_IsSynchronized.argtypes=[c_void_p]
         GetDllLibPpt().ImageCollection_get_IsSynchronized.restype=c_bool
@@ -43,10 +27,8 @@ class ImageCollection (  EmbedImageList) :
 
     def SyncRoot(self)->'SpireObject':
         """
-    <summary>
         Gets a synchronization root.
-            Readonly <see cref="T:System.Object" />.
-    </summary>
+          
         """
         GetDllLibPpt().ImageCollection_get_SyncRoot.argtypes=[c_void_p]
         GetDllLibPpt().ImageCollection_get_SyncRoot.restype=c_void_p

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

@@ -8,31 +8,15 @@ import abc
 
 class ImageTransformEffectCollection (  ImageTransform, ICollection) :
     """
-    <summary>
-        Represents a collection of effects apllied to an image.
-    </summary>
+    Represents a collection of effects apllied to an image.
+    
     """
-#
-#    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().ImageTransformEffectCollection_CopyTo.argtypes=[c_void_p ,c_void_p,c_int]
-#        CallCFunction(GetDllLibPpt().ImageTransformEffectCollection_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>
+    
         """
         GetDllLibPpt().ImageTransformEffectCollection_get_IsSynchronized.argtypes=[c_void_p]
         GetDllLibPpt().ImageTransformEffectCollection_get_IsSynchronized.restype=c_bool
@@ -43,10 +27,8 @@ class ImageTransformEffectCollection (  ImageTransform, ICollection) :
 
     def SyncRoot(self)->'SpireObject':
         """
-    <summary>
         Gets a synchronization root.
-            Readonly <see cref="T:System.Object" />.
-    </summary>
+         
         """
         GetDllLibPpt().ImageTransformEffectCollection_get_SyncRoot.argtypes=[c_void_p]
         GetDllLibPpt().ImageTransformEffectCollection_get_SyncRoot.restype=c_void_p

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

@@ -8,14 +8,20 @@ import abc
 
 class LineStyleCollection (  LineStyleList, ICollection) :
     """
-    <summary>
-        Represents the collection of line styles.
-    </summary>
+    Represents a collection of line styles in a presentation.
+    
+    This class provides thread-safe access to a collection of line formatting styles.
     """
 
     def Equals(self ,obj:'SpireObject')->bool:
         """
-
+        Determines whether the specified object is equal to the current LineStyleCollection.
+        
+        Args:
+            obj (SpireObject): The object to compare with.
+            
+        Returns:
+            bool: True if the objects are equal; otherwise, False.
         """
         intPtrobj:c_void_p = obj.Ptr
 
@@ -24,27 +30,14 @@ class LineStyleCollection (  LineStyleList, ICollection) :
         ret = CallCFunction(GetDllLibPpt().LineStyleCollection_Equals,self.Ptr, intPtrobj)
         return ret
 
-#
-#    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().LineStyleCollection_CopyTo.argtypes=[c_void_p ,c_void_p,c_int]
-#        CallCFunction(GetDllLibPpt().LineStyleCollection_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>
+        Checks whether access to the collection is thread-safe.
+        
+        Returns:
+            bool: True if access is synchronized (thread-safe); otherwise, False.
         """
         GetDllLibPpt().LineStyleCollection_get_IsSynchronized.argtypes=[c_void_p]
         GetDllLibPpt().LineStyleCollection_get_IsSynchronized.restype=c_bool
@@ -55,10 +48,10 @@ class LineStyleCollection (  LineStyleList, ICollection) :
 
     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().LineStyleCollection_get_SyncRoot.argtypes=[c_void_p]
         GetDllLibPpt().LineStyleCollection_get_SyncRoot.restype=c_void_p