理论教育 路线图设计元素:终点样式和默认选中步骤绑定

路线图设计元素:终点样式和默认选中步骤绑定

时间:2023-05-19 理论教育 版权反馈
【摘要】:路线图元素包含下列属性。5)endPointDesign:控制路线图终点的设计样式,默认有以下5种样式。6)selectedStep:控制默认选中的步骤,若使用多步骤路线图,则必须与相应的上下文结点进行绑定。

路线图设计元素:终点样式和默认选中步骤绑定

路线图(RoadMap)将若干步骤显示在一个顺序的序列中,如可以在向导中进行具体步骤的提醒,并能够根据不同需求设置样式。路线图包含了两种子元素:“RoadMapStep”步骤和“MultipleRoadMapStep”多级步骤,在有固定步数的路线图中可直接使用前者,而在动态的路线图(不确定步数)中则可使用后者。两种子元素也可以混合使用,非常灵活。路线图元素包含下列属性。

1)accessibilityDescription:设置复选框组中的文本是否在用户选中整个元素时显示。

2)contextMenuBehaviour:设置上下文菜单行为,默认有“继承”“允许”和“禁止”3种类型。

3)contextMenuId:设置上下文菜单的唯一标识。

4)enabled:控制元素是否可用。

5)endPointDesign:控制路线图终点的设计样式,默认有以下5种样式。

●disabled:选中路线图终点时不会触发任何事件,且显示为未激活状态。

●more:路线图终点表示还有更多的后续步骤未显示。

●moreDisabled:路线图终点表示还有更多的步骤,但是终点的样式是未激活状态。

●selected:路线图终点可以被选中,还能额外显示一些文本信息。

●standard:默认标准的路线图终点的样式。

6)selectedStep:控制默认选中的步骤,若使用多步骤路线图,则必须与相应的上下文结点进行绑定。

7)startPointDesign:控制路线图起点的设计样式,与终点样式类似,默认有以下5种样式。

●disabled:选中路线图起点时不会触发任何事件,且显示为未激活状态。

●more:路线图起点表示当前显示的流程之前还有更多的步骤未显示。

●moreDisabled:路线图起点表示之前还有更多的步骤,但是显示样式是未激活状态。

●selected:路线图起点可以被选中,还能额外显示一些文本信息。

●standard:默认标准的路线图起点的样式。

8)tooltip:控制提示消息的显示文本。

9)visible:控制元素是否可见。

10)onLoadSteps事件:当路线图还有更多步骤未显示时,用户在单击更多步骤时进行的初始化事件,可以通过映射判断是否已到达路线图的末尾。

11)onSelect事件:会在用户单击任一步骤时触发,可以通过映射返回当前选中步骤的唯一标识。

开发实例:

1)打开任一视图(如果需要创建新的工程或视图,请参考之前章节步骤),右击“Outline”元素清单中的“RootElement”根结点,选择插入子对象,选择“RoadMap“路线图类型,输入ID名称,随后单击“OK”按钮,如图4-281所示。

2)接着插入路线图中的步骤,右击“Outline”中新建的路线图,选择“Insert Step”,随后选择“MultipleRoadMapStep”多级步骤,如图4-282所示。

3)完成创建后,保存所有修改,如图4-283所示。

4)创建一个上下文结点以及字符串类型的特性,分别用于对应路线图的数据源和存放步骤的文本,如图4-284所示。

978-7-111-58177-2-Chapter04-315.jpg

图4-281 选择元素类型

978-7-111-58177-2-Chapter04-316.jpg

图4-282 选择元素类型

978-7-111-58177-2-Chapter04-317.jpg

图4-283 元素清单

978-7-111-58177-2-Chapter04-318.jpg

图4-284 上下文清单

5)由于实例中进行测试的是多级步骤,所以结点的集合属性必须是“0··n”或“1··n”,如图4-285所示。

6)随后选中“MultipleRoadMapStep”,修改其属性。将“dataSource”选择刚创建的“roadMap”结点,将“description”与“desc”特性进行绑定。注意不要混淆其中的两个属性,“description”属性是为每一步骤显示的描述,而“name”则是为每一步骤显示的名称,这里只绑定描述属性,如图4-286所示。

978-7-111-58177-2-Chapter04-319.jpg

图4-285 修改结点属性(www.daowen.com)

978-7-111-58177-2-Chapter04-320.jpg

图4-286 修改属性

7)在开发工具中,可以看到整个路线图的雏形预览,如图4-287所示。

8)随后选择“RoadMap”路线图,修改其属性。将“selectedStep”选中步骤修改为“MultipleRoadMapStep”。保存修改后,路线图中就会有默认选中并且高亮显示的步骤,如图4-288所示。

978-7-111-58177-2-Chapter04-321.jpg

图4-287 预览效果

978-7-111-58177-2-Chapter04-322.jpg

图4-288 预览效果

9)为路线图创建一个“Select”动作并与“onSelect”事件绑定,如图4-289所示。

978-7-111-58177-2-Chapter04-323.jpg

图4-289 修改事件属性

10)在创建动作时,新建“id”和“ele”两个参数,用于存放对应步骤的唯一标识和步骤对象,如图4-290所示。

978-7-111-58177-2-Chapter04-324.jpg

图4-290 添加参数

11)右击“Outline”清单中的路线图元素,选择“Parameter Mapping”创建参数映射(如果在创建动作时不添加对应参数,则无法进行映射),将路线图所选的关步骤ID与创建的动作中的参数“id”进行映射,将所选对象与参数“ele”进行映射,随后单击“OK”按钮,如图4-291所示。

978-7-111-58177-2-Chapter04-325.jpg

图4-291 进行参数映射

12)保存所有修改后进入Java编辑器,添加事件处理器的逻辑,打印当前选中步骤的标识:

wdComponentAPI.getMessageManager().reportSuccess("Selected Step:"+id);

wdContext.nodeRoadMap().setLeadSelection(ele.index());//设置为选中步骤

13)在“wdDoInit”方法中添加初始化路线图的代码:

IRoadMapNode nodeRoadMap=wdContext.nodeRoadMap();

IRoadMapElement createAndAddRoadMapElement=nodeRoadMap.createAndAddRoadMapElement();

createAndAddRoadMapElement.setDesc("步骤一");

createAndAddRoadMapElement=nodeRoadMap.createAndAddRoadMapElement();

createAndAddRoadMapElement.setDesc("步骤二");

createAndAddRoadMapElement=nodeRoadMap.createAndAddRoadMapElement();

createAndAddRoadMapElement.setDesc("步骤三");

14)保存所有修改,并重新编译、运行之后,即可进行相关测试,如图4-292所示。

15)单击任意步骤,如图4-293所示。

16)在消息区域中即可提示对应选中的步骤标识,如图4-294所示。

978-7-111-58177-2-Chapter04-326.jpg

图4-292 运行效果1

978-7-111-58177-2-Chapter04-327.jpg

图4-293 运行效果2

978-7-111-58177-2-Chapter04-328.jpg

图4-294 选择后的效果

免责声明:以上内容源自网络,版权归原作者所有,如有侵犯您的原创版权请告知,我们将尽快删除相关内容。

我要反馈