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

spire/presentation/ICommentAuthor.py

@@ -8,13 +8,13 @@ import abc
 
 class ICommentAuthor (SpireObject) :
     """
-
+    Represents an author of comments in a presentation.
     """
     @property
 
     def Initials(self)->str:
         """
-
+        Gets or sets the author's initials.
         """
         GetDllLibPpt().ICommentAuthor_get_Initials.argtypes=[c_void_p]
         GetDllLibPpt().ICommentAuthor_get_Initials.restype=c_void_p
@@ -24,6 +24,12 @@ class ICommentAuthor (SpireObject) :
 
     @Initials.setter
     def Initials(self, value:str):
+        """
+        Sets the author's initials.
+
+        Args:
+            value: The initials string to set.
+        """
         valuePtr = StrToPtr(value)
         GetDllLibPpt().ICommentAuthor_set_Initials.argtypes=[c_void_p, c_char_p]
         CallCFunction(GetDllLibPpt().ICommentAuthor_set_Initials,self.Ptr,valuePtr)
@@ -32,7 +38,7 @@ class ICommentAuthor (SpireObject) :
 
     def Name(self)->str:
         """
-
+        Gets or sets the author's name.
         """
         GetDllLibPpt().ICommentAuthor_get_Name.argtypes=[c_void_p]
         GetDllLibPpt().ICommentAuthor_get_Name.restype=c_void_p
@@ -42,6 +48,12 @@ class ICommentAuthor (SpireObject) :
 
     @Name.setter
     def Name(self, value:str):
+        """
+        Sets the author's name.
+
+        Args:
+            value: The name string to set.
+        """
         valuePtr = StrToPtr(value)
         GetDllLibPpt().ICommentAuthor_set_Name.argtypes=[c_void_p, c_char_p]
         CallCFunction(GetDllLibPpt().ICommentAuthor_set_Name,self.Ptr,valuePtr)
@@ -50,7 +62,7 @@ class ICommentAuthor (SpireObject) :
 
     def CommentsList(self)->'CommentCollection':
         """
-
+        Gets the collection of comments by this author (read-only).
         """
         GetDllLibPpt().ICommentAuthor_get_CommentsList.argtypes=[c_void_p]
         GetDllLibPpt().ICommentAuthor_get_CommentsList.restype=c_void_p
@@ -62,7 +74,7 @@ class ICommentAuthor (SpireObject) :
     @property
     def LastIndex(self)->int:
         """
-
+        Gets the last index used by this author (read-only).
         """
         GetDllLibPpt().ICommentAuthor_get_LastIndex.argtypes=[c_void_p]
         GetDllLibPpt().ICommentAuthor_get_LastIndex.restype=c_int
@@ -72,7 +84,7 @@ class ICommentAuthor (SpireObject) :
     @property
     def ColorIndex(self)->int:
         """
-
+        Gets the author's color index (read-only).
         """
         GetDllLibPpt().ICommentAuthor_get_ColorIndex.argtypes=[c_void_p]
         GetDllLibPpt().ICommentAuthor_get_ColorIndex.restype=c_int
@@ -83,7 +95,7 @@ class ICommentAuthor (SpireObject) :
 
     def Id(self)->'UInt32':
         """
-
+        Gets the author's unique ID (read-only).
         """
         GetDllLibPpt().ICommentAuthor_get_Id.argtypes=[c_void_p]
         GetDllLibPpt().ICommentAuthor_get_Id.restype=c_void_p
@@ -96,7 +108,7 @@ class ICommentAuthor (SpireObject) :
 
     def ExtensionList(self)->'ExtensionList':
         """
-
+        Gets the extension list for the author (read-only).
         """
         GetDllLibPpt().ICommentAuthor_get_ExtensionList.argtypes=[c_void_p]
         GetDllLibPpt().ICommentAuthor_get_ExtensionList.restype=c_void_p

spire/presentation/IDigitalSignature.py

@@ -8,39 +8,16 @@ import abc
 
 class IDigitalSignature (SpireObject) :
     """
-    <summary>
-        Represents a DigitalSignature in Presentation.
-    </summary>
+    Represents a digital signature in a presentation document.
     """
