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

spire/presentation/Presentation.py

@@ -8,28 +8,35 @@ from ctypes import *
 import abc
 
 class Presentation (_Presentation) :
+    """
+    Represents a PowerPoint presentation document. Provides comprehensive functionality 
+    for creating, loading, manipulating, saving, and presenting slideshow documents.
+    """
 
     @dispatch
     def __init__(self):
+        """
+        Initializes a new empty Presentation instance.
+        """
         GetDllLibPpt().Presentation_CreatePresentation.restype = c_void_p
         intPtr = CallCFunction(GetDllLibPpt().Presentation_CreatePresentation)
         super(Presentation, self).__init__(intPtr)
     def __del__(self):
+        """
+        Destructor that releases resources associated with the Presentation instance.
+        """
         GetDllLibPpt().Presentation_Dispose.argtypes = [c_void_p]
         CallCFunction(GetDllLibPpt().Presentation_Dispose,self.Ptr)
         super(Presentation, self).__del__()
-    """
-    <summary>
-        Represents an Presentation document. 
-    </summary>
-    """
+    
     @property
 
     def SlideSize(self)->'SlideSize':
         """
-    <summary>
-        Get slide size.
-    </summary>
+        Gets the current slide size configuration.
+
+        Returns:
+            SlideSize: Object representing slide dimensions and orientation.
         """
         GetDllLibPpt().Presentation_get_SlideSize.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_SlideSize.restype=c_void_p
@@ -42,7 +49,10 @@ class Presentation (_Presentation) :
 
     def SectionList(self)->'SectionList':
         """
+        Gets the collection of sections organizing slides in the presentation.
 
+        Returns:
+            SectionList: Collection of presentation sections.
         """
         GetDllLibPpt().Presentation_get_SectionList.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_SectionList.restype=c_void_p
@@ -54,12 +64,12 @@ class Presentation (_Presentation) :
 
     def SetPageSize(self ,w:float,h:float,IsRatio:bool):
         """
-    <summary>
-        Set page size.
-    </summary>
-    <param name="w">Width or width ratio</param>
-    <param name="h">Height or height ratio</param>
-    <param name="IsRation">Is ratio</param>
+        Configures the page/slide dimensions.
+
+        Args:
+            w: Width value or width ratio
+            h: Height value or height ratio
+            IsRatio: True if values represent ratios, False for absolute units
         """
         
         GetDllLibPpt().Presentation_SetPageSize.argtypes=[c_void_p ,c_float,c_float,c_bool]
@@ -68,7 +78,9 @@ class Presentation (_Presentation) :
     @property
     def StrictFirstAndLastCharacters(self)->bool:
         """
+        Gets or sets whether to use strict typography rules for first/last characters.
 
+        This property controls typographic rules regarding line breaks and character positioning.
         """
         GetDllLibPpt().Presentation_get_StrictFirstAndLastCharacters.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_StrictFirstAndLastCharacters.restype=c_bool
@@ -84,9 +96,10 @@ class Presentation (_Presentation) :
 
     def WavAudios(self)->'WavAudioCollection':
         """
-    <summary>
-        Gets the collection of all embedded audio.
-    </summary>
+        Gets the collection of all embedded audio files in the presentation.
+
+        Returns:
+            WavAudioCollection: Collection of audio objects.
         """
         GetDllLibPpt().Presentation_get_WavAudios.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_WavAudios.restype=c_void_p
@@ -99,9 +112,10 @@ class Presentation (_Presentation) :
 
     def Videos(self)->'VideoCollection':
         """
-    <summary>
-        Gets the collection of all embedded video.
-    </summary>
+        Gets the collection of all embedded video files in the presentation.
+
+        Returns:
+            VideoCollection: Collection of video objects.
         """
         GetDllLibPpt().Presentation_get_Videos.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_Videos.restype=c_void_p
@@ -114,9 +128,10 @@ class Presentation (_Presentation) :
 
     def TagsList(self)->'TagCollection':
         """
-    <summary>
-        Gets the tags collection.
-    </summary>
+        Gets the collection of document tags/metadata.
+
+        Returns:
+            TagCollection: Collection of tag objects.
         """
         GetDllLibPpt().Presentation_get_TagsList.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_TagsList.restype=c_void_p
@@ -129,9 +144,10 @@ class Presentation (_Presentation) :
 
     def Images(self)->'ImageCollection':
         """
-    <summary>
-        Gets the collection of all images.
-    </summary>
+        Gets the collection of all images used in the presentation.
+
+        Returns:
+            ImageCollection: Collection of image objects.
         """
         GetDllLibPpt().Presentation_get_Images.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_Images.restype=c_void_p
