K3BOS认证培训教材.pptVIP

插件开发（三） BillEvent接口对象插件开发案例 案例三：在单据加载（打开做好的单据）后，判断单据状态，如果是“修改”模式，锁定单据头供应商字段，不允许修改 分析： (1)使用事件：单据加载后触发，AfterLoadBill事件 (2)判断单据状态，使用BillEvent对象的BillStatus属性 (3)锁定字段，需要访问到该字段，然后使用字段对象(BOSField)的FieldLock属性 BillEvent接口对象插件开发案例 BillEvent对象的BillStatus属性为只读属性，用于获取单据对象的状态 单据一共有三个状态，用三个常量代表，对应三个整数值(类型long)： BillEvent接口对象插件开发案例 关键代码 BillEvent接口对象插件开发案例 案例四：客户要求，单据在生成凭证后，打开单据仍可修改单据头备注字段，修改后可以保存 问题： (1) 单据在生成凭证后，处于“查看”状态，所有字段都被锁定，不能修改 (2) 在工具栏和菜单上找不到“保存”命令,无法保存 BillEvent接口对象插件开发案例 分析一： (1) 单据事件：AfterLoadBill (2) 要使单据可以修改，必须把单据的状态设置为“修改”状态，使用BillEvent对象的BillStatus属性 (3) 把“备注字段”从“锁定”改为“非锁定”，使用BOSField对象的FieldLock属性 (4) 把原本隐藏的“保存”命令显示出来，并且启用该命令。使用BillEvent对象的SetBarStatus方法 (5) 恢复单据的初始状态。因此需要在代码开始声明变量保存单据的初始状态 BillEvent接口对象插件开发案例 分析二： (1)BillEvent对象的BillStatus属性为只读属性，只能获取单据的状态，而不能直接设置单据状态。 (2)使用BillEvent对象的BillCtl属性来解决此问题 m_BillInterface.BillCtl返回可直接设置的单据对象: m_BillInterface.BillCtl.BillStatus=Enu_BillStatusExt_Modify 把单据状态设置为“修改” BillEvent接口对象插件开发案例 BillEvent对象的SetBarStatus方法 该方法用于设置菜单命令，包含三个参数： 参数一：菜单或命令的名称 参数二：菜单命令的可见选项(Visible)或启用(Enable)选项 参数三：布尔值，true表示该命令可见或启用，false则相反 每个菜单或命令把”名称“作为唯一标识，在金蝶BOS开发向导中可以查找到 BillEvent接口对象插件开发案例 BillEvent接口对象插件开发案例 案例五：客户对单据的菜单工具栏有下列特殊要求。 (1)把“文件”菜单中的“复制”命令放到工具栏”新增”命令之后 (2)隐藏“文件”菜单中的“页面设置”命令 (3)在“选项”菜单下新增命令“查看版本”，当单击此命令，弹出提示“您使用的是K3 12.1演示版” 本案例需要修改、新增原有菜单命令，插件开发向导需要多作一步设置 BillEvent接口对象插件开发案例 BillEvent接口对象插件开发案例 隐藏 “页面设置”命令、新增“查看版本”命令，由插件开发向导完成，并生成代码框架 开发人员只需要在代码框架中完成两段代码 (1)把 “复制”命令放到工具栏”新增”命令之后 (2) 单击“查看版本”命令，弹出提示信息 移动【复制】命令 移动复制命令，使用到的菜单/工具栏名称： BillEvent接口对象插件开发案例 把菜单命令移动到工具栏，使用BOSTools的InsertAfter或InsertBefore方法 包含两个参数： 参数一：移动到工具栏上所处位置菜单命令的名称 参数二：要移动的菜单命令(BOSTool)对象 BillEvent接口对象插件开发案例 代码块一 处理【查看版本】的单击事件 为【查看版本】命令增加单击事件，使用BillEvent的MenuBarClick事件 开发向导已生成了该事件的代码框架 BillEvent接口对象插件开发案例 案例六：客户希望打开已保存的单据后，在单据的状态栏显示单据体第一行分录的物料名称 观察：单据状态栏 案例分析(一) (1)使用单据事件：AfterLoadBill (2)获取第一行分录的“物料名称”字段的值 (3)使用BillEvent对象的SetStatus方法，把第(2)步获取的值显示在状态栏上 案例分析(二) 获取单据体字段的值与单据头有区别：单据头字段只有一个值，而多分录单据体的每个字段都是一列，可以包含一到多个值