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

spire/presentation/{Cell.py → table/Cell.py}

@@ -8,17 +8,17 @@ import abc
 
 class Cell (  IActiveSlide, IActivePresentation) :
     """
-    <summary>
-        Represents a cell of a table.
-    </summary>
+    Represents a single cell in a presentation table.
+    Provides properties for layout, formatting, and content management.
     """
     @property
     def OffsetX(self)->float:
         """
-    <summary>
-        Gets a distance from left side of a table to left side of a cell.
-            Read-only <see cref="T:System.Double" />.
-    </summary>
+        Gets the horizontal offset from table's left edge to cell's left edge.
+        Read-only.
+        
+        Returns:
+            float: Horizontal offset in points.
         """
         GetDllLibPpt().Cell_get_OffsetX.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_OffsetX.restype=c_double
@@ -28,10 +28,11 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def OffsetY(self)->float:
         """
-    <summary>
-        Gets a distance from top side of a table to top side of a cell.
-            Read-only <see cref="T:System.Double" />.
-    </summary>
+        Gets the vertical offset from table's top edge to cell's top edge.
+        Read-only.
+        
+        Returns:
+            float: Vertical offset in points.
         """
         GetDllLibPpt().Cell_get_OffsetY.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_OffsetY.restype=c_double
@@ -41,10 +42,11 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def FirstRowIndex(self)->int:
         """
-    <summary>
-        Gets an index of first row, covered by the cell.
-            Read-only <see cref="T:System.Int32" />.
-    </summary>
+        Gets the index of the first row spanned by this cell.
+        Read-only.
+        
+        Returns:
+            int: First row index.
         """
         GetDllLibPpt().Cell_get_FirstRowIndex.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_FirstRowIndex.restype=c_int
@@ -54,10 +56,9 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def FirstColumnIndex(self)->int:
         """
-    <summary>
         Gets an index of first column, covered by the cell.
-            Read-only <see cref="T:System.Int32" />.
-    </summary>
+        Returns:
+            int: First column index.
         """
         GetDllLibPpt().Cell_get_FirstColumnIndex.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_FirstColumnIndex.restype=c_int
@@ -67,10 +68,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def Width(self)->float:
         """
-    <summary>
         Gets the width of the cell.
-            Read-only <see cref="T:System.Double" />.
-    </summary>
+            
         """
         GetDllLibPpt().Cell_get_Width.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_Width.restype=c_double
@@ -80,10 +79,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def Height(self)->float:
         """
-    <summary>
         Gets the height of the cell.
-            Read-only <see cref="T:System.Double" />.
-    </summary>
+           
         """
         GetDllLibPpt().Cell_get_Height.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_Height.restype=c_double
@@ -93,11 +90,9 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def MinimalHeight(self)->float:
         """
-    <summary>
         Gets the minimum height of a cell.
-            This is a sum of minimal heights of all rows cowered by the cell.
-            Read-only <see cref="T:System.Double" />.
-    </summary>
+        This is a sum of minimal heights of all rows cowered by the cell.
+            
         """
         GetDllLibPpt().Cell_get_MinimalHeight.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_MinimalHeight.restype=c_double
@@ -108,10 +103,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def BorderLeft(self)->'TextLineFormat':
         """
-    <summary>
         Gets a left border line properties object.
-            Read-only <see cref="T:Spire.Presentation.TextLineFormat" />.
-    </summary>
+        Read-only 
         """
         GetDllLibPpt().Cell_get_BorderLeft.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_BorderLeft.restype=c_void_p
@@ -124,10 +117,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def BorderTop(self)->'TextLineFormat':
         """
-    <summary>
         Gets a top border line properties object.
-            Read-only <see cref="T:Spire.Presentation.TextLineFormat" />.
-    </summary>
+        Read-only
         """
         GetDllLibPpt().Cell_get_BorderTop.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_BorderTop.restype=c_void_p
@@ -140,10 +131,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def BorderRight(self)->'TextLineFormat':
         """
-    <summary>
         Gets a right border line properties object.
-            Read-only <see cref="T:Spire.Presentation.TextLineFormat" />.
-    </summary>
+        Read-only 
         """
         GetDllLibPpt().Cell_get_BorderRight.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_BorderRight.restype=c_void_p
@@ -156,10 +145,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def BorderBottom(self)->'TextLineFormat':
         """
-    <summary>
         Gets a bottom border line properties object.
-            Read-only <see cref="T:Spire.Presentation.TextLineFormat" />.
-    </summary>
+        Read-only 
         """
         GetDllLibPpt().Cell_get_BorderBottom.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_BorderBottom.restype=c_void_p
@@ -172,9 +159,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def BorderLeftDisplayColor(self)->'Color':
         """
-    <summary>
         Gets a left border display color.
-    </summary>
+    
         """
         GetDllLibPpt().Cell_get_BorderLeftDisplayColor.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_BorderLeftDisplayColor.restype=c_void_p
