spire-xls 15.5.0__py3-none-win_amd64.whl → 15.11.1__py3-none-win_amd64.whl

spire/xls/XlsValidation.py

@@ -6,15 +6,22 @@ from spire.xls import *
 from ctypes import *
 import abc
 
-class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICloneParent) :
-    """
-
+class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICloneParent,SpireObject) :
+    """Represents a data validation rule in an Excel worksheet.
+    
+    This class provides functionality for creating and managing data validation rules
+    that restrict the type of data or values users can enter into a cell or range.
+    It implements IDataValidation, IExcelApplication, IOptimizedUpdate, and ICloneParent interfaces.
     """
     @property
 
     def InputTitle(self)->str:
-        """
-
+        """Gets or sets the title of the input message box.
+        
+        The input message appears when a user selects a cell with data validation.
+        
+        Returns:
+            str: The title of the input message box.
         """
         GetDllLibXls().XlsValidation_get_InputTitle.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_InputTitle.restype=c_void_p
@@ -24,14 +31,23 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @InputTitle.setter
     def InputTitle(self, value:str):
+        """Sets the title of the input message box.
+        
+        Args:
+            value (str): The title text to display in the input message box.
+        """
         GetDllLibXls().XlsValidation_set_InputTitle.argtypes=[c_void_p, c_wchar_p]
         CallCFunction(GetDllLibXls().XlsValidation_set_InputTitle, self.Ptr, value)
 
     @property
 
     def InputMessage(self)->str:
-        """
-
+        """Gets or sets the message of the input message box.
+        
+        The input message appears when a user selects a cell with data validation.
+        
+        Returns:
+            str: The message content of the input message box.
         """
         GetDllLibXls().XlsValidation_get_InputMessage.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_InputMessage.restype=c_void_p
@@ -41,14 +57,23 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @InputMessage.setter
     def InputMessage(self, value:str):
+        """Sets the message of the input message box.
+        
+        Args:
+            value (str): The message text to display in the input message box.
+        """
         GetDllLibXls().XlsValidation_set_InputMessage.argtypes=[c_void_p, c_wchar_p]
         CallCFunction(GetDllLibXls().XlsValidation_set_InputMessage, self.Ptr, value)
 
     @property
 
     def ErrorTitle(self)->str:
-        """
-
+        """Gets or sets the title of the error message box.
+        
+        The error message appears when a user enters invalid data in a cell with validation.
+        
+        Returns:
+            str: The title of the error message box.
         """
         GetDllLibXls().XlsValidation_get_ErrorTitle.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_ErrorTitle.restype=c_void_p
@@ -58,14 +83,23 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @ErrorTitle.setter
     def ErrorTitle(self, value:str):
+        """Sets the title of the error message box.
+        
+        Args:
+            value (str): The title text to display in the error message box.
+        """
         GetDllLibXls().XlsValidation_set_ErrorTitle.argtypes=[c_void_p, c_wchar_p]
         CallCFunction(GetDllLibXls().XlsValidation_set_ErrorTitle, self.Ptr, value)
 
     @property
 
     def ErrorMessage(self)->str:
-        """
-
+        """Gets or sets the message of the error message box.
+        
+        The error message appears when a user enters invalid data in a cell with validation.
+        
+        Returns:
+            str: The message content of the error message box.
         """
         GetDllLibXls().XlsValidation_get_ErrorMessage.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_ErrorMessage.restype=c_void_p
@@ -75,14 +109,24 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @ErrorMessage.setter
     def ErrorMessage(self, value:str):
+        """Sets the message of the error message box.
+        
+        Args:
+            value (str): The message text to display in the error message box.
+        """
         GetDllLibXls().XlsValidation_set_ErrorMessage.argtypes=[c_void_p, c_wchar_p]
         CallCFunction(GetDllLibXls().XlsValidation_set_ErrorMessage, self.Ptr, value)
 
     @property
 
     def Formula1(self)->str:
-        """
-
+        """Gets or sets the first formula or value for the data validation.
+        
+        For most validation types, this property sets the minimum value or the only value
+        used for validation.
+        
+        Returns:
+            str: The first formula or value for validation.
         """
         GetDllLibXls().XlsValidation_get_Formula1.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_Formula1.restype=c_void_p
@@ -92,14 +136,23 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @Formula1.setter
     def Formula1(self, value:str):