@@ -144,9 +160,10 @@ class Presentation (_Presentation) :
 
     def DocumentProperty(self)->'IDocumentProperty':
         """
-    <summary>
-        Gets Standard and custom document properties.
-    </summary>
+        Gets standard and custom document properties.
+
+        Returns:
+            IDocumentProperty: Interface for accessing document properties.
         """
         GetDllLibPpt().Presentation_get_DocumentProperty.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_DocumentProperty.restype=c_void_p
@@ -159,9 +176,10 @@ class Presentation (_Presentation) :
 
     def CommentAuthors(self)->'CommentAuthorCollection':
         """
-    <summary>
-        Gets CommentAuthor List.
-    </summary>
+        Gets the collection of comment authors in the presentation.
+
+        Returns:
+            CommentAuthorCollection: Collection of comment author objects.
         """
         GetDllLibPpt().Presentation_get_CommentAuthors.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_CommentAuthors.restype=c_void_p
@@ -173,7 +191,9 @@ class Presentation (_Presentation) :
     @property
     def DFlag(self)->bool:
         """
+        Gets or sets the document flag status (internal use).
 
+        This property is used internally for document state tracking.
         """
         GetDllLibPpt().Presentation_get_DFlag.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_DFlag.restype=c_bool
@@ -189,10 +209,10 @@ class Presentation (_Presentation) :
 
     def FormatAndVersion(self)->'FormatAndVersion':
         """
-    <summary>
-        Gets the the Format and Version of file;
-            read-only
-    </summary>
+        Gets the file format and version of the presentation (read-only).
+
+        Returns:
+            FormatAndVersion: Enumeration value representing file format and version.
         """
         GetDllLibPpt().Presentation_get_FormatAndVersion.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_FormatAndVersion.restype=c_int
@@ -225,10 +245,10 @@ class Presentation (_Presentation) :
 
     def GetDigitalSignatures(self)->'IDigitalSignatures':
         """
-    <summary>
-        Get collection of DigitalSignature in this file.
-    </summary>
-    <returns>Collection of DigitalSignature</returns>
+        Gets the collection of digital signatures applied to the document.
+
+        Returns:
+            IDigitalSignatures: Collection of digital signature objects.
         """
         GetDllLibPpt().Presentation_GetDigitalSignatures.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_GetDigitalSignatures.restype=c_void_p
@@ -239,9 +259,7 @@ class Presentation (_Presentation) :
 
     def RemoveAllDigitalSignatures(self):
         """
-    <summary>
-        Remove all DigitalSignature in this file.
-    </summary>
+        Removes all digital signatures from the document.
         """
         GetDllLibPpt().Presentation_RemoveAllDigitalSignatures.argtypes=[c_void_p]
         CallCFunction(GetDllLibPpt().Presentation_RemoveAllDigitalSignatures,self.Ptr)
@@ -249,9 +267,10 @@ class Presentation (_Presentation) :
     @property
     def IsDigitallySigned(self)->bool:
         """
-    <summary>
-        Indicates whether this spreadsheet is digitally signed.
-    </summary>
+        Indicates whether the presentation contains digital signatures.
+
+        Returns:
+            bool: True if digitally signed, False otherwise.
         """
         GetDllLibPpt().Presentation_get_IsDigitallySigned.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_IsDigitallySigned.restype=c_bool
@@ -261,9 +280,10 @@ class Presentation (_Presentation) :
 
     def SetCustomFontsFolder(self ,fontsFolder:str):
         """
-    <summary>
-        Set folder where the custom font is located.
-                <param name="fontsFolder">the fonts folfer.</param></summary>
+        Sets the folder path for custom fonts used in the presentation.
+
+        Args:
+            fontsFolder: Path to the folder containing custom fonts
         """
         
         fontsFolderPtr = StrToPtr(fontsFolder)
@@ -274,9 +294,13 @@ class Presentation (_Presentation) :
 
     def IsPasswordProtected(self ,fileName:str)->bool:
         """
-    <summary>
-        Determine whether the document is encrypted
-    </summary>
+        Determines if a file is password protected.
+
+        Args:
+            fileName: Path to the file to check
+
+        Returns:
+            bool: True if password protected, False otherwise
         """
         
         fileNamePtr = StrToPtr(fileName)
@@ -289,9 +313,13 @@ class Presentation (_Presentation) :
 
     def IsPasswordProtected(self ,stream:Stream)->bool:
         """
-    <summary>
-        Determine whether the document is encrypted
-                <param name="stream">file stream</param></summary>
+        Determines if a stream contains a password protected presentation.
+
+        Args:
+            stream: Input stream containing presentation data
+
+        Returns:
+            bool: True if password protected, False otherwise
         """
         intPtrstream:c_void_p = stream.Ptr
 
