Silverlight甘特圖：二、時間線開發原理

1. 語法

1.1. XAML

2. 備注

2.1. 布局計算

TimeLine作為時間軸(橫向坐標)，其精度為毫秒。原點為StartDate，相對於原點的位置為某一時間點減去開始時間所得時間的毫秒數，即XPosition。

TimeLine布局計算繼承自ILayout接口，主要依賴於XPosition，ViewPortWidth，ViewPortHeight屬性。

出於性能考慮，TimeLine僅僅計算出當前ViewPortWidth和ViewPortHeight范圍內的所需的單元格(表示時間段的方格)。

2.2. 渲染

TimeLine允許自定義Renderer的風格，自定義的Renderer類必須繼承自ITimeLineEntryRenderer接口。可參考SimpleTimeLineEntryRenderer的實現。並指定TimeLine.ItemRendererProvider的值為自定義的Renderer類。

2.3. 放大/縮小

時間軸控件允許自定義放大縮小的層級，從而變換“年/季度”，“年/月”，“月/日”等不同樣式。

設定放大縮小層級，必須了解Dictionary<IDateTimeDescriptor, int>和最小MinDateTimeRangeWidth 的定義。

1) Dictionary<IDateTimeDescriptor, int>

IDateTimeDescriptor表示TimeLine上同一時間軸上每個方塊顯示的時間范圍，即一個單元時間范圍，如下面的代碼表示2季度：

new SimpleDateTimeDescriptor(2, DateTimeType.Quarter)

Dictionary包含N個IDateTimeDescriptor，依次排列。即排列中枚舉了N級單元時間范圍。

2) MinDateTimeRangeWidth

MinDateTimeRangeWidth 表示繪制IDateTimeDescriptor時間范圍的最小長度。如MinDateTimeRangeWidth = 80d; 則表示80像素表示2個季度時間的長度。

3) 放大原理

舉一個簡單的例子，設定如下：

ITaskDescriptor t = new SimpleTaskDescriptor{StartDate=2010/1/1,
EndDate=2010/4/1}
MinDateTimeRangeWidth = 80d
new SimpleDateTimeDescriptor(1, DateTimeType.Quarter)
new SimpleDateTimeDescriptor(1, DateTimeType.Year)

上面定義時間開始與2010年1月1日，跨度為1個季度的任務，並定義了兩級單元時間范圍，此外，還定義單元時間范圍在屏幕上繪制的長度下限為80像素。

當甘特圖此任務條以>=80像素顯示時，TimeLine上單元格顯示為”X季度”。當任務以<80像素顯示時，時間軸上單元格顯示為”XX年”。

此外，還需注意Dictionary<IDateTimeDescriptor, int>類型中標紅的int類型，此類型參數表示”跳針”，用於TimeLine的多層時間軸，譬如下圖表示兩層時間軸：

顯然，每一層時間軸有不同的縮放機制，而每一種放大機制都對應了一個Dictionary<IDateTimeDescriptor, int>類型的實例。從而形成”年/季度”，“年/月”等結構。

通過下面的例子，說明如何”跳針”， DefaultDateTimeRangeDescriptor是下層時間軸的縮放機制，DefaultDateTimeRangeDescriptor2是上層時間軸的縮放機制，上層時間軸使用了跳針:

public static Dictionary<IDateTimeDescriptor, int> DefaultDateTimeRangeDescriptor
        {
            get
            {
                if (_defaultDateTimeRangeDescriptor == null)
                {
                    _defaultDateTimeRangeDescriptor = new Dictionary<IDateTimeDescriptor, int>();
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(1, DateTimeType.Minute), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(5, DateTimeType.Minute), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(10, DateTimeType.Minute), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(15, DateTimeType.Minute), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(30, DateTimeType.Minute), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(1, DateTimeType.Hour), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(2, DateTimeType.Hour), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(6, DateTimeType.Hour), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(12, DateTimeType.Hour), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(1, DateTimeType.WeekDay), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(2, DateTimeType.Day), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(4, DateTimeType.Day), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(7, DateTimeType.Day), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(1, DateTimeType.Month), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(1, DateTimeType.Quarter), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(2, DateTimeType.Quarter), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(1, DateTimeType.Year), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(2, DateTimeType.Year), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(5, DateTimeType.Year), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(10, DateTimeType.Year), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(20, DateTimeType.Year), 0);
                    _defaultDateTimeRangeDescriptor.Add(new SimpleDateTimeDescriptor(50, DateTimeType.Year), 0);
                }
                return _defaultDateTimeRangeDescriptor;
            }
        }

        public static Dictionary<IDateTimeDescriptor, int> DefaultDateTimeRangeDescriptor2
        {
            get
            {
                if (_defaultDateTimeRangeDescriptor2 == null)
                {
                    _defaultDateTimeRangeDescriptor2 = new Dictionary<IDateTimeDescriptor, int>();
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(1, DateTimeType.Minute), 1); //-------0
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(5, DateTimeType.Minute), 1);//-------1
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(10, DateTimeType.Minute), 3);//-------2
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(15, DateTimeType.Minute), 2);//-------3
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(30, DateTimeType.Minute), 1);//-------4
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(1, DateTimeType.Hour), 2);//-------5
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(2, DateTimeType.Hour), 1);//-------6
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(6, DateTimeType.Hour), 2);//-------7
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(12, DateTimeType.Hour), 1);//-------8
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(1, DateTimeType.Day), 3);//-------9
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(2, DateTimeType.Day), 3);//-------10
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(4, DateTimeType.Day), 2);//-------11
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(1, DateTimeType.Week), 1);//-------12
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(1, DateTimeType.Month), 1);//-------14
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(1, DateTimeType.Quarter), 2);//-------15
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(2, DateTimeType.Quarter), 1);//-------16
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(1, DateTimeType.Year), 1);//-------18
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(2, DateTimeType.Year), 1);//-------19
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(5, DateTimeType.Year), 1);//-------20
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(10, DateTimeType.Year), 1);//-------21
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(20, DateTimeType.Year), 1);//-------22
                    _defaultDateTimeRangeDescriptor2.Add(new SimpleDateTimeDescriptor2(50, DateTimeType.Year), 0);//-------22
                }
                return _defaultDateTimeRangeDescriptor2;
            }
        }

DeafultDateTimeDescriptor2中第一行Int = 1，意思是，如果當前時間軸上放大至：80像素/1分鍾的話，那么直接跳到下一個，用400像素的單元格表示5分鍾。