-#    @property
-#
-#    def Certificate(self)->'X509Certificate2':
-#        """
-#    <summary>
-#        Certificate object that was used to sign.
-#    </summary>
-#        """
-#        GetDllLibPpt().IDigitalSignature_get_Certificate.argtypes=[c_void_p]
-#        GetDllLibPpt().IDigitalSignature_get_Certificate.restype=c_void_p
-#        intPtr = CallCFunction(GetDllLibPpt().IDigitalSignature_get_Certificate,self.Ptr)
-#        ret = None if intPtr==None else X509Certificate2(intPtr)
-#        return ret
-#
-
-
-#    @Certificate.setter
-#    def Certificate(self, value:'X509Certificate2'):
-#        GetDllLibPpt().IDigitalSignature_set_Certificate.argtypes=[c_void_p, c_void_p]
-#        CallCFunction(GetDllLibPpt().IDigitalSignature_set_Certificate,self.Ptr, value.Ptr)
-
-
     @property
 
     def Comments(self)->str:
         """
-    <summary>
-        Signature Comments.
-    </summary>
+        Gets or sets comments associated with the digital signature.
+        
+        Returns:
+            str: The comments text associated with the signature.
         """
         GetDllLibPpt().IDigitalSignature_get_Comments.argtypes=[c_void_p]
         GetDllLibPpt().IDigitalSignature_get_Comments.restype=c_void_p
@@ -58,9 +35,10 @@ class IDigitalSignature (SpireObject) :
 
     def SignTime(self)->'DateTime':
         """
-    <summary>
-        Sign Time.
-    </summary>
+        Gets or sets the date and time when the document was signed.
+        
+        Returns:
+            DateTime: The timestamp of the digital signature.
         """
         GetDllLibPpt().IDigitalSignature_get_SignTime.argtypes=[c_void_p]
         GetDllLibPpt().IDigitalSignature_get_SignTime.restype=c_void_p
@@ -77,9 +55,10 @@ class IDigitalSignature (SpireObject) :
     @property
     def IsValid(self)->bool:
         """
-    <summary>
-        Indicates whether this digital signature is valid.
-    </summary>
+        Indicates whether this digital signature is cryptographically valid.
+        
+        Returns:
+            bool: True if the signature is valid, False if invalid or compromised.
         """
         GetDllLibPpt().IDigitalSignature_get_IsValid.argtypes=[c_void_p]
         GetDllLibPpt().IDigitalSignature_get_IsValid.restype=c_bool

spire/presentation/IDigitalSignatures.py

@@ -8,9 +8,8 @@ import abc
 
 class IDigitalSignatures (  IEnumerable) :
     """
-    <summary>
-        Represents a Collection of DigitalSignature in Presentation.
-    </summary>
+    Represents a Collection of DigitalSignature in Presentation.
+   
     """
 #
 #    def Add(self ,certificate:'X509Certificate2',comments:str,signTime:'DateTime')->'IDigitalSignature':

spire/presentation/IDocumentProperty.py

@@ -8,16 +8,14 @@ import abc
 
 class IDocumentProperty (SpireObject) :
     """
-
+    Manages built-in and custom document properties/metadata for presentations.
     """
     @property
 
     def Application(self)->str:
         """
-    <summary>
         Gets or sets the name of the application.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+           
         """
         GetDllLibPpt().IDocumentProperty_get_Application.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_Application.restype=c_void_p
@@ -36,10 +34,8 @@ class IDocumentProperty (SpireObject) :
 
     def MarkAsFinal(self)->bool:
         """
-    <summary>
         Gets or sets the name of the application.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+            
         """
         GetDllLibPpt().IDocumentProperty_IsMarkAsFinal.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_IsMarkAsFinal.restype= c_bool
@@ -57,10 +53,8 @@ class IDocumentProperty (SpireObject) :
 
     def Company(self)->str:
         """
-    <summary>
         Gets or sets the company property.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+           
         """
         GetDllLibPpt().IDocumentProperty_get_Company.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_Company.restype=c_void_p
@@ -78,10 +72,8 @@ class IDocumentProperty (SpireObject) :
 
     def Manager(self)->str:
         """
-    <summary>
         Gets or sets the manager property.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+           
         """
         GetDllLibPpt().IDocumentProperty_get_Manager.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_Manager.restype=c_void_p
@@ -99,10 +91,8 @@ class IDocumentProperty (SpireObject) :
 
     def Format(self)->str:
         """
-    <summary>
         Gets or sets the intended format of a presentation.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+           
         """
         GetDllLibPpt().IDocumentProperty_get_Format.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_Format.restype=c_void_p
