LightningChart数据可视化工具使用篇33-ViewXY图例框

.net_wang

图例框

演示示例： Multiple legends; Heatmap legends; Segments with splitters


从第v.8版本开始，ViewXY 支持在同一个张图形中出现多个图例框。在ViewXY.LegendBoxes集中插入这些图例框。

图:庞大的 LegendBoxXY 属性树

在图例框中设置隐藏/显示某序列图

图:在图例框中显示有系列名和图标。取消选定某个系列的勾选框可以将其隐藏。

防止某系列在图例框中自行列出

如果某个特定的系列不应该列在图例框中，则为该系列设置series.ShowInLegendBox = False。

选择在哪个图例框中显示特定的系列

用 series.LegendBoxIndex 可选择首选的图例框。系列仅可出现在一个图例框中。所有系列的默认索引为0，意味着除非另有说明，否则它们都将出现在同一个图例框中。

选择在哪个图形段中显示图例框

用 SegmentIndex 来控制在哪个段中显示图例框。只适用于基于段的Position选项。

隐藏复选框

设置 ShowCheckBoxes = False，可隐藏复选框。


隐藏图标

设置 ShowIcons = False，可隐藏图标。


修改强度系列的调色板刻度

要隐藏一个IntensityGrid或IntensityMesh的调色板刻度，可设置IntensityScales.Visible = False。设置 ScaleSizeDim1 和 ScaleSizeDim2 属性，则可对其大小进行调整。刻度的边框以及名称的位置也可以修改。

图：在底部的图片中设置LegendBox.IntensityScales.Visible = false

控制位置

图例框可以自动放置或手动放置。自动放置可以让它们对齐到图形段的左侧/顶部/右侧/底部，或在图边距上。用Position属性可以控制位置。位置选项有：TopCenter、TopLeft、TopRight、LeftCenter、 RightCenter、 BottomLeft、 BottomCenter、 BottomRight、 Manual。

如果视图分为数个片段，图例框可以根据其所属的段进行对齐（此可用SegmentIndex来控制）。对于基于图段进行控制，有以下几个选项可用：SegmentTopLeft、SegmentTopCenter, SegmentTopRight、SegmentBottomLeft、SegmentBottomCenter、SegmentBottomRight、SegmentLeftMarginCenter、SegmentRightMarginCenter。

Offset属性根据给定的数量从由Position属性决定的地方来移动位置。

[C#] 纯文本查看 复制代码

// 设置图例框位置，偏移量从RightCenter位置移动
chart.ViewXY.LegendBoxes[0].Position = LegendBoxPositionXY.RightCenter;
chart.ViewXY.LegendBoxes[0].Offset = new PointIntXY（-15, -70）;

Manual定位计算从图例框左上角到视图左上角的偏移量。注意，这与TopLeft选项不同，TopLeft选项是从图形区域的顶部计算的。


注意，当移动或改变图例框的大小时，其Position 设置为Manual，并更新 Offset 属性以显示新的位置。


如果不设置Position回除‘Manual’之外的选项，自动图例框对齐是禁用的。由于在Position选项之间切换时Offset未更新，图例框有时看起来会消失（位于视图之外）。这个问题可通过将Offset设置回0,0来修正。


为图形段间的图例框分配空间
设置 ViewXY.AutoSpaceLegendBoxes = True后，将对段之间的额外空间进行分配，以适当安置其中的图例框。



注意，段间也要分配ViewXY.AxisLayout.SegmentsGap。

图：Position = SegmentBottomRight. AutoSpaceLegendBoxes = False.

图： Position = SegmentBottomRight. AutoSpaceLegendBoxes = True.

段间距内的图例框对齐
要将图例框垂直对齐到指定段附近，可设置AlignmentInSegmentGap = Near。要将其垂直对齐到段与段之间间距的中心，可设置AlignmentInSegmentGap = Center。


在同一图边距中的几个图例框水平对齐

AlignmentInVerticalMargin 属性具有 Left/Center/Right 几个选项。该属性控制将图例框（设置在同一个垂直图边距内）的水平位置。设置为相同的垂直边框。

图：AlignmentInVerticalMargin = Left set for both Legend boxes.

图例框的大小调整与移动

图例框支持调整大小和滚动条。从边缘处抓取可调整大小。

图：图例框中的滚动体

注意，当移动或调整图例框大小时，其Position 设置为 Manual， 并更新 Offset 属性，以显示新的位置（参阅第Error! Reference source not found.章节）。

遇到使用问题，关注Arction公众号可以跟官方技术支持在线聊天解决，技术支持这一块儿Lightningchart做的还是不错的。

最新版V10 LightningChart下载地址：猛击下载