@@ -187,9 +173,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def BorderTopDisplayColor(self)->'Color':
         """
-    <summary>
         Gets a top border display color.
-    </summary>
+    
         """
         GetDllLibPpt().Cell_get_BorderTopDisplayColor.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_BorderTopDisplayColor.restype=c_void_p
@@ -202,9 +187,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def BorderRightDisplayColor(self)->'Color':
         """
-    <summary>
         Gets a right border display color.
-    </summary>
+    
         """
         GetDllLibPpt().Cell_get_BorderRightDisplayColor.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_BorderRightDisplayColor.restype=c_void_p
@@ -217,9 +201,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def BorderBottomDisplayColor(self)->'Color':
         """
-    <summary>
         Gets a bottom border display color.
-    </summary>
+    
         """
         GetDllLibPpt().Cell_get_BorderBottomDisplayColor.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_BorderBottomDisplayColor.restype=c_void_p
@@ -232,10 +215,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def BorderDiagonalDown(self)->'TextLineFormat':
         """
-    <summary>
         Gets a top-left to bottom-right diagonal line properties object.
-            Read-only <see cref="T:Spire.Presentation.TextLineFormat" />.
-    </summary>
+        Read-only 
         """
         GetDllLibPpt().Cell_get_BorderDiagonalDown.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_BorderDiagonalDown.restype=c_void_p
@@ -248,10 +229,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def BorderDiagonalUp(self)->'TextLineFormat':
         """
-    <summary>
         Gets a bottom-left to top-right diagonal line properties object.
-            Read-only <see cref="T:Spire.Presentation.TextLineFormat" />.
-    </summary>
+        Read-only 
         """
         GetDllLibPpt().Cell_get_BorderDiagonalUp.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_BorderDiagonalUp.restype=c_void_p
@@ -264,10 +243,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def FillFormat(self)->'FillFormat':
         """
-    <summary>
         Gets a cell fill properties object.
-            Read-only <see cref="P:Spire.Presentation.Cell.FillFormat" />.
-    </summary>
+        Read-only
         """
         GetDllLibPpt().Cell_get_FillFormat.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_FillFormat.restype=c_void_p
@@ -279,10 +256,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def MarginLeft(self)->float:
         """
-    <summary>
         Gets or sets the left margin in a TextFrame.
-            Read/write <see cref="T:System.Double" />. 
-    </summary>
+        Read/write 
         """
         GetDllLibPpt().Cell_get_MarginLeft.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_MarginLeft.restype=c_double
@@ -297,10 +272,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def MarginRight(self)->float:
         """
-    <summary>
         Gets or sets the right margin in a TextFrame.
-            Read/write <see cref="T:System.Double" />. 
-    </summary>
+        Read/write 
         """
         GetDllLibPpt().Cell_get_MarginRight.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_MarginRight.restype=c_double
@@ -315,10 +288,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def MarginTop(self)->float:
         """
-    <summary>
         Gets or sets the top margin in a TextFrame.
-            Read/write <see cref="T:System.Double" />. 
-    </summary>
+        Read/write 
         """
         GetDllLibPpt().Cell_get_MarginTop.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_MarginTop.restype=c_double
@@ -333,10 +304,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def MarginBottom(self)->float:
         """
-    <summary>
         Gets or sets the bottom margin in a TextFrame.
-            Read/write <see cref="T:System.Double" />. 
-    </summary>
+        Read/write
         """
         GetDllLibPpt().Cell_get_MarginBottom.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_MarginBottom.restype=c_double
@@ -352,10 +321,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def VerticalTextType(self)->'VerticalTextType':
         """
-    <summary>
         Gets or sets the type of vertical text.
-            Read/write <see cref="P:Spire.Presentation.Cell.VerticalTextType" />.
-    </summary>
+        Read/write 
         """
         GetDllLibPpt().Cell_get_VerticalTextType.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_VerticalTextType.restype=c_int
@@ -372,10 +339,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def TextAnchorType(self)->'TextAnchorType':
         """
-    <summary>
         Gets or sets the text anchor type.
-            Read/write <see cref="P:Spire.Presentation.Cell.TextAnchorType" />.
-    </summary>
+        Read/write 
         """
         GetDllLibPpt().Cell_get_TextAnchorType.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_TextAnchorType.restype=c_int
@@ -391,10 +356,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def AnchorCenter(self)->bool:
         """
-    <summary>
         Indicates whether or not text box centered inside a cell.
-            Read/write <see cref="T:System.Boolean" />.
-    </summary>
+        Read/write 
         """
         GetDllLibPpt().Cell_get_AnchorCenter.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_AnchorCenter.restype=c_bool
