HotXLS 开发者参考:TXLSXDataValidation 和 TXLSXDataValidations 类

TXLSXDataValidation 和 TXLSXDataValidations 类

TXLSXDataValidations 提供此 XLSX 功能的 API,并保留原始标识符 TXLSXWorksheet.DataValidations 提供此 XLSX 功能的 API,并保留原始标识符 TXLSXDataValidation

提供此 XLSX 功能的 API,并保留原始标识符

function Add(const ARange: WideString; AType: TXLSXDataValidationType; AOp: TXLSXDvOperator; const AFormula1: WideString): Integer;
function Add(const ARange: WideString; AType: TXLSXDataValidationType; AOp: TXLSXDvOperator; const AFormula1, AFormula2: WideString): Integer;
function AddList(const ARange, AItems: WideString): Integer;
procedure TXLSXDataValidation.SetPrompt(const ATitle, AText: WideString);
procedure TXLSXDataValidation.SetError(const ATitle, AText: WideString; AStyle: TXLSXDvErrorStyle = xlsxDvErrStop);

提供此 XLSX 功能的 API,并保留原始标识符

Range and ValidationType主要成员
Op, Formula1 and Formula2主要成员
AllowBlank使用属性和方法创建、读取和更新工作表、区域与对象
PromptTitle and Prompt使用属性和方法创建、读取和更新工作表、区域与对象
ErrorTitle, ErrorMessage and ErrorStyle另请参阅
ShowDropDown另请参阅
ImeModeTXLSXDataValidation 和 TXLSXDataValidations 类

规则目标区域

自 2.384.76 起,工作表本地目标接受单个单元格、单元格矩形、$B:$D 这样的整列以及 $5:$8 这样的整行;反序端点会被规范化,空格、制表符或换行符分隔多个区域
绝对引用和混合引用保留原始的 Range 文本;匹配使用第 1 到 1048576 行和 A 到 XFD 列,跳过畸形或超出网格的区域,并保持有效的兄弟区域继续生效,不会抛出新的 setter 异常
带工作表限定的引用和外部引用不是目标区域;每条规则都属于其所在工作表,美元符号必须出现在普通 A1 引用位置
规则查找、单元格和区域删除、单单元格验证以及已存储单元格的验证审计使用同一套目标几何;目标解析不改变列表源公式支持
自 2.384.77 起,行和列编辑也会在工作表网格内变换整轴规则目标;横跨所有行或列的范围在该轴被编辑时保持完整,而另一轴上的编辑会移动、缩小或移除目标
区域克隆保留完整覆盖约定:每个目标区域都必须落在源矩形内规则才会被复制,仅部分相交不会复制规则;目标留在网格内时,整轴目标可以从整行或整列源克隆
整轴验证目标在编辑期间保持为一条规则,公式从其第一个存留锚点出发调整;这不会扩展现有的 ODS 自定义布尔或标量公式互操作支持

TXLSXWorksheet

var Index: Integer;
begin
  Index := Sheet.DataValidations.AddList('D2:D100', 'New,Active,Closed');
  Sheet.DataValidations[Index].SetPrompt('Status', 'Select a permitted status');
  Sheet.DataValidations[Index].SetError('Invalid status', 'Choose a value from the list');
end;

ODS 范围

ODS 导出从第一个受支持的目标区域派生有效的首单元格基址,整行和整列也包括在内;畸形的前导区域不会成为基址
自定义布尔验证的导出仍然不受支持,标量阈值公式保留其既有的公式语法限制;目标区域修复不为相对验证公式建立对外互操作性

TXLSXWorksheet