作者:Dflying Chen (http://dflying.cnblogs.com/)
註:本系列文章比較基礎,基本為Atlas官方文檔的翻譯,熟悉Atlas的朋友可以跳過。
本系列有三篇文章:
- ASP.NET Atlas簡單控制項介紹——Sys.Component基類與Sys.UI.Control基類
- ASP.NET Atlas簡單控制項介紹——InputControl,TextBox,Button和CheckBox
- ASP.NET Atlas簡單控制項介紹——Label,HyperLink,Select和Image
這篇是其中的第三篇:ASP.NET Atlas簡單控制項介紹——Label,HyperLink,Select和Image
Atlas中的用戶端控制項均繼承或間接繼承於Sys.UI.Control基類(請參考:ASP.NET Atlas簡單控制項介紹——Sys.Component基類與Sys.UI.Control基類),並有所擴充,在上一篇文章(ASP.NET Atlas簡單控制項介紹——InputControl,TextBox,Button和CheckBox)中,我介紹了InputControl,TextBox,Button和CheckBox控制項。本文將繼續介紹Atlas內建的剩下四種簡單控制項:Label,HyperLink,Select和Image。
Sys.UI.Label
Atlas中的Label控制項可以用來顯示一段文字,同時也可以作為一段HTML的預留位置。Label控制項有如下屬性:
- text:擷取或設定Label中的內容。該內容既可以以文本方式顯示或是以HTML方式顯示,取決於htmlEncode屬性的設定。
- htmlEncode:擷取或設定一個布爾值。代表Label中的內容是否以純文字方式顯示,預設值為false。
Sys.UI.HyperLink
HyperLink控制項繼承於Sys.UI.Label,用來封裝HTML中的a元素。HyperLink除了擁有Label的所有屬性以外,還提供如下屬性:
- navigateURL:擷取或設定HyperLink中的導航URL,是對a元素的href屬性的封裝。
如下事件:
- click:在該HyperLink被點擊時觸發。
Sys.UI.Select
Select控制項封裝了DOM元素select,可用來表示一個Drop Down List。Select控制項有如下屬性:
- firstItemText:擷取或設定List中的第一項的文本。可以被設定成諸如“請選擇……”等文本來提示使用者輸入。預設值為空白,即不顯示提示輸入的文字。
- selectedValue:擷取或設定該List中被選中的條目的值。
- data:擷取或設定一個DataTable(關於Atlas用戶端DataTable對象,請參考:Atlas命名空間Sys.Data下控制項介紹——DataColumn,DataRow和DataTable),代表該Select中的資料。
- textProperty:擷取或設定一個String,代表data屬性中的DataTable裡,將作為該Select中條目中的文本顯示的欄位的名稱。
- valueProperty:擷取或設定一個String,代表data屬性中的DataTable裡,將作為該Select中條目中的值的欄位的名稱。
如下事件:
- selectionChanged:在該Select中被選中的條目變化時被引發。
Sys.UI.Image
Image控制項作為對DOM元素img的封裝,提供如下屬性:
- imageURL:擷取或設定一個代表圖片路徑的字串,是對img元素的src屬性的封裝。
- alternateText:擷取或設定一個代表圖片文字說明的字串,是對img元素的alt屬性的封裝。
- width:擷取或設定圖片的寬度。
- height:擷取或設定圖片的高度。