@@ -303,9 +331,9 @@ class Presentation (_Presentation) :
     @property
     def HighQualityImage(self)->bool:
         """
-    <summary>
-        Determine whether the document is encrypted
-                <param name="stream">file stream</param></summary>
+        Gets or sets whether to use high-quality image rendering.
+
+        When True, images will be rendered at higher quality at the cost of performance.
         """
         GetDllLibPpt().Presentation_get_HighQualityImage.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_HighQualityImage.restype=c_bool
@@ -319,12 +347,18 @@ class Presentation (_Presentation) :
 
     
     def SlideSizeAutoFit(self, value:bool):
+        """
+        Enables or disables automatic slide size fitting.
+
+        Args:
+            value: True to enable auto-fitting, False to disable
+        """
         GetDllLibPpt().Presentation_set_SlideSizeAutoFit.argtypes=[c_void_p, c_bool]
         CallCFunction(GetDllLibPpt().Presentation_set_SlideSizeAutoFit,self.Ptr, value)
 
     def Dispose(self):
         """
-
+        Releases all resources used by the Presentation object.
         """
         GetDllLibPpt().Presentation_Dispose.argtypes=[c_void_p]
         CallCFunction(GetDllLibPpt().Presentation_Dispose,self.Ptr)
@@ -333,9 +367,10 @@ class Presentation (_Presentation) :
 
     def SaveToPdfOption(self)->'SaveToPdfOption':
         """
-    <summary>
-        SaveToPdfOption
-    </summary>
+        Gets or sets options for saving to PDF format.
+
+        Returns:
+            SaveToPdfOption: Configuration object for PDF export.
         """
         GetDllLibPpt().Presentation_get_SaveToPdfOption.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_SaveToPdfOption.restype=c_void_p
@@ -353,7 +388,10 @@ class Presentation (_Presentation) :
 
     def SaveToHtmlOption(self)->'SaveToHtmlOption':
         """
+        Gets or sets options for saving to HTML format.
 
+        Returns:
+            SaveToHtmlOption: Configuration object for HTML export.
         """
         GetDllLibPpt().Presentation_get_SaveToHtmlOption.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_SaveToHtmlOption.restype=c_void_p
@@ -371,9 +409,10 @@ class Presentation (_Presentation) :
 
     def SaveToPptxOption(self)->'SaveToPptxOption':
         """
-    <summary>
-        save to pptx option.
-    </summary>
+        Gets or sets options for saving to PPTX format.
+
+        Returns:
+            SaveToPptxOption: Configuration object for PPTX export.
         """
         GetDllLibPpt().Presentation_get_SaveToPptxOption.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_SaveToPptxOption.restype=c_void_p
@@ -390,11 +429,13 @@ class Presentation (_Presentation) :
 
     def FindSlide(self ,id:int)->'ISlide':
         """
-    <summary>
-        Find a slide by ID.
-    </summary>
-    <param name="id"></param>
-    <returns></returns>
+        Finds a slide by its unique identifier.
+
+        Args:
+            id: Slide identifier to locate
+
+        Returns:
+            ISlide: Found slide object or None if not found
         """
         
         GetDllLibPpt().Presentation_FindSlide.argtypes=[c_void_p ,c_int]
@@ -422,10 +463,10 @@ class Presentation (_Presentation) :
 
     def GetStream(self)->'Stream':
         """
-    <summary>
-        Gets the document as a stream to read from.
-    </summary>
-    <returns>A <see cref="T:System.IO.Stream" /> to read from.</returns>
+        Gets the presentation content as a readable stream.
+
+        Returns:
+            Stream: Readable stream containing presentation data
         """
         GetDllLibPpt().Presentation_GetStream.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_GetStream.restype=c_void_p
@@ -438,10 +479,11 @@ class Presentation (_Presentation) :
 
     def LoadFromStream(self ,stream:Stream,fileFormat:FileFormat):
         """
-    <summary>
-        Opens the document from a stream.
-    </summary>
-    <param name="stream">The document stream.</param>
+        Loads presentation content from a stream.
+
+        Args:
+            stream: Stream containing presentation data
+            fileFormat: Format of the presentation data
         """
         intPtrstream:c_void_p = stream.Ptr
         enumfileFormat:c_int = fileFormat.value
@@ -453,12 +495,12 @@ class Presentation (_Presentation) :
 
     def LoadFromStream(self ,stream:Stream,fileFormat:FileFormat,password:str):
         """
-    <summary>
-        Opens the document from a stream.
-    </summary>
-    <param name="stream">The document stream.</param>
-    <param name="fileFormat">The file format</param>
-    <param name="password">The password.</param>
+        Loads password-protected presentation content from a stream.
+
+        Args:
+            stream: Stream containing presentation data
+            fileFormat: Format of the presentation data
+            password: Password to unlock the presentation
         """
         intPtrstream:c_void_p = stream.Ptr
         enumfileFormat:c_int = fileFormat.value
