ScriptColumn
在脚本的 OnInit 方法中,它可以调用 ScriptInitData.AddColumn 方法向 Opus 添加自定义列。这些列可以显示在文件列表和信息提示中,并且可以使用 高级查找 功能进行搜索。每次调用 AddColumn 都会返回一个 ScriptColumn 对象,脚本需要对其进行初始化。
最后更新于
在脚本的 OnInit 方法中,它可以调用 ScriptInitData.AddColumn 方法向 Opus 添加自定义列。这些列可以显示在文件列表和信息提示中,并且可以使用 高级查找 功能进行搜索。每次调用 AddColumn 都会返回一个 ScriptColumn 对象,脚本需要对其进行初始化。
最后更新于
属性名称 | 返回类型 | 说明 | |
---|---|---|---|
autogroup
布尔值
如果将其设置为 True(这是默认设置),并且文件列表按此列进行 分组,Opus 将根据列值自动生成组。如果您将其设置为 False,Opus 将希望您在 OnScriptColumn 函数中提供分组信息。
autorefresh
布尔值 或 整数
设置为 True(或 1)以强制 Opus 在文件更改时更新此列的值。您还可以将此值设置为 2 以强制 Opus 在文件的属性更改时更新值(通常仅在文件修改时间或大小更改时才会更新)。
defsort
整数
此属性允许您控制列的默认排序行为。通常,当用户单击列标题按列进行排序时,该列最初按升序排序,然后再次单击可反转排序顺序。如果您将 defsort 设置为 -1,则首次单击列标题将按降序排序。日期和大小字段默认设置此行为。
defwidth
整数 或 字符串
为您的列指定一个默认宽度,除非文件列表已启用自动调整大小,否则将使用此宽度。如果您指定一个简单的整数值,则表示以平均字符(例如 12 指定 12 个平均字符宽)度量的宽度。您还可以通过添加 px 后缀(例如 "150px" 指定 150 个像素)来指定绝对像素数。
ellipsis
字符串
对于图形列,指定第一个图形颜色集。只要其百分比低于阈值,该图形就会以这些颜色显示。 您可以指定单一颜色(以 r,g,b 或 #rrggbb 格式),在这种情况下,该图形将为纯色,或者指定恰好五种颜色来配置图形的渐变。在第二种情况下,这五种颜色分别对应于 外部亮、内部亮、内部暗、外部暗 和 纯色。前四个控制渐变,第五个(纯色)在禁用渐变时使用。
graph_colors 属性返回一个 Vector;您需要使用 push_back() 方法将您的颜色添加到其中。
m
使用中间省略号,而不是结尾省略号
graph_colors
graph_colors2
对象:Vector
类似于 graph_colors,此属性允许您为图形列配置第二组颜色,当图形值超过阈值时将使用此颜色组。
graph_threshold
对于图形列,指定将图形从第一组颜色切换到第二组颜色的百分比阈值(例如,蓝色图形变为红色表示驱动器几乎已满)。将阈值设置为 -1 以完全禁用第二组颜色。
grouporder
字符串
如果 autogroup 属性设置为 False,那么 grouporder 属性允许您控制列的组出现的顺序。应以分号分隔在字符串中列出每个组,按所需顺序分隔(例如 "Never Modified;Modified")。如果未提供,组将默认按字母顺序列序。
header
字符串
如果设置此属性,则此列添加到文件窗口时将在列标题中显示定义的字符串。如果未设置,将使用 label 值。
infotiponly
布尔值
如果您希望您的列仅可用于 信息提示 中,则将其设置为 True。如果您列花费大量时间来返回值时,您可能需要这样做,在这种情况下,用户可能只希望在信息提示中使用它,以便他们可以按需查看值。如果设置为 False(默认值),则该列将无处可用。
justify
字符串
此字段允许您控制列的对齐方式。如果未指定,则默认左对齐列。可接受的值为 居中、左、右 和 路径。
keyscroll
布尔值
如果将其设置为 True,并且用户启用了 针对排序字段特定的键滚动 配置选项,则您的列将参与此特殊模式。
label
字符串
使用此设置来设置列的标签。当列添加到详细资料或高级模式文件列表中时(除非被 header 属性覆盖),以及在诸如 文件夹选项 对话框中诸如的各种列列表中,将在列标题中显示此标签。
match
**Vector:**string
maxstars
整数
如果列类型设置为 星星,则此属性允许您指定要使用的最大星星数。这用于确保列大小正确。
method
字符串
这是您脚本中提供新列实际值的方法的名称。通常将其设置为 OnXXXXX,其中 XXXXX 是命令的名称,然而可以使用任何方法名称。
调用方法时,将向它传递一个单独的参数,即 ScriptColumnData 对象。通常将此方法称为 OnScriptColumn。
multicol
布尔值
如果您的脚本实现了多个需要进行公共计算的列,您可能希望设置 multicol 属性。如果将其设置为 True,则列处理函数可以选择同时返回多列的数据,而不仅仅是它被调用的特定列。 当调用程序句柄时,ScriptColumnData 对象将不包含通常的 group、sort、type 和 value 属性。相反,它将具有一个 columns 属性,指向可用于一次为一列或多列设置值的 Map。
例如,您可能会这样设置名为 MyColumn 的列的值:
scriptColData.columns("MyColumn").value = "My Column Value";
用户数据
变体
允许您将数据值与一列关联。此值将以 ScriptColumnData.userdata 属性的形式传递给您的列处理程序
m
使用中间省略号,而不是结尾省略号
graph_colors
用户数据
变体
允许您将数据值与一列关联。此值将以 ScriptColumnData.userdata 属性的形式传递给您的列处理程序