CATIA V5百科全书系列——操作界面模块（User Interface）

CATIA V5百科全书(CAA V5 Encyclopedia)是CATIA CAA(Component Application Architecture, 组件应用框架)二次开发最全面的资料，其具体位置在...\Program Files\Dassault Systemes\B21\CAADoc\Doc\onlineDoc\CAACenV5Default.htm，可以直接用浏览器打开。本人初学CAA二次开发，参考了一些视频和文章，但仍然认为Encyclopedia是最全面的一手资料。本系列文章旨在翻译百科全书中的操作界面模块(User Interface)，一方面督促自己学习，一方面抛砖引玉，希望能给需要的朋友一点点参考价值。

目录

操作界面模块简介

1 Wintop Frame

1.1 技术文章

1.2 用例

1.3 参考

2 Wintop Commands

2.1 技术文章

2.2 用例

2.3 参考

3 Wintop Dialogs

3.1 技术文章

3.2 用例

3.3 参考

4 Webtop

4.1 技术文章

4.2 用例

4.3 参考

5 Thin Webtop

5.1 技术文章

5.2 用例

5.3 参考

总结

---

操作界面模块简介

操作界面建模器用于处理Wintop、Webtop和Thin Webtop等操作界面。Wintop由借助 ApplicationFrame和CATIAApplicationFrame框架提供给应用程序的Frame对象、借助 DialogEngine框架提供的交互式命令以及借助Dialog框架提供的对话框窗口和对话框组成。 Webtop由借助JApplicationFrame和PortalBase框架的Portal中的CATLets和命令组成。Thin Webtop由一个新的Java对话平台组成。

---

1 Wintop Frame

1.1 技术文章

• 应用程序框架概述——交互的基础
• 了解应用程序框架布局——对隐含在V5 交互式应用程序布局中的对象的描述
• 什么是Product Line视觉识别——您可以自定义的与Product Line相关的对象
• 对象属性访问——如何为您的对象属性添加属性页
• 应用程序属性访问——如何为您的应用程序属性添加属性页
• 设定控制器——封装对设置文件的访问
• CAA命令模型——了解命令及其工作方式
• 命令头(Commands Headers)——与您的对话命令一起出现的对象
• 为命令头创建资源——如何为命令头创建标题、帮助信息和图标
• 为Workshops或Workbenches(工作台)创建资源——如何为Workshops或Workbenches创建标题、帮助信息和图标
• 上下文(Contextua)帮助——技术文档文件树的结构和内容
• 搜索概览——如何在 V5 文档中搜索对象？
• 热启动增量备份(Incremental Backup)——原则和 CAA 集成

1.2 用例

Workbench

• 创建Workbench——公开(Exposing)和组织专用于给定任务的命令
• 创建Add-in——定制Workshop或Workbench
• 使您的文档独立命令在所有工作台中可用——使用CATIAfrGeneralWksAddin
• 管理工作台之间的转换——使用CATIWorkbenchTransition
• 定义激活的工作台——使用CATIAfrActivateWorkbench

Command Header

• 创建标准命令头——公开命令
• 创建定制的命令头——公开命令并管理其可用性
• 创建检查按钮——使用CATAfrCheckHeaderAccessor
• 在上下文(Contextual)菜单中插入命令——用CATIContextualMenu实现
• 创建组合(Combo)命令头——如何创建在工具栏中组合显示的命令头类
• 创建最近使用的(Most Recent Used)命令头——如何创建表示菜单中项目动态列表的命令头类
• 在工具栏中创建编辑器——如何创建表示工具栏中编辑器的命令头类

Window

• 创建文档的窗口(1)——使文档在V5应用程序框架中显示
• 创建文档的窗口(2)——如何创建多视图窗口
• 编辑对象——使对象可编辑

Applicatioan Design

• 附加组件(Add-on)的上下文帮助——如何创建文档文件树
• 创建Product Line的视觉识别——将自己的Product Line与其他Product Line区分开来

Object or Application Properties

• 为对象属性创建属性页——Customizing Edit->Properties
• 为应用程序属性创建属性页——Customizing Tools->Options
• 创建设置控制器——封装设置文件访问

Interactive Tools

• 创建可中断任务——使用CATIProgressTask，CATIProgressTaskUI和CATTaskController
• 创建搜索查询——如何在V5中创建查询以查找对象
• 在“工具面板(Tools Palette)”工具栏中创建带有选项的命令——如何实现CATIAfrCmdPaletteOptions以及定义选项
• 在工作台中使用“工具面板”工具栏——如何实现CATIAfrPaletteOptions

Others

• 使用相机——创建被视为多个最终用户命令的单个命令
• 展开/折叠规范树节点——如何在规范树(Specification Tree)中取出对象
• 将规范树节点居中——如何查找选定对象的规范树节点并将其居中

1.3 参考

• ApplicationFrame框架参考——ApplicationFrame的接口和类参考
• CATIAApplicationFrame框架参考——CATIAApplicationFrame的接口和类参考
• InteractiveInterfaces框架参考——InteractiveInterfaces的接口和类参考

---

2 Wintop Commands

2.1 技术文章

• 状态对话框命令入门——一个简单但完整的状态对话框命令示例
• 用UML(统一建模语言)描述状态对话命令——UML提供的用于设计状态对话框命令的工具
• DialogEngine编程指导——编程逐步介绍
• 为状态对话命令创建类——如何创建对话命令类
• 管理状态对话命令的Lifecycle——编写命令类的构造函数和析构函数以及Activate，Desactivate，Cancel方法
• 状态图(Statechart Diagram)的实现——从状态图到BuildGraph方法
• 使用对话框输入——如何让用户从对话框窗口输入
• 管理撤销和重做——如何撤销和重做用户的输入、切换行为和命令结果
• 创建上下文菜单——如何在当前命令下将项目添加到上下文菜单
• 为状态对话框命令分配资源——如何为命令提示符引用外部资源
• 使命令可用——如何将命令集成到应用程序框架中

