当前位置:沸点梦工场 > WAP网页设计 > Asp.net wap开发教程 > 浏览文章

ASP.NET 移动控件--PhoneCall 控件

互联网 2007年06月21日 【字体:

PhoneCall 控件是一种简单、基于文本、只可输出的控件,用于表示要拨叫的电话号码。对于支持拨打电话的设备(例如移动电话),PhoneCall 控件显示为一个交互元素,当被激活时,它将进行拨叫。在其他设备上,电话号码显示为文本,带有可选的超级链接。

移动控件语法
必需的属性、默认值和具有代码特征的元素以粗体显示。

<mobile:PhoneCall
   runat="server"
   id="id"
   Alignment="{NotSet|Left|Center|Right}"
   Font-Name="fontName"
   Font-Size="{NotSet|Normal|Small|Large}"
   Font-Bold="{NotSet|False|True}"
   Font-Italic="{NotSet|False|True}"
   ForeColor="foregroundColor"
   BackColor="backgroundColor"
   StyleReference="styleReference"
   Text="text"
   Wrapping="{NotSet|Wrap|NoWrap}"

   AlternateFormat="alternateText"
   AlternateURL="targetURL"
   PhoneNumber="phoneNumber">
   SoftKeyLabel="softKeyLabel">

innerText
</mobile:PhoneCall>
构造函数
构造函数 说明
PhoneCall 初始化 PhoneCall 类的一个新实例。

属性
Property 说明
(基控件属性) 基移动控件属性中定义的属性。
AlternateFormat PhoneNumber 属性文本值的格式化字符串。这只用于无法从 Web 内容进行电话拨叫的设备。默认值是 {0} {1},其中 {0} 是 Text 属性的值,{1} 是 PhoneNumber 属性的值。
AlternateURL 如果此属性包含一个非 null 的值,则控件将 AlternateFormat 属性中的值呈现为定位点。如果激活该定位点,则控件将浏览到 AlternateURL 属性中指定的 URL。这用于无法从 Web 内容进行电话拨叫的设备。默认值为 null。
PhoneNumber 设置或返回表示电话号码的字符串。(必需)有关您可以在字符串中使用的格式的信息,请参见 PhoneNumber 属性。
SoftKeylabel  设置或返回当命令显示在软键上时用于命令的标签。默认值为 empty 字符串。
Text(从 TextControl 类继承) 指定要为可以进行电话拨叫的设备呈现的控件文本。默认值是电话号码。可以通过 Text 特性来指定 Text 属性,也可以将它用作内部文本。如果用两种方式指定 Text 属性,则内部文本优先。但是,如果以编程方式设置 Text 属性,则会自动移除内部文本,新设置的属性优先。

包容规则
以下控件可以包含 PhoneCall 控件。

控件 说明
System.Web.UI.MobileControls.Form 可以包含任意多个 PhoneCall 控件。
System.Web.UI.MobileControls.Panel 可以包含任意多个 PhoneCall 控件。

PhoneCall 控件不能包含任何其他控件。

设备模板
无。

特定于设备的行为
下表说明 PhoneCall 控件的行为,该行为取决于目标设备从 Web 内容进行电话拨叫的功能。

设备功能 行为描述
具有电话功能的设备 在支持以编程方式进行电话拨叫的设备上,控件的文本显示为命令。调用该命令将拨打电话号码或向用户提供拨打电话号码的多个选项(某些移动电话自动执行后者)。如果未定义文本字段,则使用 PhoneNumber 属性。
这种情况下的呈现行为与指定设备的 Link 控件的行为相同。
 
没有电话功能的设备 在其他设备上,AlternateFormat 属性被视为生成要显示文本的格式化字符串。
PhoneCall 控件根据 AlternateURL 属性的值显示电话号码。如果 AlternateURL 属性包含 null,则 PhoneCall 控件呈现号码的方式与指定设备的 Label 控件相同。如果 AlternateURL 属性包含非 null 的值,则 PhoneCall 控件呈现号码的方式与指定设备的 Link 控件相同。
 

示例
下面的示例包含一个窗体,该窗体上放置有一个 PhoneCall 控件。

[Visual Basic, C#]
<%@ Page Inherits="System.Web.UI.MobileControls.MobilePage"
    Language="C#" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<mobile:Form runat="server">
   <mobile:PhoneCall runat="server"
      AlternateFormat="{0} at {1}"
      AlternateURL="http://www.microsoft.com/china"
      phoneNumber="425-555-0187">Microsoft Corporation
   </mobile:PhoneCall>
</mobile:Form>