@@ -471,12 +513,11 @@ class Presentation (_Presentation) :
 
     def LoadFromFile(self ,file:str):
         """
-    <summary>
-        Opens the document from a file.
-    </summary>
-    <param name="file">The document file path.</param>
+        Loads presentation content from a file.
+
+        Args:
+            file: Path to the presentation file
         """
-        
         filePtr = StrToPtr(file)
         GetDllLibPpt().Presentation_LoadFromFile.argtypes=[c_void_p ,c_char_p]
         CallCFunction(GetDllLibPpt().Presentation_LoadFromFile,self.Ptr,filePtr)
@@ -485,10 +526,11 @@ class Presentation (_Presentation) :
 
     def LoadFromFile(self ,file:str,password:str):
         """
-    <summary>
-        Opens the document from a file.
-    </summary>
-    <param name="file">The document file path.</param>
+        Loads password-protected presentation content from a file.
+
+        Args:
+            file: Path to the presentation file
+            password: Password to unlock the presentation
         """
         
         filePtr = StrToPtr(file)
@@ -500,7 +542,11 @@ class Presentation (_Presentation) :
 
     def LoadFromFile(self ,file:str,fileFormat:FileFormat):
         """
+        Loads presentation content from a file with specific format.
 
+        Args:
+            file: Path to the presentation file
+            fileFormat: Format of the presentation file
         """
         enumfileFormat:c_int = fileFormat.value
 
@@ -512,7 +558,12 @@ class Presentation (_Presentation) :
 
     def LoadFromFile(self ,file:str,fileFormat:FileFormat,password:str):
         """
+        Loads password-protected presentation content from a file with specific format.
 
+        Args:
+            file: Path to the presentation file
+            fileFormat: Format of the presentation file
+            password: Password to unlock the presentation
         """
         enumfileFormat:c_int = fileFormat.value
 
@@ -525,10 +576,11 @@ class Presentation (_Presentation) :
 
     def SaveToFile(self ,stream:Stream,fileFormat:FileFormat):
         """
-    <summary>
-        Saves the document to the specified stream. 
-    </summary>
-    <param name="stream">The <see cref="T:System.IO.Stream" /> where the document will be saved.</param>
+        Saves the presentation to a stream.
+
+        Args:
+            stream: Output stream to write presentation data
+            fileFormat: Format to save the presentation in
         """
         intPtrstream:c_void_p = stream.Ptr
         enumfileFormat:c_int = fileFormat.value
@@ -539,10 +591,11 @@ class Presentation (_Presentation) :
 
     def SaveToSVG(self)->List[Stream]:
        """
-   <summary>
-       Saves the document to the SVG Format. 
-   </summary>
-       """
+        Saves the presentation as SVG images (one per slide).
+
+        Returns:
+            List[Stream]: Collection of streams containing SVG data for each slide
+        """
        GetDllLibPpt().Presentation_SaveToSVG.argtypes=[c_void_p]
        GetDllLibPpt().Presentation_SaveToSVG.restype=IntPtrArray
        intPtrArray = CallCFunction(GetDllLibPpt().Presentation_SaveToSVG,self.Ptr)
@@ -554,9 +607,14 @@ class Presentation (_Presentation) :
 
     def OnlineSaveToFile(self ,file:str,fileFormat:'FileFormat')->bool:
         """
-    <summary>
-        used for online. 
-    </summary>
+        Saves the presentation for online/cloud use.
+
+        Args:
+            file: Output file path
+            fileFormat: Format to save the presentation in
+
+        Returns:
+            bool: True if save succeeded, False otherwise
         """
         enumfileFormat:c_int = fileFormat.value
 
@@ -570,11 +628,11 @@ class Presentation (_Presentation) :
 
     def SaveToFile(self ,file:str,fileFormat:FileFormat):
         """
-    <summary>
-        Saves the document to the specified file. 
-    </summary>
-    <param name="file">A string that contains the path of the file to which to save this document.</param>
-    <param name="fileFormat">convert to fileFormat.</param>
+        Saves the presentation to a file.
+
+        Args:
+            file: Output file path
+            fileFormat: Format to save the presentation in
         """
         enumfileFormat:c_int = fileFormat.value
 
@@ -621,10 +679,10 @@ class Presentation (_Presentation) :
 
     def Encrypt(self ,password:str):
         """
