spire-presentation 11.2.0__py3-none-macosx_11_0_arm64.whl

spire/presentation/IOleObject.py

@@ -0,0 +1,661 @@
+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 IOleObject (SpireObject) :
+    """Represents an OLE (Object Linking and Embedding) object in a presentation."""
+    @property
+
+    def SubstituteImagePictureFillFormat(self)->'PictureFillFormat':
+        """
+        Gets the image fill properties for the OLE object's substitute image.
+        
+        Returns:
+            PictureFillFormat: Read-only picture fill format.
+        """
+        GetDllLibPpt().IOleObject_get_SubstituteImagePictureFillFormat.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_SubstituteImagePictureFillFormat.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_SubstituteImagePictureFillFormat,self.Ptr)
+        ret = None if intPtr==None else PictureFillFormat(intPtr)
+        return ret
+
+
+    @property
+
+    def ObjectName(self)->str:
+        """
+        Gets or sets the name of the OLE object.
+        
+        Returns:
+            str: Name of the OLE object.
+        """
+        GetDllLibPpt().IOleObject_get_ObjectName.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_ObjectName.restype=c_void_p
+        ret = PtrToStr(CallCFunction(GetDllLibPpt().IOleObject_get_ObjectName,self.Ptr))
+        return ret
+
+
+    @ObjectName.setter
+    def ObjectName(self, value:str):
+        """
+        Sets the name of the OLE object.
+        
+        Args:
+            value (str): New object name.
+        """
+        valuePtr = StrToPtr(value)
+        GetDllLibPpt().IOleObject_set_ObjectName.argtypes=[c_void_p, c_char_p]
+        CallCFunction(GetDllLibPpt().IOleObject_set_ObjectName,self.Ptr,valuePtr)
+
+    @property
+
+    def ProgId(self)->str:
+        """
+        Gets or sets the Programmatic Identifier (ProgID) of the OLE object.
+        
+        Returns:
+            str: Programmatic identifier.
+        """
+        GetDllLibPpt().IOleObject_get_ProgId.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_ProgId.restype=c_void_p
+        ret = PtrToStr(CallCFunction(GetDllLibPpt().IOleObject_get_ProgId,self.Ptr))
+        return ret
+
+
+    @ProgId.setter
+    def ProgId(self, value:str):
+        """
+        Sets the Programmatic Identifier (ProgID) of the OLE object.
+        
+        Args:
+            value (str): New ProgID value.
+        """
+        valuePtr = StrToPtr(value)
+        GetDllLibPpt().IOleObject_set_ProgId.argtypes=[c_void_p, c_char_p]
+        CallCFunction(GetDllLibPpt().IOleObject_set_ProgId,self.Ptr,valuePtr)
+
+    @property
+
+    def Data(self)->'Stream':
+        """
+        Gets or sets the embedded object data.
+        
+        Returns:
+            Stream: Byte stream of embedded object data.
+        """
+        GetDllLibPpt().IOleObject_get_DataStream.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_DataStream.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_DataStream,self.Ptr)
+        ret = None if intPtr==None else Stream(intPtr)
+        return ret
+
+
+    @Data.setter
+    def Data(self, value:'Stream'):
+        """
+        Sets the embedded object data.
+        
+        Args:
+            value (Stream): New object data stream.
+        """
+       
+        GetDllLibPpt().IOleObject_set_DataStream.argtypes=[c_void_p,c_void_p]
+        CallCFunction(GetDllLibPpt().IOleObject_set_DataStream,self.Ptr, value.Ptr)
+
+
+    @property
+
+    def LinkShortFilePath(self)->str:
+        """
+        Gets the short path to the linked file.
+        
+        Returns:
+            str: Read-only short file path.
+        """
+        GetDllLibPpt().IOleObject_get_LinkShortFilePath.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_LinkShortFilePath.restype=c_void_p
+        ret = PtrToStr(CallCFunction(GetDllLibPpt().IOleObject_get_LinkShortFilePath,self.Ptr))
+        return ret
+
+
+    @property
+
+    def LinkFilePath(self)->str:
+        """
+        Gets or sets the full path to the linked file.
+        
+        Returns:
+            str: Full file path for linked objects.
+        """
+        GetDllLibPpt().IOleObject_get_LinkFilePath.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_LinkFilePath.restype=c_void_p
+        ret = PtrToStr(CallCFunction(GetDllLibPpt().IOleObject_get_LinkFilePath,self.Ptr))
+        return ret
+
+
+    @LinkFilePath.setter
+    def LinkFilePath(self, value:str):
+        """
+        Sets the full path to the linked file.
+        
+        Args:
+            value (str): New file path.
+        """
+        valuePtr = StrToPtr(value)
+        GetDllLibPpt().IOleObject_set_LinkFilePath.argtypes=[c_void_p, c_char_p]
+        CallCFunction(GetDllLibPpt().IOleObject_set_LinkFilePath,self.Ptr,valuePtr)
+
+    @property
+    def IsIconVisible(self)->bool:
+        """
+        Indicates whether the object is displayed as an icon.
+        
+        Returns:
+            bool: True if visible as icon, False otherwise.
+        """
+        GetDllLibPpt().IOleObject_get_IsIconVisible.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_IsIconVisible.restype=c_bool
+        ret = CallCFunction(GetDllLibPpt().IOleObject_get_IsIconVisible,self.Ptr)
+        return ret
+
+    @IsIconVisible.setter
+    def IsIconVisible(self, value:bool):
+        """
+        Sets whether the object is displayed as an icon.
+        
+        Args:
+            value (bool): True to show as icon, False to show content.
+        """
+        GetDllLibPpt().IOleObject_set_IsIconVisible.argtypes=[c_void_p, c_bool]
+        CallCFunction(GetDllLibPpt().IOleObject_set_IsIconVisible,self.Ptr, value)
+
+    @property
+    def IsObjectLink(self)->bool:
+        """
+        Indicates whether the object is linked to an external file.
+        
+        Returns:
+            bool: True if linked, False if embedded.
+        """
+        GetDllLibPpt().IOleObject_get_IsObjectLink.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_IsObjectLink.restype=c_bool
+        ret = CallCFunction(GetDllLibPpt().IOleObject_get_IsObjectLink,self.Ptr)
+        return ret
+
+    @property
+
+    def ShapeLocking(self)->'GraphicalNodeLocking':
+        """
+        Gets shape locking properties.
+        
+        Returns:
+            GraphicalNodeLocking: Read-only locking settings.
+        """
+        GetDllLibPpt().IOleObject_get_ShapeLocking.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_ShapeLocking.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_ShapeLocking,self.Ptr)
+        ret = None if intPtr==None else GraphicalNodeLocking(intPtr)
+        return ret
+
+
+    @property
+    def IsTextBox(self)->bool:
+        """
+        Checks if the shape is a text holder.
+        
+        Returns:
+            bool: True if text holder, False otherwise.
+        """
+        GetDllLibPpt().IOleObject_get_IsTextBox.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_IsTextBox.restype=c_bool
+        ret = CallCFunction(GetDllLibPpt().IOleObject_get_IsTextBox,self.Ptr)
+        return ret
+
+    @property
+
+    def Placeholder(self)->'Placeholder':
+        """
+        Gets placeholder properties.
+        
+        Returns:
+            Placeholder: Read-only placeholder object.
+        """
+        GetDllLibPpt().IOleObject_get_Placeholder.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Placeholder.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_Placeholder,self.Ptr)
+        ret = None if intPtr==None else Placeholder(intPtr)
+        return ret
+
+
+    @property
+
+    def TagsList(self)->'TagCollection':
+        """
+        Gets the shape's metadata tags.
+        
+        Returns:
+            TagCollection: Read-only tag collection.
+        """
+        GetDllLibPpt().IOleObject_get_TagsList.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_TagsList.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_TagsList,self.Ptr)
+        ret = None if intPtr==None else TagCollection(intPtr)
+        return ret
+
+
+    @property
+
+    def Frame(self)->'GraphicFrame':
+        """
+        Gets or sets the shape's frame properties.
+        
+        Returns:
+            GraphicFrame: Frame properties object.
+        """
+        GetDllLibPpt().IOleObject_get_Frame.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Frame.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_Frame,self.Ptr)
+        ret = None if intPtr==None else GraphicFrame(intPtr)
+        return ret
+
+
+    @Frame.setter
+    def Frame(self, value:'GraphicFrame'):
+        """
+        Sets the shape's frame properties.
+        
+        Args:
+            value (GraphicFrame): New frame properties.
+        """
+        GetDllLibPpt().IOleObject_set_Frame.argtypes=[c_void_p, c_void_p]
+        CallCFunction(GetDllLibPpt().IOleObject_set_Frame,self.Ptr, value.Ptr)
+
+    @property
+
+    def Line(self)->'TextLineFormat':
+        """
+        Gets line formatting properties.
+        
+        Returns:
+            TextLineFormat: Line format object (may be null).
+        """
+        GetDllLibPpt().IOleObject_get_Line.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Line.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_Line,self.Ptr)
+        ret = None if intPtr==None else TextLineFormat(intPtr)
+        return ret
+
+
+    @property
+
+    def ThreeD(self)->'FormatThreeD':
+        """
+        Gets 3D effect properties.
+        
+        Returns:
+            FormatThreeD: 3D format object (may be null).
+        """
+        GetDllLibPpt().IOleObject_get_ThreeD.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_ThreeD.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_ThreeD,self.Ptr)
+        ret = None if intPtr==None else FormatThreeD(intPtr)
+        return ret
+
+
+    @property
+
+    def EffectDag(self)->'EffectDag':
+        """
+        Gets effect properties.
+        
+        Returns:
+            EffectDag: Effect object (may be null).
+        """
+        GetDllLibPpt().IOleObject_get_EffectDag.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_EffectDag.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_EffectDag,self.Ptr)
+        ret = None if intPtr==None else EffectDag(intPtr)
+        return ret
+
+
+    @property
+
+    def Fill(self)->'FillFormat':
+        """
+        Gets fill properties.
+        
+        Returns:
+            FillFormat: Fill format object (may be null).
+        """
+        GetDllLibPpt().IOleObject_get_Fill.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Fill.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_Fill,self.Ptr)
+        ret = None if intPtr==None else FillFormat(intPtr)
+        return ret
+
+
+    @property
+
+    def Click(self)->'ClickHyperlink':
+        """
+        Gets or sets mouse click hyperlink.
+        
+        Returns:
+            ClickHyperlink: Hyperlink for click action.
+        """
+        GetDllLibPpt().IOleObject_get_Click.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Click.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_Click,self.Ptr)
+        ret = None if intPtr==None else ClickHyperlink(intPtr)
+        return ret
+
+
+    @Click.setter
+    def Click(self, value:'ClickHyperlink'):
+        """
+        Sets mouse click hyperlink.
+        
+        Args:
+            value (ClickHyperlink): New click hyperlink.
+        """
+        GetDllLibPpt().IOleObject_set_Click.argtypes=[c_void_p, c_void_p]
+        CallCFunction(GetDllLibPpt().IOleObject_set_Click,self.Ptr, value.Ptr)
+
+    @property
+
+    def MouseOver(self)->'ClickHyperlink':
+        """
+        Gets or sets mouse over hyperlink.
+        
+        Returns:
+            ClickHyperlink: Hyperlink for mouseover action.
+        """
+        GetDllLibPpt().IOleObject_get_MouseOver.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_MouseOver.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_MouseOver,self.Ptr)
+        ret = None if intPtr==None else ClickHyperlink(intPtr)
+        return ret
+
+
+    @MouseOver.setter
+    def MouseOver(self, value:'ClickHyperlink'):
+        """
+        Sets mouse over hyperlink.
+        
+        Args:
+            value (ClickHyperlink): New mouseover hyperlink.
+        """
+        GetDllLibPpt().IOleObject_set_MouseOver.argtypes=[c_void_p, c_void_p]
+        CallCFunction(GetDllLibPpt().IOleObject_set_MouseOver,self.Ptr, value.Ptr)
+
+    @property
+    def IsHidden(self)->bool:
+        """
+        Indicates whether the shape is hidden.
+        
+        Returns:
+            bool: True if hidden, False otherwise.
+        """
+        GetDllLibPpt().IOleObject_get_IsHidden.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_IsHidden.restype=c_bool
+        ret = CallCFunction(GetDllLibPpt().IOleObject_get_IsHidden,self.Ptr)
+        return ret
+
+    @IsHidden.setter
+    def IsHidden(self, value:bool):
+        """
+        Sets shape visibility.
+        
+        Args:
+            value (bool): True to hide, False to show.
+        """
+        GetDllLibPpt().IOleObject_set_IsHidden.argtypes=[c_void_p, c_bool]
+        CallCFunction(GetDllLibPpt().IOleObject_set_IsHidden,self.Ptr, value)
+
+    @property
+    def ZOrderPosition(self)->int:
+        """
+        Gets or sets z-order position.
+        
+        Returns:
+            int: Position in z-order stack.
+        """
+        GetDllLibPpt().IOleObject_get_ZOrderPosition.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_ZOrderPosition.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().IOleObject_get_ZOrderPosition,self.Ptr)
+        return ret
+
+    @ZOrderPosition.setter
+    def ZOrderPosition(self, value:int):
+        """
+        Sets z-order position.
+        
+        Args:
+            value (int): New z-order position.
+        """
+        GetDllLibPpt().IOleObject_set_ZOrderPosition.argtypes=[c_void_p, c_int]
+        CallCFunction(GetDllLibPpt().IOleObject_set_ZOrderPosition,self.Ptr, value)
+
+    @property
+    def Rotation(self)->float:
+        """
+        Gets or sets rotation angle.
+        
+        Returns:
+            float: Rotation in degrees (positive = clockwise).
+        """
+        GetDllLibPpt().IOleObject_get_Rotation.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Rotation.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().IOleObject_get_Rotation,self.Ptr)
+        return ret
+
+    @Rotation.setter
+    def Rotation(self, value:float):
+        GetDllLibPpt().IOleObject_set_Rotation.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().IOleObject_set_Rotation,self.Ptr, value)
+
+    @property
+    def Left(self)->float:
+        """
+        Gets or sets horizontal position.
+        
+        Returns:
+            float: X-coordinate of upper-left corner.
+        """
+        GetDllLibPpt().IOleObject_get_Left.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Left.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().IOleObject_get_Left,self.Ptr)
+        return ret
+
+    @Left.setter
+    def Left(self, value:float):
+        """
+        Sets horizontal position.
+        
+        Args:
+            value (float): New left position.
+        """
+        GetDllLibPpt().IOleObject_set_Left.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().IOleObject_set_Left,self.Ptr, value)
+
+    @property
+    def Top(self)->float:
+        """
+        Gets or sets vertical position.
+        
+        Returns:
+            float: Y-coordinate of upper-left corner.
+        """
+        GetDllLibPpt().IOleObject_get_Top.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Top.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().IOleObject_get_Top,self.Ptr)
+        return ret
+
+    @Top.setter
+    def Top(self, value:float):
+        """
+        Sets vertical position.
+        
+        Args:
+            value (float): New top position.
+        """
+        GetDllLibPpt().IOleObject_set_Top.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().IOleObject_set_Top,self.Ptr, value)
+
+    @property
+    def Width(self)->float:
+        """
+        Gets or sets object width.
+        
+        Returns:
+            float: Width of the OLE object.
+        """
+        GetDllLibPpt().IOleObject_get_Width.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Width.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().IOleObject_get_Width,self.Ptr)
+        return ret
+
+    @Width.setter
+    def Width(self, value:float):
+        """
+        Sets object width.
+        
+        Args:
+            value (float): New width value.
+        """
+        GetDllLibPpt().IOleObject_set_Width.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().IOleObject_set_Width,self.Ptr, value)
+
+    @property
+    def Height(self)->float:
+        """
+        Gets or sets object height.
+        
+        Returns:
+            float: Height of the OLE object.
+        """
+        GetDllLibPpt().IOleObject_get_Height.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Height.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().IOleObject_get_Height,self.Ptr)
+        return ret
+
+    @Height.setter
+    def Height(self, value:float):
+        """
+        Sets object height.
+        
+        Args:
+            value (float): New height value.
+        """
+        GetDllLibPpt().IOleObject_set_Height.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().IOleObject_set_Height,self.Ptr, value)
+
+    @property
+
+    def AlternativeText(self)->str:
+        """
+        Gets or sets alternative text.
+        
+        Returns:
+            str: Alternative text description.
+        """
+        GetDllLibPpt().IOleObject_get_AlternativeText.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_AlternativeText.restype=c_void_p
+        ret = PtrToStr(CallCFunction(GetDllLibPpt().IOleObject_get_AlternativeText,self.Ptr))
+        return ret
+
+
+    @AlternativeText.setter
+    def AlternativeText(self, value:str):
+        """
+        Sets alternative text.
+        
+        Args:
+            value (str): New alternative text.
+        """
+        valuePtr = StrToPtr(value)
+        GetDllLibPpt().IOleObject_set_AlternativeText.argtypes=[c_void_p, c_char_p]
+        CallCFunction(GetDllLibPpt().IOleObject_set_AlternativeText,self.Ptr,valuePtr)
+
+    @property
+
+    def Name(self)->str:
+        """
+        Gets or sets shape name.
+        
+        Returns:
+            str: Name of the shape.
+        """
+        GetDllLibPpt().IOleObject_get_Name.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Name.restype=c_void_p
+        ret = PtrToStr(CallCFunction(GetDllLibPpt().IOleObject_get_Name,self.Ptr))
+        return ret
+
+
+    @Name.setter
+    def Name(self, value:str):
+        """
+        Sets shape name.
+        
+        Args:
+            value (str): New shape name.
+        """
+        valuePtr = StrToPtr(value)
+        GetDllLibPpt().IOleObject_set_Name.argtypes=[c_void_p, c_char_p]
+        CallCFunction(GetDllLibPpt().IOleObject_set_Name,self.Ptr,valuePtr)
+
+    @property
+
+    def Slide(self)->'ActiveSlide':
+        """
+        Gets parent slide.
+        
+        Returns:
+            ActiveSlide: Read-only parent slide.
+        """
+        GetDllLibPpt().IOleObject_get_Slide.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Slide.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_Slide,self.Ptr)
+        ret = None if intPtr==None else ActiveSlide(intPtr)
+        return ret
+
+
+    @property
+
+    def Presentation(self)->'Presentation':
+        """Gets parent presentation."""
+        GetDllLibPpt().IOleObject_get_Presentation.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Presentation.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_Presentation,self.Ptr)
+        ret = None if intPtr==None else Presentation(intPtr)
+        return ret
+
+
+    @property
+
+    def Parent(self)->'SpireObject':
+        """Gets parent object."""
+        GetDllLibPpt().IOleObject_get_Parent.argtypes=[c_void_p]
+        GetDllLibPpt().IOleObject_get_Parent.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().IOleObject_get_Parent,self.Ptr)
+        ret = None if intPtr==None else SpireObject(intPtr)
+        return ret
+
+
+    def RemovePlaceholder(self):
+        """Removes placeholder properties from the shape."""
+        GetDllLibPpt().IOleObject_RemovePlaceholder.argtypes=[c_void_p]
+        CallCFunction(GetDllLibPpt().IOleObject_RemovePlaceholder,self.Ptr)
+
+    def Dispose(self):
+        """
+        Dispose object and free resources.
+   
+        """
+        GetDllLibPpt().IOleObject_Dispose.argtypes=[c_void_p]
+        CallCFunction(GetDllLibPpt().IOleObject_Dispose,self.Ptr)
+