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分钟。