+        """Sets the first formula or value for the data validation.
+        
+        Args:
+            value (str): The first formula or value for validation.
+        """
         GetDllLibXls().XlsValidation_set_Formula1.argtypes=[c_void_p, c_wchar_p]
         CallCFunction(GetDllLibXls().XlsValidation_set_Formula1, self.Ptr, value)
 
     @property
 
     def DateTime1(self)->'DateTime':
-        """
-
+        """Gets or sets the first date/time value for the data validation.
+        
+        Used when validating date or time values, typically as the minimum value.
+        
+        Returns:
+            DateTime: The first date/time value for validation.
         """
         GetDllLibXls().XlsValidation_get_DateTime1.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_DateTime1.restype=c_void_p
@@ -110,14 +163,24 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @DateTime1.setter
     def DateTime1(self, value:'DateTime'):
+        """Sets the first date/time value for the data validation.
+        
+        Args:
+            value (DateTime): The first date/time value for validation.
+        """
         GetDllLibXls().XlsValidation_set_DateTime1.argtypes=[c_void_p, c_void_p]
         CallCFunction(GetDllLibXls().XlsValidation_set_DateTime1, self.Ptr, value.Ptr)
 
     @property
 
     def Formula2(self)->str:
-        """
-
+        """Gets or sets the second formula or value for the data validation.
+        
+        For validation types that require a range (like between or not between),
+        this property sets the maximum value.
+        
+        Returns:
+            str: The second formula or value for validation.
         """
         GetDllLibXls().XlsValidation_get_Formula2.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_Formula2.restype=c_void_p
@@ -127,14 +190,23 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @Formula2.setter
     def Formula2(self, value:str):
+        """Sets the second formula or value for the data validation.
+        
+        Args:
+            value (str): The second formula or value for validation.
+        """
         GetDllLibXls().XlsValidation_set_Formula2.argtypes=[c_void_p, c_wchar_p]
         CallCFunction(GetDllLibXls().XlsValidation_set_Formula2, self.Ptr, value)
 
     @property
 
     def DateTime2(self)->'DateTime':
-        """
-
+        """Gets or sets the second date/time value for the data validation.
+        
+        Used when validating date or time values with a range, typically as the maximum value.
+        
+        Returns:
+            DateTime: The second date/time value for validation.
         """
         GetDllLibXls().XlsValidation_get_DateTime2.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_DateTime2.restype=c_void_p
@@ -145,14 +217,23 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @DateTime2.setter
     def DateTime2(self, value:'DateTime'):
+        """Sets the second date/time value for the data validation.
+        
+        Args:
+            value (DateTime): The second date/time value for validation.
+        """
         GetDllLibXls().XlsValidation_set_DateTime2.argtypes=[c_void_p, c_void_p]
         CallCFunction(GetDllLibXls().XlsValidation_set_DateTime2, self.Ptr, value.Ptr)
 
     @property
 
     def AllowType(self)->'CellDataType':
-        """
-
+        """Gets or sets the data type allowed in the cell or range.
+        
+        This property determines what type of data is valid for the cells with validation.
+        
+        Returns:
+            CellDataType: The data type allowed for validation.
         """
         GetDllLibXls().XlsValidation_get_AllowType.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_AllowType.restype=c_int
@@ -162,14 +243,23 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @AllowType.setter
     def AllowType(self, value:'CellDataType'):
+        """Sets the data type allowed in the cell or range.
+        
+        Args:
+            value (CellDataType): The data type to allow for validation.
+        """
         GetDllLibXls().XlsValidation_set_AllowType.argtypes=[c_void_p, c_int]
         CallCFunction(GetDllLibXls().XlsValidation_set_AllowType, self.Ptr, value.value)
 
     @property
 
     def CompareOperator(self)->'ValidationComparisonOperator':
