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

spire/presentation/{CellRange.py → charts/CellRange.py}

@@ -8,16 +8,16 @@ import abc
 
 class CellRange (SpireObject) :
     """
-    <summary>
-        Represents cell range for chart data
-    </summary>
+    Represents a cell range used as a data source for charts.
+    Stores location and value information for chart data points.
     """
     @property
     def Row(self)->int:
         """
-    <summary>
-        Gets the row.
-    </summary>
+        Gets the row index of the cell.
+        
+        Returns:
+            int: Zero-based row index.
         """
         GetDllLibPpt().CellRange_get_Row.argtypes=[c_void_p]
         GetDllLibPpt().CellRange_get_Row.restype=c_int
@@ -27,9 +27,10 @@ class CellRange (SpireObject) :
     @property
     def Column(self)->int:
         """
-    <summary>
-        Gets the column.
-    </summary>
+        Gets the column index of the cell.
+        
+        Returns:
+            int: Zero-based column index.
         """
         GetDllLibPpt().CellRange_get_Column.argtypes=[c_void_p]
         GetDllLibPpt().CellRange_get_Column.restype=c_int
@@ -39,9 +40,10 @@ class CellRange (SpireObject) :
     @property
     def NumberValue(self)->float:
         """
-    <summary>
-        Gets or set number value.
-    </summary>
+        Gets or sets the numeric value of the cell.
+        
+        Returns:
+            float: The numeric value of the cell
         """
         GetDllLibPpt().CellRange_get_NumberValue.argtypes=[c_void_p]
         GetDllLibPpt().CellRange_get_NumberValue.restype=c_double
@@ -57,9 +59,10 @@ class CellRange (SpireObject) :
 
     def Text(self)->str:
         """
-    <summary>
-        Gets or set string value.
-    </summary>
+        Gets or sets the string value of the cell.
+        
+        Returns:
+            str: The textual content of the cell
         """
         GetDllLibPpt().CellRange_get_Text.argtypes=[c_void_p]
         GetDllLibPpt().CellRange_get_Text.restype=c_void_p
@@ -77,12 +80,10 @@ class CellRange (SpireObject) :
 
     def Value(self)->'SpireObject':
         """
-    <summary>
-        Gets or sets the value.
-    </summary>
-<value>
-            The value.
-            </value>
+        Gets or sets the underlying value object of the cell.
+        
+        Returns:
+            SpireObject: The raw value object of the cell
         """
         GetDllLibPpt().CellRange_get_Value.argtypes=[c_void_p]
         GetDllLibPpt().CellRange_get_Value.restype=c_void_p
@@ -100,9 +101,10 @@ class CellRange (SpireObject) :
 
     def WorksheetName(self)->str:
         """
-    <summary>
-        Gets worksheet name.
-    </summary>
+        Gets the name of the worksheet containing this cell.
+        
+        Returns:
+            str: The name of the parent worksheet
         """
         GetDllLibPpt().CellRange_get_WorksheetName.argtypes=[c_void_p]
         GetDllLibPpt().CellRange_get_WorksheetName.restype=c_void_p
@@ -113,9 +115,10 @@ class CellRange (SpireObject) :
     @property
     def WorksheetIndex(self)->int:
         """
-    <summary>
-        Gets worksheet Index.
-    </summary>
+        Gets the zero-based index of the worksheet containing this cell.
+        
+        Returns:
+            int: The index of the parent worksheet
         """
         GetDllLibPpt().CellRange_get_WorksheetIndex.argtypes=[c_void_p]
         GetDllLibPpt().CellRange_get_WorksheetIndex.restype=c_int
@@ -126,11 +129,15 @@ class CellRange (SpireObject) :
 
     def Equals(self ,cellRange:'CellRange')->bool:
         """
-    <summary>
-        Indicates whether the specified <see cref="T:Spire.Presentation.Charts.CellRange" /> is equal to this instance.
-    </summary>
-    <param name="cellRange">The data cell.</param>
-    <returns></returns>
+        Determines if this cell range is equal to another specified cell range.
+        
+        Compares both position and content of the cells.
+        
+        Args:
+            cellRange (CellRange): The cell range to compare with
+            
+        Returns:
+            bool: True if the cell ranges are identical, otherwise False
         """
         intPtrcellRange:c_void_p = cellRange.Ptr
 
@@ -143,16 +150,13 @@ class CellRange (SpireObject) :
 
     def Equals(self ,obj:SpireObject)->bool:
         """
-    <summary>
-        Indicates whether the specified <see cref="T:System.Object" /> is equal to this instance.
-    </summary>
-    <param name="obj">The <see cref="T:System.Object" /> to compare with this instance.</param>
-    <returns>
-  <c>true</c> if the specified <see cref="T:System.Object" /> is equal to this instance; otherwise, <c>false</c>.
-            </returns>
-<exception cref="T:System.NullReferenceException">
-            The     <paramref name="obj" /> parameter is null.
-              </exception>
+        Determines if this cell range is equal to another specified object.
+        
+        Args:
+            obj (SpireObject): The object to compare with
+            
+        Returns:
+            bool: True if the objects are identical cell ranges, otherwise False
         """
         intPtrobj:c_void_p = obj.Ptr
 
