【用友NC单据UI基本代码示例】本示例在用友NC57环境下调试通过
最近在做基于NC的二次开发，这种封闭的系统文档很少，一个简单的例子都不能找到帮助。
本示例的目的是为了让后来者少走我走过的弯路
package nc.ui.ic.generaltc;
import nc.ui.pub.ButtonObject;
import nc.ui.pub.ClientEnvironment;
import nc.ui.pub.ToftPanel;
import nc.ui.pub.beans.UIPanel;
import nc.ui.pub.bill.BillCardPanel;
import nc.ui.pub.bill.BillEditEvent;
import nc.ui.pub.bill.BillEditListener;
import nc.ui.pub.bill.BillItem;
import nc.ui.pub.bill.BillListPanel;
import nc.ui.scm.pub.query.SCMQueryConditionDlg;
import javax.swing.JComboBox;
import javax.swing.JLabel;
import javax.swing.JTextField;
import java.awt.Dimension;
/**
* NC5.7单据基础示例
* @ClassName: ClientUI
* @Description: TODO
* @author s
* @date 2013-4-9 下午2:22:21
* BillEditListener是按钮监听类
* 实现BillEditListener，需实现bodyRowChange()、afterEdit()两个方法
*/
public class ClientUI extends ToftPanel implements BillEditListener { // 单据类型
private BillCardPanel cpBill = null;
// 客户端环境变量类
private ClientEnvironment ce = getClientEnvironment();
// 按钮查询,增加,修改,删除,保存,取消,打印,审核,弃审,关闭,打开.
protected ButtonObject bnQuery = new ButtonObject("查询", "查询", 1, "查询");
protected ButtonObject bnAdd = new ButtonObject("增加", "增加", 2, "增加");
protected ButtonObject bnModify = new ButtonObject("修改", "修改", 3, "修改");
protected ButtonObject bnDelete = new ButtonObject("删除", "删除", 4, "删除");
protected ButtonObject bnSave = new ButtonObject("保存", "保存", 5, "保存");
protected ButtonObject bnCancel = new ButtonObject("取消", "取消", 6, "取消");
protected ButtonObject bnPrint = new ButtonObject("打印", "打印", 7, "打印");
protected ButtonObject bnAudit = new ButtonObject("审核", "审核", 9, "审核");
protected ButtonObject bnUnAudit = new ButtonObject("弃审", "弃审", 10, "弃审");
protected ButtonObject bnClose = new ButtonObject("关闭", "关闭", 11, "关闭");
protected ButtonObject bnOpen = new ButtonObject("打开", "打开", 12, "打开");
protected ButtonObject[] bgMain = { bnQuery, bnAdd, bnModify, bnDelete,
bnSave, bnCancel, bnPrint, bnAudit, bnUnAudit, bnClose, bnOpen };
// 状态 有下列五种状态
private int iStatus = 0;
private int INIT = 0;
private int NEW = 1;
private int UPDATED = 2;
private int DELETED = 3;
private int SAVED = 4;
private nc.vo.scm.pub.session.ClientLink m_cl=null;
protected UIPanel conditionpanel = null;
public ClientUI() {
super();
initialize();
} /**
* 选中行触发该方法
*/
public void bodyRowChange(BillEditEvent arg0) {
// TODO Auto-generated method stub
// int isChangeRow = arg0.getRow();
} public void afterEdit(BillEditEvent arg0) {
} /**
* 界面初始化。
* @Title: initialize
* @Description: TODO
* @return void
* @throws
* 创建者：s
* 创建日期：2013-4-10
*/
private void initialize() {
try {
setName("TcUI");
m_cl = new nc.vo.scm.pub.session.ClientLink(ClientEnvironment.getInstance());
//INIT,NEW,UPDATED,DELETED,SAVED;
iStatus = INIT;
setBnStatus(iStatus);
//bnOpen.setHint("测试！！！！！");
// 加载按钮
setButtons(bgMain);
add(getBillCardPanel());
// onQuery();
} catch (Exception e) {
nc.vo.scm.pub.SCMEnv.out(e.getMessage());
JLabel msg = new JLabel(e.getMessage());
msg.setHorizontalAlignment(JLabel.CENTER);
add(msg);
}
} /**
* 设置单据窗体
* @Title: getBillCardPanel
* @Description: TODO
* @return BillCardPanel
* @throws
* 创建者：s
* 创建日期：2013-4-10
*/
private BillCardPanel getBillCardPanel() {
if (cpBill == null) {
try {
cpBill = new BillCardPanel();
/*
* 单据模板有两种常用加载方式
* 第一种是根据“单据模板编号”来加载
* 单据模板编号是模板在标准产品库中所保存的模板编号，在pub_billtemplet(单据模板主表)中的pk_billtemplet字段
* 可根据nodecode条件去pub_billtemplet表中查询
* 可用语句select pk_billtemplet from pub_billtemplet where nodecode='40081001'来查询
* nodecode是在“功能注册”时定义的节点“功能编码”，或称“节点编号”，见图1（单据类型管理）
*/
//cpBill.loadTemplet("0001AA1000000004OJWO");
/*
* 第二种方式是使用cpBill.loadTemplet(strBillType, strBusiType, strOperator, strCorp)方法加载
* strBillType是单据模板在标准产品库中所保存的模板类型，在pub_billtemplet(单据模板主表)中的pk_billtypecode字段
* 可根据nodecode条件去pub_billtemplet表中查询
* 可用语句select pk_billtypecode from pub_billtemplet where nodecode='40081001'来查询
* strBusiType是业务类型，可设为null
* strOperator是操作者，使用ClientEnvironment.getUser().getPrimaryKey()取得环境用户参数
* strCorp是公司参数，使用ClientEnvironment.getCorporation().getPk_corp()取得环境公司参数
*/
cpBill.loadTemplet("40081001", null, ce.getUser().getPrimaryKey(), ce.getCorporation().getPk_corp());
//设置单据体表体菜单是否显示
cpBill.setBodyMenuShow(false);
//添加监听
cpBill.addEditListener(this);
} catch (java.lang.Throwable ivjExc) {
}
}
return cpBill;
}
/**
*
* @Title: getConditionPanel
* @Description: TODO
* @return UIPanel
* @throws
* 创建者：s
* 创建日期：2013-4-9
*/
protected UIPanel getConditionPanel() {
if (conditionpanel == null) {
conditionpanel = new UIPanel();
conditionpanel.setName("UIPanel");
conditionpanel.setLayout(new java.awt.GridLayout(2, 6, 0, 1));
conditionpanel.setMaximumSize(new Dimension(550, 40));
conditionpanel.setPreferredSize(new Dimension(550, 40));
conditionpanel.setMinimumSize(new Dimension(550, 1));
}
return conditionpanel;
}
@Override
public String getTitle() {
// TODO Auto-generated method stub
return null;
} @Override
public void onButtonClicked(ButtonObject arg0) {
// TODO Auto-generated method stub }
/**
* 设置按钮状态。
* @Title: setBnStatus
* @Description: TODO
* @param status
* @return void
* @throws
* 创建者：s
* 创建日期：2013-4-10
*/
public void setBnStatus(int status) {
//初始、删除、保存状态
if (status == INIT || status == DELETED || status == SAVED) {
bnQuery.setEnabled(true);
bnAdd.setEnabled(true);
bnModify.setEnabled(true);
bnSave.setEnabled(false);
bnCancel.setEnabled(false);
bnDelete.setEnabled(true);
// bnModify.setEnabled(false);
}
//增加、修改状态
else if (status == NEW || status == UPDATED) {
bnQuery.setEnabled(false);
bnAdd.setEnabled(false);
bnSave.setEnabled(true);
bnCancel.setEnabled(true);
bnDelete.setEnabled(false);
bnModify.setEnabled(false);
}
//bnPrint.setEnabled(false);
updateButtons();
}
}
图1：单据类型管理界面