-        """
-
+        """Gets or sets the comparison operator for the data validation.
+        
+        This property determines how the cell's value is compared against the validation criteria.
+        
+        Returns:
+            ValidationComparisonOperator: The comparison operator for validation.
         """
         GetDllLibXls().XlsValidation_get_CompareOperator.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_CompareOperator.restype=c_int
@@ -179,13 +269,23 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @CompareOperator.setter
     def CompareOperator(self, value:'ValidationComparisonOperator'):
+        """Sets the comparison operator for the data validation.
+        
+        Args:
+            value (ValidationComparisonOperator): The comparison operator to use for validation.
+        """
         GetDllLibXls().XlsValidation_set_CompareOperator.argtypes=[c_void_p, c_int]
         CallCFunction(GetDllLibXls().XlsValidation_set_CompareOperator, self.Ptr, value.value)
 
     @property
     def IsListInFormula(self)->bool:
-        """
-
+        """Gets or sets whether the validation list is in a formula.
+        
+        When True, the Formula1 property contains a formula that evaluates to a list.
+        When False, Formula1 contains a comma-separated list of values.
+        
+        Returns:
+            bool: True if the validation list is in a formula; otherwise, False.
         """
         GetDllLibXls().XlsValidation_get_IsListInFormula.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_IsListInFormula.restype=c_bool
@@ -194,13 +294,22 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @IsListInFormula.setter
     def IsListInFormula(self, value:bool):
+        """Sets whether the validation list is in a formula.
+        
+        Args:
+            value (bool): True to indicate the validation list is in a formula; otherwise, False.
+        """
         GetDllLibXls().XlsValidation_set_IsListInFormula.argtypes=[c_void_p, c_bool]
         CallCFunction(GetDllLibXls().XlsValidation_set_IsListInFormula, self.Ptr, value)
 
     @property
     def IgnoreBlank(self)->bool:
-        """
-
+        """Gets or sets whether blank values are allowed in the validated range.
+        
+        When True, empty cells are considered valid regardless of the validation criteria.
+        
+        Returns:
+            bool: True if blank values are allowed; otherwise, False.
         """
         GetDllLibXls().XlsValidation_get_IgnoreBlank.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_IgnoreBlank.restype=c_bool
@@ -209,13 +318,22 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @IgnoreBlank.setter
     def IgnoreBlank(self, value:bool):
+        """Sets whether blank values are allowed in the validated range.
+        
+        Args:
+            value (bool): True to allow blank values; otherwise, False.
+        """
         GetDllLibXls().XlsValidation_set_IgnoreBlank.argtypes=[c_void_p, c_bool]
         CallCFunction(GetDllLibXls().XlsValidation_set_IgnoreBlank, self.Ptr, value)
 
     @property
     def IsSuppressDropDownArrow(self)->bool:
-        """
-
+        """Gets or sets whether to suppress the dropdown arrow for list validation.
+        
+        When True, the dropdown arrow for list-type validation is not displayed.
+        
+        Returns:
+            bool: True if the dropdown arrow is suppressed; otherwise, False.
         """
         GetDllLibXls().XlsValidation_get_IsSuppressDropDownArrow.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_IsSuppressDropDownArrow.restype=c_bool
@@ -224,13 +342,20 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @IsSuppressDropDownArrow.setter
     def IsSuppressDropDownArrow(self, value:bool):
+        """Sets whether to suppress the dropdown arrow for list validation.
+        
+        Args:
+            value (bool): True to suppress the dropdown arrow; otherwise, False.
+        """
         GetDllLibXls().XlsValidation_set_IsSuppressDropDownArrow.argtypes=[c_void_p, c_bool]
         CallCFunction(GetDllLibXls().XlsValidation_set_IsSuppressDropDownArrow, self.Ptr, value)
 
     @property
     def ShapesCount(self)->int:
-        """
-
+        """Gets the count of shapes associated with this validation.
+        
+        Returns:
+            int: The number of shapes associated with this validation.
         """
         GetDllLibXls().XlsValidation_get_ShapesCount.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_ShapesCount.restype=c_int
@@ -239,8 +364,13 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @property
     def ShowInput(self)->bool:
-        """
-
+        """Gets or sets whether to display the input message when a cell is selected.
+        
+        When True, the input message (specified by InputTitle and InputMessage) is displayed
+        when the user selects a cell with this validation.
+        
+        Returns:
+            bool: True if the input message is displayed; otherwise, False.
         """
         GetDllLibXls().XlsValidation_get_ShowInput.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_ShowInput.restype=c_bool
@@ -249,13 +379,23 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @ShowInput.setter
     def ShowInput(self, value:bool):
+        """Sets whether to display the input message when a cell is selected.
+        
+        Args:
+            value (bool): True to display the input message; otherwise, False.
+        """
         GetDllLibXls().XlsValidation_set_ShowInput.argtypes=[c_void_p, c_bool]
         CallCFunction(GetDllLibXls().XlsValidation_set_ShowInput, self.Ptr, value)
 
     @property
     def ShowError(self)->bool:
-        """
-
+        """Gets or sets whether to display an error message when invalid data is entered.
+        
+        When True, the error message (specified by ErrorTitle and ErrorMessage) is displayed
+        when the user enters invalid data in a cell with this validation.
+        
+        Returns:
+            bool: True if the error message is displayed; otherwise, False.
         """
         GetDllLibXls().XlsValidation_get_ShowError.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_ShowError.restype=c_bool
@@ -264,13 +404,22 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @ShowError.setter
     def ShowError(self, value:bool):
+        """Sets whether to display an error message when invalid data is entered.
+        
+        Args:
+            value (bool): True to display the error message; otherwise, False.
+        """
         GetDllLibXls().XlsValidation_set_ShowError.argtypes=[c_void_p, c_bool]
         CallCFunction(GetDllLibXls().XlsValidation_set_ShowError, self.Ptr, value)
 
     @property
     def PromptBoxHPosition(self)->int:
-        """
-
+        """Gets or sets the horizontal position of the input message box.
+        
+        Specifies the horizontal offset in pixels for the input message box.
+        
+        Returns:
+            int: The horizontal position in pixels.
         """
         GetDllLibXls().XlsValidation_get_PromptBoxHPosition.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_PromptBoxHPosition.restype=c_int
@@ -279,13 +428,22 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @PromptBoxHPosition.setter
     def PromptBoxHPosition(self, value:int):
+        """Sets the horizontal position of the input message box.
+        
+        Args:
+            value (int): The horizontal position in pixels.
+        """
         GetDllLibXls().XlsValidation_set_PromptBoxHPosition.argtypes=[c_void_p, c_int]
         CallCFunction(GetDllLibXls().XlsValidation_set_PromptBoxHPosition, self.Ptr, value)
 
     @property
     def PromptBoxVPosition(self)->int:
-        """
-
+        """Gets or sets the vertical position of the input message box.
+        
+        Specifies the vertical offset in pixels for the input message box.
+        
+        Returns:
+            int: The vertical position in pixels.
         """
         GetDllLibXls().XlsValidation_get_PromptBoxVPosition.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_PromptBoxVPosition.restype=c_int
@@ -294,13 +452,22 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @PromptBoxVPosition.setter
     def PromptBoxVPosition(self, value:int):
+        """Sets the vertical position of the input message box.
+        
+        Args:
+            value (int): The vertical position in pixels.
+        """
         GetDllLibXls().XlsValidation_set_PromptBoxVPosition.argtypes=[c_void_p, c_int]
         CallCFunction(GetDllLibXls().XlsValidation_set_PromptBoxVPosition, self.Ptr, value)
 
     @property
     def IsInputVisible(self)->bool:
-        """
-
+        """Gets or sets whether the input message box is visible.
+        
+        Controls the visibility of the input message box independently of ShowInput.
+        
+        Returns:
+            bool: True if the input message box is visible; otherwise, False.
         """
         GetDllLibXls().XlsValidation_get_IsInputVisible.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_IsInputVisible.restype=c_bool
@@ -309,13 +476,24 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @IsInputVisible.setter
     def IsInputVisible(self, value:bool):
+        """Sets whether the input message box is visible.
+        
+        Args:
+            value (bool): True to make the input message box visible; otherwise, False.
+        """
         GetDllLibXls().XlsValidation_set_IsInputVisible.argtypes=[c_void_p, c_bool]
         CallCFunction(GetDllLibXls().XlsValidation_set_IsInputVisible, self.Ptr, value)
 
     @property
     def IsInputPositionFixed(self)->bool:
-        """
-
+        """Gets or sets whether the input message box position is fixed.
+        
+        When True, the input message box appears at the position specified by
+        PromptBoxHPosition and PromptBoxVPosition. When False, the position is
+        determined automatically.
+        
+        Returns:
+            bool: True if the input message box position is fixed; otherwise, False.
         """
         GetDllLibXls().XlsValidation_get_IsInputPositionFixed.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_IsInputPositionFixed.restype=c_bool
@@ -324,14 +502,24 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @IsInputPositionFixed.setter
     def IsInputPositionFixed(self, value:bool):
+        """Sets whether the input message box position is fixed.
+        
+        Args:
+            value (bool): True to fix the input message box position; otherwise, False.
+        """
         GetDllLibXls().XlsValidation_set_IsInputPositionFixed.argtypes=[c_void_p, c_bool]
         CallCFunction(GetDllLibXls().XlsValidation_set_IsInputPositionFixed, self.Ptr, value)
 
     @property
 
     def AlertStyle(self)->'AlertStyleType':
-        """
-
+        """Gets or sets the style of the error alert.
+        
+        Determines the icon and buttons displayed in the error message box
+        when invalid data is entered.
+        
+        Returns:
+            AlertStyleType: The style of the error alert.
         """
         GetDllLibXls().XlsValidation_get_AlertStyle.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_AlertStyle.restype=c_int