@@ -409,13 +372,11 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def ColSpan(self)->int:
         """
-    <summary>
         Gets the number of grid columns in the parent table's table grid
-            which shall be spanned by the current cell. This property allows cells
-            to have the appearance of being merged, as they span vertical boundaries
-            of other cells in the table.
-            Read-only <see cref="T:System.Int32" />.
-    </summary>
+        which shall be spanned by the current cell. This property allows cells
+        to have the appearance of being merged, as they span vertical boundaries
+        of other cells in the table.
+        Read-only 
         """
         GetDllLibPpt().Cell_get_ColSpan.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_ColSpan.restype=c_int
@@ -425,12 +386,10 @@ class Cell (  IActiveSlide, IActivePresentation) :
     @property
     def RowSpan(self)->int:
         """
-    <summary>
         Gets the number of rows that a merged cell spans. This is used in combination
-            with the vMerge attribute on other cells in order to specify the beginning cell
-            of a horizontal merge.
-            Read-only <see cref="T:System.Int32" />.
-    </summary>
+        with the vMerge attribute on other cells in order to specify the beginning cell
+        of a horizontal merge.
+        Read-only.
         """
         GetDllLibPpt().Cell_get_RowSpan.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_RowSpan.restype=c_int
@@ -441,10 +400,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def TextFrame(self)->'ITextFrameProperties':
         """
-    <summary>
         Gets the text frame of a cell.
-            Read-only <see cref="T:Spire.Presentation.TextFrameProperties" />.
-    </summary>
+        Read-only 
         """
         GetDllLibPpt().Cell_get_TextFrame.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_TextFrame.restype=c_void_p
@@ -457,10 +414,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def Slide(self)->'ActiveSlide':
         """
-    <summary>
         Gets the parent slide of a cell.
-            Read-only <see cref="T:Spire.Presentation.ActiveSlide" />.
-    </summary>
+        Read-only 
         """
         GetDllLibPpt().Cell_get_Slide.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_Slide.restype=c_void_p
@@ -473,10 +428,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def Presentation(self)->'Presentation':
         """
-    <summary>
         Gets the parent presentation of a cell.
-            Read-only <see cref="T:Spire.Presentation.PresentationPptx" />.
-    </summary>
+        Read-only 
         """
         from spire.presentation import Presentation
         GetDllLibPpt().Cell_get_Presentation.argtypes=[c_void_p]
@@ -489,11 +442,10 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def Split(self ,RowCount:int,ColunmCount:int):
         """
-    <summary>
         Split the cell.
-    </summary>
-    <param name="RowCount">The number of cells being split in the row direction.</param>
-    <param name="ColunmCount">The number of cells being split in the colunm direction.</param>
+        Args:
+            RowCount:The number of cells being split in the row direction.
+            ColunmCount:The number of cells being split in the colunm direction.
         """
         
         GetDllLibPpt().Cell_Split.argtypes=[c_void_p ,c_int,c_int]
@@ -501,10 +453,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def SplitBySpan(self):
         """
-    <summary>
         The cell is split into its RowSpan rows in the  row direction,
-            and it is split into its ColSpan colunms in the colunm direction.
-    </summary>
+        and it is split into its ColSpan colunms in the colunm direction.
         """
         GetDllLibPpt().Cell_SplitBySpan.argtypes=[c_void_p]
         CallCFunction(GetDllLibPpt().Cell_SplitBySpan,self.Ptr)
@@ -513,9 +463,8 @@ class Cell (  IActiveSlide, IActivePresentation) :
 
     def DisplayColor(self)->'Color':
         """
-    <summary>
         get cell's display color
-    </summary>
+   
         """
         GetDllLibPpt().Cell_get_DisplayColor.argtypes=[c_void_p]
         GetDllLibPpt().Cell_get_DisplayColor.restype=c_void_p

spire/presentation/{CellCollection.py → table/CellCollection.py}

@@ -8,13 +8,21 @@ import abc
 
 class CellCollection (  PptObject, IActiveSlide) :
     """
-    <summary>
-        Represents a collection of cells.
-    </summary>
+    Represents a collection of Cell objects in a table.
+    Provides indexed access and enumeration capabilities.
     """
 
     @dispatch
     def __getitem__(self, key):
+        """
+        Gets the Cell at the specified index.
+        
+        Args:
+            key (int): Index of the cell to retrieve.
+        
+        Returns:
+            Cell: The cell at the specified index.
+        """
         if key >= self.Count:
             raise StopIteration
         GetDllLibPpt().CellCollection_get_Item.argtypes=[c_void_p ,c_int]
