PhoneCall 控制項是以文字為基礎而只供輸出的簡易控制項，可用來表示要呼叫的電話號碼。對於支援撥打電話的裝置 (例如行動電話)，PhoneCall 控制項可提供做為啟動時即撥號的互動項目。在其他裝置上，電話號碼會顯示為文字，並附帶選擇性的超連結。
行動控制項語法
需要的屬性和具程式碼功能的項目以粗體樣式標註。
<mobile:PhoneCallrunat="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 屬性 (Property) 之文字值的格式字串。這僅用於無法從 Web 內容啟始電話撥號的裝置。預設值為 {0} {1}，其中 {0} 是 Text 屬性 (Property) 的值，而 {1} 是 PhoneNumber 屬性 (Property) 的值。 |
| AlternateURL | 當這個屬性 (Property) 包含 null 以外的值時，控制項會將 AlternateFormat 屬性 (Property) 中的值呈現為錨點。如果啟動這個錨點，控制項會瀏覽至 AlternateURL 屬性 (Property) 中指定的 URL。這是用於無法從 Web 內容啟始電話撥號的裝置。預設值是 null。 |
| PhoneNumber | 設定或傳回表示電話號碼的字串 (必要項)。如需可以在字串中使用的格式的詳細資訊，請參閱 PhoneNumber 屬性 (Property)。 |
| SoftKeylabel | 設定或傳回其顯示在螢幕小鍵盤時命令所使用的標籤。預設值是空的 String。 |
| Text (繼承自 TextControl 類別) | 指定所要呈現的控制項文字給可以啟始電話撥號的裝置。預設值是 Phone Number。Text 屬性 (Property) 可以經由使用 Text 屬性 (Attribute)，或做為內部文字而加以指定。如果 Text 屬性 (Property) 可用兩種方式指定，則永遠以內部文字為優先。然而，如果 Text 屬性以程式方式設定，則內部文字會自動移除並以新設定的屬性為優先。 |
內含項目規則
下列控制項可以包含 PhoneCall 控制項。
| 控制項 | 註解 |
|---|---|
| System.Web.UI.MobileControls.Form | 可以包含任何數目的 PhoneCall 控制項。 |
| System.Web.UI.MobileControls.Panel | 可以包含任何數目的 PhoneCall 控制項。 |
PhoneCall 控制項不可以包含任何其他控制項。
裝置樣板
無
裝置的特定行為
下列表格描述 PhoneCall 控制項的行為，這端視目標裝置從 Web 內容啟始電話撥號的能力而定。
| 裝置能力 | 行為描述 |
|---|---|
| 具有電話功能的裝置 | 在支援以程式設計的方式撥打電話的裝置上，控制項的文字將顯示為命令。叫用該命令即會撥打電話號碼或提供使用者幾個撥號的選項 (有些行動電話自動執行後者)。如果文字欄位沒有定義，則會使用 PhoneNumber 屬性 (Property)。
這個狀況下的呈現行為與指定裝置的 Link 控制項完全相同。 |
| 沒有電話功能的裝置 | 在其他裝置上，AlternateFormat 屬性 (Property) 被視為產生顯示文字的格式字串。
PhoneCall 控制項會根據 AlternateURL 屬性 (Property) 值顯示電話號碼。當 AlternateURL 屬性 (Property) 包含 null 時，PhoneCall 控制項會使用與指定裝置之 Label 控制項相同的方式呈現數字。當 AlternateURL 屬性 (Property) 包含 null 以外的值時，PhoneCall 控制項會使用與指定裝置之 Link 控制項相同的方式呈現數字。 |
範例
下列範例包含具有單一 PhoneCall 控制項放置其上的單一表單。
<%@ 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="https://www.microsoft.com"
phoneNumber="425-555-0187">Microsoft Corporation
</mobile:PhoneCall>
</mobile:Form>