Version

Configuring xamOutlookCalendarView

This is one of the five topics explaining the views of the xamSchedule controls:

This topic is organized in sections as follows:

  • Introduction

  • Purpose

  • xamOutlookCalendarView Configuration Options

    • Control specific settings

    • Replicated Settings

  • Related Topics

Introduction

The xamOutllokCalendarDayView is designed to combine the xamDayView, xamScheduleView and xamMonthView all in one easy-to-use shell. In order to simplify the use of the control, the properties of the underlying views are replicated on the xamOutlookCalendarView which is responsible for passing the values to the appropriate View controls. (Figure 1)

xamOutlookCalendar IGView.png
Figure 1: Example of the xamOutlookCalendarView control

Purpose

The purpose of this view is to provide a control that combines the xamDayView, xamScheduleView and xamMonthView all in one easy-to-use shell

xamOutlookCalendarView Configuration Options

Control specific settings

  • ViewModes

    The view mode is controlled by the CurrentViewMode property. It returns or sets the current view which indicates which control and the settings of the control to be displayed. Available values include:

    • DayViewDay – Shows a xamDayView control displaying one or more days. If the previous value was DayViewWeek or DayViewWorkWeek the visible days count will not change. If the previous view was different - one day will be shown.

    • DayViewWeek – Shows a xamDayView control displaying a full week.

    • DayViewWorkWeek – Shows a xamDayView control displaying the work week.

    • MonthView – Shows a xamMonthView control.

    • ScheduleViewDay – Shows a xamSchedleView control displaying one or more days. If the previous value was ScheduleViewWeek or ScheduleViewWorkWeek the visible days count will not change. If the previous view was different - one day will be shown.

    • ScheduleViewWeek – Shows a xamScheduleView control displaying a full week.

    • ScheduleViewWorkWeek – Shows a xamScheduleView control displaying the work week.

  • Header Area

    The header area consists of two navigation buttons and a date range. The visibility of the header is set by the HeaderVisibility property. Text from the date range is available by accessing the read-only CurrentViewDateRangeText property.

  • Date Navigation

    The xamOutlookCalendarView allows users to navigate using the header area navigation buttons. For richer user experience the control exposes the DateNavigator property. This property allows the you to set a xamDateNavigator instance to use in conjunction with xamOutlookCalendarView to use the built-in automatic synchronization between the controls.

Replicated Settings

There are many properties common to all view controls. The XamOutlookCalendarView control replicates these properties in order to simplify the use of the control. This API approach allows you to change the type of the view you are using with minimum effort. Here are some of the common properties:

Other properties are specific only for Day and Schedule views:

For more detailed information on these properties please refer to the documentation of the xamSchedule View that the property is replicated from.