@@ -25,10 +33,13 @@ class CellCollection (  PptObject, IActiveSlide) :
 
     def get_Item(self ,index:int)->'Cell':
         """
-    <summary>
-        Gets a cell by index.
-            Read-only <see cref="T:Spire.Presentation.Cell" />.
-    </summary>
+        Gets the Cell at the specified index.
+        
+        Args:
+            index (int): Index of the cell to retrieve.
+        
+        Returns:
+            Cell: The cell at the specified index.
         """
         
         GetDllLibPpt().CellCollection_get_Item.argtypes=[c_void_p ,c_int]
@@ -41,10 +52,11 @@ class CellCollection (  PptObject, IActiveSlide) :
     @property
     def Count(self)->int:
         """
-    <summary>
-        Gets the count of cells in a collection.
-            Read-only <see cref="T:System.Int32" />.
-    </summary>
+        Gets the number of cells in the collection.
+        Read-only.
+        
+        Returns:
+            int: Total cell count.
         """
         GetDllLibPpt().CellCollection_get_Count.argtypes=[c_void_p]
         GetDllLibPpt().CellCollection_get_Count.restype=c_int
@@ -55,10 +67,11 @@ class CellCollection (  PptObject, IActiveSlide) :
 
     def Slide(self)->'ActiveSlide':
         """
-    <summary>
-        Gets the parent slide of a CellExCollection.
-            Read-only <see cref="T:Spire.Presentation.ActiveSlide" />.
-    </summary>
+        Gets the parent slide of the collection.
+        Read-only.
+        
+        Returns:
+            ActiveSlide: Parent slide object.
         """
         GetDllLibPpt().CellCollection_get_Slide.argtypes=[c_void_p]
         GetDllLibPpt().CellCollection_get_Slide.restype=c_void_p
@@ -71,10 +84,11 @@ class CellCollection (  PptObject, IActiveSlide) :
 
     def Presentation(self)->'Presentation':
         """
-    <summary>
-        Gets the parent presentation of a CellExCollection.
-            Read-only <see cref="T:Spire.Presentation.PresentationPptx" />.
-    </summary>
+        Gets the parent presentation of the collection.
+        Read-only.
+        
+        Returns:
+            Presentation: Parent presentation object.
         """
         GetDllLibPpt().CellCollection_get_Presentation.argtypes=[c_void_p]
         GetDllLibPpt().CellCollection_get_Presentation.restype=c_void_p
@@ -86,11 +100,10 @@ class CellCollection (  PptObject, IActiveSlide) :
 
     def GetEnumerator(self)->'IEnumerator':
         """
-    <summary>
-        Gets an enumerator for all cells which top-left corner
-            belongs to this collection. Each cell returned only once.
-    </summary>
-    <returns>An <see cref="T:System.Collections.IEnumerator" /> for the collection.</returns>
+        Gets an enumerator that iterates through all cells in the collection.
+        
+        Returns:
+            IEnumerator: Enumerator for cell collection.
         """
         GetDllLibPpt().CellCollection_GetEnumerator.argtypes=[c_void_p]
         GetDllLibPpt().CellCollection_GetEnumerator.restype=c_void_p
@@ -117,9 +130,10 @@ class CellCollection (  PptObject, IActiveSlide) :
     @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 synchronized (thread-safe).
+        
+        Returns:
+            bool: True if access is thread-safe; otherwise, False.
         """
         GetDllLibPpt().CellCollection_get_IsSynchronized.argtypes=[c_void_p]
         GetDllLibPpt().CellCollection_get_IsSynchronized.restype=c_bool
@@ -130,10 +144,10 @@ class CellCollection (  PptObject, IActiveSlide) :
 
     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 to synchronize access to the collection.
         """
         GetDllLibPpt().CellCollection_get_SyncRoot.argtypes=[c_void_p]
         GetDllLibPpt().CellCollection_get_SyncRoot.restype=c_void_p

spire/presentation/{ColumnCollection.py → table/ColumnCollection.py}

@@ -8,31 +8,16 @@ import abc
 
 class ColumnCollection (  ColumnList) :
     """
-    <summary>
-        Represents collection of columns in a table.
-    </summary>
+    Represents collection of columns in a table.
+    
     """
-#
-#    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().ColumnCollection_CopyTo.argtypes=[c_void_p ,c_void_p,c_int]
-#        CallCFunction(GetDllLibPpt().ColumnCollection_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 synchronized (thread-safe).
+        
+        Returns:
+            bool: True if access is thread-safe; otherwise, False.
         """
         GetDllLibPpt().ColumnCollection_get_IsSynchronized.argtypes=[c_void_p]
         GetDllLibPpt().ColumnCollection_get_IsSynchronized.restype=c_bool
@@ -43,10 +28,10 @@ class ColumnCollection (  ColumnList) :
 
     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 to synchronize access to the collection.
         """
         GetDllLibPpt().ColumnCollection_get_SyncRoot.argtypes=[c_void_p]
         GetDllLibPpt().ColumnCollection_get_SyncRoot.restype=c_void_p