@@ -119,10 +109,8 @@ class IDocumentProperty (SpireObject) :
     @property
     def SharedDoc(self)->bool:
         """
-    <summary>
         Indicates whether the presentation is shared between multiple people.
-            Read/write <see cref="T:System.Boolean" />.
-    </summary>
+            
         """
         GetDllLibPpt().IDocumentProperty_get_SharedDoc.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_SharedDoc.restype=c_bool
@@ -138,10 +126,8 @@ class IDocumentProperty (SpireObject) :
 
     def Template(self)->str:
         """
-    <summary>
         Gets or sets the template of a application.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+            
         """
         GetDllLibPpt().IDocumentProperty_get_Template.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_Template.restype=c_void_p
@@ -159,10 +145,8 @@ class IDocumentProperty (SpireObject) :
 
     def TotalEditingTime(self)->'TimeSpan':
         """
-    <summary>
         Total editing time of a presentation.
-            Read/write <see cref="T:System.TimeSpan" />.
-    </summary>
+
         """
         GetDllLibPpt().IDocumentProperty_get_TotalEditingTime.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_TotalEditingTime.restype=c_void_p
@@ -180,10 +164,8 @@ class IDocumentProperty (SpireObject) :
 
     def Title(self)->str:
         """
-    <summary>
         Gets or sets the title of a presentation.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+           
         """
         GetDllLibPpt().IDocumentProperty_get_Title.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_Title.restype=c_void_p
@@ -201,10 +183,8 @@ class IDocumentProperty (SpireObject) :
 
     def Subject(self)->str:
         """
-    <summary>
         Gets or sets the subject of a presentation.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+           
         """
         GetDllLibPpt().IDocumentProperty_get_Subject.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_Subject.restype=c_void_p
@@ -222,10 +202,8 @@ class IDocumentProperty (SpireObject) :
 
     def Author(self)->str:
         """
-    <summary>
         Gets or sets the author of a presentation.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+           
         """
         GetDllLibPpt().IDocumentProperty_get_Author.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_Author.restype=c_void_p
@@ -243,10 +221,8 @@ class IDocumentProperty (SpireObject) :
 
     def Keywords(self)->str:
         """
-    <summary>
         Gets or sets the keywords of a presentation.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+
         """
         GetDllLibPpt().IDocumentProperty_get_Keywords.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_Keywords.restype=c_void_p
@@ -264,10 +240,8 @@ class IDocumentProperty (SpireObject) :
 
     def Comments(self)->str:
         """
-    <summary>
         Gets or sets the comments of a presentation.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+
         """
         GetDllLibPpt().IDocumentProperty_get_Comments.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_Comments.restype=c_void_p
@@ -285,10 +259,8 @@ class IDocumentProperty (SpireObject) :
 
     def Category(self)->str:
         """
-    <summary>
         Gets or sets the category of a presentation.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+
         """
         GetDllLibPpt().IDocumentProperty_get_Category.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_Category.restype=c_void_p
@@ -306,10 +278,8 @@ class IDocumentProperty (SpireObject) :
 
     def CreatedTime(self)->'DateTime':
         """
-    <summary>
         Gets or sets the date when a presentation was created.
-            Read/write <see cref="T:System.DateTime" />.
-    </summary>
+            
         """
         GetDllLibPpt().IDocumentProperty_get_CreatedTime.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_CreatedTime.restype=c_void_p
@@ -327,10 +297,8 @@ class IDocumentProperty (SpireObject) :
 
     def LastSavedTime(self)->'DateTime':
         """
-    <summary>
         Gets or sets the date when a presentation was modified last time.
-            Read/write <see cref="T:System.DateTime" />.
-    </summary>
+           
         """
         GetDllLibPpt().IDocumentProperty_get_LastSavedTime.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_LastSavedTime.restype=c_void_p
@@ -348,10 +316,8 @@ class IDocumentProperty (SpireObject) :
 
     def LastPrinted(self)->'DateTime':
         """
-    <summary>
         Gets or sets the date when a presentation was printed last time.
-            Read/write <see cref="T:System.DateTime" />.
-    </summary>
+
         """
         GetDllLibPpt().IDocumentProperty_get_LastPrinted.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_LastPrinted.restype=c_void_p
@@ -369,10 +335,8 @@ class IDocumentProperty (SpireObject) :
 
     def LastSavedBy(self)->str:
         """
-    <summary>
         Gets or sets the name of a last person who modified a presentation.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+           
         """
         GetDllLibPpt().IDocumentProperty_get_LastSavedBy.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_LastSavedBy.restype=c_void_p