-    <summary>
-        Encrypts with specified password.
-    </summary>
-    <param name="password">The password.</param>
+        Encrypts the presentation with a password.
+
+        Args:
+            password: Encryption password
         """
         
         passwordPtr = StrToPtr(password)
@@ -633,9 +691,7 @@ class Presentation (_Presentation) :
 
     def RemoveEncryption(self):
         """
-    <summary>
-        Removes the encryption.
-    </summary>
+        Removes encryption from the presentation.
         """
         GetDllLibPpt().Presentation_RemoveEncryption.argtypes=[c_void_p]
         CallCFunction(GetDllLibPpt().Presentation_RemoveEncryption,self.Ptr)
@@ -643,21 +699,18 @@ class Presentation (_Presentation) :
 
     def Protect(self ,password:str):
         """
-    <summary>
-        Protection for this presentation.
-    </summary>
-    <param name="password">The password.</param>
+        Protects the presentation from modification.
+
+        Args:
+            password: Protection password
         """
-        
         passwordPtr = StrToPtr(password)
         GetDllLibPpt().Presentation_Protect.argtypes=[c_void_p ,c_char_p]
         CallCFunction(GetDllLibPpt().Presentation_Protect,self.Ptr,passwordPtr)
 
     def RemoveProtect(self):
         """
-    <summary>
-        Remove proection.
-    </summary>
+        Removes protection from the presentation.
         """
         GetDllLibPpt().Presentation_RemoveProtect.argtypes=[c_void_p]
         CallCFunction(GetDllLibPpt().Presentation_RemoveProtect,self.Ptr)
@@ -722,7 +775,10 @@ class Presentation (_Presentation) :
 
     def SetFooterText(self ,text:str):
         """
+        Sets the footer text for all slides.
 
+        Args:
+            text: Footer text to apply
         """
         
         textPtr = StrToPtr(text)
@@ -733,7 +789,10 @@ class Presentation (_Presentation) :
 
     def SetDateTime(self ,dateTime:DateTime):
         """
+        Sets the date/time for all slides using default format.
 
+        Args:
+            dateTime: DateTime object containing the date/time value
         """
         intPtrdateTime:c_void_p = dateTime.Ptr
 
@@ -744,7 +803,11 @@ class Presentation (_Presentation) :
 
     def SetDateTime(self ,dateTime:DateTime,format:str):
         """
+        Sets the date/time for all slides with custom formatting.
 
+        Args:
+            dateTime: DateTime object containing the date/time value
+            format: Custom format string for date/time display
         """
         intPtrdateTime:c_void_p = dateTime.Ptr
 
@@ -755,7 +818,10 @@ class Presentation (_Presentation) :
 
     def SetFooterVisible(self ,visible:bool):
         """
+        Shows or hides the footer on all slides.
 
+        Args:
+            visible: True to show footer, False to hide
         """
         
         GetDllLibPpt().Presentation_SetFooterVisible.argtypes=[c_void_p ,c_bool]
@@ -764,7 +830,10 @@ class Presentation (_Presentation) :
 
     def SetDateTimeVisible(self ,visible:bool):
         """
+        Shows or hides the date/time on all slides.
 
+        Args:
+            visible: True to show date/time, False to hide
         """
         
         GetDllLibPpt().Presentation_SetDateTimeVisible.argtypes=[c_void_p ,c_bool]
@@ -773,7 +842,10 @@ class Presentation (_Presentation) :
 
     def SetSlideNoVisible(self ,visible:bool):
         """
+        Shows or hides slide numbers on all slides.
 
+        Args:
+            visible: True to show slide numbers, False to hide
         """
         
         GetDllLibPpt().Presentation_SetSlideNoVisible.argtypes=[c_void_p ,c_bool]
@@ -782,9 +854,9 @@ class Presentation (_Presentation) :
     @property
     def SlideNumberVisible(self)->bool:
         """
-    <summary>
-        Gets or sets value .Specifies whether the slide number placeholder is enabled for this master
-    </summary>
+        Gets or sets whether slide numbers are visible.
+
+        When True, slide numbers will be displayed on slides.
         """
         GetDllLibPpt().Presentation_get_SlideNumberVisible.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_SlideNumberVisible.restype=c_bool
@@ -799,9 +871,9 @@ class Presentation (_Presentation) :
     @property
     def DateTimeVisible(self)->bool:
         """
-    <summary>
-        Gets or sets value .Specifies whether Date-Time placeholder is enabled for this master
-    </summary>
+        Gets or sets whether date/time is visible on slides.
+
+        When True, date/time will be displayed on slides.
         """
         GetDllLibPpt().Presentation_get_DateTimeVisible.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_DateTimeVisible.restype=c_bool
@@ -816,9 +888,9 @@ class Presentation (_Presentation) :
     @property
     def FooterVisible(self)->bool:
         """
