Definition and Usage

The SelectionList control is used to create a list on a mobile device.

Differences between a SelectionList control and a List control:

• A SelectionList control supports multiple item selections and the List control only supports single item selections
• A SelectionList control supports drop-down lists, combo boxes, and radio buttons and the List control only supports common lists
• An item selected from a SelectionList control does not generate a server event
• A SelectionList control does not offer pagination

---

Properties

Property	Value	Description
Alignment	left center right	Optional. How to align the list
BackColor	rgb(x,x,x) #xxxxxx colorname	Optional. A background color for the list
DataMember	dataMember	Optional. Specifies the data member to extract in data binding to a data source
DataTextField	dataTextField	Optional.
DataValueField	dataValueField	Optional.
ForeColor	rgb(x,x,x) #xxxxxx colorname	Optional. A foreground color for the list
Font-Bold	false true	Optional. Specifies whether or not the text in the list should be bold
Font-Italic	false true	Optional. Specifies whether or not the text in the list should be italic
Font-Name	fontname	Optional. Specifies the font name of the text in the list
Font-Size	normal small large	Optional. Specifies the font size of the text in the list
id	unique_name	Optional. A unique id for the control
OnItemDataBind	function_name	Optional. The name of the function to be executed when an item is data bound to a MobileListItem object
OnSelectedIndexChanged	function_name	Optional. The name of the function to be executed when the index of the selected item has changed
Rows	rows	Optional. Specifies the number of rows to display. Default is "4"
runat	"server"	Required. Specifies that the control is a server control
SelectType	DropDown ListBox Radio MultiSelectListBox CheckBox	Optional. Specifies the type of list to display. "DropDown" is default.
StyleReference	name_of_style_element	Optional. Specifies a reference to a style to be applied to the control
Title	text	Optional. Specifies a title to display. Only for WML devices
Wrapping	wrap nowrap	Optional. Specifies whether or not the text in the list should wrap

Example 1

The following example is an .aspx page with two forms. The first form has a list of cars. The second form is activated when a car is selected in the first form, and it displays the price of the selected car:

<%@ Page Inherits="System.Web.UI.MobileControls.MobilePage"%> <%@ Register TagPrefix="Mobile" Namespace="System.Web.UI.MobileControls" Assembly="System.Web.Mobile" %> <script runat="server"> Sub Car_Click(sender as Object, e as EventArgs) ActiveForm=f2 t1.text=cars.Selection.Value End Sub </script> <Mobile:Form id="f1" runat="server">   <Mobile:SelectionList runat="server" id="cars" >     <Item Text="Volvo" Value="$30,000" />     <Item Text="BMW" Value="$32,000" />     <Item Text="Audi" Value="$34,000" />   </Mobile:SelectionList>   <Mobile:Command runat="server"   OnClick="Car_Click" Text="Submit" /> </Mobile:Form> <Mobile:Form id="f2" runat="server">   <Mobile:Label id="t1" runat="server" /> </Mobile:Form>

When this page is displayed on a mobile device, the navigation and display functions of the page will be compiled differently for different devices with different display characteristics.

Fore some devices, like a handheld PC, it might display a dropdown list to choose from. For a cell phone it might display a list of options to select from.

评论 (0) All

登陆 | 还没注册？