spire-presentation 11.2.0__py3-none-macosx_11_0_arm64.whl

spire/presentation/charts/ChartBaseUnitType.py

@@ -0,0 +1,18 @@
+from enum import Enum
+from plum import dispatch
+from typing import TypeVar,Union,Generic,List,Tuple
+from spire.presentation.common import *
+from spire.presentation import *
+from ctypes import *
+import abc
+
+class ChartBaseUnitType(Enum):
+    """
+    Specifies the base unit type for category axis scaling.
+    
+    """
+    Days = 0
+    Months = 1
+    Years = 2
+    Auto = -1
+

spire/presentation/charts/ChartCategory.py

@@ -0,0 +1,40 @@
+from enum import Enum
+from plum import dispatch
+from typing import TypeVar,Union,Generic,List,Tuple
+from spire.presentation.common import *
+from spire.presentation import *
+from ctypes import *
+import abc
+
+class ChartCategory (  PptObject) :
+    """
+    Represents chart categories in a presentation.
+    
+    """
+    @property
+
+    def DataRange(self)->'CellRange':
+        """
+        Gets or sets the CellRange object associated with this chart category.
+        
+        Returns:
+            CellRange: The cell range defining the category's data source.
+        """
+        GetDllLibPpt().ChartCategory_get_DataRange.argtypes=[c_void_p]
+        GetDllLibPpt().ChartCategory_get_DataRange.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartCategory_get_DataRange,self.Ptr)
+        ret = None if intPtr==None else CellRange(intPtr)
+        return ret
+
+
+    @DataRange.setter
+    def DataRange(self, value:'CellRange'):
+        """
+        Sets the CellRange object for this chart category.
+        
+        Args:
+            value (CellRange): The new cell range to associate with this category.
+        """
+        GetDllLibPpt().ChartCategory_set_DataRange.argtypes=[c_void_p, c_void_p]
+        CallCFunction(GetDllLibPpt().ChartCategory_set_DataRange,self.Ptr, value.Ptr)
+

spire/presentation/charts/ChartCategoryCollection.py

