Label, contrôle

Article
04/11/2008

Crée un contrôle à base de texte, qui affiche un texte de sortie uniquement sur un périphérique mobile. Le texte d'une étiquette peut être spécifié soit via l'attribut Text, soit sous la forme du contenu de l'élément <Label>. Si l'attribut Text est spécifié des deux façons, le texte interne a toujours la priorité. Cependant, si l'attribut Text est défini par programme, le texte interne est automatiquement supprimé ; en outre, la propriété nouvellement définie à la priorité.

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:Labelrunat="server"
   id="id"
   Font-Name="fontName"
   Font-Size="{NotSet|Normal|Small|Large}"
   Font-Bold="{NotSet|False|True}"
   Font-Italic="{NotSet|False|True}"
   ForeColor="foregroundColor"
   BackColor="backgroundColor"
   Alignment="{NotSet|Left|Center|Right}"
   StyleReference="styleReference"
   Text="Text"
   Wrapping="{NotSet|Wrap|NoWrap}">
innerText
</mobile:Label>

Règles relatives à la relation contenant-contenu

Les règles de la relation contenant-contenu pour toutes les classes concrètes dérivées de la classe TextControl sont identiques. Les contrôles suivants peuvent contenir un contrôle Label.

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

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

Modèles de périphériques

Aucun.

Comportement spécifique au périphérique

Le style de rendu d'une étiquette diffère selon le périphérique ; toutefois, le texte de l'étiquette s'affiche sur tous les périphériques. L'étiquette est rendue de la même façon en langages HTML et WML.

Le contrôle affiche le texte de l'étiquette sur sa propre ligne, en appliquant les attributs de style appropriés. Une balise <br> (saut de ligne) suit l'étiquette. Si vous ajoutez deux étiquettes à la suite sur un formulaire, les sauts de ligne obligeront les étiquettes à être rendues sous forme de colonne verticale.

Pour plus d'informations sur la façon dont les différents attributs de style sont interprétés sur les divers périphériques, consultez Rendu spécifique au périphérique.

Exemple

L'exemple suivant utilise deux étiquettes, une sur chaque contrôle Form. La première étiquette n'est pas modifiée et, par conséquent, ne requiert pas d'attribut ID. La seconde étiquette a la valeur de l'attribut ID de WelcomeMessage ; par ailleurs, le gestionnaire d'événements Button_OnClick active son formulaire.

<%@ Page Inherits=
   "System.Web.UI.MobileControls.MobilePage" Language="VB" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<script language="vb" runat="server">
protected Sub Submit_Click(sender as Object, e as EventArgs) 
   WelcomeMessage.Text = "Welcome to my app, " + NameEdit.Text
   ActiveForm = Form2
End Sub
</script>

<mobile:Form runat="server">
  <mobile:Label runat="server">Enter your name</mobile:Label>
  <mobile:TextBox runat="server" id="NameEdit" />
  <mobile:Command runat="server" id="Submit" OnClick="Submit_Click">
      OK
  </mobile:Command>
</mobile:Form>

<mobile:Form runat="server" id="Form2">
  <mobile:Label runat="server" id="WelcomeMessage" />
</mobile:Form>
[C#]
<%@ Page Inherits=
   "System.Web.UI.MobileControls.MobilePage" Language="C#" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<script language="c#" runat="server">
protected void Submit_Click(Object sender, EventArgs e) 
{
   WelcomeMessage.Text = "Welcome to my app, " + NameEdit.Text;
   ActiveForm = Form2;
}
</script>

<mobile:Form runat="server">
  <mobile:Label runat="server">Enter your name</mobile:Label>
  <mobile:TextBox runat="server" id="NameEdit" />
  <mobile:Command runat="server" id="Submit" OnClick="Submit_Click">
      OK
  </mobile:Command>
</mobile:Form>

<mobile:Form runat="server" id="Form2">
  <mobile:Label runat="server" id="WelcomeMessage" />
</mobile:Form>

Voir aussi

Label, classe | Label, membres de classe | Guide de référence des contrôles

Partager via