-    <summary>
-        Gets or sets value .Specifies whether the Footer placeholder is enabled for this master
-    </summary>
+        Gets or sets whether footer is visible on slides.
+
+        When True, footer will be displayed on slides.
         """
         GetDllLibPpt().Presentation_get_FooterVisible.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_FooterVisible.restype=c_bool
@@ -833,9 +905,9 @@ class Presentation (_Presentation) :
     @property
     def AutoCompressPictures(self)->bool:
         """
-    <summary>
-        Indicates that Compress Pictures feature automatically reduces the file size of pictures.
-    </summary>
+        Gets or sets automatic picture compression.
+
+        When True, images will be automatically compressed to reduce file size.
         """
         GetDllLibPpt().Presentation_get_AutoCompressPictures.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_AutoCompressPictures.restype=c_bool
@@ -850,9 +922,9 @@ class Presentation (_Presentation) :
     @property
     def BookmarkIdSeed(self)->int:
         """
-    <summary>
-        Bookmark ID Seed.
-    </summary>
+        Gets or sets the starting ID for bookmarks.
+
+        This value determines the starting point for bookmark ID generation.
         """
         GetDllLibPpt().Presentation_get_BookmarkIdSeed.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_BookmarkIdSeed.restype=c_int
@@ -868,9 +940,10 @@ class Presentation (_Presentation) :
 
     def DefaultTextStyle(self)->'TextStyle':
         """
-    <summary>
-        Default paragraph and list style.
-    </summary>
+        Gets the default text style for the presentation.
+
+        Returns:
+            TextStyle: Default text formatting properties
         """
         GetDllLibPpt().Presentation_get_DefaultTextStyle.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_DefaultTextStyle.restype=c_void_p
@@ -882,9 +955,9 @@ class Presentation (_Presentation) :
     @property
     def ShowNarration(self)->bool:
         """
-    <summary>
-        Specifies whether slide show narration should be played when presenting
-    </summary>
+        Gets or sets whether narration is played during slide shows.
+
+        When True, audio narration will play during presentations.
         """
         GetDllLibPpt().Presentation_get_ShowNarration.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_ShowNarration.restype=c_bool
@@ -899,9 +972,9 @@ class Presentation (_Presentation) :
     @property
     def ShowAnimation(self)->bool:
         """
-    <summary>
-        Specifies whether slide show animation should be shown when presenting
-    </summary>
+        Gets or sets whether animations are played during slide shows.
+
+        When True, slide animations will play during presentations.
         """
         GetDllLibPpt().Presentation_get_ShowAnimation.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_ShowAnimation.restype=c_bool
@@ -916,9 +989,9 @@ class Presentation (_Presentation) :
     @property
     def ShowLoop(self)->bool:
         """
-    <summary>
-        Specifies whether the slide show should be set to loop at the end
-    </summary>
+        Gets or sets whether slide shows loop continuously.
+
+        When True, presentations will restart automatically after completion.
         """
         GetDllLibPpt().Presentation_get_ShowLoop.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_ShowLoop.restype=c_bool
@@ -933,9 +1006,10 @@ class Presentation (_Presentation) :
     @property
     def HasMacros(self)->bool:
         """
-    <summary>
-        Specifies whether contains VBA macros.
-    </summary>
+        Indicates whether the presentation contains VBA macros.
+
+        Returns:
+            bool: True if macros are present, False otherwise
         """
         GetDllLibPpt().Presentation_get_HasMacros.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_HasMacros.restype=c_bool
@@ -944,9 +1018,7 @@ class Presentation (_Presentation) :
 
     def DeleteMacros(self):
         """
-    <summary>
-        Delete the Macros
-    </summary>
+        Deletes all VBA macros from the presentation.
         """
         GetDllLibPpt().Presentation_DeleteMacros.argtypes=[c_void_p]
         CallCFunction(GetDllLibPpt().Presentation_DeleteMacros,self.Ptr)
@@ -955,9 +1027,10 @@ class Presentation (_Presentation) :
 
     def ShowType(self)->'SlideShowType':
         """
-    <summary>
-        Specifies the slide show type
-    </summary>
+        Gets or sets the slide show presentation type.
+
+        Returns:
+            SlideShowType: Enumeration value representing presentation mode
         """
         GetDllLibPpt().Presentation_get_ShowType.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_ShowType.restype=c_int
@@ -973,9 +1046,9 @@ class Presentation (_Presentation) :
     @property
     def UseTimings(self)->bool:
         """
