SchedulerControl.AppointmentViewInfoCustomizing Event

Allows customizing the appointment‘s appearance by modifying the style elements when it is painted.

Namespace: DevExpress.Xpf.Scheduler

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

NuGet Package: DevExpress.Wpf.Scheduler

Declaration

C#

public event AppointmentViewInfoCustomizingEventHandler AppointmentViewInfoCustomizing

VB.NET

Public Event AppointmentViewInfoCustomizing As AppointmentViewInfoCustomizingEventHandler

Event Data

The AppointmentViewInfoCustomizing event's data class is AppointmentViewInfoCustomizingEventArgs. The following properties provide information specific to this event:

Property	Description
ViewInfo	Gets the object which contains information used to render the appointment.

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.

If you need to implement conditional styling based on the appointment data, handle the AppointmentViewInfoCustomizing event, and modify any appearance property using the appointment’s data as a condition.

Example

Tip

A complete sample project is available in the DevExpress Code Examples database at https://supportcenter.devexpress.com/ticket/details/e2999/how-to-customize-appointment-tooltips.

This example demonstrates how to use the AppointmentViewInfo.Subject, AppointmentViewInfo.Location, AppointmentViewInfo.Description, AppointmentViewInfo.CustomViewInfo, SchedulerViewBase.AppointmentToolTipContentTemplate properties and SchedulerControl.AppointmentViewInfoCustomizing event to define and apply a custom template for showing an appointment subject, location, description and resource images within appointment tooltips.

C#

using System.IO;
using System.Data;
using System.Windows;
using System.Data.OleDb;
using DevExpress.Xpf.Core.Native;
using System.Collections.Generic;
using System.Windows.Media.Imaging;
using DevExpress.XtraScheduler;
using DevExpress.Xpf.Scheduler;
using DevExpress.Xpf.Scheduler.Drawing;

namespace WpfApplication1 {
public partial class MainWindow : Window {
    Dictionary<Resource, BitmapImage> resourceImages = new Dictionary<Resource, BitmapImage>();

    public MainWindow() {
        InitializeComponent();

        // ...

        DataTemplate template = (DataTemplate)this.FindResource("AppointmentTooltipContentTemplate");
        schedulerControl1.WorkWeekView.AppointmentToolTipContentTemplate = template;

    }

    private void schedulerControl1_AppointmentViewInfoCustomizing(object sender, 
                                                                AppointmentViewInfoCustomizingEventArgs e) {
    AppointmentViewInfo viewInfo = e.ViewInfo;
    Resource resource = schedulerControl1.Storage.Resources.GetResourceById(viewInfo.Appointment.ResourceId);
    if (resource == Resource.Empty || resource.Image == null)
        viewInfo.CustomViewInfo = null;
    else {
        if (!this.resourceImages.ContainsKey(resource))
        this.resourceImages[resource] = ImageHelper.CreateImageFromStream(ConvertImageToMemoryStream(resource.Image));

        viewInfo.CustomViewInfo = this.resourceImages[resource];
    }
    }

    public static MemoryStream ConvertImageToMemoryStream(System.Drawing.Image img) {
        var ms = new MemoryStream();
        img.Save(ms, System.Drawing.Imaging.ImageFormat.Png);
        return ms;
    }

}
}

VB.NET

Imports Microsoft.VisualBasic
Imports System.IO
Imports System.Data
Imports System.Windows
Imports System.Data.OleDb
Imports DevExpress.Xpf.Core.Native
Imports System.Collections.Generic
Imports System.Windows.Media.Imaging
Imports DevExpress.XtraScheduler
Imports DevExpress.Xpf.Scheduler
Imports DevExpress.Xpf.Scheduler.Drawing

Namespace WpfApplication1
Partial Public Class MainWindow
    Inherits Window
    Private resourceImages As Dictionary(Of Resource, BitmapImage) = New Dictionary(Of Resource,  _
                        BitmapImage)()

    Public Sub New()
        InitializeComponent()

        ' ...

        Dim template As DataTemplate = CType(Me.FindResource("AppointmentTooltipContentTemplate"),  _
                 DataTemplate)
        schedulerControl1.WorkWeekView.AppointmentToolTipContentTemplate = template

    End Sub

    Private Sub schedulerControl1_AppointmentViewInfoCustomizing(ByVal sender As Object, _
                                                                 ByVal e As AppointmentViewInfoCustomizingEventArgs)
        Dim viewInfo As AppointmentViewInfo = e.ViewInfo
        Dim resource As Resource = schedulerControl1.Storage.Resources.GetResourceById(viewInfo.Appointment.ResourceId)
        If resource Is resource.Empty OrElse resource.Image Is Nothing Then
            viewInfo.CustomViewInfo = Nothing
        Else
            If (Not Me.resourceImages.ContainsKey(resource)) Then
                Me.resourceImages(resource) = ImageHelper.CreateImageFromStream(ConvertImageToMemoryStream(resource.Image))
            End If

            viewInfo.CustomViewInfo = Me.resourceImages(resource)
        End If
    End Sub

    Public Shared Function ConvertImageToMemoryStream(ByVal img As System.Drawing.Image) As MemoryStream
        Dim ms = New MemoryStream()
        img.Save(ms, System.Drawing.Imaging.ImageFormat.Png)
        Return ms
    End Function

