SelectionList Control

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.

Jump to: Top of Page or HOME or Printer friendly page

Search W3Schools:

What Others Say About Us

Does the world know about us? Check out these places:

Dogpile Alta Vista MSN Google Excite Lycos Yahoo Ask Jeeves

We Help You For Free. You Can Help Us!

W3Schools is for training only. We do not warrant its correctness or its fitness for use. The risk of using it remains entirely with the user. While using this site, you agree to have read and accepted our terms of use and privacy policy.

How we converted to XHTML

Password Protect
Your Web Pages

Your own Web Site?

Read W3Schools
Hosting Tutorial

$15 Domain Name
Registration
Save $20 / year!

Advertise
at W3Schools

Only 0.5 CPM

SELECTED LINKS

University Online
Master Degree
Bachelor Degree

Web Software

The Future of
Web Development

Jobs and Careers

Web Security
Web Statistics
Web Standards

PARTNERS

W3Schools
TopXML
VisualBuilder
XMLPitstop
DevelopersDex
DevGuru
Programmers Heaven
The Code Project
Tek Tips Forum
ZVON.ORG
TopXML Search