@@ -0,0 +1,195 @@
+from enum import Enum
+from plum import dispatch
+from typing import TypeVar,Union,Generic,List,Tuple
+from spire.presentation.common import *
+from spire.presentation import *
+from ctypes import *
+import abc
+
+class ChartCategoryCollection (SpireObject) :
+    """
+    Represents a collection of ChartCategory objects in a chart.
+    Provides methods to manage categories including adding, removing, and accessing items.
+    """
+
+    def get_Item(self ,index:int)->'ChartCategory':
+        """
+        Gets the ChartCategory at the specified index.
+        
+        Args:
+            index (int): The zero-based index of the category to retrieve.
+        
+        Returns:
+            ChartCategory: The category at the specified index.
+        """
+        
+        GetDllLibPpt().ChartCategoryCollection_get_Item.argtypes=[c_void_p ,c_int]
+        GetDllLibPpt().ChartCategoryCollection_get_Item.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartCategoryCollection_get_Item,self.Ptr, index)
+        ret = None if intPtr==None else ChartCategory(intPtr)
+        return ret
+
+
+    @property
+
+    def CategoryLabels(self)->'CellRanges':
+        """
+        Gets or sets the cell ranges containing category labels.
+        
+        Returns:
+            CellRanges: The collection of cell ranges defining category labels.
+        """
+        GetDllLibPpt().ChartCategoryCollection_get_CategoryLabels.argtypes=[c_void_p]
+        GetDllLibPpt().ChartCategoryCollection_get_CategoryLabels.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartCategoryCollection_get_CategoryLabels,self.Ptr)
+        ret = None if intPtr==None else CellRanges(intPtr)
+        return ret
+
+
+    @CategoryLabels.setter
+    def CategoryLabels(self, value:'CellRanges'):
+        GetDllLibPpt().ChartCategoryCollection_set_CategoryLabels.argtypes=[c_void_p, c_void_p]
+        CallCFunction(GetDllLibPpt().ChartCategoryCollection_set_CategoryLabels,self.Ptr, value.Ptr)
+
+
+    def AppendCellRange(self ,cellRange:'CellRange')->int:
+        """
+        Creates a new chart category from a CellRange and adds it to the collection.
+        
+        Args:
+            cellRange (CellRange): The cell range to create the category from.
+        
+        Returns:
+            int: Index of the newly added category.
+        """
+        intPtrcellRange:c_void_p = cellRange.Ptr
+
+        GetDllLibPpt().ChartCategoryCollection_Append.argtypes=[c_void_p ,c_void_p]
+        GetDllLibPpt().ChartCategoryCollection_Append.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().ChartCategoryCollection_Append,self.Ptr, intPtrcellRange)
+        return ret
+
+
+    def AppendStr(self ,value:str)->int:
+        """
+        Appends a new category using a string value.
+        
+        Args:
+            value (str): The string value for the new category.
+        
+        Returns:
+            int: Index of the newly added category.
+        """
+        valuePtr = StrToPtr(value)
+        GetDllLibPpt().ChartCategoryCollection_AppendV.argtypes=[c_void_p ,c_char_p]
+        GetDllLibPpt().ChartCategoryCollection_AppendV.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().ChartCategoryCollection_AppendV,self.Ptr,valuePtr)
+        return ret
+
+
+    def AppendFloat(self ,value:float)->int:
+        """
+        Appends a new category using a numeric value.
+        
+        Args:
+            value (float): The numeric value for the new category.
+        
+        Returns:
+            int: Index of the newly added category.
+        """
+        GetDllLibPpt().ChartCategoryCollection_AppendV1.argtypes=[c_void_p ,c_float]
+        GetDllLibPpt().ChartCategoryCollection_AppendV1.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().ChartCategoryCollection_AppendV1,self.Ptr, value)
+        return ret
+
+    def AppendSpireObject(self ,value:SpireObject)->int:
+        """
+        Creates a new ChartCategory from a SpireObject and adds it to the collection.
+        
+        Args:
+            value (SpireObject): The object to create the category from.
+        
+        Returns:
+            int: Index of the newly added category.
+        """
+        intPtrvalue:c_void_p = value.Ptr
+
+        GetDllLibPpt().ChartCategoryCollection_AppendV11.argtypes=[c_void_p ,c_void_p]
+        GetDllLibPpt().ChartCategoryCollection_AppendV11.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().ChartCategoryCollection_AppendV11,self.Ptr, intPtrvalue)
+        return ret
+
+
+    def IndexOf(self ,value:'ChartCategory')->int:
+        """
+        Searches for the specified ChartCategory and returns its index.
+        
+        Args:
+            value (ChartCategory): The category to locate.
+        
+        Returns:
+            int: Zero-based index if found; otherwise -1.
+        """
+        intPtrvalue:c_void_p = value.Ptr
+
+        GetDllLibPpt().ChartCategoryCollection_IndexOf.argtypes=[c_void_p ,c_void_p]
+        GetDllLibPpt().ChartCategoryCollection_IndexOf.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().ChartCategoryCollection_IndexOf,self.Ptr, intPtrvalue)
+        return ret
+
+
+    def Remove(self ,value:'ChartCategory'):
+        """
+        Removes a specific category from the collection.
+        
+        Args:
+            value (ChartCategory): The category to remove.
+        """
+        intPtrvalue:c_void_p = value.Ptr
+
+        GetDllLibPpt().ChartCategoryCollection_Remove.argtypes=[c_void_p ,c_void_p]
+        CallCFunction(GetDllLibPpt().ChartCategoryCollection_Remove,self.Ptr, intPtrvalue)
+
+    @property
+    def Count(self)->int:
+        """
+        Gets the number of categories in the collection.
+        
+        Returns:
+            int: Total count of categories.
+        """
+
+        GetDllLibPpt().ChartCategoryCollection_GetCount.argtypes=[c_void_p ,c_void_p]
+        ret = CallCFunction(GetDllLibPpt().ChartCategoryCollection_GetCount,self.Ptr)
+        return ret
+
+    def Clear(self):
+        """
+        Removes all categories from the collection.
+        """
+        GetDllLibPpt().ChartCategoryCollection_Clear.argtypes=[c_void_p ,c_void_p]
+        CallCFunction(GetDllLibPpt().ChartCategoryCollection_Clear,self.Ptr)
+
+    @property
+    def Capacity(self)->int:
+        """
+        Gets or sets the capacity of the collection.
+        
+        Returns:
+            int: Current capacity of the collection.
+        """
+        GetDllLibPpt().ChartCategoryCollection_getCapacity.argtypes=[c_void_p ,c_void_p]
+        ret = CallCFunction(GetDllLibPpt().ChartCategoryCollection_getCapacity,self.Ptr)
+        return ret
+    
+    @Capacity.setter
+    def Capacity(self, value:int)->int:
+        """
+        Sets the capacity of the collection.
+        
+        Args:
+            value (int): The new capacity value.
+        """
+        GetDllLibPpt().ChartCategoryCollection_setCapacity.argtypes=[c_void_p ,c_void_p]
+        CallCFunction(GetDllLibPpt().ChartCategoryCollection_setCapacity,self.Ptr,value)
+

