Controllo PhoneCall

Articolo
04/11/2008

Il controllo PhoneCall è un controllo semplice, di solo output e basato su testo utilizzato per rappresentare un numero telefonico da chiamare. Per i dispositivi che supportano le chiamate telefoniche, ad esempio i telefoni cellulari, il controllo PhoneCall si presenta come un elemento interattivo che, se attivato, effettua una chiamata. Su altri dispositivi il numero telefonico viene visualizzato come testo con un collegamento ipertestuale facoltativo.

Sintassi dei controlli mobili

Le proprietà necessarie, le impostazioni predefinite e gli elementi dalle funzionalità di codice sono in grassetto.

<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>

Costruttori

Costruttore	Descrizione
PhoneCall	Inizializza una nuova istanza della classe PhoneCall.

Proprietà

Proprietà	Descrizione
Proprietà di base dei controlli	Le proprietà definite in Proprietà di base dei controlli mobili.
AlternateFormat	Stringa di formattazione per il valore di testo della proprietà PhoneNumber. Viene utilizzata soltanto per i dispositivi che non sono in grado di avviare chiamate telefoniche dal contenuto Web. Il valore predefinito è {0} {1} dove {0} è il valore della proprietà Text e {1} è il valore della proprietà PhoneNumber.
AlternateURL	Quando questa proprietà presenta un valore diverso da null, il controllo esegue il rendering del valore nella proprietà AlternateFormat come un punto di ancoraggio. Se il punto di ancoraggio è attivato, il controllo passerà all'URL specificato nella proprietà AlternateURL. Viene utilizzata per i dispositivi che non sono in grado di avviare chiamate telefoniche dal contenuto Web. Il valore predefinito è null.
PhoneNumber	Imposta o restituisce una stringa che rappresenta un numero telefonico (obbligatoria). Per ulteriori informazioni sui formati che è possibile utilizzare nella stringa, vedere la proprietà PhoneNumber.
SoftKeylabel	Imposta o restituisce un'etichetta utilizzata per il comando visualizzato su un tasto softkey. Il valore predefinito è una stringa vuota.
Text (ereditata dalla classe TextControl)	Specifica il testo per un controllo di cui eseguire il rendering per dispositivi in grado di avviare chiamate telefoniche. Il valore predefinito è Phone Number. È possibile specificare la proprietà Text tramite l'attributo Text o come testo interno. Se la proprietà Text viene specificata in entrambi i modi, il testo interno avrà la precedenza. Tuttavia, se la proprietà Text viene impostata a livello di codice, il testo interno verrà automaticamente rimosso e la proprietà appena impostata avrà la precedenza.

Regole di contenimento

I controlli descritti di seguito possono contenere un controllo PhoneCall.

Controllo	Commenti
System.Web.UI.MobileControls.Form	Può contenere un numero indefinito di controlli PhoneCall.
System.Web.UI.MobileControls.Panel	Può contenere un numero indefinito di controlli PhoneCall.

Nel controllo PhoneCall non possono essere contenuti altri controlli.

Modelli di dispositivo

Nessuno.

Comportamento specifico del dispositivo

Nella tabella riportata di seguito viene descritto il comportamento del controllo PhoneCall che dipende dalle funzionalità di telefonia del dispositivo di destinazione, ovvero se il dispositivo di destinazione è in grado di avviare chiamate telefoniche dal contenuto Web.

Funzionalità del dispositivo	Descrizione del comportamento
Dispositivi con funzionalità di telefonia	Su dispositivi che supportano le chiamate telefoniche a livello di codice, il testo del controllo viene visualizzato come un comando. Richiamando il comando viene composto il numero telefonico oppure vengono rese disponibili per l'utente una serie di opzioni per la composizione del numero. Da alcuni telefoni cellulari viene automaticamente effettuata la seconda operazione. Se il campo di testo non è definito, verrà utilizzata la proprietà PhoneNumber. In questo caso il comportamento del rendering è identico a quello di un controllo Link per il dispositivo specificato.
Dispositivi senza funzionalità di telefonia	Su altri dispositivi la proprietà AlternateFormat viene interpretata come una stringa di formattazione che genera il testo da visualizzare. Il controllo PhoneCall consente di visualizzare il numero telefonico in base al valore della proprietà AlternateURL. Se nella proprietà AlternateURL è presente un valore null, il controllo PhoneCall eseguirà il rendering del numero nello stesso modo in cui lo eseguirà il controllo Label per il dispositivo specificato. Se nella proprietà AlternateURL è presente un valore diverso da null, il controllo PhoneCall eseguirà il rendering del numero nello stesso modo in cui lo eseguirà il controllo Link per il dispositivo specificato.

Dispositivi con funzionalità di telefonia

Su dispositivi che supportano le chiamate telefoniche a livello di codice, il testo del controllo viene visualizzato come un comando. Richiamando il comando viene composto il numero telefonico oppure vengono rese disponibili per l'utente una serie di opzioni per la composizione del numero. Da alcuni telefoni cellulari viene automaticamente effettuata la seconda operazione. Se il campo di testo non è definito, verrà utilizzata la proprietà PhoneNumber.

In questo caso il comportamento del rendering è identico a quello di un controllo Link per il dispositivo specificato.

Dispositivi senza funzionalità di telefonia

Su altri dispositivi la proprietà AlternateFormat viene interpretata come una stringa di formattazione che genera il testo da visualizzare.

Il controllo PhoneCall consente di visualizzare il numero telefonico in base al valore della proprietà AlternateURL. Se nella proprietà AlternateURL è presente un valore null, il controllo PhoneCall eseguirà il rendering del numero nello stesso modo in cui lo eseguirà il controllo Label per il dispositivo specificato. Se nella proprietà AlternateURL è presente un valore diverso da null, il controllo PhoneCall eseguirà il rendering del numero nello stesso modo in cui lo eseguirà il controllo Link per il dispositivo specificato.

Esempio

Di seguito viene ripotato l'esempio di un form singolo su cui è presente un unico controllo 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>

Vedere anche

Riferimenti ai controlli | Classe PhoneCall | Membri della classe PhoneCall | Proprietà PhoneNumber