自定义点
类图表
JcaTreeConfig 的自定义点
下表描述了使用 TreeConfig API 时可用的自定义点。
属性设置 API | 说明 |
|---|---|
setExpansionLevel | 设置树的初始展开级别。 |
setNodeColumn | 设置将用于显示节点标签的列的名称。 |
setShowTreeLines | 设置是否显示树线以在树中显示结构 |
setDisableAction | 如果设置为 true，则不会在树中显示展开/折叠按钮 |
JcatTableConfig 可提供 API setFindInTableMode。此 API 可用于针对树启用/禁用 findInTree 功能。
配置树 - 定义节点列
要显示节点标签 (或 +/- 按钮) 的列的 id 应传递到 setNodeColumn 方法
在 buildcomponentCOnfig 方法中，构建器应针对 TreeConfig 调用此 setter 方法
示例：
TreeConfig tree = factory.newTreeConfig();
tree.addComponent(factory.newColumnConfig(NAME, true));
tree.addComponent(factory.newColumnConfig(NUMBER, true));
tree.setNodeColumn(NUMBER);
tree.addComponent(factory.newColumnConfig(NAME, true));
tree.addComponent(factory.newColumnConfig(NUMBER, true));
tree.setNodeColumn(NUMBER);
配置树 - 控制展开级别
第一次填充并显示树时，您可以控制展开级别。可通过 setExpansionLevel 使用以下展开级别之一来完成此操作
• 如果展开值为“无”，则树将展开至根级别。如果值为“一”，树将展开到 I 级别，如果值为“完全”，树将完全展开。
示例：
TreeConfig tree = factory.newTreeConfig();
treeConfig. setExpansionLevel (TableTreeProperties.FULL_EXPAND);
treeConfig. setExpansionLevel (TableTreeProperties.FULL_EXPAND);
配置树 - 隐藏展开/折叠按钮
展开/折叠按钮 演示文稿由 setDisableAction 方法控制。您可以为此属性设置字符串值。"true" 值将显示展开/折叠按钮，而 "false" 值将对其进行隐藏。
TreeConfig tree = factory.newTreeConfig();
treeConfig. setDisableAction(“false”) //hides the expand/collapse Norgie
treeConfig. setDisableAction(“false”) //hides the expand/collapse Norgie
配置树 - 启用树线
通过使用调用 setShowTreeLines 方法，可显示树线以在树中显示结构，如下所示：
TreeConfig tree = factory.newTreeConfig();
treeConfig. setshowTreeLines (false);
treeConfig. setshowTreeLines (false);
配置树 - 行的预先选择
要配置树中的行的预先选择，可在组件可用时注册函数。
函数名称可以是任何内容，但该内容应位于全局命名空间中。
PTC.onAvailable(‘<component_id>’,populateConfig);
在已注册的函数中，提供在网格对象处定义的 populatePreSelectionsConfig 函数的实现。
function populateConfig(grid){
grid.populatePreSelectionsConfig = function(preSelecionObj){
preSelecionObj.comparableFn = "PTC.carambola.compareOid";
var defaultValues = ['LEG','BOLT_1_4','TIRE'];
preSelecionObj.oids = defaultValues;
}
}
grid.populatePreSelectionsConfig = function(preSelecionObj){
preSelecionObj.comparableFn = "PTC.carambola.compareOid";
var defaultValues = ['LEG','BOLT_1_4','TIRE'];
preSelecionObj.oids = defaultValues;
}
}
基础结构会在运行时针对每个网格调用 populatePreSelectionsConfig函数，因此不能更改 populatePreSelectionsConfig 函数名称。
在 populatePreSelectionsConfig 函数中，指定需要预先选择的值数组，并通过 preSelecionObj 自变量指定比较运算符函数。
需要使用比较运算符函数来确定是否 JCA oid 的表示与在 preSelectionObj.oids 中指定的表示相同，以预先选择一行。
例如，在类型选取器中，指定的 oid 将采用 wt.doc.WTDocument 格式，而 JCA 表示为 typepicker$typePicker$$|components$loadWizardStep$$wt.doc.WTDocument!*，因此，比较运算符函数将检查 wt.doc.WTDocument 是否与 as typepicker$typePicker$$|components$loadWizardStep$$wt.doc.WTDocument!* 相同