-    <summary>
-        Specifies whether slide transition timing should be used to advance slides when presenting
-    </summary>
+        Gets or sets whether slide timings are used during presentations.
+
+        When True, slide transitions will follow preset timing settings.
         """
         GetDllLibPpt().Presentation_get_UseTimings.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_UseTimings.restype=c_bool
@@ -990,9 +1063,9 @@ class Presentation (_Presentation) :
     @property
     def EmbedTrueTypeFonts(self)->bool:
         """
-    <summary>
-        Indicates whther embeds TrueType fonts in a document when it's saved.
-    </summary>
+        Gets or sets whether TrueType fonts are embedded in the document.
+
+        When True, fonts will be embedded to ensure consistent rendering.
         """
         GetDllLibPpt().Presentation_get_EmbedTrueTypeFonts.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_EmbedTrueTypeFonts.restype=c_bool
@@ -1007,9 +1080,9 @@ class Presentation (_Presentation) :
     @property
     def FirstSlideNumber(self)->int:
         """
-    <summary>
-        Slide number that appears on the first slide in your presentation.
-    </summary>
+        Gets or sets the starting slide number.
+
+        This value determines the number shown on the first slide.
         """
         GetDllLibPpt().Presentation_get_FirstSlideNumber.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_FirstSlideNumber.restype=c_int
@@ -1025,9 +1098,10 @@ class Presentation (_Presentation) :
 
     def HandoutMaster(self)->'INoteMasterSlide':
         """
-    <summary>
-        Gets a master for all notes slides of this presentation.
-    </summary>
+        Gets the handout master slide.
+
+        Returns:
+            INoteMasterSlide: Master slide for handout layouts
         """
         GetDllLibPpt().Presentation_get_HandoutMaster.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_HandoutMaster.restype=c_void_p
@@ -1040,9 +1114,10 @@ class Presentation (_Presentation) :
 
     def NotesMaster(self)->'INoteMasterSlide':
         """
-    <summary>
-        Gets a master for all notes slides of this presentation.
-    </summary>
+        Gets the notes master slide.
+
+        Returns:
+            INoteMasterSlide: Master slide for speaker notes layouts
         """
         GetDllLibPpt().Presentation_get_NotesMaster.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_NotesMaster.restype=c_void_p
@@ -1055,9 +1130,10 @@ class Presentation (_Presentation) :
 
     def NotesSlideSize(self)->'SizeF':
         """
-    <summary>
-        Gets note slide size object.
-    </summary>
+        Gets the size of notes slides.
+
+        Returns:
+            SizeF: Dimensions of notes slides
         """
         GetDllLibPpt().Presentation_get_NotesSlideSize.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_NotesSlideSize.restype=c_void_p
@@ -1069,9 +1145,9 @@ class Presentation (_Presentation) :
     @property
     def SaveSubsetFonts(self)->bool:
         """
-    <summary>
-        Indicates whther embeds subset TrueType fonts in a document when it's saved.
-    </summary>
+        Gets or sets whether to embed font subsets.
+
+        When True, only used characters from fonts will be embedded.
         """
         GetDllLibPpt().Presentation_get_SaveSubsetFonts.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_SaveSubsetFonts.restype=c_bool
@@ -1086,9 +1162,9 @@ class Presentation (_Presentation) :
     @property
     def ServerZoom(self)->float:
         """
-    <summary>
-        Specifies a zoom level for visual representations of the document.
-    </summary>
+        Gets or sets the server-side zoom level.
+
+        This property affects how the presentation is rendered on servers.
         """
         GetDllLibPpt().Presentation_get_ServerZoom.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_ServerZoom.restype=c_float
@@ -1104,9 +1180,10 @@ class Presentation (_Presentation) :
 
     def Masters(self)->'MasterSlideCollection':
         """
-    <summary>
-        Gets a list of all master slides.
-    </summary>
+        Gets the collection of master slides.
+
+        Returns:
+            MasterSlideCollection: Collection of master slide objects
         """
         GetDllLibPpt().Presentation_get_Masters.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_Masters.restype=c_void_p
@@ -1119,9 +1196,10 @@ class Presentation (_Presentation) :
 
     def Slides(self)->'SlideCollection':
         """
-    <summary>
-        Gets a list of all slides.
-    </summary>
+        Gets the collection of slides.
+
+        Returns:
+            SlideCollection: Collection of slide objects
         """
         GetDllLibPpt().Presentation_get_Slides.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_Slides.restype=c_void_p
@@ -1133,9 +1211,10 @@ class Presentation (_Presentation) :
 
     def SlideCountPerPageForPrint(self)->'PageSlideCount':
         """