End Class
End Namespace

XAML

<Window x:Class="WpfApplication1.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:dxschcore="clr-namespace:DevExpress.XtraScheduler;assembly=DevExpress.XtraScheduler.v10.2.Core"
        xmlns:dxsch="http://schemas.devexpress.com/winfx/2008/xaml/scheduler"
        Title="MainWindow" Height="350" Width="525">

<Window.Resources>
    <!--AppointmentTooltipTemplate-->
    <DataTemplate x:Key="AppointmentTooltipContentTemplate">
        <Grid>
            <Grid.ColumnDefinitions>
                <ColumnDefinition Width="AUTO"/>
                <ColumnDefinition Width="*"/>
            </Grid.ColumnDefinitions>
            <Grid.RowDefinitions>
                <RowDefinition Height="Auto"/>
                <RowDefinition Height="Auto"/>
                <RowDefinition Height="Auto"/>
            </Grid.RowDefinitions>

            <Border Grid.RowSpan="2" SnapsToDevicePixels="True"
                    Margin="2" BorderThickness="1"
                    BorderBrush="DarkGray" CornerRadius="2">
                <Image SnapsToDevicePixels="True" Stretch="Uniform" 
                        MaxWidth="140" MaxHeight="100" 
                        Source="{Binding ViewInfo, Path=CustomViewInfo}"/>
            </Border>

            <TextBlock Grid.Column="1" Text="{Binding ViewInfo, Path=Subject}"/>
            <TextBlock Grid.Row="1" Grid.Column="1" Text="{Binding ViewInfo, Path=Location}"/>
            <TextBlock Grid.Row="2" Grid.ColumnSpan="2"  Text="{Binding ViewInfo, Path=Description}"/>
        </Grid>
    </DataTemplate>
</Window.Resources>

<Grid>
    <dxsch:SchedulerControl 
        Name="schedulerControl1" 
        HorizontalAlignment="Stretch" VerticalAlignment="Stretch" 
        ActiveViewType="WorkWeek"
        GroupType="None"
        AppointmentViewInfoCustomizing="schedulerControl1_AppointmentViewInfoCustomizing">

        <dxsch:SchedulerControl.Storage>
            <dxsch:SchedulerStorage>

                <!---->

            </dxsch:SchedulerStorage>
        </dxsch:SchedulerControl.Storage>

    </dxsch:SchedulerControl>
</Grid>
</Window>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AppointmentViewInfoCustomizing event.

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.

XAML

how-to-display-custom-tooltips-for-appointments-resource-headers-and-date-headers-e4432/CS/MainWindow.xaml#L230

<Grid>
    <dxsch:SchedulerControl Name="schedulerControl1" GroupType="Resource" AppointmentViewInfoCustomizing="schedulerControl1_AppointmentViewInfoCustomizing">
        <dxsch:SchedulerControl.Storage>

how-to-display-a-custom-field-value-in-a-custom-appointment-template-e4681/CS/MainWindow.xaml#L29

<Grid>
    <dxsch:SchedulerControl Name="schedulerControl1" AppointmentViewInfoCustomizing="schedulerControl1_AppointmentViewInfoCustomizing" />
</Grid>

how-to-customize-appointment-tooltips-e2999/CS/WpfApplication1/MainWindow.xaml#L42

GroupType="None"
AppointmentViewInfoCustomizing="schedulerControl1_AppointmentViewInfoCustomizing">

how-to-split-appointments-into-groups-e3792/CS/MainWindow.xaml#L7

<Grid>
    <dxsch:SchedulerControl Name="schedulerControl1" ActiveViewType="WorkWeek" AppointmentViewInfoCustomizing="schedulerControl1_AppointmentViewInfoCustomizing" />
</Grid>