公司新控件使用说明.doc

国泰新技术常用控件使用说明引言1.1编写目的本文件将对国泰新技术公司的常用控件作使用介绍，以方便大家入手使用。本文件预期读者： 江苏国泰国际集团新技术有限公司开发部控件主要属性2.1框架设计2.1.1 命名空间命名空间暂定为：Epoint.Web.UI.WebControls2X。 2X表示适用于.Net FrameWork2.X。Epoint.Web.UI.WebControls2XTextBoxTextBoxControlsButtonNumericTextBoxSpecialTextBoxUpDownAddButtonCloseButtonDeleteButtonImageButtonImageButtonControlsAddImageButtonCloseImageButtonDeleteImageButtonDateTextBoxDateFromToTreeViewHtmlEditorButtonControlsTreeViewControlsTextTreeView2.2 TextBoxTextBox控件继承于.Net的TextBox控件，具有原微软控件的所有功能，并且添加了如下属性配置： AllowNull为是否可以为空,默认为true； TextAlign是文本对齐方式文本框的对齐方式； SelectionOnFocus为控件获得焦点时光标所在位置，分为最前，最后，和选中三种。以下是一段示例代码：2.2.1 NumericTextBoxNumericTextBox控件继承于公司控件中的的TextBox控件，同样具有所有上面TextBox控件的属性，并且增加NumericProperty属性节点，可以限制输入字符的类型,只能输入数字,并且中文输入法无效，它的下面有如下子属性： TextBoxType，文本类型，包括Int，Numeric,Money,Rate,其中 int型不能输入小数点 MaxVlaue，最大值，如果不设置，则没有最大值 MinValue，最小值，如果不设置，则没有最小值 Precision，精度，指定小数点后面位数，多出的位数自动四舍五入(数据类型为money时，精度为2，即使设置超过2也没用) MoneyChar，Money前缀符号(只对Money有效) ShowMoneyChar,是否显示Money前缀符号(只对Money有效) 要获取去除MoneyChar和分节符（输入数字后，控件会自动显示逗号为分节符，如100000显示100，000）后的值下面是一段使用的示例代码： 2.2.2 SpecialTextBoxSpecialTextBox同样继承于我们的TextBox控件，主要用于输入Email，身份证、邮政编码等特殊输入，增加以下属性配置： SpecialType，文本类型,包括Email, IdentityCard，PostCode，Mobile四个值，分别表示电子邮件，身份证号码，邮编以及手机号码四种情况；示例代码： 23 Date类型控件日期控件包括DateTextBox和DateFromTo两种，下面是两者的介绍。2.3.1 DateTextBox主要用于选择日期的文本框。增加以下属性配置： InputDateType，选择日期类型，包括input和select（手输、选择），为select时不能手动输入 Character为输出框显示的信息，CN为中文格式日期，HX为-分割，XG为/分割如果日期类型不为选择，则添加日期验证 MinDate和MaxDate用于确定日期可选范围示例代码：2.3.2 DateFromToDateFromTo控件在DateTextBox控件基础上多了几个属性： DateGapNum,最小时间间隔 DateGapType，最小时间间隔的单位，默认为day(天)； MaxFromDate最大起始时间,MaxToDate最大结束时间,MinFromDate最小起始时间,MinToDate最小结束时间增加以下属性配置.示例代码：2.4 TreeView采用梅花雪的TreeView，整合成为我们的通用控件TreeView增加以下属性配置 InputType属性给出树结点前面的选择框类型; RootNodeText属性是最上面结点的文本内容; OnTreeNodePopulate为点击结点动态生成子结点的方法; Target为链接打开的目标页面 ImgFolds为树基本图片文件夹所在目录EpointTreeNode的属性： NavigateUrl属性修改为:当此属性为javascript开头的形式时，调用javascript方法，否则为直接链接页面，可以参照后台； CtrlClickFunction方法，为点击选择框时触发的事件，不能以javascript开头，直接写方法即可,引号用单引号 ExpandOnCheckedChanged ，CheckedChanged时候是否展开所有子节点 RunClickEvtOnInit 生成节点时运行Input的Click事件 ShowImage 是否显示节点Image ShowInputCtrl是否显示选择框 PopulateOnDemand是否有子节点示例代码：前台页面：. 后台使用方法：准备测试用信息：private string strText = TextBox, Button, Date, TreeView, HtmlEdit ; private string strUrl = Master_Text.aspx, Master_Button.aspx, Master_Date.aspx, Epoint_Tree.aspx, Epoint_HtmlEdit.aspx ;页面载入时,生成顶级树：.if (!Page.IsPostBack) / GetNewData();/顶级节点生成方法/. if (RequestType = 1) this.table1.Visible = false; .private void GetNewData() Epoint.Web.UI.WebControls2X.EpointTreeNode tn=new Epoint.Web.UI.WebControls2X.EpointTreeNode(); for (int i = 0; i strText.Length; i+) tn = new EpointTreeNode(strTexti, strTexti + i.ToString();/实例化一个节点 tn.CtrlClickFunction = alert(You Clicked + strTexti + ); ; tn.ExpandOnCheckedChanged = true;/CheckedChanged时候是否展开所有子节点 tn.ShowInputCtrl = true;/显示节点前选择控件 tn.NavigateUrl = strUrli;/节点链接地址 /tn.NavigateUrl = javascript:alert(ll); TreeView1.Nodes.Add(tn);/添加节点 if(strTexti != HtmlEdit) tn.PopulateOnDemand = true;/节点是否有子节点 .子节点生成方法：protected void TreeView1_TreeNodePopulate(object sender, EpointTreeNodeEventArgs e) Epoint.Web.UI.WebControls2X.EpointTreeNode node = e.Node; EpointTreeNode tn; switch (node.Text) case TextBox: tn = new EpointTreeNode(NumericTextBox, NumericTextBox); tn.CtrlClickFunction = alert(You Clicked NumericTextBox); tn.ShowInputCtrl = true; tn.Checked = true; tn.RunClickEvtOnInit = true; tn.NavigateUrl = Epoint_NumericTextBox.aspx; tn.PopulateOnDemand = false; tn.ShowImage = false; node.ChildNodes.Add(tn); tn = new EpointTreeNode(SpecialTextBox, SpecialTextBox); tn.CtrlClickFunction = alert(You Clicked SpecialTextBox); tn.ShowInputCtrl = false; tn.NavigateUrl = Master_SpecialTextBox.aspx; tn.PopulateOnDemand = false; tn.ShowImage = false; node.ChildNodes.Add(tn); break; . 2.4.1 TextTreeViewTextTreeView控件继承TreeView。用于选择多级代码,添加了以下属性： MultiSelect，能否多选 OnlyReturnLeaf，是否只返回叶节点的值使用方法参见TreeView使用。2.5 Button此Button控件继承微软的Button控件，添加了MouseOverClass（鼠标移动上按钮时按钮所用css文件效果）和AfterClickJSFunction（点击按钮调用OnClientClick方法后再调用的前台方法）属性,示例如下：2.5.1 CloseButton继承Button控件 关闭本页,弹出是否关闭页面的询问，无附加属性2.5.2 AddButtonAddButton控件继承于公司Button控件，主要用于打开新窗口，新增了OpenWindowProp属性集，有如下新添属性： AddUrl打开窗口的Url； OpenType打开的方式，有open，showModalDialog，以及showModelessDialog三种方式 WindowOpenFeatrues，打开页面方式为open时设置，包含一些打开页面的基本属性 WindowModalDialogFeatures，打开页面为showModalDialog时设置，包含一些页面基本属性以及通过FunArguments属性来传递参数以及上级页面地址。示例代码：Open形式打开: showModalDialog形式打开：/传递页面参数 function getArg() var obj = new Object(); = test; obj.id=11; obj.FormName = Master_AddButton.aspx; return obj; 2.5.3 DeleteButtonDeleteButton控件继承于公司Button控件，添加了 Raise