学习目标

1. 了解苍穹提示框的种类；

2. 掌握各种提示框的使用。

内容简介

本学习单元主要学习苍穹开发如何使用各类提示框。

1. 工具栏提示框

工具栏显示提示框，提示框有分绿色、黄色、红色的，代表的意义不一样。一般绿色用来提示用户操作成功；黄色代替这些信息是提醒、警示作用，不会中断用户的操作；而红色则表明系统出现异常。提示框的信息代表异常的信息或提示。

1.1绿色工具栏提示框

使用场景

在单据或列表进行某项操作后需要提示用户操作已成功执行时，这时可以在工具栏提示用户。比如标准单据保存后提示用户保存成功，效果图如下：

实现方式

this.getView().showSuccessNotification("操作成功")；

1.2黄色工具栏提示框

使用场景

在单据或列表界面操作或值改变时，可能需要给用户信息提醒。但这些提醒一般不会中断用户的操作，起通知、提醒或警示作用，比如说，办公用品领用申请单，当申请数量超过10 则提示“请节约使用办公用品哦”，效果图如下：

实现方式

@Override
    public void propertyChanged(PropertyChangedArgs e) {
       // TODO Auto-generated method stub
       super.propertyChanged(e);
       //当物品来源渠道为赠送时，显示来源说明字段
       //申请领用数量大于10则提示节约使用
       if(e.getProperty().getName().equals("kded_qty")) {
           if(e.getChangeSet()[0].getNewValue()!=null &&(BigDecimal.valueOf(10).compareTo((BigDecimal) e.getChangeSet()[0].getNewValue())<0)) {
              this.getView().showTipNotification("请节约使用办公用品哦");
           }
           
       }
    }

该提示框默认显示3.5秒就自动消失，如需显示更长时间可使用以下接口

this.getView().showTipNotification("请节约使用办公用品哦", 5000);//5秒后提示框自动消失

1.3红色工具栏提示框

使用场景

在系统操作的过程中可能会遇到不可预知的错误或者用户执行了业务不允许的操作行为，可通过工具栏错误提示框告知用户系统出现异常或警示用户错误操作。比如办公用品领用申请单不允许用户一次领用100以上的物品，效果图如下：

实现方式

  @Override
    public void propertyChanged(PropertyChangedArgs e) {
       // TODO Auto-generated method stub
       super.propertyChanged(e);
       //申请数量大于100则清空申请数量并提示重新填写
       if(e.getProperty().getName().equals("kded_qty")) {
           if(e.getChangeSet()[0].getNewValue()!=null &&(BigDecimal.valueOf(100).compareTo((BigDecimal) e.getChangeSet()[0].getNewValue())<0)) {
              this.getView().showErrorNotification("领用申请数量一次不允许超过100,请重新填写");
              this.getModel().setValue("kded_qty", null);
           }
           
       }
}

2.控件提示

使用场景

在单据开发时，经常需要对单据上的字段做一些特殊的提示，尤其是某些字段变化后，可能需要提示一些关联的信息。比如办公用品登记单，当物品来源渠道选择赠送时，显示“物品获赠来源”字段，并在“物品来源渠道”字段下提示“请尽量填写物品获赠来源信息”，如果物品来源渠道选择采购时则清空提示。效果图如下：

实现方式

FieldTip tishiTip = new FieldTip(FieldTipsLevel.Info,FieldTipsTypes.others,"kded_sourcetype","请尽量填写物品获赠来源信息");
this.getView().showFieldTip(tishiTip);

说明：

注意：FieldTip对象创建有3个参数，第一个表示消息的类型，有FieldTipType.Info 、FieldTipType.Warning和FieldTipType.Error；第二个参数为单据控件的标识；第三个参数为需要显示的信息。

实现代码

