atlas中的客户端控件均继承或间接继承于sys.ui.control基类(请参考:asp.net atlas简单控件介绍之两个基类),并有所扩展,本文将介绍atlas内建的简单控件inputcontrol,textbox,button和checkbox。
sys.ui.inputcontrol
inputcontrol类是一个抽象类,作为所有提供用户输入的控件(例如textbox,见下文)的基类,提供了输入数据验证等公有操作。inputcontrol抽象类提供如下属性:
isvalid:该属性为只读,返回布尔值,代表输入数据经过验证后是否合法,即是否通过了所有validator(请参考:在asp.net atlas中创建自定义的validator)的验证。
validationmessage:该属性为只读,返回string。当验证失败时,它包含第一个引发失败的validator的错误信息;若验证成功,则为空字符串。
validators:返回该inputcontrol的validator集合,您可以通过这个属性添加/删除某个validator来实现对用户输入信息的验证。
sys.ui.textbox
textbox控件是任何一种gui都必须提供的控件之一,也是我们最常用的和用户交互的控件之一。atlas中的textbox封装了type为input的dom元素input,或是dom元素textarea,继承于inputcontrol基类以获得输入数据验证的功能。textbox提供如下属性。
text:获取或设置textbox中的文字。
正因为textbox在实际程序设计中非常常用,所以我们也经常需要对它的扩展。
sys.ui.button
button控件在gui中同样重要。atlas将dom元素中的button概念扩展,使button不单单指type为button或submit的html input元素,还可以应用到例如span,a等元素上,提供开发人员统一的编程接口。button提供如下两个属性:
command:获取或设置代表该button引发的命令名称的string。当该button的父控件允许event bubbling时,父控件的onbubbleevent事件处理函数中可以访问到该属性以得到该button传递过来的命令名称。
argument:获取或设置代表该button引发的命令参数的string。该button的父控件允许event bubbling时,父控件的onbubbleevent事件处理函数中可以访问到该属性以得到该button传递过来的参数。
以上两个属性在某些情况中非常有用,您可以在这篇文章:使用 asp.net atlas pagenavigator控件实现客户端分页导航中看到它们的实际应用。
button还提供如下的事件:
click:在该button被点击时触发。
注意:当某个button被点击时,首先触发的是该button的click事件,然后再触发该button父控件的onbubbleevent事件。
sys.ui.checkbox
atlas中的checkbox封装了type为checkbox的input dom元素。用户可以使用它输入一个布尔值。checkbox提供如下属性:
checked:获取或设置代表该checkbox是否被选中的布尔值。
checkbox还提供如下事件:
click:在该checkbox被点击时触发。
本文中提到的控件均非常简单,故略去示例程序,欢迎大家留下看法或提出您的问题。在接下来的一篇文章中,我将介绍select,hyperlink,label和image控件。
新闻热点
疑难解答
图片精选