'Declaration Public Property DateNavigator As IOutlookDateNavigator
public IOutlookDateNavigator DateNavigator {get; set;}
The DateNavigator is similar to that of the Date Navigator within Outlook. As the user interacts with that calendar selecting days, the Calendar View of outlook changes accordingly to show those dates and change its view as needed. Similarly as the end user changes or navigates through the Calendar View, the selected dates in the DateNavigator are updated accordingly.
While one may provide their own implementation for the IOutlookDateNavigator interface, the most common scenario will be to use a XamDateNavigator which implements this interface. One would put an instance of that control in their UI and then bind this property to that element (e.g. using a Binding with the ElementName set).
The xamOutlookCalendarView will listen to the IOutlookDateNavigator.SelectedDatesChanged of the DateNavigator and will update its UI based upon the changes. For example, when the dates that make up a specific week are selected, the control will change its CurrentViewMode to one of the WeekMode views (e.g. DayViewWeekMode or ScheduleViewWeekMode) depending upon the current value of this property. Similarly as the state of the control changes (e.g. the CurrentViewMode is set - directly or implicitly via the keyboard interactions or commands) or as the user navigates the view to other dates, the control will notify the DateNavigator of the changes so that it may update its information so the two controls may be in sync.
Note: The XamOutlookCalendarView does not attempt to contain or reparent the object that is set as the value of the DateNavigator property. If this interface is implemented by a control such as XamDateNavigator then one would put an instance of that control somewhere within the UI of their application and then set this property to that control.
Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2