-    <summary>
-        Number of total slides per page.
-    </summary>
+        Gets or sets the number of slides per printed page.
+
+        Returns:
+            PageSlideCount: Enumeration value representing slides per page
         """
         GetDllLibPpt().Presentation_get_SlideCountPerPageForPrint.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_SlideCountPerPageForPrint.restype=c_int
@@ -1150,9 +1229,10 @@ class Presentation (_Presentation) :
 
     def SelectSlidesForPrint(self ,selectSlidesForPrint:List[str]):
         """
-    <summary>
-        Select print slides
-    </summary>
+        Selects specific slides for printing.
+
+        Args:
+            selectSlidesForPrint: List of slide identifiers to print
         """
         #arrayselectSlidesForPrint:ArrayTypeselectSlidesForPrint = ""
         countselectSlidesForPrint = len(selectSlidesForPrint)
@@ -1170,9 +1250,10 @@ class Presentation (_Presentation) :
 
     def OrderForPrint(self)->'Order':
         """
-    <summary>
-        The order of Print.
-    </summary>
+        Gets or sets the printing order (horizontal/vertical).
+
+        Returns:
+            Order: Enumeration value representing print order
         """
         GetDllLibPpt().Presentation_get_OrderForPrint.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_OrderForPrint.restype=c_int
@@ -1188,9 +1269,9 @@ class Presentation (_Presentation) :
     @property
     def SlideFrameForPrint(self)->bool:
         """
-    <summary>
-        Whether to set slideFrame for printing.
-    </summary>
+        Gets or sets whether to print slide frames.
+
+        When True, a border will be printed around each slide.
         """
         GetDllLibPpt().Presentation_get_SlideFrameForPrint.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_SlideFrameForPrint.restype=c_bool
@@ -1205,9 +1286,9 @@ class Presentation (_Presentation) :
     @property
     def GrayLevelForPrint(self)->bool:
         """
-    <summary>
-        Whether to set gray level for printing
-    </summary>
+        Gets or sets whether to print in grayscale.
+
+        When True, printed output will be in grayscale.
         """
         GetDllLibPpt().Presentation_get_GrayLevelForPrint.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_GrayLevelForPrint.restype=c_bool
@@ -1221,6 +1302,11 @@ class Presentation (_Presentation) :
 
     @property
     def IsNoteRetained(self)->bool:
+        """
+        Gets or sets whether speaker notes are retained.
+
+        When True, speaker notes will be preserved during operations.
+        """
         GetDllLibPpt().Presentation_get_IsNoteRetained.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_get_IsNoteRetained.restype=c_bool
         ret = CallCFunction(GetDllLibPpt().Presentation_get_IsNoteRetained,self.Ptr)
@@ -1235,9 +1321,13 @@ class Presentation (_Presentation) :
 
     def AddEmbeddedFont(self,pathName:str)->str:
         """
-    <summary>
-        
-    </summary>
+        Embeds a font file into the presentation.
+
+        Args:
+            pathName: Path to the font file
+
+        Returns:
+            str: Identifier for the embedded font
         """
         pathNamePtr = StrToPtr(pathName)
         GetDllLibPpt().Presentation_AddEmbeddedFont.argtypes=[c_void_p,c_char_p]
@@ -1249,7 +1339,10 @@ class Presentation (_Presentation) :
     @staticmethod
     def SetDefaultFontName(value:str):
         """
+        Sets the default font name for new presentations.
 
+        Args:
+            value: Font name to use as default
         """
         valuePtr = StrToPtr(value)
         GetDllLibPpt().Presentation_set_DefaultFontName.argtypes=[c_char_p]
@@ -1259,7 +1352,7 @@ class Presentation (_Presentation) :
     @staticmethod   
     def ResetDefaultFontName():
         """
-
+        Resets the default font name to system default.
         """
         GetDllLibPpt().Presentation_Reset_DefaultFontName.argtypes=[c_void_p]
         GetDllLibPpt().Presentation_Reset_DefaultFontName.restype=c_void_p
@@ -1268,7 +1361,10 @@ class Presentation (_Presentation) :
     @staticmethod
     def SetCustomFontsDirctory(value:str):
         """
+        Sets the directory for custom fonts.
 
+        Args:
+            value: Path to directory containing custom fonts
         """
         valuePtr = StrToPtr(value)
         GetDllLibPpt().Presentation_set_CustomFontsDirctory.argtypes=[c_char_p]
@@ -1278,7 +1374,12 @@ class Presentation (_Presentation) :
 
     def ReplaceAndFormatText(self,value1:str,value2:str,format:DefaultTextRangeProperties):
         """
+        Replaces text and applies formatting.
 
+        Args:
+            value1: Text to find
+            value2: Replacement text
+            format: Formatting to apply to the replacement text
         """
         value1Ptr = StrToPtr(value1)
         value2Ptr = StrToPtr(value2)