除非工作表受到保护(即使用 cfspreadsheet 的password
属性),否则锁定单元格不会执行任何操作。但这样做有一些负面的副作用......
保护工作表会锁定所有单元格。这意味着您基本上必须通过应用格式来“解锁”其他所有内容。从理论上讲,您可以解锁整个工作表:
<cfset SpreadsheetFormatCellRange (sheet, {locked=false}, 1, 1, maxRow, maxCol)>
但是,这会产生令人讨厌的效果,即填充工作表中的每个单元格。因此,如果您将文件读入查询,查询将包含约 65,536 行和 256 列。即使您只明确填充了几个单元格。
锁定功能更适合您希望锁定除少数单元格之外的所有内容(而不是相反)的情况。除非那是您正在做的事情,否则考虑到所有负面影响,我可能不会为此烦恼。
副作用示例
<cfset testFile = "c:/test.xls">
<cfset sheet = spreadsheetNew()>
<!--- only unlocking 100 rows to demonstrate --->
<cfset SpreadsheetFormatCellRange (sheet, {locked=false}, 1, 1, 100, 10)>
<!--- populate two cells --->
<cfset SpreadsheetSetCellValue(sheet,"LOCKED",1,1)>
<cfset SpreadsheetSetCellValue(sheet,"UNLOCKED",2,1)>
<!--- make one cell locked --->
<cfset SpreadsheetFormatCell(sheet, {locked=true}, 1, 1)>
<cfspreadsheet action="write"
name="sheet"
fileName="#testFile#"
password=""
overwrite="true" >
<!--- now see it is filled with empty cells --->
<cfspreadsheet action="read"
query="sheetData"
src="#testFile#" >
<cfdump var="#sheetData#" label="Lots of empty cells" />