spire-presentation 11.2.0__py3-none-macosx_11_0_arm64.whl

spire/presentation/PictureShape.py

@@ -0,0 +1,124 @@
+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 *
+from spire.presentation.drawing.IImageData import IImageData
+
+class PictureShape (  IActiveSlide) :
+    """
+    Represents a picture in a presentation.
+    """
+    @property
+
+    def EmbedImage(self)->'IImageData':
+        """
+        Gets or sets the embedded image.
+        
+        Returns:
+            IImageData: The embedded image data.
+        """
+        GetDllLibPpt().PictureShape_get_EmbedImage.argtypes=[c_void_p]
+        GetDllLibPpt().PictureShape_get_EmbedImage.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().PictureShape_get_EmbedImage,self.Ptr)
+        ret = None if intPtr==None else IImageData(intPtr)
+        return ret
+
+
+    @EmbedImage.setter
+    def EmbedImage(self, value:'IImageData'):
+        """
+        Sets the embedded image.
+        
+        Args:
+            value (IImageData): The image data to set.
+        """
+        GetDllLibPpt().PictureShape_set_EmbedImage.argtypes=[c_void_p, c_void_p]
+        CallCFunction(GetDllLibPpt().PictureShape_set_EmbedImage,self.Ptr, value.Ptr)
+
+    @property
+
+    def Url(self)->str:
+        """
+        Gets or sets the URL of a linked image.
+        
+        Returns:
+            str: The URL string of the linked image.
+        """
+        GetDllLibPpt().PictureShape_get_Url.argtypes=[c_void_p]
+        GetDllLibPpt().PictureShape_get_Url.restype=c_void_p
+        ret = PtrToStr(CallCFunction(GetDllLibPpt().PictureShape_get_Url,self.Ptr))
+        return ret
+
+
+    @Url.setter
+    def Url(self, value:str):
+        """
+        Sets the URL of a linked image.
+        
+        Args:
+            value (str): The URL string to set.
+        """
+        valuePtr = StrToPtr(value)
+        GetDllLibPpt().PictureShape_set_Url.argtypes=[c_void_p, c_char_p]
+        CallCFunction(GetDllLibPpt().PictureShape_set_Url,self.Ptr,valuePtr)
+
+    @property
+    def Transparency(self)->int:
+        """
+        Gets or sets the transparency level of the picture fill.
+        
+        Note: Value ranges from 0 (opaque) to 100 (fully transparent).
+        
+        Returns:
+            int: The current transparency value.
+        """
+        GetDllLibPpt().PictureShape_get_Transparency.argtypes=[c_void_p]
+        GetDllLibPpt().PictureShape_get_Transparency.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().PictureShape_get_Transparency,self.Ptr)
+        return ret
+
+    @Transparency.setter
+    def Transparency(self, value:int):
+        """
+        Sets the transparency level of the picture fill.
+        
+        Args:
+            value (int): Transparency value (0-100 range).
+        """
+        GetDllLibPpt().PictureShape_set_Transparency.argtypes=[c_void_p, c_int]
+        CallCFunction(GetDllLibPpt().PictureShape_set_Transparency,self.Ptr, value)
+
+    @property
+
+    def Slide(self)->'ActiveSlide':
+        """
+        Gets the parent slide containing this picture.
+        
+        Returns:
+            ActiveSlide: The parent slide object.
+        """
+        GetDllLibPpt().PictureShape_get_Slide.argtypes=[c_void_p]
+        GetDllLibPpt().PictureShape_get_Slide.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().PictureShape_get_Slide,self.Ptr)
+        ret = None if intPtr==None else ActiveSlide(intPtr)
+        return ret
+
+
+    @property
+
+    def Presentation(self)->'Presentation':
+        """
+        Gets the parent presentation containing this picture.
+        
+        Returns:
+            Presentation: The parent presentation object.
+        """
+        GetDllLibPpt().PictureShape_get_Presentation.argtypes=[c_void_p]
+        GetDllLibPpt().PictureShape_get_Presentation.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().PictureShape_get_Presentation,self.Ptr)
+        ret = None if intPtr==None else Presentation(intPtr)
+        return ret
+
+

spire/presentation/Placeholder.py