2.2 用例

• 状态图的实现——编写BuildGraph方法
• 管理选择——通过鼠标单击检索现有对象
• 管理多项选择——从鼠标单击或trap选择中检索现有对象
• 管理指示——通过鼠标点击检索三维点
• 将对话窗口与对话代理(Dialog Agent)相关联——使用现有的通知(notification)来评估(value)对话代理(1)
• 将对话窗口与对话代理(Dialog Agent)相关联——使用新的通知(notification)来评估(value)对话代理(2)
• 将对话窗口与状态相关联——使用对话窗口代替对话代理
• 订阅(Subscribing)鼠标移动事件——将临时图形反馈与鼠标移动相关联
• 管理命令的撤销与重做——使用户能够对命令的结果进行撤销或重做
• 管理输入和操作的撤消/重做——使最终用户能够在状态图中来回移动(操作)
• 创建上下文菜单——在状态对话命令中定制对象的上下文菜单
• 创建包含在对话框窗口中的命令——创建没有状态的命令
• 在命令中编辑对象——如何使用CATEditAgent类堆栈(stack)工作台

2.3 参考

• DialogEngine框架参考——DialogEngine的接口和类参考

---

3 Wintop Dialogs

3.1 技术文章

• 对话框(Dialog)概述——对话框窗口和对话框(Boxes)概览
• 对话框编程指南——编程逐步介绍
• 创建对话框对象——如何创建和管理对话框对象
• 排列对话框对象——如何在对话框窗口和对话框中管理对话框的布局
• 使用网格(Grid)排列对话框对象——如何使用网格布局管理对话框对象
• 使用表格(Tabulation)排列对话框对象——如何使用表格布局管理对话框对象
• 使用回调触发操作——如何将动作与控件关联
• 管理数量(Magnitude)和单位(Units)——如何使组合、编辑器和微调器数值字段与实际值匹配
• 将资源分配给对话框——如何为文本、消息、图标和图片使用外部资源
• 设计交互式应用程序——如何创建一个单独的交互式应用程序

3.2 用例

• 开始——一个对话框的简单例子
• Burger Order对话框——一个复杂的对话框例子
• 创建可自动调整大小的对话框——使用表格排列对话框对象
• 保存和恢复对话框状态——如何保留和检索对话框对象值
• 发送/接收机制——使命令协作
• 向交互式应用程序发送数据消息——使用Backbone发送包含数据的消息

3.3 参考

• 对话框框架参考——Dialog的接口和类参考
• 对话框类参考——与编程信息连接的图解目录(Illustrated catalog)
• 对话框类的用法和连接(Link)参考——对话框类之间的用法和父/子连接
• 数量和单元参考——组合框、编辑器和微调器中数值字段可用的数量和相关单元
• 光标(Cursor)参考——可以指定给鼠标光标的形状

---

4 Webtop

4.1 技术文章

• Portal中的CATlet——CATlet MVC(Model-View-Controller)范式及开发
• 处理CATlet中的选择——CSO对象的选择管理
• 如何在Portal中声明CATlet——ENOVIA Portal内应用程序的声明
• 在Portal中编程命令和标题——Portal中命令的声明
• 为CATlet创建Workshop——Portal中CATlet命令的声明
• ENOVIA Portal的URL机制——用于Portal中通信(Communication)的URL机制
• Portal注册表——Portal注册表(Registry)的声明和使用
• Portal对话框——Portal对话框(DialogBox)组件的使用
• 在Portal中自定义Swing组件——如何扩展Swing组件以及使用Portal的外观颜色

4.2 用例

• 创建CATlet——在Portal中创建新的CATlet(MVC 结构)
• 创建命令——创建新的命令以及将其添加到CATlet Workshop中
• 创建命令头——创建新的命令头并将其与命令关联
• 发送PortalURL——将PortalURL发送到Portal
• 接收PortalURL——从Portal中接收PortalURL
• 使用PortalRegistry——使用Portal框架的注册表

4.3 参考

• Java API参考——Java com.dassault_systemes.catweb.* and com.dassault_systemes.PortalNative.PLNtools packages reference documentation

---

5 Thin Webtop

5.1 技术文章

• CATJDialog概述——JDialog组件概览
• JDialog的安全性——如何在JDialog应用程序上部署安全性
• 配置PO访问——如何个性化PO访问
• 创建管理命令——如何创建集中管理命令
• 写入无状态控制器——设计无状态控制器最好的实践

5.2 用例

• 创建命令——如何使用JDialog开发命令
• 在EVW和WP中部署命令——如何使用JDialog部署命令
• 网格约束布局——使用网格约束定义复杂的布局

5.3 参考

• Java API参考——Java com.dassault_systemes.catweb.* and com.dassault_systemes.PortalNative.PLNtools packages reference documentation

---

总结

本文简单介绍了百科全书中的操作界面模块(User Interface)，并对User Interface下Wintop Frame, Wintop Commands, Wintop Dialogs, Webtop和Thin Webtop等五个部分的技术文章、用例和参考文档的标题进行了翻译，其内部的具体的功能和内容读者可根据需求点进去学习。本文在翻译时保留了许多关键词的英文，因为在编程和查阅帮助文档时会经常碰到，能理解意思就行,翻译也是为了更好的理解嘛。本文旨在抛砖引玉，后续将会翻译一些我看过的文章，第一次在CSDN发表文章，文中必定有许多错误和不足，还请读者海涵，如果能及时与我联系，我将不胜感激。