SchedulerControl.ShowRecurrenceForm(UserControl, Boolean) Method

Invokes the Appointment Recurrence dialog for the specified recurring appointment.

Namespace: DevExpress.Xpf.Scheduler

Assembly: DevExpress.Xpf.Scheduler.v24.1.dll

NuGet Package: DevExpress.Wpf.Scheduler

Declaration

C#

public virtual void ShowRecurrenceForm(
    UserControl parentForm,
    bool readOnly
)

VB.NET

Public Overridable Sub ShowRecurrenceForm(
    parentForm As UserControl,
    readOnly As Boolean
)

Parameters

Name	Type	Description
parentForm	UserControl	A UserControl object that specifies an Edit Appointment form from which the Appointment Recurrence dialog is invoked.
readOnly	Boolean	true to open this form to display properties of a read-only recurring appointment (in this case all form editors are disabled); otherwise, false.

Remarks

Important

You are viewing documentation for the legacy WPF Scheduler control. If you’re starting a new project, we strongly recommend that you use a new control declared in the DevExpress.Xpf.Scheduling namespace. If you decide to upgrade an existing project in order to switch to the updated scheduler control, see the Migration Guidelines document.

The Appointment Recurrence dialog allows end-users to change the appointment recurrence characteristics. The common appearance of the standard Appointment Recurrence form is shown below.

Use the SchedulerControl.RecurrenceFormShowing event to handle the display of this form, for example, to invoke your own custom form instead of the standard one.

Example

The following code snippet illustrates how to use the SchedulerControl.ShowRecurrenceForm method to invoke the Appointment Recurrence dialog when clicking the Recurrence button on the custom Edit Appointment form. To specify Recurrence button visibility, use the AppointmentFormController.ShouldShowRecurrence property.

View Example

CustomAppointmentForm.xaml.vb

Private Sub Recurrence_button_Click(sender As Object, e As RoutedEventArgs)
    control_Renamed.ShowRecurrenceForm(Me, False)
End Sub

CustomAppointmentForm.xaml

<Button Name="Recurrence_button" Margin="6,0,0,0" MinWidth="75" 
        Visibility="{Binding Controller.ShouldShowRecurrence, Converter={StaticResource booleanToVisibilityConverter}}"
        Content="Recurrence" Click="Recurrence_button_Click"/>

CustomAppointmentForm.xaml.cs

private void Recurrence_button_Click(object sender, RoutedEventArgs e) {
    control.ShowRecurrenceForm(this, false);
}

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ShowRecurrenceForm(UserControl, Boolean) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-invoke-the-default-appointment-recurrence-dialog-from-a-custom-edit-appointment-form-e3796/CS/WpfApplication1/CustomAppointmentForm.xaml.cs#L52

private void Recurrence_button_Click(object sender, RoutedEventArgs e) {
    control.ShowRecurrenceForm(this, false);
}

VB.NET

how-to-invoke-the-default-appointment-recurrence-dialog-from-a-custom-edit-appointment-form-e3796/VB/WpfApplication1/CustomAppointmentForm.xaml.vb#L73

Private Sub Recurrence_button_Click(sender As Object, e As RoutedEventArgs)
    control_Renamed.ShowRecurrenceForm(Me, False)
End Sub