移动平台常用属及插件开发.docx

目录1、创建移动表单（单据）2移动表单2移动单据32、属性4表单插件4列表插件4列表双击事件4每页显示行数5顶部菜单（列表顶部菜单）5来源单据6顶部菜单颜色7顶部菜单图片8预览单据内码8背景图片9背景颜色9快捷过滤字段9查询字段10长按菜单11方向11边框12内/外边距12文本颜色（标题颜色）12字体（标题字体）13是否可见13图标（图标键）133、插件开发14列表条件格式化144、发布151、创建移动表单（单据）移动表单点击【新建】进入如下界面，选择移动表单，修改业务对象名称以及编号（业务对象的标识）确定后进入如下界面，可以选择“空模板”，会生成空界面，完全由用户自己自定义，或者选择我们预置的模板，会复制出模板的样式，再由用户修改移动单据点击【新建】进入如下界面，选择移动表单，修改业务对象名称以及编号（业务对象的标识），确定后进入如下界面下一步后，选择数据源、绑定模板与数据源单据体关联关系以及选择单据和列表的字段下一步，选择模板中移动代理字段与数据源字段的替换关系，确定后会自动生成替换数据源和字段后模板，并且样式会保留下来，注意，如果源字段没指定替换字段，则会被移除。2、属性表单插件移动单据表单插件继承Kingdee.BOS.Mobile.PlugIn. AbstractMobileBillPlugin移动表单插件继承Kingdee.BOS.Mobile.PlugIn. AbstractMobilePlugin列表插件移动单据列表插件继承Kingdee.BOS.Mobile.PlugIn. AbstractMobileListPlugin列表双击事件移动单据列表点击某行，想进入单据详情界面，必须配置列表双击事件查看，否则在Android或者IOS客户端上点击移动列表上行时候，是不会有相应的，点击行时候同时会触发EntityRowDoubleClick(EntityRowClickEventArgs e)事件，可以插件干预，做自己业务逻辑。每页显示行数移动单据列表每一页加载数据的条数，移动客户端建议行数不宜过大，点击查看更多会加载下一页的数据顶部菜单（列表顶部菜单）顶部菜单，即单据维护界面的导航栏菜单，列表顶部菜单对应移动单据列表上的导航栏菜单其中预置了3个按钮和1个下拉按钮，“返回”、“侧滑”、“按钮”、“下拉按钮”，一般后两个比较常用，接着修改标识、可见性、图标等。点击导航菜单对应事件：AfterButtonClick(AfterButtonClickEventArgs e)e.MenuKey记录了对应菜单按钮的标识来源单据移动单据上特有属性，选择要获取数据的单据或者基础资料，之后会在左边生成树结构，比如出差申请单，然后拖动字段或者单据体到界面上会自动生成移动代理字段和代理分录；顶部菜单颜色移动表单或者单据详情界面导航栏上的颜色，可以自定义，可以输入#ACACAC或者172,172,172，或者直接选择一个颜色顶部菜单图片移动表单或者单据详情界面导航栏上的背景图片，可以输入*.png、*.jpg等；注意图片存放位置：站点目录imagesmobile，如果没有mobile目录则新建一个；预览单据内码输入来源单据的任意一条数据的内码，保存后右键移动单据，点击预览，可以预先看到界面的展示效果，如下背景图片主要用在流式布局上，可以输入*.png、*.jpg等；注意图片存放位置：站点目录imagesmobile背景颜色主要用在流式布局、按钮上，可以个性化设置颜色快捷过滤字段单据列表上过滤窗口，设置要过滤的字段以及比较符类型，如下：查询字段当列表插件上需要获取来源单据字段数据，又不希望通过在界面添加字段和展示字段，则可以用这个属性，如下：两个标签的值是通过来源单据的申请日期来设置，则需要在查询字段上加上申请日期的标识Fdate，如果有多个用逗号隔开；则在插件中可以这样使用，重写OnFormatRowConditions(ListFormatConditionArgs args)事件，ListFormatConditionArgs包的DataRow有添加字段和查询字段数据包DynamicObject obj = (DynamicObjectDataRow)args.DataRow).DynamicObject;DateTime time = Convert.ToDateTime(objFDATE);长按菜单移动列表上属性，可以设置列表上长按某一行时，弹出的菜单选项，插件中可以重写AfterBarItemClick(AfterBarItemClickEventArgs e), e.BarItemKey记录了菜单标识方向流式布局特有重要属性，有竖向和横向两个选项，一般设计布局的时候要注意一下这个属性，有时候发现控件在布局上没显示可能是这个导致。设计移动表单界面的时候，要先设计好界面布局以及方向，是一种好的习惯。边框流式布局可以设置单线框，文本控件可以设置输入区下划线、输入框边框、网格以及无边框这几个选项。如内外边距下截图。内/外边距流式布局特有重要属性，如果需要调整控件的内外边距，需要在控件外围加一个流式布局，然后在输入内外边距(左、上、右、下)，比如2,2,2,2表示离左上右下各2个像素。文本颜色（标题颜色）文本控件内容和标题的颜色，可以自定义设置。设置方法跟设置背景颜色一致。移动界面要更美观的展示需要灵活的用这个属性。字体（标题字体）设置文本内容和标题的字体类型，包括大小、字体类型等，也是常设置的属性。是否可见菜单按钮和下拉按钮的属性，默认是不可见，需要设置可见性才能看到菜单按钮。图标（图标键）图片控件和菜单按钮、下拉按钮有这个属性，可以设置图片控件背景图片，以及按钮的小图标，给人较好的视觉效果，可以输入*.png、*.jpg等；注意图片存放位置：站点目录imagesmobile3、插件开发列表条件格式化如果希望在移动列表每一行上动态显示不同图片、设置不同字体颜色或者改变行高度，需要列表条件格式化。列表插件使用如下：重写OnFormatRowConditions(ListFormatConditionArgs args)事件，该事件获取每一行数据后会触发一次DynamicObject obj = (DynamicObjectDataRow)args.DataRow).DynamicObject;args.FormatConditions条件格式化集合，类型List代码示例：args.FormatConditions.Add(new MobileFormatCondition() Key = FMobileListField3, ForeColor = 255,255,0,0 );移动表单插件使用如下：List formatCondition = new List();formatCondition.Add(new MobileFormatCondition() Key = FStatus, ForeColor = 255,81,186,255, Row = i + 1 );注意：移动表单列表条件格式化，需要指定行号Row，而列表则不需要this.View.GetControl(FMobileListViewEntity).setFormat(formatCondition);Kingdee.BOS.Mobile.Metadata .MobileFormatCondition类属性介绍Key 控件标识BackColor 背景颜色ForeColor 字体颜色ImageKey 图片标识Value 控件值Row 行号（移动表单插件需要）如何打开移动界面如何打开移动单据的详情界面？MobileShowParameter parameter = new MobileShowParameter();parameter.PKey = rowObjrowObj.DynamicObjectType.PrimaryKey.Name.ToString();parameter.FormId = BOS_MOB_AcitivityManager;parameter.ParentPageId = this.View.PageId;this.View.ShowForm(parameter);如何打开移动单据的列表界面？MobileListShowParameter parameter = new MobileListShowParameter();parameter.FormId = BOS_MOB_AcitivityManager;parameter.ParentPageId = this.View.PageId;this.View.ShowForm(parameter);移动列表绑定数据源在插件中如何为移动表单绑定数据源代码示例：参考Kingdee.BOS.Mobile.FormPlugIns.Business. MobileCalendarWeekEditthis.View.Model.DeleteEntryData(FMobileListViewEntity);获取移动列表数据包DynamicObjectCollection entityList = this.Model.DataObjectMobileListViewEntity as DynamicObjectCollection;创