spire/presentation/charts/ChartCrossesType.py

@@ -0,0 +1,21 @@
+from enum import Enum
+from plum import dispatch
+from typing import TypeVar,Union,Generic,List,Tuple
+from spire.presentation.common import *
+from spire.presentation import *
+from ctypes import *
+import abc
+
+class ChartCrossesType(Enum):
+    """
+    Specifies where an axis crosses another axis in a chart.
+
+    Attributes:
+        AxisCrossesAtZero:Axis crosses at the zero point.
+        Maximum:Axis crosses at the maximum value
+        Custom:Axis crosses at a custom specified value
+    """
+    AxisCrossesAtZero = 0
+    Maximum = 1
+    Custom = 2
+

spire/presentation/charts/ChartData.py

@@ -0,0 +1,267 @@
+from enum import Enum
+from plum import dispatch
+from typing import TypeVar,Union,Generic,List,Tuple
+from spire.presentation.common import *
+from spire.presentation import *
+from ctypes import *
+import abc
+
+class ChartData (SpireObject) :
+    """
+    Represents the data associated with a chart.
+    
+    This class provides access to individual cells or ranges of cells within the chart's data source.
+    It includes methods to retrieve specific data points and clear data ranges.
+    """
+
+    @dispatch
+    def __getitem__(self, row,column):
+        """
+        Accesses a single cell in the chart data by row and column indices.
+        
+        Args:
+            row: Row index (0-based)
+            column: Column index (0-based)
+            
+        Returns:
+            CellRange: Object representing the requested cell
+        """
+        
+        GetDllLibPpt().ChartData_get_Item.argtypes=[c_void_p ,c_int,c_int]
+        GetDllLibPpt().ChartData_get_Item.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartData_get_Item,self.Ptr, row,column)
+        ret = None if intPtr==None else CellRange(intPtr)
+        return ret
+
+    @dispatch
+    def __getitem__(self, startRow,startColumn,endRow,endColumn):
+        """
+        Accesses a range of cells in the chart data.
+        
+        Args:
+            startRow: Starting row index
+            startColumn: Starting column index
+            endRow: Ending row index
+            endColumn: Ending column index
+            
+        Returns:
+            CellRanges: Collection of cells in the specified range
+        """
+        
+        GetDllLibPpt().ChartData_get_ItemRCLL.argtypes=[c_void_p ,c_int,c_int,c_int,c_int]
+        GetDllLibPpt().ChartData_get_ItemRCLL.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartData_get_ItemRCLL,self.Ptr, startRow,startColumn,endRow,endColumn)
+        ret = None if intPtr==None else CellRanges(intPtr)
+        return ret
+
+    @dispatch
+    def __getitem__(self, name:str):
+        """
+        Accesses a cell by its Excel-style name (e.g., "A1").
+        
+        Args:
+            name: Cell reference in Excel format
+            
+        Returns:
+            CellRange: Object representing the requested cell
+        """
+        
+        namePtr = StrToPtr(name)
+        GetDllLibPpt().ChartData_get_ItemN.argtypes=[c_void_p ,c_char_p]
+        GetDllLibPpt().ChartData_get_ItemN.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartData_get_ItemN,self.Ptr,namePtr)
+        ret = None if intPtr==None else CellRange(intPtr)
+        return ret
+
+    @dispatch
+
+    def get_Item(self ,row:int,column:int)->CellRange:
+        """
+        Retrieves a specific cell in the chart data.
+        
+        Args:
+            row: Row index (0-based)
+            column: Column index (0-based)
+            
+        Returns:
+            CellRange: Object representing the requested cell
+        """
+        
+        GetDllLibPpt().ChartData_get_Item.argtypes=[c_void_p ,c_int,c_int]
+        GetDllLibPpt().ChartData_get_Item.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartData_get_Item,self.Ptr, row,column)
+        ret = None if intPtr==None else CellRange(intPtr)
+        return ret
+
+
+
+    def Clear(self ,row:int,column:int,lastRow:int,lastColumn:int):
+        """
+        Clears data within the specified range.
+        
+        Args:
+            row: Starting row index
+            column: Starting column index
+            lastRow: Ending row index
+            lastColumn: Ending column index
+        """
+        GetDllLibPpt().ChartData_Clear.argtypes=[c_void_p ,c_int,c_int,c_int,c_int]
+        CallCFunction(GetDllLibPpt().ChartData_Clear,self.Ptr, row,column,lastRow,lastColumn)
+
+    @dispatch
+
+    def get_Item(self ,row:int,column:int,lastRow:int,lastColumn:int)->CellRanges:
+        """
+        Retrieves a range of cells.
+        
+        Args:
+            row: Starting row index
+            column: Starting column index
+            lastRow: Ending row index
+            lastColumn: Ending column index
+            
+        Returns:
+            CellRanges: Collection of cells in the specified range
+        """
+        GetDllLibPpt().ChartData_get_ItemRCLL.argtypes=[c_void_p ,c_int,c_int,c_int,c_int]
+        GetDllLibPpt().ChartData_get_ItemRCLL.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartData_get_ItemRCLL,self.Ptr, row,column,lastRow,lastColumn)
+        ret = None if intPtr==None else CellRanges(intPtr)
+        return ret
+
+
+    @dispatch
+
+    def get_Item(self ,worksheetIndex:int,row:int,column:int,lastRow:int,lastColumn:int)->CellRanges:
+        """
+        Retrieves a range of cells from a specific worksheet.
+        
+        Args:
+            worksheetIndex: Index of the worksheet
+            row: Starting row index
+            column: Starting column index
+            lastRow: Ending row index
+            lastColumn: Ending column index
+            
+        Returns:
+            CellRanges: Collection of cells in the specified range
+        """
+        
+        GetDllLibPpt().ChartData_get_ItemWRCLL.argtypes=[c_void_p ,c_int,c_int,c_int,c_int,c_int]
+        GetDllLibPpt().ChartData_get_ItemWRCLL.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartData_get_ItemWRCLL,self.Ptr, worksheetIndex,row,column,lastRow,lastColumn)
+        ret = None if intPtr==None else CellRanges(intPtr)
+        return ret
+
+
+    @dispatch
+
+    def get_Item(self ,name:str)->CellRange:
+        """
+        Retrieves a cell by its Excel-style name.
+        
+        Args:
+            name: Cell reference in Excel format
+            
+        Returns:
+            CellRange: Object representing the requested cell
+        """
+        namePtr = StrToPtr(name)
+        GetDllLibPpt().ChartData_get_ItemN.argtypes=[c_void_p ,c_char_p]
+        GetDllLibPpt().ChartData_get_ItemN.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartData_get_ItemN,self.Ptr,namePtr)
+        ret = None if intPtr==None else CellRange(intPtr)
+        return ret
+
+
+    @dispatch
+
+    def get_Item(self ,name:str,endCellName:str)->CellRanges:
+        """
+        Retrieves a range of cells by starting and ending Excel-style names.
+        
+        Args:
+            name: Starting cell reference
+            endCellName: Ending cell reference
+            
+        Returns:
+            CellRanges: Collection of cells in the specified range
+        """
+        namePtr = StrToPtr(name)
+        endCellNamePtr = StrToPtr(endCellName)
+        GetDllLibPpt().ChartData_get_ItemNE.argtypes=[c_void_p ,c_char_p,c_char_p]
+        GetDllLibPpt().ChartData_get_ItemNE.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartData_get_ItemNE,self.Ptr,namePtr,endCellNamePtr)
+        ret = None if intPtr==None else CellRanges(intPtr)
+        return ret
+
+
+    @dispatch
+
+    def get_Item(self ,worksheetIndex:int,name:str)->CellRange:
+        """
+        Retrieves a cell from a specific worksheet by Excel-style name.
+        
+        Args:
+            worksheetIndex: Index of the worksheet
+            name: Cell reference in Excel format
+            
+        Returns:
+            CellRange: Object representing the requested cell
+        """
+        namePtr = StrToPtr(name)
+        GetDllLibPpt().ChartData_get_ItemWN.argtypes=[c_void_p ,c_int,c_char_p]
+        GetDllLibPpt().ChartData_get_ItemWN.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartData_get_ItemWN,self.Ptr, worksheetIndex,namePtr)
+        ret = None if intPtr==None else CellRange(intPtr)
+        return ret
+
+
+    @dispatch
+
+    def get_Item(self ,worksheetIndex:int,name:str,endCellName:str)->CellRanges:
+        """
+        Retrieves a range of cells from a specific worksheet.
+        
+        Args:
+            worksheetIndex: Index of the worksheet
+            name: Starting cell reference
+            endCellName: Ending cell reference
+            
+        Returns:
+            CellRanges: Collection of cells in the specified range
+        """
+        namePtr = StrToPtr(name)
+        endCellNamePtr = StrToPtr(endCellName)
+        GetDllLibPpt().ChartData_get_ItemWNE.argtypes=[c_void_p ,c_int,c_char_p,c_char_p]
+        GetDllLibPpt().ChartData_get_ItemWNE.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ChartData_get_ItemWNE,self.Ptr, worksheetIndex,namePtr,endCellNamePtr)
+        ret = None if intPtr==None else CellRanges(intPtr)
+        return ret
+    
+
+    @property
+    def LastRowIndex(self)->int:
+        """
+        Gets the index of the last row containing data.
+        
+        Returns:
+            int: 0-based index of the last data row
+        """
+        GetDllLibPpt().ChartData_LastRowIndex.argtypes=[c_void_p ,c_void_p]
+        ret = CallCFunction(GetDllLibPpt().ChartData_LastRowIndex,self.Ptr)
+        return ret
+    
+    @property
+    def LastColIndex(self)->int:
+        """
+        Gets the index of the last column containing data.
+        
+        Returns:
+            int: 0-based index of the last data column
+        """
+        GetDllLibPpt().ChartData_LastColIndex.argtypes=[c_void_p ,c_void_p]
+        ret = CallCFunction(GetDllLibPpt().ChartData_LastColIndex,self.Ptr)
+        return ret
+
+