PhoneCall, contrôle

Article
04/11/2008

Le contrôle PhoneCall est un contrôle à base de texte, de sortie uniquement, facile à utiliser et qui permet de représenter un numéro de téléphone à appeler. Sur les périphériques qui prennent en charge l'exécution d'appels téléphoniques, par exemple les téléphones portables, le contrôle PhoneCall est présenté sous la forme d'un élément interactif, qui une fois activé, compose un numéro. Sur d'autres périphériques, le numéro de téléphone s'affiche sous forme de texte avec un lien facultatif.

Syntaxe des contrôles mobiles

Les propriétés, valeurs par défaut et éléments de code requis sont indiqués en caractères gras.

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

Constructeurs

Constructeur	Description
PhoneCall, constructeur	Initialise une nouvelle instance de la classe PhoneCall.

Propriétés

Propriété	Description
(Propriétés de base des contrôles)	Propriétés définies dans Propriétés de base des contrôles mobiles.
AlternateFormat, propriété	Chaîne de mise en forme de la valeur texte de la propriété PhoneNumber. Elle est utilisée uniquement pour les périphériques qui ne peuvent pas effectuer d'appels téléphoniques à partir d'un contenu Web. La valeur par défaut est {0} {1}, où {0} représente la valeur de la propriété Text, et {1} la valeur de la propriété PhoneNumber.
AlternateUrl, propriété	Lorsque cette propriété contient une valeur autre que null, le contrôle l'affiche dans la propriété AlternateFormat sous la forme d'une ancre. Si l'ancre est activée, le contrôle recherche l'URL spécifiée dans la propriété AlternateURL. Elle est utilisée pour les périphériques qui ne peuvent pas effectuer d'appels téléphoniques à partir d'un contenu Web. La valeur par défaut est null.
PhoneNumber, propriété	Définit ou retourne une chaîne qui représente un numéro de téléphone (obligatoire). Pour plus d'informations sur les formats utilisables dans la chaîne, consultez la propriété PhoneNumber.
SoftkeyLabel, propriété (PhoneCall)	Définit ou retourne l'étiquette utilisée pour la commande lorsqu'elle s'affiche sur une softkey. La valeur par défaut est une chaîne vide.
Text, propriété (héritée de TextControl, classe)	Spécifie le texte d'un contrôle à afficher sur les périphériques pouvant effectuer des appels téléphoniques. La valeur par défaut est Phone Number. La propriété Text peut être spécifiée via l'attribut Text ou sous forme de texte interne. Si la propriété Text est spécifiée des deux façons, le texte interne a la priorité. Cependant, si la propriété Text est définie par programme, le texte interne est automatiquement supprimé ; en outre, la propriété nouvellement définie à la priorité.

Règles relatives à la relation contenant-contenu

Les contrôles suivants peuvent contenir un contrôle PhoneCall.

Contrôle	Commentaires
System.Web.UI.MobileControls.Form	Peut contenir n'importe quel nombre de contrôles PhoneCall.
System.Web.UI.MobileControls.Panel	Peut contenir n'importe quel nombre de contrôles PhoneCall.

Le contrôle PhoneCall ne peut pas contenir d'autres contrôles.

Modèles de périphériques

Aucun.

Comportement spécifique au périphérique

Le tableau suivant décrit le comportement du contrôle PhoneCall, qui dépend de la capacité du périphérique cible à effectuer des appels téléphoniques à partir d'un contenu Web.

Fonctionnalité du périphérique	Description du comportement
Périphériques avec fonctionnalité de téléphonie	Sur les périphériques qui prennent en charge l'exécution d'appels téléphoniques par programme, le texte du contrôle s'affiche sous la forme d'une commande. L'appel de cette commande déclenche la composition du numéro de téléphone ou la présentation à l'utilisateur d'un certain nombre d'options de numérotation (certains téléphones portables l'effectuent automatiquement). Si le champ de texte n'est pas défini, la propriété PhoneNumber est utilisée. Dans ce cas, le type de rendu est identique à celui d'un contrôle Link sur le périphérique spécifié.
Périphériques sans fonctionnalité de téléphonie	Sur les autres périphériques, la propriété AlternateFormat est considérée comme une chaîne de mise en forme qui génère le texte à afficher. Le contrôle PhoneCall affiche le numéro de téléphone en fonction de la valeur de la propriété AlternateURL. Lorsque la propriété AlternateURL a la valeur null, le contrôle PhoneCall affiche le numéro de la même façon que le contrôle Label pour le périphérique spécifié. Lorsque la propriété AlternateURL contient une valeur autre que null, le contrôle PhoneCall affiche le numéro de la même façon que le contrôle Link pour le périphérique spécifié.

Périphériques avec fonctionnalité de téléphonie

Sur les périphériques qui prennent en charge l'exécution d'appels téléphoniques par programme, le texte du contrôle s'affiche sous la forme d'une commande. L'appel de cette commande déclenche la composition du numéro de téléphone ou la présentation à l'utilisateur d'un certain nombre d'options de numérotation (certains téléphones portables l'effectuent automatiquement). Si le champ de texte n'est pas défini, la propriété PhoneNumber est utilisée.

Dans ce cas, le type de rendu est identique à celui d'un contrôle Link sur le périphérique spécifié.

Périphériques sans fonctionnalité de téléphonie

Sur les autres périphériques, la propriété AlternateFormat est considérée comme une chaîne de mise en forme qui génère le texte à afficher.

Le contrôle PhoneCall affiche le numéro de téléphone en fonction de la valeur de la propriété AlternateURL. Lorsque la propriété AlternateURL a la valeur null, le contrôle PhoneCall affiche le numéro de la même façon que le contrôle Label pour le périphérique spécifié. Lorsque la propriété AlternateURL contient une valeur autre que null, le contrôle PhoneCall affiche le numéro de la même façon que le contrôle Link pour le périphérique spécifié.

Exemple

L'exemple suivant contient un formulaire unique qui possède un seul contrôle 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>

Voir aussi

Guide de référence des contrôles | PhoneCall, classe | PhoneCall, membres de classe | PhoneNumber, propriété

Partager via