@@ -163,12 +167,10 @@ class CellRange (SpireObject) :
 
     def GetHashCode(self)->int:
         """
-    <summary>
-        Gets a hash code for this instance.
-    </summary>
-    <returns>
-            A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table. 
-            </returns>
+        Generates a hash code for this cell range.
+        
+        Returns:
+            int: A hash code value for the current object
         """
         GetDllLibPpt().CellRange_GetHashCode.argtypes=[c_void_p]
         GetDllLibPpt().CellRange_GetHashCode.restype=c_int
@@ -179,9 +181,10 @@ class CellRange (SpireObject) :
 
     def NumberFormat(self)->str:
         """
-    <summary>
-        set the number format of the chart data source(excel).
-    </summary>
+        Gets or sets the number formatting string for numeric values.
+        
+        Returns:
+            str: The current number format string
         """
         GetDllLibPpt().CellRange_get_NumberFormat.argtypes=[c_void_p]
         GetDllLibPpt().CellRange_get_NumberFormat.restype=c_void_p

spire/presentation/{CellRanges.py → charts/CellRanges.py}

@@ -8,13 +8,21 @@ import abc
 
 class CellRanges (  SpireObject ) :
     """
-    <summary>
-        Represents collection of a cells with data.
-    </summary>
+    Represents a collection of CellRange objects.
+    Provides methods to add, remove, and access cell ranges.
     """
 
     @dispatch
     def __getitem__(self, index):
+        """
+        Gets the CellRange at the specified index.
+        
+        Args:
+            index (int): Index of the cell range to retrieve.
+        
+        Returns:
+            CellRange: The cell range at the specified index.
+        """
         if index >= self.Count:
             raise StopIteration
         GetDllLibPpt().CellRanges_get_Item.argtypes=[c_void_p ,c_int]
@@ -25,11 +33,13 @@ class CellRanges (  SpireObject ) :
 
     def get_Item(self ,index:int)->'CellRange':
         """
-    <summary>
-        Gets a cell by index.
-    </summary>
-    <param name="index">Index of a cell.</param>
-    <returns>Cell with data.</returns>
+        Gets the CellRange at the specified index.
+        
+        Args:
+            index (int): Index of the cell range to retrieve.
+        
+        Returns:
+            CellRange: The cell range at the specified index.
         """
         
         GetDllLibPpt().CellRanges_get_Item.argtypes=[c_void_p ,c_int]
@@ -41,11 +51,13 @@ class CellRanges (  SpireObject ) :
 
     def Add(self ,cellRange:'CellRange')->int:
         """
-    <summary>
-        Add new cell to the collection.
-    </summary>
-    <param name="cellRange">New cell to add.</param>
-    <returns>Index of a new added <see cref="T:Spire.Presentation.Charts.CellRange" />.</returns>
+        Adds a new CellRange to the collection.
+        
+        Args:
+            cellRange (CellRange): The cell range to add.
+        
+        Returns:
+            int: Index of the newly added cell range.
         """
         intPtrcellRange:c_void_p = cellRange.Ptr
 
@@ -57,11 +69,13 @@ class CellRanges (  SpireObject ) :
     
     def AddObject(self ,value:SpireObject)->int:
         """
-    <summary>
-        Creates <see cref="T:Spire.Presentation.Charts.CellRange" /> from specified value and adds it to the collection.
-    </summary>
-    <param name="value">The value.</param>
-    <returns>Index of a new added <see cref="T:Spire.Presentation.Charts.CellRange" />.</returns>
+        Creates a CellRange from a SpireObject and adds it to the collection.
+        
+        Args:
+            value (SpireObject): The object to convert to a cell range.
+        
+        Returns:
+            int: Index of the newly added cell range.
         """
         intPtrvalue:c_void_p = value.Ptr
 
@@ -73,10 +87,10 @@ class CellRanges (  SpireObject ) :
 
     def RemoveAt(self ,index:int):
         """
-    <summary>
-        Removes a cell from the collection by index.
-    </summary>
-    <param name="index">Index of a cell to remove.</param>
+        Removes the cell range at the specified index.
+        
+        Args:
+            index (int): Index of the cell range to remove.
         """
         
         GetDllLibPpt().CellRanges_RemoveAt.argtypes=[c_void_p ,c_int]
@@ -85,9 +99,10 @@ class CellRanges (  SpireObject ) :
 
     def GetEnumerator(self)->'IEnumerator':
         """
-    <summary>
         Gets an enumerator for the entire collection.
-    </summary>
+        
+        Returns:
+            IEnumerator: Enumerator for cell ranges.
         """
         GetDllLibPpt().CellRanges_GetEnumerator.argtypes=[c_void_p]
         GetDllLibPpt().CellRanges_GetEnumerator.restype=c_void_p
@@ -99,9 +114,10 @@ class CellRanges (  SpireObject ) :
     @property
     def Count(self)->int:
         """
-    <summary>
-        Gets the count of cells in collection.
-    </summary>
+        Gets the number of cell ranges in the collection.
+        
+        Returns:
+            int: Total count of cell ranges.
         """
         GetDllLibPpt().CellRanges_get_Count.argtypes=[c_void_p]
         GetDllLibPpt().CellRanges_get_Count.restype=c_int