@@ -341,23 +529,38 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @AlertStyle.setter
     def AlertStyle(self, value:'AlertStyleType'):
+        """Sets the style of the error alert.
+        
+        Args:
+            value (AlertStyleType): The style of the error alert to use.
+        """
         GetDllLibXls().XlsValidation_set_AlertStyle.argtypes=[c_void_p, c_int]
         CallCFunction(GetDllLibXls().XlsValidation_set_AlertStyle, self.Ptr, value.value)
 
     @property
 
     def Values(self)->List[str]:
-        """
-
+        """Gets or sets the list of valid values for list-type validation.
+        
+        For list-type validation, this property contains the list of values
+        that are considered valid.
+        
+        Returns:
+            List[str]: The list of valid values.
         """
         GetDllLibXls().XlsValidation_get_Values.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_Values.restype=IntPtrArray
         intPtrArray = CallCFunction(GetDllLibXls().XlsValidation_get_Values, self.Ptr)
-        ret = GetVectorFromArray(intPtrArray, c_wchar_p)
+        ret = GetStrVectorFromArray(intPtrArray, c_wchar_p)
         return ret
 
     @Values.setter
     def Values(self, value:List[str]):
+        """Sets the list of valid values for list-type validation.
+        
+        Args:
+            value (List[str]): The list of valid values.
+        """
         vCount = len(value)
         ArrayType = c_wchar_p * vCount
         vArray = ArrayType()
@@ -369,8 +572,12 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
     @property
 
     def DataRange(self)->'IXLSRange':
-        """
-
+        """Gets or sets the cell range to which the data validation applies.
+        
+        This property specifies the range of cells that will have this validation rule applied.
+        
+        Returns:
+            IXLSRange: The cell range with this validation rule.
         """
         GetDllLibXls().XlsValidation_get_DataRange.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_DataRange.restype=c_void_p
@@ -381,14 +588,24 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @DataRange.setter
     def DataRange(self, value:'IXLSRange'):
+        """Sets the cell range to which the data validation applies.
+        
+        Args:
+            value (IXLSRange): The cell range to apply this validation rule to.
+        """
         GetDllLibXls().XlsValidation_set_DataRange.argtypes=[c_void_p, c_void_p]
         CallCFunction(GetDllLibXls().XlsValidation_set_DataRange, self.Ptr, value.Ptr)
 
     @dispatch
 
     def AddRange(self ,dv:'XlsValidation'):
-        """
-
+        """Adds the range from another validation object to this validation.
+        
+        This method combines the range of cells from another validation object
+        with the range of cells in this validation.
+        
+        Args:
+            dv (XlsValidation): The validation object whose range to add.
         """
         intPtrdv:c_void_p = dv.Ptr
 
@@ -398,8 +615,12 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
     @dispatch
 
     def AddRange(self ,range:XlsRange):
-        """
-
+        """Adds a range of cells to this validation.
+        
+        This method extends the validation rule to apply to the specified range of cells.
+        
+        Args:
+            range (XlsRange): The range of cells to add to this validation.
         """
         intPtrrange:c_void_p = range.Ptr
 
@@ -427,8 +648,12 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
     @dispatch
 
     def RemoveRange(self ,range:XlsRange):
-        """
-
+        """Removes a range of cells from this validation.
+        
+        This method excludes the specified range of cells from this validation rule.
+        
+        Args:
+            range (XlsRange): The range of cells to remove from this validation.
         """
         intPtrrange:c_void_p = range.Ptr
 
@@ -438,9 +663,12 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
     @property
 
     def Worksheet(self)->'XlsWorksheet':
+        """Gets the worksheet that contains this validation rule.
+        
+        Returns:
+            XlsWorksheet: The worksheet containing this validation rule.
         """
-
-        """
+        from spire.xls.XlsWorksheet import XlsWorksheet
         GetDllLibXls().XlsValidation_get_Worksheet.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_Worksheet.restype=c_void_p
         intPtr = CallCFunction(GetDllLibXls().XlsValidation_get_Worksheet, self.Ptr)
