Tip
Use the scheduler's Smart Tag to generate a default context menu for appointments, time rulers or time cells in design-time, and customize it as required. Refer to the Create Context Menu topic for details.
-
Add a New Item
The OptionsContextMenu class provides options that allow you to customize context menus. Use the *ContextMenuActions property to access the target context menu's actions collection. Add an InsertAction to the retrieved collection to add a new item to the context menu. The following code sample inserts two new items to the appointment context menu.
| MainWindow.xaml |
<dxsch:OptionsContextMenu.AppointmentContextMenuActions>
<!--Insert the "Recurrence" item invoking the Recurrence dialog-->
<dxb:InsertAction Index="-1">
<dxb:BarButtonItem Content="Recurrence"
Glyph="{dx:DXImage Image=Recurrence_32x32.png}"
Command="{Binding ElementName=schedulerCommands, Path=OpenRecurrenceWindowCommand}">
</dxb:BarButtonItem>
</dxb:InsertAction>
<!--Insert the check item which converts the selected appointment to an all day event-->
<dxb:InsertAction>
<dxb:BarCheckItem x:Name="allDayCheck"
Content="All-Day Appointment"
Glyph="{dx:DXImage Image=Check_16x16.png}"
CheckedChanged="allDayCheck_CheckedChanged"/>
</dxb:InsertAction>
</dxsch:OptionsContextMenu.AppointmentContextMenuActions>
|
As a result, the menu appears as follows.
-
Update an Existing Item
Obtain the context menu's action collection and add an UpdateAction to it to update any existing context menu item, as shown in the code sample below.
| MainWindow.xaml |
<dxsch:OptionsContextMenu.TimeRulerContextMenuActions>
<!--Hide the "New All Day Event" and "New Recurring Event" items-->
<dxb:UpdateAction ElementName="{x:Static Member=dxsch:DefaultBarItemNames.ContextMenu_Items_TimeRuler_Actions_NewAllDayEvent}"
PropertyName="IsVisible"
Value="False"/>
<dxb:UpdateAction ElementName="{x:Static Member=dxsch:DefaultBarItemNames.ContextMenu_Items_TimeRuler_Actions_NewRecurringEvent}"
PropertyName="IsVisible"
Value="False"/>
<!--Disable the "New Appointment" and "New Recurring Appointment" item-->
<dxb:UpdateAction ElementName="{x:Static Member=dxsch:DefaultBarItemNames.ContextMenu_Items_TimeRuler_Actions_NewAppointment}"
PropertyName="IsEnabled"
Value="False"/>
<dxb:UpdateAction ElementName="{x:Static Member=dxsch:DefaultBarItemNames.ContextMenu_Items_TimeRuler_Actions_NewRecurringAppointment}"
PropertyName="IsEnabled"
Value="False"/>
</dxsch:OptionsContextMenu.TimeRulerContextMenuActions>
|
The image shows the code execution result.
-
Remove the Item
Add a RemoveAction to the menu's action collection to delete any item from the target context menu. The code snippet shows how to delete an item from the appointment drop context menu.
| MainWindow.xaml |
<dxsch:OptionsContextMenu.AppointmentDropContextMenuActions>
<!--Remove the "Copy" item-->
<dxb:RemoveAction ElementName="{x:Static Member=dxsch:DefaultBarItemNames.ContextMenu_Items_AppointmentDrop_Actions_CopyAppointmentsOnDrop}"/>
</dxsch:OptionsContextMenu.AppointmentDropContextMenuActions>
|
The resulting context menu is shown on the image below.
The OptionsContextMenu.*ContextMenu properties allow you to provide a custom context menu instead of the default one. The code sample below shows how to provide a custom cell pop-up menu shown in the image.
| MainWindow.xaml |
<dxsch:OptionsContextMenu.CellContextMenu>
<dxb:PopupMenu>
<dxb:PopupMenu.Items>
<dxb:BarButtonItem Content="Add Broadcast..."
Glyph="{dx:DXImage Image=Appointment_16x16.png}"
Command="{Binding ElementName=schedulerCommands, Path=ShowNewAppointmentWindowCommand}"/>
<dxb:BarButtonItem Content="Add News Block..."
Glyph="{dx:DXImage Image=RecurringAppointment_16x16.png}"
Command="{Binding ElementName=schedulerCommands, Path=ShowNewRecurringAppointmentWindowCommand}"/>
</dxb:PopupMenu.Items>
</dxb:PopupMenu>
</dxsch:OptionsContextMenu.CellContextMenu>
|