Calendar, contrôle

Article
10/11/2017

Le contrôle Calendar affiche un calendrier dans lequel les utilisateurs peuvent naviguer pour atteindre n’importe quel jour de n’importe quelle année. Lorsque la page ASP.NET s’exécute, le contrôle Calendar s’affiche sous forme de tableau HTML. Un certain nombre de ses propriétés définissent donc différents aspects de mise en forme de ce tableau. Ces propriétés n'étant pas toutes totalement prises en charge par certaines anciennes versions de navigateurs, toutes les fonctionnalités de mise en forme correspondantes ne sont donc pas disponibles dans ces navigateurs.

Le contrôle Calendar est un contrôle assez complexe et possède de nombreuses options de programmation et de mise en forme. Pour plus d’informations sur l’utilisation du contrôle Calendar , voir Contrôle serveur Web Calendar (Visual Studio) Cc295478.xtlink_newWindow(fr-fr,Expression.40).png dans MSDN Library.

Pour ajouter un contrôle Calendar à une page

Faites glisser le contrôle Calendar du panneau Boîte à outils sur votre page.

Appliquer des mises en forme de base au contrôle Calendar

En mode Création, cliquez avec le bouton droit sur le contrôle Calendar , puis cliquez sur Afficher les tâches de contrôle courantes.

Conseil :
Vous pouvez également cliquer sur le contrôle Calendar en mode Création, puis cliquer sur la flèche dans le coin supérieur droit pour afficher le menu Tâches courantes du contrôle Calendar. Cliquez de nouveau sur la flèche pour masquer le menu.

Dans le menu Tâches courantes du contrôle Calendar, cliquez sur Format automatique.
Dans la boîte de dialogue Format automatique, sélectionnez un mode dans la liste Sélectionner un mode. L’effet de votre mode sur le contrôle Calendar est affiché dans la zone Aperçu.
Cliquez sur OK pour appliquer le mode de mise en forme et fermer la boîte de dialogue ou sur Appliquer pour appliquer le mode de mise en forme sans fermer la boîte de dialogue.

Pour définir d’autres propriétés qui déterminent l’apparence et le comportement du contrôle Calendar , utilisez le panneau Propriétés de la balise.

Pour utiliser le panneau Propriétés de la balise afin de définir les propriétés de Calendar

Cliquez avec le bouton droit sur le contrôle Calendar en mode Création et cliquez sur Propriétés dans le menu contextuel.
Entrez les valeurs de la propriété ou sélectionnez-les dans les listes déroulantes où elles sont disponibles.

Pour une description complète de toutes les propriétés du contrôle Calendar , voir Propriétés Calendar Cc295478.xtlink_newWindow(fr-fr,Expression.40).png dans MSDN Library.

Fonctionnalités du calendrier

Vous pouvez définir des propriétés pour spécifier la façon dont les utilisateurs peuvent interagir avec le contrôle Calendar .

Propriétés communes des fonctionnalités du calendrier

Propriétés	Description
SelectedDate	Une date spécifique est mise en valeur dans le contrôle.
ShowNextPrevMonth	Active ou désactive la navigation entre les mois. Par défaut, le calendrier affiche le mois contenant la date du jour. Les utilisateurs peuvent naviguer entre les mois dans le contrôle Calendar en cliquant sur les liens de navigation entre les mois dans la barre de titre du calendrier. Si la valeur false est attribuée à la propriété, le contrôle n'affiche pas dans le titre les contrôles qui permettent à l'utilisateur de se déplacer de mois en mois.
SelectionMode	Affectez l’une des valeurs définies dans l’énumération SelectionMode à cette propriété : Day , DayWeek ou DayWeekMonth pour spécifier ce qu’un utilisateur peut sélectionner. Pour désactiver toutes les sélections de date, affectez la valeur Aucun à la propriété. Pour permettre à l'utilisateur de sélectionner une date, le calendrier est affiché avec des liens. Chaque jour contient un lien vers le numéro de date. Si vous définissez le calendrier de sorte que l’utilisateur puisse y sélectionner une semaine ou le mois tout entier, une colonne supplémentaire contenant des liens de sélection est ajoutée à sa gauche.
VisibleDate	Cette date détermine le mois affiché par le calendrier. L’utilisateur peut passer de mois en mois dans le calendrier et ainsi modifier la date visible sans affecter celle du jour. Vous pouvez naviguer d'un mois à l'autre en définissant par programme la date visible.

Modification de l'apparence générale du calendrier

Étant donné que le contrôle Calendar est un contrôle complexe constitué de nombreux éléments, il propose une grande variété d’options de personnalisation.

Le contrôle Calendar définit un aspect par défaut pour le calendrier sur la page, mais vous pouvez modifier l’apparence globale du calendrier. Si vous définissez les propriétés d’apparence de certains éléments du calendrier (date du jour, date sélectionnée, etc.), chacun de ces paramètres est basé sur les paramètres par défaut choisis pour le calendrier dans son entier.

Propriétés d’apparence communes du calendrier

Propriétés	Description
Font , ForeColor , BackColor	Modifier la police, la couleur du texte et d'arrière-plan.
Height, Width	Modifier la taille globale du contrôle.
NextMonthText , PrevMonthText , NextPrevFormat , NextPrevStyle	Modifier l'apparence des liens hypertexte de navigation entre les mois.
CellPadding , CellSpacing	Modifier les marges et l’espacement entre les jours.
FirstDayOfWeek	Spécifier le premier jour de la semaine (dimanche est sélectionné par défaut).
DayStyle	Définir le style des jours du mois en cours. Les week-ends, le jour actuel et le jour sélectionné peuvent avoir des styles différents.
DayHeaderStyle	Définir le style de la rangée au-dessus du calendrier où les noms des jours apparaissent.
NextPrevStyle	Définir le style des sections situées aux extrémités gauche et droite de la barre de titre et où se trouvent les contrôles LinkButtons de navigation entre les mois.
OtherMonthDayStyle	Définir le style des jours du mois précédent et du mois suivant qui apparaissent dans la vue du mois en cours.
SelectedDayStyle	Définir le style du jour sélectionné par l'utilisateur.
SelectorStyle	Définir le style de la colonne de gauche contenant des liens pour la sélection d'une semaine ou de tout le mois.
TitleStyle	Définir le style de la barre de titre située en haut du calendrier et contenant le nom du mois et les liens de navigation entre les mois. Si l’élément NextPrevStyle est défini, il remplace les extrémités de la barre de titre.
TodayDayStyle	Spécifier le style de la date du jour.
WeekendDayStyle	Définir le style des jours de la semaine.

Pour plus d’informations sur le contrôle Calendar , voir Vue d’ensemble du contrôle serveur Web Calendar Cc295478.xtlink_newWindow(fr-fr,Expression.40).png dans MSDN Library.