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

spire/presentation/PictureShape.py

@@ -4,22 +4,20 @@ from typing import TypeVar,Union,Generic,List,Tuple
 from spire.presentation.common import *
 from spire.presentation import *
 from ctypes import *
-from spire.presentation.IImageData import IImageData
+from spire.presentation.drawing.IImageData import IImageData
 
 class PictureShape (  IActiveSlide) :
     """
-    <summary>
-        Represents a picture in a presentation.
-    </summary>
+    Represents a picture in a presentation.
     """
     @property
 
     def EmbedImage(self)->'IImageData':
         """
-    <summary>
         Gets or sets the embedded image.
-            Read/write <see cref="P:Spire.Presentation.PictureShape.EmbedImage" />.
-    </summary>
+        
+        Returns:
+            IImageData: The embedded image data.
         """
         GetDllLibPpt().PictureShape_get_EmbedImage.argtypes=[c_void_p]
         GetDllLibPpt().PictureShape_get_EmbedImage.restype=c_void_p
@@ -30,6 +28,12 @@ class PictureShape (  IActiveSlide) :
 
     @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)
 
@@ -37,10 +41,10 @@ class PictureShape (  IActiveSlide) :
 
     def Url(self)->str:
         """
-    <summary>
-        Gets or sets linked image's URL.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+        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
@@ -50,6 +54,12 @@ class PictureShape (  IActiveSlide) :
 
     @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)
@@ -57,10 +67,12 @@ class PictureShape (  IActiveSlide) :
     @property
     def Transparency(self)->int:
         """
-    <summary>
-        Gets or sets the Transparency of a picture fill.
-            The value ranges from 0 to 100.
-    </summary>
+        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
@@ -69,6 +81,12 @@ class PictureShape (  IActiveSlide) :
 
     @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)
 
@@ -76,10 +94,10 @@ class PictureShape (  IActiveSlide) :
 
     def Slide(self)->'ActiveSlide':
         """
-    <summary>
-        Gets the parent slide of a picture.
-            Read-only <see cref="T:Spire.Presentation.ActiveSlide" />.
-    </summary>
+        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
@@ -92,7 +110,10 @@ class PictureShape (  IActiveSlide) :
 
     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

spire/presentation/Placeholder.py

@@ -8,18 +8,18 @@ import abc
 
 class Placeholder (  PptObject) :
     """
-    <summary>
-        Represents a placeholder on a slide.
-    </summary>
+    Represents a placeholder area on a slide that can hold specific types of content.
     """
     @property
 
     def Orientation(self)->'Direction':
         """
-    <summary>
-        Gets the orientation of a placeholder.
-            Read-only <see cref="P:Spire.Presentation.Placeholder.Orientation" />.
-    </summary>
+        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
@@ -31,10 +31,12 @@ class Placeholder (  PptObject) :
 
     def Size(self)->'PlaceholderSize':
         """
-    <summary>
-        Gets the size of a placeholder.
-            Read-only <see cref="T:Spire.Presentation.PlaceholderSize" />.
-    </summary>
+        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
@@ -46,10 +48,12 @@ class Placeholder (  PptObject) :
 
     def Type(self)->'PlaceholderType':
         """
-    <summary>
-        Gets the type of a placeholder.
-            Read-only <see cref="T:Spire.Presentation.Converter.Entity.PlaceholderType" />.
-    </summary>
+        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
@@ -61,10 +65,12 @@ class Placeholder (  PptObject) :
 
     def Index(self)->'UInt32':
         """
-    <summary>
-        Gets the index of a placeholder.
-            Read-only <see cref="T:System.UInt32" />.
-    </summary>
+        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
@@ -76,7 +82,15 @@ class Placeholder (  PptObject) :
 
     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
 

spire/presentation/PlaceholderSize.py

@@ -8,9 +8,13 @@ import abc
 
 class PlaceholderSize(Enum):
     """
-    <summary>
-        Represents the size of a placeholder.
-    </summary>
+    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

spire/presentation/PlaceholderType.py

@@ -8,9 +8,26 @@ import abc
 
 class PlaceholderType(Enum):
     """
-    <summary>
-        Represents the type of a placeholder.
-    </summary>
+    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

spire/presentation/PptObject.py

@@ -8,15 +8,17 @@ 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':
         """
-    <summary>
-        Reference to Parent object. Read-only.
-    </summary>
+        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
@@ -27,9 +29,10 @@ class PptObject (SpireObject) :
 
     def Dispose(self):
         """
-    <summary>
-        Dispose object and free resources.
-    </summary>
+        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)