@@ -389,10 +353,8 @@ class IDocumentProperty (SpireObject) :
     @property
     def RevisionNumber(self)->int:
         """
-    <summary>
         Gets or sets the presentation revision number.
-            Read/write <see cref="T:System.Int32" />.
-    </summary>
+           
         """
         GetDllLibPpt().IDocumentProperty_get_RevisionNumber.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_RevisionNumber.restype=c_int
@@ -408,10 +370,8 @@ class IDocumentProperty (SpireObject) :
 
     def ContentStatus(self)->str:
         """
-    <summary>
         Gets or sets the content status of a presentation.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+            
         """
         GetDllLibPpt().IDocumentProperty_get_ContentStatus.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_ContentStatus.restype=c_void_p
@@ -429,10 +389,8 @@ class IDocumentProperty (SpireObject) :
 
     def ContentType(self)->str:
         """
-    <summary>
         Gets or sets the content type of a presentation.
-            Read/write <see cref="T:System.String" />.
-    </summary>
+            
         """
         GetDllLibPpt().IDocumentProperty_get_ContentType.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_ContentType.restype=c_void_p
@@ -449,10 +407,8 @@ class IDocumentProperty (SpireObject) :
     @property
     def Count(self)->int:
         """
-    <summary>
         Gets the number of custom properties actually contained in a collection.
-            Read-only <see cref="T:System.Int32" />.
-    </summary>
+            
         """
         GetDllLibPpt().IDocumentProperty_get_Count.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_Count.restype=c_int
@@ -463,9 +419,8 @@ class IDocumentProperty (SpireObject) :
 
     def HyperlinkBase(self)->str:
         """
-    <summary>
         Gets or sets the HyperlinkBase document property.
-    </summary>
+   
         """
         GetDllLibPpt().IDocumentProperty_get_HyperlinkBase.argtypes=[c_void_p]
         GetDllLibPpt().IDocumentProperty_get_HyperlinkBase.restype=c_void_p
@@ -482,12 +437,11 @@ class IDocumentProperty (SpireObject) :
 
     def GetPropertyName(self ,index:int)->str:
         """
-    <summary>
         Return a custom property name at the specified index.
-    </summary>
-    <param name="index">The zero-based index of a custom property to get.</param>
-    <returns>Custom property name at the specified index.</returns>
-<exception cref="T:System.ArgumentOutOfRangeException">Index is less than zero. Index is equal to or greater than Count.</exception>
+        Args:
+            index:The zero-based index of a custom property to get.
+        returns:
+            Custom property name at the specified index.
         """
         
         GetDllLibPpt().IDocumentProperty_GetPropertyName.argtypes=[c_void_p ,c_int]
@@ -499,11 +453,11 @@ class IDocumentProperty (SpireObject) :
 
     def Remove(self ,name:str)->bool:
         """
-    <summary>
         Remove a custom property associated with a specified name.
-    </summary>
-    <param name="name">Name of a custom property to remove.</param>
-    <returns>Return true if a property was removed, false overwise.</returns>
+        Args:
+            name:Name of a custom property to remove.
+        returns:
+            Return true if a property was removed, false overwise.
         """
         
         namePtr = StrToPtr(name)
@@ -515,11 +469,11 @@ class IDocumentProperty (SpireObject) :
 
     def Contains(self ,name:str)->bool:
         """
-    <summary>
         Check presents of a custom property with a specified name.
-    </summary>
-    <param name="name">Name of a custom property to check.</param>
-    <returns>Return true if property exists, false overwise.</returns>
+        Args:
+            name:Name of a custom property to check.
+        returns:
+            Return true if property exists, false overwise.
         """
         
         namePtr = StrToPtr(name)
@@ -531,10 +485,8 @@ class IDocumentProperty (SpireObject) :
 
     def get_Item(self ,name:str)->'SpireObject':
         """
-    <summary>
         Gets or sets the custom property associated with a specified name.
-            Read/write <see cref="T:System.Object" />.
-    </summary>
+           
         """
         
         namePtr = StrToPtr(name)
@@ -548,7 +500,10 @@ class IDocumentProperty (SpireObject) :
 
     def set_Item(self ,name:str,value:'SpireObject'):
         """
-
+        Set the custom property.
+        Args:
+            name:Name of a custom property.
+            value:The value of custom property.
         """
         intPtrvalue:c_void_p = value.Ptr