@Override
    public void propertyChanged(PropertyChangedArgs e) {
       // TODO Auto-generated method stub
       super.propertyChanged(e);
       //当物品来源渠道为赠送时，显示来源说明字段
       if(e.getProperty().getName().equals("kded_sourcetype")) {
            FieldTip tishiTip = new FieldTip(FieldTipsLevel.Info,FieldTipsTypes.others,"kded_sourcetype","请尽量填写物品获赠来源信息");
           if(e.getChangeSet()[0].getNewValue().equals("gived")) {
              this.getView().setVisible(true, "kded_givenitems");  
              this.getView().showFieldTip(tishiTip);
           }else{
              this.getView().setVisible(false, "kded_givenitems"); 
              tishiTip.setSuccess(true);
                this.getView().showFieldTip(tishiTip);
              
           }
       }
    }

3. 弹窗提示框

3.1弹窗提示信息框

使用场景

弹出提示框模式一般是单据重要值发生变化时需要以醒目的方式提醒用户，告知用户某个重要内容发生了变化，此类提示框上没有“取消”或“确认”按钮，比如办公用品领用申请单，当申请数量超过10 则提示“请节约使用办公用品哦”，效果图如下图所示：

实现方式

 this.getView().showMessage("请节约使用办公物品哦");

3.2弹窗错误信息框

使用场景

在系统操作的过程中可能会遇到不可预知的错误，通过弹出错误类的提示框告知用户系统出现异常，在提示框的详细信息中会注明异常的信息或提示。比如办公用品领用申请单不允许用户一次领用100以上的物品，如申请数量大于100系统会弹出错误信息提示框提示用户重新填写申请数量，如下图所示：

点击 “显示详情” 后，显示详情如下：

实现方式

this.getView().showErrMessage("领用申请数量一次不允许超过100,请重新填写","申请数量过大提示：");
this.getModel().setValue("kded_qty", null);//将申请数量置空

3.3弹窗确认消息框

使用场景

在界面弹出确认框方式一般用于用户在操作核心功能、不可逆功能或修改某种核心参数时需要用户再次确认，防止误操作。在软件功能设计中最普遍的是删除操作一般会弹出确认信息让用户再次确认。在用户点击确认框中的具体功能后，会触发反调操作，在反调操作中可以处理业务逻辑。

比如在点击 “废弃” 时，提醒用户是否真的要作废办公用品领用申请单（单据已经配置了废弃操作），防止用户误操作。如下图所示：

当选择了 “是” 选项之后，要将领用申请单的实际领域数量改成0。（确认框有三个按钮的，也有两个按钮的，具体可以参考kd.bos.form.MessageBoxOptions中的枚举值）
此处简单模拟点击工具栏上“作废”按钮弹出确认框为例，实现方式如下：

点击按钮后弹出确认框

@Override
public void beforeItemClick(BeforeItemClickEvent evt) {
// TODO Auto-generated method stub
super.beforeItemClick(evt);
if(evt.getItemKey().equals("kded_feiqi")){
  evt.setCancel(true);//取消原来的操作
  //作废操作前让用户选择是否继续作废操作，在用户点击确认框上的按钮后，系统会调用confirmCallBack方法
  ConfirmCallBackListener confirmCallBackListener = new ConfirmCallBackListener("feiqiction", this);
  //设置页面确认框，参数为：标题，选项框类型，回调监听
 this.getView().showConfirm("您确认作废此办公用品领用申请单吗？", MessageBoxOptions.YesNo, confirmCallBackListener);

}

点击确认后继续调用废弃操作

 @Override
 public void confirmCallBack(MessageBoxClosedEvent messageBoxClosedEvent) {
 // TODO Auto-generated method stub
 super.confirmCallBack(messageBoxClosedEvent);
 //判断回调参数id
 if("feiqiction".equals(messageBoxClosedEvent.getCallBackId())){
   if (MessageBoxResult.Yes.equals(messageBoxClosedEvent.getResult())) {
     this.getModel().setValue("kded_realqty", 0);//将实际领取数量置为0
     this.getView().invokeOperation("feiqi"); //继续调用废弃操作           
          }
     }
}

弹出提示的多种实现方式

恭喜您！