How to: Customize Visible Resource Coloring (legacy)

• Aug 03, 2020
• 3 minutes to read

Note

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.

This example demonstrates how to use the SchedulerControl.QueryResourceColorSchema event and SchedulerControl.GetResourceColorSchemasCopy method to link a specific color schema to each visible resource and specify a custom color schema for the selected resource, if more than one resource is displayed in the scheduler view.

Tip

A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=E3208.

C#

using System;
using System.Data;
using System.Windows;
using DevExpress.XtraScheduler;
using System.Collections.Generic;
// ...

namespace WpfApplication1 {
    public partial class MainWindow : Window {

        Dictionary<object, SchedulerColorSchema> resourceColorSchemas = 
            new Dictionary<object, SchedulerColorSchema>();

        public MainWindow() {
            InitializeComponent();

            // ...

            // Get copies of color schemas that are currently used to paint resources.
            PrepareResourceColorSchemas();
        }

        // ...

        private void PrepareResourceColorSchemas() {
            int count = schedulerControl1.Storage.ResourceStorage.Count;
            SchedulerColorSchemaCollection currentColorchemas = 
                schedulerControl1.GetResourceColorSchemasCopy();
            int schemaCount = currentColorchemas.Count;
            for (int i = 0; i < count; i++) {
                Resource resource = schedulerControl1.Storage.ResourceStorage[i];
                resourceColorSchemas.Add(resource.Id, currentColorchemas[i % schemaCount]);
            }
        }

        private void schedulerControl1_QueryResourceColorSchema(object sender, 
                                                                QueryResourceColorSchemaEventArgs e) {
            object key = e.Resource.Id;
            if (this.resourceColorSchemas.ContainsKey(key))
                e.ResourceColorSchema = this.resourceColorSchemas[key];

            // Specify the custom color schema for the selected resource 
            // if there are more than one visible resources.
            if ShouldHighlightResource(e.Resource)) {
                e.ResourceColorSchema = new SchedulerColorSchema(Color.LightCyan);
            }
        }

        protected bool ShouldHighlightResource(Resource resource) { 
            if (schedulerControl1.ActiveView.GetResources().Count <= 1)
                return false;

            return schedulerControl1.SelectedResource.Equals(resource);
        }

        Resource selectedResource = Resource.Empty;
        private void schedulerControl1_SelectionChanged(object sender, EventArgs e) {
            if (!selectedResource.Equals(schedulerControl1.SelectedResource)) {
                selectedResource = schedulerControl1.SelectedResource;
                schedulerControl1.ActiveView.LayoutChanged();
            }
        }
    }
}

VB.NET

Imports Microsoft.VisualBasic
Imports System
Imports System.Data
Imports System.Windows
Imports DevExpress.XtraScheduler
Imports System.Collections.Generic
' ...

Namespace WpfApplication1
    Partial Public Class MainWindow
        Inherits Window

        Private resourceColorSchemas As Dictionary(Of Object, SchedulerColorSchema) =
            New Dictionary(Of Object, SchedulerColorSchema)()

        Public Sub New()
            InitializeComponent()

            ' ...

            ' Get copies of color schemas that are currently used to paint resources.
            PrepareResourceColorSchemas()
        End Sub

        ' ... 

        Private Sub PrepareResourceColorSchemas()
            Dim count As Integer = schedulerControl1.Storage.ResourceStorage.Count
            Dim currentColorchemas As SchedulerColorSchemaCollection =
                schedulerControl1.GetResourceColorSchemasCopy()
            Dim schemaCount As Integer = currentColorchemas.Count
            For i As Integer = 0 To count - 1
                Dim resource As Resource = schedulerControl1.Storage.ResourceStorage(i)
                resourceColorSchemas.Add(resource.Id, currentColorchemas(i Mod schemaCount))
            Next i
        End Sub

        Private Sub schedulerControl1_QueryResourceColorSchema(ByVal sender As Object, _
                                                               ByVal e As
QueryResourceColorSchemaEventArgs)
            Dim key As Object = e.Resource.Id
            If Me.resourceColorSchemas.ContainsKey(key) Then
                e.ResourceColorSchema = Me.resourceColorSchemas(key)
            End If

            ' Specify the custom color schema for the selected resource 
            ' if there are more than one visible resources.
            If ShouldHighlightResource(e.Resource) Then
                e.ResourceColorSchema = New SchedulerColorSchema(Color.LightCyan)
            End If
        End Sub

        Protected Function ShouldHighlightResource(ByVal resource As Resource) As Boolean
            If schedulerControl1.ActiveView.GetResources().Count <= 1 Then
                Return False
            End If

            Return schedulerControl1.SelectedResource.Equals(resource)
        End Function

        Private selectedResource As Resource = Resource.Empty
        Private Sub schedulerControl1_SelectionChanged(ByVal sender As Object, ByVal e As EventArgs)
            If (Not selectedResource.Equals(schedulerControl1.SelectedResource)) Then
                selectedResource = schedulerControl1.SelectedResource
                schedulerControl1.ActiveView.LayoutChanged()
            End If
        End Sub
    End Class
End Namespace

XAML

<dxsch:SchedulerControl Name="schedulerControl1"
                        QueryResourceColorSchema="schedulerControl1_QueryResourceColorSchema"
                        SelectionChanged="schedulerControl1_SelectionChanged"/>