RecurrenceRangeControl.TimeZoneHelper Property

Provides access to the object used for date/time calculations.

Namespace: DevExpress.Xpf.Scheduler.UI

Assembly: DevExpress.Xpf.Scheduler.v14.2.dll

Declaration

C#

public TimeZoneHelper TimeZoneHelper { get; set; }

VB.NET

Public Property TimeZoneHelper As TimeZoneHelper

Property Value

Type	Description
TimeZoneHelper	A DevExpress.XtraScheduler.TimeZoneHelper class instance.

Remarks

Use the TimeZoneHelper property to specify the time zone helper used to convert date/time values from the time zone of the current host to the client time zone of the scheduler control, and vice versa.

Examples

This example demonstrates how to use the RecurrenceRangeControl control on a custom Edit Appointment form to modify the recurrence range of the pattern appointment. To bind the RecurrenceRangeControl control to the recurrence range settings via the RecurrenceVisualController and AppointmentFormController controllers, use the RecurrenceRangeControl.RecurrenceInfo and RecurrenceRangeControl.Pattern properties.

For an example with step-by-step instructions on how to replace a standard Edit Appointment form with a custom one, refer to the Lesson 3 - Create a Custom Edit Appointment Form with Custom Fields document.

C#

using System;
using System.Windows;
using System.Windows.Controls;
using DevExpress.Xpf.Scheduler;
using DevExpress.XtraScheduler;
using DevExpress.Xpf.Scheduler.UI;

namespace SilverlightApplication1 {
    public partial class CustomAppointmentForm : UserControl {
        SchedulerControl control;
        Appointment apt;
        CustomAppointmentFormController controller;
        RecurrenceVisualController recurrenceVisualController;

        public CustomAppointmentForm(SchedulerControl control, Appointment apt) {
            this.control = control;
            this.apt = apt;
            this.controller = new CustomAppointmentFormController(control, apt);
            this.recurrenceVisualController = new RecurrenceVisualController(controller);

            InitializeComponent();
        }

        public SchedulerControl Control { get { return control; } }
        public Appointment Appointment { get { return apt; } }
        public CustomAppointmentFormController Controller { get { return controller; } }
        public RecurrenceVisualController RecurrenceVisualController 
                                          { get { return recurrenceVisualController; } }
        public TimeZoneHelper TimeZoneHelper { get { return Controller.TimeZoneHelper; } }
        public bool ShouldShowRecurrence { get { return Appointment.Type == AppointmentType.Pattern 
                                                        && Controller.ShouldShowRecurrenceButton; } }

        private void Ok_button_Click(object sender, RoutedEventArgs e) {
            if (ShouldShowRecurrence)
                RecurrenceVisualController.ApplyRecurrence();
            Controller.ApplyChanges();
            SchedulerFormBehavior.Close(this, true);         
        }
    }
}

public class CustomAppointmentFormController : AppointmentFormController {
    public CustomAppointmentFormController(SchedulerControl control, Appointment apt)
        : base(control, apt) {
    }
}

VB.NET

Imports Microsoft.VisualBasic
Imports System
Imports System.Windows
Imports System.Windows.Controls
Imports DevExpress.Xpf.Scheduler
Imports DevExpress.XtraScheduler
Imports DevExpress.Xpf.Scheduler.UI

Partial Public Class CustomAppointmentForm
    Inherits UserControl
    Private control_Renamed As SchedulerControl
    Private apt As Appointment
    Private controller_Renamed As CustomAppointmentFormController
    Private recurrenceVisualController_Renamed As RecurrenceVisualController

    Public Sub New(ByVal control As SchedulerControl, ByVal apt As Appointment)
        Me.control_Renamed = control
        Me.apt = apt
        Me.controller_Renamed = New CustomAppointmentFormController(control, apt)
        Me.recurrenceVisualController_Renamed = New RecurrenceVisualController(controller_Renamed)

        InitializeComponent()
    End Sub

    Public ReadOnly Property Control() As SchedulerControl
        Get
            Return control_Renamed
        End Get
    End Property
    Public ReadOnly Property Appointment() As Appointment
        Get
            Return apt
        End Get
    End Property
    Public ReadOnly Property Controller() As CustomAppointmentFormController
        Get
            Return controller_Renamed
        End Get
    End Property
    Public ReadOnly Property RecurrenceVisualController() As RecurrenceVisualController
        Get
            Return recurrenceVisualController_Renamed
        End Get
    End Property
    Public ReadOnly Property TimeZoneHelper() As TimeZoneHelper
        Get
            Return Controller.TimeZoneHelper
        End Get
    End Property
    Public ReadOnly Property ShouldShowRecurrence() As Boolean
        Get
            Return Appointment.Type = AppointmentType.Pattern AndAlso Controller.ShouldShowRecurrenceButton
        End Get
    End Property

    Private Sub Ok_button_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
        If ShouldShowRecurrence Then
            RecurrenceVisualController.ApplyRecurrence()
        End If
        Controller.ApplyChanges()
        SchedulerFormBehavior.Close(Me, True)
    End Sub
End Class

Public Class CustomAppointmentFormController
    Inherits AppointmentFormController
    Public Sub New(ByVal control As SchedulerControl, ByVal apt As Appointment)
        MyBase.New(control, apt)
    End Sub
End Class

XAML

<dxsch:RecurrenceRangeControl RecurrenceInfo="{Binding RecurrenceVisualController.RecurrenceInfo}"
                              Pattern="{Binding Controller.PatternCopy}"
                              TimeZoneHelper="{Binding Path=TimeZoneHelper, Mode=OneTime}"
                              Visibility="{Binding ShouldShowRecurrence, Converter={dxschint:BoolToVisibilityConverter}}"/>