Previous topicNext topic
Help > 开发指南 > Excel > API > 示例 > 迷你图 >
如何：指定迷你轴设置

将迷你图添加到工作表后，可以配置其水平轴和垂直轴设置，以最有效的方式表示数据。

水平轴选项

若要调整迷你图组的水平轴设置，请使用 SparklineGroup.HorizontalAxis 属性。此属性提供对 SparklineHorizontalAxis 对象的访问，该对象允许您指定以下轴选项。

能见度

若要在迷你图上显示水平轴，请将 SparklineHorizontalAxis 对象的 SparklineColor.IsVisible 属性设置为 true。请注意，仅当迷你图数据同时包含正值和负值时，才会显示迷你图的水平轴;否则，不显示轴。

若要更改轴颜色，请设置 SparklineHorizontalAxis 对象的 SparklineColor.Color 属性。

Vb.Net
'创建一组线条迷你图。
Dim lineGroup As DevExpress.Spreadsheet.SparklineGroup = worksheet.SparklineGroups.Add(worksheet("F3:F4"), worksheet("B3:E3,B4:E4"), DevExpress.Spreadsheet.SparklineGroupType.Line)

'显示水平轴并指定其颜色。
lineGroup.HorizontalAxis.IsVisible = True
lineGroup.HorizontalAxis.Color = Color.ForestGreen

C#
// 创建一组线条迷你图。
DevExpress.Spreadsheet.SparklineGroup lineGroup = worksheet.SparklineGroups.Add(worksheet["F3:F4"], worksheet["B3:E3,B4:E4"], DevExpress.Spreadsheet.SparklineGroupType.Line);

// 显示水平轴并指定其颜色。
lineGroup.HorizontalAxis.IsVisible = true;
lineGroup.HorizontalAxis.Color = Color.ForestGreen;


轴类型

默认情况下，创建迷你图时，它使用常规轴类型，该类型定期在迷你图上显示数据点。但是，如果基础数据在不规则的时间段内出现，则可以通过将数据标记与日期成比例地间隔开来在迷你图上反映这些时间间隔（日期之间的间隔越长，迷你图上相应数据标记之间的间距越长）。若要将轴类型更改为日期轴，请将包含所需迷你图组的日期值的单元格区域分配给 SparklineGroup.DateRange 属性。这将自动将水平轴转换为日期轴（SparklineHorizontalAxis.IsDateAxis 属性将返回 true）。

Vb.Net
 lineGroup.DateRange = worksheet("B2:E2")

C#
 lineGroup.DateRange = worksheet["B2:E2"];


数据绘图顺序

如果要以相反方向（从右到左的顺序）显示迷你图组中每个迷你图上的数据点，请将 SparklineHorizontalAxis.RightToLeft 属性设置为 true。

Vb.Net
 lineGroup.HorizontalAxis.RightToLeft = True

C#
 lineGroup.HorizontalAxis.RightToLeft = true;


垂直轴选项

若要为迷你图组的垂直轴指定缩放选项，请使用 SparklineGroup.VerticalAxis 属性。此属性允许您指定如何计算垂直轴的最小值和最大值。

您可以选择以下选项之一。

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

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

'指定垂直轴选项。
Dim verticalAxis As DevExpress.Spreadsheet.SparklineVerticalAxis = columnGroup.VerticalAxis
'设置垂直轴的自定义最小值。
verticalAxis.MinScaleType = DevExpress.Spreadsheet.SparklineAxisScaling.Custom
verticalAxis.MinCustomValue = 0
'设置垂直轴的自定义最大值。
verticalAxis.MaxScaleType = DevExpress.Spreadsheet.SparklineAxisScaling.Custom
verticalAxis.MaxCustomValue = 12000

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

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

// 指定垂直轴选项。
DevExpress.Spreadsheet.SparklineVerticalAxis verticalAxis = columnGroup.VerticalAxis;
// 设置垂直轴的自定义最小值。
verticalAxis.MinScaleType = DevExpress.Spreadsheet.SparklineAxisScaling.Custom;
verticalAxis.MinCustomValue = 0;
// 设置垂直轴的自定义最大值。
verticalAxis.MaxScaleType = DevExpress.Spreadsheet.SparklineAxisScaling.Custom;
verticalAxis.MaxCustomValue = 12000;