ASP.NET Mobile SelectionList Control
 Complete ASP.NET Mobile Reference
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.
Complete ASP.NET Mobile Reference
 |
|
|
See why there are 20,000+ Ektron integrations worldwide.
Request an INSTANT DEMO or download a FREE TRIAL today. |
|
|
|
