Previous topicNext topic
Help > 开发指南 > Excel > API > 示例 > 迷你图 >
如何：自定义迷你图外观

下面的示例演示了如何自定义迷你图外观。

指定迷你图颜色

若要指定用于绘制迷你图组中每个迷你图的颜色，请使用 SparklineGroup.SeriesColor 属性。对于一组线迷你图，还可以利用 SparklineGroup.LineWeight 属性设置线条粗细。

突出显示数据点

您可以通过在线迷你图上显示和着色标记，或者通过在列和赢/输迷你图上按颜色区分点来突出显示迷你图上的重要数据点。若要访问标记选项，请使用 SparklineGroup.Points 属性，该属性返回 SparklinePoints 对象。下表列出了对象的属性，这些属性用于显示迷你图组中每个迷你图上的特定点。所有这些属性都返回 SparklineColor 对象，该对象控制数据标记的可见性和颜色。

因此，若要在线迷你图上显示所需的标记，请使用相应的属性访问 SparklineColor 对象，并将 SparklineColor.IsVisible 属性设置为 true。对于列和赢/输迷你图（默认情况下显示所有数据标记），设置 SparklineColor.IsVisible 属性将使用应用的迷你图样式定义的颜色突出显示正确的迷你图条。若要将自定义颜色应用于标记，请将所需的颜色分配给 SparklineColor.Color 属性。

属性 描述
SparklinePoints.Markers 显示线迷你图上的所有标记，以区分各个数据点。
SparklinePoints.Negative 突出显示与小于零的所有数据值相对应的标记。
SparklinePoints.Highest 突出显示与最高数据值相对应的标记。
SparklinePoints.Lowest 突出显示与最低数据值相对应的标记。
SparklinePoints.First 突出显示与第一个数据点对应的标记。
SparklinePoints.Last 突出显示与最后一个数据点相对应的标记。

Vb.Net
Dim worksheet As DevExpress.Spreadsheet.Worksheet = workbook.Worksheets("SparklineExamples")
workbook.Worksheets.ActiveWorksheet = worksheet

'创建一组线条迷你图。
Dim lineGroup As DevExpress.Spreadsheet.SparklineGroup = worksheet.SparklineGroups.Add(worksheet("G4:G7"), worksheet("C4:F4,C5:F5,C6:F6, C7:F7"), DevExpress.Spreadsheet.SparklineGroupType.Line)

'自定义组外观。设置Sparkline的颜色。
lineGroup.SeriesColor = Color.FromArgb(&H1F, &H49, &H7D)

'设置Sparkline的线的粗细。
lineGroup.LineWeight = 1.5

'在迷你图上显示数据标记并指定其颜色。
Dim points As DevExpress.Spreadsheet.SparklinePoints = lineGroup.Points
points.Markers.IsVisible = True
points.Markers.Color = Color.FromArgb(&H4B, &HAC, &HC6)

'突出显示组中每条火花线上的最高点和最低点。
points.Highest.Color = Color.FromArgb(&HA9, &HD6, &H4F)
points.Lowest.Color = Color.FromArgb(&H80, &H64, &HA2)

C#
DevExpress.Spreadsheet.Worksheet worksheet = workbook.Worksheets["SparklineExamples"];
workbook.Worksheets.ActiveWorksheet = worksheet;

// 创建一组线条迷你图。
DevExpress.Spreadsheet.SparklineGroup lineGroup = worksheet.SparklineGroups.Add(worksheet["G4:G7"], worksheet["C4:F4,C5:F5,C6:F6, C7:F7"], DevExpress.Spreadsheet.SparklineGroupType.Line);

// 自定义组外观。设置Sparkline的颜色。
lineGroup.SeriesColor = Color.FromArgb(0x1F, 0x49, 0x7D);

// 设置Sparkline的线的粗细。
lineGroup.LineWeight = 1.5;

// 在迷你图上显示数据标记并指定其颜色。
DevExpress.Spreadsheet.SparklinePoints points = lineGroup.Points;
points.Markers.IsVisible = true;
points.Markers.Color = Color.FromArgb(0x4B, 0xA, 0xC6);

// 突出显示组中每条火花线上的最高点和最低点。
points.Highest.Color = Color.FromArgb(0xA9, 0xD6, 0x4F);
points.Lowest.Color = Color.FromArgb(0x80, 0x64, 0xA2);

下图显示了由上述代码创建的迷你图（工作簿在 Microsoft® Excel® 中打开）。