@@ -0,0 +1,101 @@
+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 Placeholder (  PptObject) :
+    """
+    Represents a placeholder area on a slide that can hold specific types of content.
+    """
+    @property
+
+    def Orientation(self)->'Direction':
+        """
+        Gets the text orientation within the placeholder.
+        
+        Read-only property that indicates the text flow direction.
+        
+        Returns:
+            Direction: Enumeration value representing text orientation
+        """
+        GetDllLibPpt().Placeholder_get_Orientation.argtypes=[c_void_p]
+        GetDllLibPpt().Placeholder_get_Orientation.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().Placeholder_get_Orientation,self.Ptr)
+        objwraped = Direction(ret)
+        return objwraped
+
+    @property
+
+    def Size(self)->'PlaceholderSize':
+        """
+        Gets the relative size category of the placeholder.
+        
+        Read-only property indicating the size category (Full, Half, Quarter).
+        
+        Returns:
+            PlaceholderSize: Enumeration value representing size category
+        """
+        GetDllLibPpt().Placeholder_get_Size.argtypes=[c_void_p]
+        GetDllLibPpt().Placeholder_get_Size.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().Placeholder_get_Size,self.Ptr)
+        objwraped = PlaceholderSize(ret)
+        return objwraped
+
+    @property
+
+    def Type(self)->'PlaceholderType':
+        """
+        Gets the content type the placeholder is designed to hold.
+        
+        Read-only property indicating the placeholder's purpose (Title, Body, Chart, etc.).
+        
+        Returns:
+            PlaceholderType: Enumeration value representing content type
+        """
+        GetDllLibPpt().Placeholder_get_Type.argtypes=[c_void_p]
+        GetDllLibPpt().Placeholder_get_Type.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().Placeholder_get_Type,self.Ptr)
+        objwraped = PlaceholderType(ret)
+        return objwraped
+
+    @property
+
+    def Index(self)->'UInt32':
+        """
+        Gets the position index of the placeholder within its parent slide.
+        
+        Read-only property that identifies the placeholder's order on the slide.
+        
+        Returns:
+            UInt32: Numerical index of the placeholder
+        """
+        GetDllLibPpt().Placeholder_get_Index.argtypes=[c_void_p]
+        GetDllLibPpt().Placeholder_get_Index.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().Placeholder_get_Index,self.Ptr)
+        ret = None if intPtr==None else UInt32(intPtr)
+        return ret
+
+
+
+    def Equals(self ,obj:'SpireObject')->bool:
+        """
+        Determines if the specified object is equivalent to this placeholder.
+        
+        Compares the current placeholder with another object to check equality.
+        
+        Args:
+            obj (SpireObject): The object to compare with the current placeholder
+            
+        Returns:
+            bool: True if objects are equivalent, False otherwise
+        """
+        intPtrobj:c_void_p = obj.Ptr
+
+        GetDllLibPpt().Placeholder_Equals.argtypes=[c_void_p ,c_void_p]
+        GetDllLibPpt().Placeholder_Equals.restype=c_bool
+        ret = CallCFunction(GetDllLibPpt().Placeholder_Equals,self.Ptr, intPtrobj)
+        return ret
+

spire/presentation/PlaceholderSize.py

@@ -0,0 +1,23 @@
+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 PlaceholderSize(Enum):
+    """
+    Specifies the size of a placeholder.
+
+    Attributes:
+        Full: Full size placeholder
+        Half: Half size placeholder
+        Quarter: Quarter size placeholder
+        none: No specific size defined
+    """
+    Full = 0
+    Half = 1
+    Quarter = 2
+    none = 3
+

spire/presentation/PlaceholderType.py

@@ -0,0 +1,49 @@
+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 PlaceholderType(Enum):
+    """
+    Specifies the type of content a placeholder can hold.
+
+    Attributes:
+        Title: Title placeholder
+        Body: Body text placeholder
+        CenteredTitle: Centered title placeholder
+        Subtitle: Subtitle placeholder
+        DateAndTime: Date and time placeholder
+        SlideNumber: Slide number placeholder
+        Footer: Footer placeholder
+        Header: Header placeholder
+        Object: Generic object placeholder
+        Chart: Chart placeholder
+        Table: Table placeholder
+        ClipArt: Clip art placeholder
+        Diagram: Diagram placeholder
+        Media: Media placeholder
+        SlideImage: Slide image placeholder
+        Picture: Picture placeholder
+        none: No specific placeholder type
+    """
+    Title = 0
+    Body = 1
+    CenteredTitle = 2
+    Subtitle = 3
+    DateAndTime = 4
+    SlideNumber = 5
+    Footer = 6
+    Header = 7
+    Object = 8
+    Chart = 9
+    Table = 10
+    ClipArt = 11
+    Diagram = 12
+    Media = 13
+    SlideImage = 14
+    Picture = 15
+    none = 16
+

spire/presentation/PptObject.py

@@ -0,0 +1,39 @@
+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 PptObject (SpireObject) :
+    """
+    Represents a base PowerPoint object providing common functionality for parent object 
+    access and resource management. Inherits from SpireObject.
+    """
+    @property
+
+    def Parent(self)->'SpireObject':
+        """
+        Gets the parent object of the current PowerPoint object.
+
+        Returns:
+            SpireObject: Reference to the parent object (read-only).
+        """
+        GetDllLibPpt().PptObject_get_Parent.argtypes=[c_void_p]
+        GetDllLibPpt().PptObject_get_Parent.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().PptObject_get_Parent,self.Ptr)
+        ret = None if intPtr==None else SpireObject(intPtr)
+        return ret
+
+
+    def Dispose(self):
+        """
+        Releases all resources used by the PptObject.
+
+        This method should be called to free unmanaged resources when the object is 
+        no longer needed to prevent memory leaks.
+        """
+        GetDllLibPpt().PptObject_Dispose.argtypes=[c_void_p]
+        CallCFunction(GetDllLibPpt().PptObject_Dispose,self.Ptr)
+