Controllo Calendar

Articolo
04/11/2008

Il controllo Calendar presenta la medesima funzionalità di selezione della data del controllo mobile ASP.NET Calendar, ma viene visualizzato su dispositivi mobili.

Se un utente seleziona una data, visualizza un'altra pagina, quindi ritorna alla pagina con il controllo Calendar, non potrà disporre di alcun elemento che consenta di conoscere la data selezionata. L'utilizzabilità viene migliorata se sulla pagina è visualizzata una data, come mostrato nell'esempio.

Sintassi dei controlli mobili

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

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

Regole di contenimento

I controlli descritti di seguito possono contenere un controllo Calendar.

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

Nel controllo Calendar non possono essere contenuti altri controlli.

Modelli di dispositivo

Nessuno.

Comportamento specifico del dispositivo

Utilizzare il controllo Calendar per richiedere la selezione di una data da parte dell'utente e per rendere disponibile la data selezionata nell'applicazione che la contiene.

Linguaggio del dispositivo	Descrizione del comportamento
HTML	Sebbene il controllo mobile Calendar sia analogo a molte delle proprietà del controllo Web Form della Classe Calendar, non espone queste proprietà specifiche del rendering HTML. Per utilizzare queste proprietà Web Form, accedere al controllo Web Form Calendar sottostante e modificare in modo esplicito queste impostazioni utilizzando la proprietà WebCalendar.
WML	Il controllo Calendar fornisce all'utente un insieme di opzioni per la selezione della data. Una di queste opzioni consente all'utente di digitare direttamente la data, altre, invece, consentono all'utente di selezionare una data mediante una serie di schermate di input.

Esempio

Nell'esempio riportato di seguito viene creato un controllo Calendar che richiede l'immissione di una data da parte dell'utente al quale, successivamente, restituirà la data selezionata.

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

Vedere anche

Classe Calendar | Membri della classe Calendar | Riferimenti ai controlli