@@ -450,8 +678,13 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
 
     def ContainsCell(self ,lCellIndex:int)->bool:
-        """
-
+        """Determines whether the validation rule applies to a specific cell.
+        
+        Args:
+            lCellIndex (int): The index of the cell to check.
+            
+        Returns:
+            bool: True if the validation rule applies to the specified cell; otherwise, False.
         """
         
         GetDllLibXls().XlsValidation_ContainsCell.argtypes=[c_void_p ,c_long]
@@ -461,37 +694,48 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
 
     def Clone(self ,parent:'SpireObject')->'SpireObject':
-        """
-
+        """Creates a copy of this validation rule with the specified parent object.
+        
+        Args:
+            parent (SpireObject): The parent object for the cloned validation rule.
+            
+        Returns:
+            SpireObject: The cloned validation rule.
         """
         intPtrparent:c_void_p = parent.Ptr
 
         GetDllLibXls().XlsValidation_Clone.argtypes=[c_void_p ,c_void_p]
         GetDllLibXls().XlsValidation_Clone.restype=c_void_p
         intPtr = CallCFunction(GetDllLibXls().XlsValidation_Clone, self.Ptr, intPtrparent)
-        ret = None if intPtr==None else SpireObject(intPtr)
+        ret = None if intPtr==None else XlsValidation(intPtr)
         return ret
 
 
     @property
 
     def Parent(self)->'SpireObject':
+        """Gets the parent object of this validation rule.
+        
+        Returns:
+            SpireObject: The parent object of this validation rule.
         """
-
-        """
+        from spire.xls.collection.XlsDataValidationCollection import XlsDataValidationCollection
         GetDllLibXls().XlsValidation_get_Parent.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_Parent.restype=c_void_p
         intPtr = CallCFunction(GetDllLibXls().XlsValidation_get_Parent, self.Ptr)
-        ret = None if intPtr==None else SpireObject(intPtr)
+        ret = None if intPtr==None else XlsDataValidationCollection(intPtr)
         return ret
 
 
     @property
 
     def ParentCollection(self)->'XlsDataValidationCollection':
+        """Gets or sets the collection that contains this validation rule.
+        
+        Returns:
+            XlsDataValidationCollection: The collection containing this validation rule.
         """
-
-        """
+        from spire.xls.collection.XlsDataValidationCollection import XlsDataValidationCollection
         GetDllLibXls().XlsValidation_get_ParentCollection.argtypes=[c_void_p]
         GetDllLibXls().XlsValidation_get_ParentCollection.restype=c_void_p
         intPtr = CallCFunction(GetDllLibXls().XlsValidation_get_ParentCollection, self.Ptr)
@@ -501,19 +745,28 @@ class XlsValidation (  IDataValidation, IExcelApplication, IOptimizedUpdate, ICl
 
     @ParentCollection.setter
     def ParentCollection(self, value:'XlsDataValidationCollection'):
+        """Sets the collection that contains this validation rule.
+        
+        Args:
+            value (XlsDataValidationCollection): The collection to contain this validation rule.
+        """
         GetDllLibXls().XlsValidation_set_ParentCollection.argtypes=[c_void_p, c_void_p]
         CallCFunction(GetDllLibXls().XlsValidation_set_ParentCollection, self.Ptr, value.Ptr)
 
     def BeginUpdate(self):
-        """
-
+        """Begins a batch update operation on the validation rule.
+        
+        Call this method before making multiple changes to the validation rule
+        to improve performance. Call EndUpdate when finished.
         """
         GetDllLibXls().XlsValidation_BeginUpdate.argtypes=[c_void_p]
         CallCFunction(GetDllLibXls().XlsValidation_BeginUpdate, self.Ptr)
 
     def EndUpdate(self):
-        """
-
+        """Ends a batch update operation on the validation rule.
+        
+        Call this method after calling BeginUpdate and making multiple changes
+        to the validation rule.
         """
         GetDllLibXls().XlsValidation_EndUpdate.argtypes=[c_void_p]
         CallCFunction(GetDllLibXls().XlsValidation_EndUpdate, self.Ptr)