Calendar, contrôle

Article
04/11/2008

Le contrôle Calendar offre une fonctionnalité de choix de date similaire au contrôle mobile ASP.NET Calendar ; toutefois, il s'affiche sur les périphériques mobiles.

Si un utilisateur sélectionne une date, va sur une autre page, puis revient sur la page contenant le contrôle Calendar, l'utilisateur n'a pas d'indication sur la date sélectionnée. L'utilisation du contrôle est plus évidente si la page affiche une date, comme le montre l'exemple.

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:Calendarrunat="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}"
   Wrapping="{NotSet|Wrap|NoWrap}"
   BreakAfter="{True|False}"
   EnableViewState="{True|False}"
   StyleReference="styleReference"
   Visible="{True|False}"

   CalendarEntryText="calendarEntryText"
   FirstDayOfWeek="{Default|Sunday|Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday}"
   OnSelectionChanged="selectionChangedHandler"
   SelectedDate="selectedDate"
   SelectionMode="{None|Day|DayWeek|DayWeekMonth}"
   ShowDayHeader="{True|False}"
   VisibleDate="visibleDateMonth"
/>

Règles relatives à la relation contenant-contenu

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

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

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

Modèles de périphériques

Aucun.

Comportement spécifique au périphérique

Utilisez le contrôle Calendar pour demander à l'utilisateur de sélectionner une date, de telle sorte que celle-ci soit disponible dans l'application qui la contient.

Langage du périphérique	Description du comportement
HTML	Bien que le contrôle mobile Calendar reproduise de nombreuses propriétés du contrôle Web Forms de Calendar, il n'expose pas les propriétés spécifiques au rendu HTML. Pour pouvoir utiliser ces propriétés Web Forms, accédez au contrôle Web Forms Calendar sous-jacent et modifiez explicitement les paramètres via la propriété WebCalendar.
WML	Le contrôle Calendar propose à l'utilisateur un ensemble de possibilités pour le choix de la date. L'une des options proposées consiste pour l'utilisateur à taper directement la date, alors que les autres options l'amènent à sélectionner une date via une série d'écrans d'entrée.

Exemple

L'exemple suivant crée un contrôle Calendar qui demande à l'utilisateur d'entrer une date, laquelle lui est ensuite renvoyée.

<%@ 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 Calendar_SelectionChanged(sender As Object, e As EventArgs)
   DateLabel.Text = "The date you selected is " + _
      Cal.SelectedDate
   ActiveForm = Form2
End Sub
</script>

<mobile:Form id="Form1" runat="server">
   <mobile:Calendar id="Cal" 
      OnSelectionChanged="Calendar_SelectionChanged" 
      runat="server"/>
</mobile:Form>

<mobile:Form id="Form2" runat="server">
   <mobile:Label id="DateLabel" runat="server"/>
</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 Calendar_SelectionChanged(Object sender, EventArgs e)
{
   Date.Text = "The date you selected is " + 
      Cal.SelectedDate;
   ActiveForm = Form2;
}
</script>

<mobile:Form id="Form1" runat="server">
   <mobile:Calendar id="Cal" 
      OnSelectionChanged="Calendar_SelectionChanged" 
      runat="server"/>
</mobile:Form>

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

Voir aussi

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

Partager via