WPS 表格 API 参考 Protection 对象

jetsung

WPS 表格 API 参考 Protection 对象

Protection 对象

代表工作表可使用的各种保护选项类型。

说明

使用 Worksheet 对象的 Protection 属性可返回一个 Protection 对象。
返回一个 Protection 对象后，就可用该对象的下列属性来设置或返回保护选项。

AllowDeletingColumns
AllowDeletingRows
AllowFiltering
AllowFormattingCells
AllowFormattingColumns
AllowFormattingRows
AllowInsertingColumns
AllowInsertingHyperlinks
AllowInsertingRows
AllowSorting
AllowUsingPivotTables

下例通过在最上面的行中放三个成员并保留该工作表说明了如何使用 Protection 对象的 AllowInserting.Columns 属性。
然后，此示例检查插入列的保护设置是否是 False，如果必要，则将其设置为 True。最后，通知用户插入一个列。

示例

function SetProtection(){
    Range("A1").Formula = "1"
    Range("B1").Formula = "3"
    Range("C1").Formula = "4" 
    Application.ActiveSheet.Protect()
	
    // Check the protection setting of the worksheet and act accordingly.
    if(Application.ActiveSheet.Protection.AllowInsertingColumns == false){ Application.ActiveSheet.Protect(null, null, null, null, null, null, null, null, true)
       alert("Insert a column between 1 and 3")
    }
    else{
       alert("Insert a column between 1 and 3")
    }
}

jetsung

Protection.AllowDeletingColumns

如果允许删除受保护工作表上的列，则返回 True。Boolean 类型，只读。

语法

express.AllowDeletingColumns
express 一个代表 Protection 对象的变量。

说明

可以使用 Protect 方法参数设置 AllowDeletingColumns 属性。
对于受保护的工作表，必须取消对包含要删除的单元格的列的锁定。

示例

function ProtectionOptions(){
    /*本示例取消对受保护的工作表上的列 A 的锁定，然后允许用户删除列 A 并通知用户。*/
    Application.ActiveSheet.Unprotect()
	
    // Unlock column A.
    Columns.Item("A:A").Locked = false
	
    // Allow column A to be deleted on a protected worksheet.
    if(Application.ActiveSheet.Protection.AllowDeletingColumns == false){
       Application.ActiveSheet.Protect(null, null, null, null, null, null, null, null, null, null, null, true)
    }
    alert("Column A can be deleted on this protected worksheet.")
}