世俱杯 2025

DotNetBar for WinForms是一个拥有89个组件的用户界面控件套包，用户可以使用Visual Studio 2005-2015轻松地创建专业的用户界面。十多年来DotNetBar帮助开发人员轻松地创建易用的专业Windows Forms (WinForms) 用户界面。

点击立即下载DotNetBar for WinForms

本文将会介绍DotNetBar for WinForms的图表控件，因为本模块内容较多，所以分为多部分介绍，本文将介绍第二部分图表容器。

图表容器

ChartContainer对象是ChartControl中所有容器类型图表元素的基本容器对象。ChartContainer元素可以是ChartPanel或ChartXy元素。

以下是可用于所有ChartContainer元素（ChartPanel和ChartXy）的属性列表。

• Bounds-获取整个容器区域的滚动调整后的矩形边界。
• ContentBounds –获取图表的内容区域的矩形边界。对于ChartPanel，它包括整个显示区域，但是对于ChartXy元素，它包括制图区域，轴，图例和标题。
• FrameBounds –获取图表框架区域的矩形边界。由于设置了边距，内边距和阴影，因此插入了该区域-并覆盖了整个内容区域。

在下图中，红色矩形表示容器Bounds，蓝色矩形表示FrameBounds，绿色矩形表示ContentBounds。

• AutoSizeMode –获取或设置用于调整容器大小的模式，可用的选项为无和填充。默认设置为无（表示不会自动调整大小）。 填充表示相对于所有其他设置的容器FillWeight，容器的大小将由分配为FillWeight的容器（请参见下面的FillWeight）确定。
• ContainerVisualStyles –获取或设置容器的视觉样式。容器支持默认，MouseOver，Selected和MouseOverSelected的样式。
• EffectiveContainerStyle –获取对容器有效（缓存，复合）样式的引用。图表元素样式是从较高级别的定义样式到较低的实例级别的样式创建的。

换句话说，如果ChartContainer的ChartControl DefaultVisualStyle设置了背景样式，则无论级别如何，它对于所有定义的ChartContainer都有效。但是，如果特定的ChartContainer的样式重新定义了相同的属性，它将覆盖ChartControl（或更高级别）级别设置的DefaultVisualStyle。

不应更改有效的样式属性，因为重新创建复合样式时，通过样式进行的更改将丢失，这是其他样式和程序更改所必需的。

• EmptyText –获取或设置在容器为空时显示的文本。对于ChartPanel元素，这是在没有可显示的ChartContainer对象的情况下（即ChartContainer集合不包含Visible条目）。对于ChartXy元素，就是没有针对图表定义的可显示ChartSeries时（即，ChartSeries集合不包含Visible条目）。
• EnableEmptyTextMarkup –获取或设置是否启用EmptyText小型标记支持。
• EnablePanning –获取或设置容器是否可以平移（通过在内容区域中单击并拖动来垂直/水平滚动）。默认值为 true。可以为任何/所有容器对象（包括每个ChartPanel，ChartXy和ChartLegend对象）启用或禁用平移。
• EnableSelection –指示是否可以使用鼠标选择容器。ChartControl维护每个图表容器的选择状态，但是除利用Selected / SelectedMouseOver样式外，当前不将其用于其他任何用途。
• FillWeight –获取或设置一个值，当AutoSizeMode为Fill时，该值表示容器的宽度相对于其他填充模式容器的宽度（默认值为100）
• HScrollBar –获取对容器的水平滚动条的引用。根据容器的内容区域是否可以在给定的区域中完全显示，可以显示水平滚动条，也可以不显示水平滚动条。控件中的每个滚动条都可以根据应用程序的需要进行样式化。
• HScrollBarHeight –获取或设置水平滚动条的高度。默认高度为9，设置此高度是为了最大程度地减少显示在屏幕上的面积，从而为图表数据和信息的可视性提供更大的区域可以根据应用程序的需要将其设置为更大或更小。
• HScrollOffset –获取或设置水平滚动条的偏移量。此属性可用于根据需要滚动容器的内容区域。
• HScrollBarVisible –获取或设置是否在需要时显示水平滚动条（由于控件内容超出可用宽度）。默认值为true，但如果不需要水平滚动条，则可以将其设置为false。
• IsSelected –获取或设置是否选择了容器。
• 图例–获取对容器的ChartLegend的引用可以为每个容器（ChartPanel和ChartXy）显示一个图例，也可以根据需要进行组合（父图例可以选择包含子图例条目，例如，如果您有一个5×5的嵌套图表矩阵，您不必有25个图例，但可以选择让一个图例控制所有25个子图表）。
• MatrixAlignEndColumn –获取或设置容器内容的X偏移量是否与在同一ChartMatrix列中结束的其他容器对齐。当您在同一ChartControl中定义多个图表时，将为定义的图表分配一系列矩阵单元格（自动或直接由应用程序分配）。如果有多个图表以矩阵的同一列结尾，则不能保证这些容器的右边缘会对齐（由于标题，轴定义等）。如果希望它们对齐，则可以为每个需要对齐的容器将此属性设置为true，并且内容区域边缘将根据需要对齐。

在下面给出的示例中，每个图表占用6个水平矩阵单元，由于为它们定义的图表标题（默认情况下将它们设置为自动换行），因此开始和结束单元格的内容默认情况下未对齐。

第一张图片的MatrixAlignStartColumns和MatrixAlignEndColumn属性设置为false。

此图像的MatrixAlignStartColumns和MatrixAlignEndColumn属性设置为true。

• MatrixAlignEndRow –获取或设置容器内容的Y偏移量是否与在同一ChartMatrix行中结束的其他容器对齐。这与MatrixAlignEndColumn的原理相同。（请参见上面的MatrixAlignEndColumn）
• MatrixAlignStartRow –获取或设置容器的内容从Y轴偏移开始的位置是否与在同一ChartMatrix行中开始的其他容器对齐。这与MatrixAlignEndColumn的原理相同。（请参见上面的MatrixAlignEndColumn）
• MatrixAlignStartColumn –获取或设置容器的内容从X偏移开始的位置是否与在同一ChartMatrix列中开始的其他容器对齐。这与MatrixAlignEndColumn的原理相同。（请参见上面的MatrixAlignEndColumn）
• MatrixAlignStartRow –获取或设置容器的内容从Y轴偏移开始的位置是否与在同一ChartMatrix行中开始的其他容器对齐。这与MatrixAlignEndColumn的原理相同。（请参见上面的MatrixAlignEndColumn）
• MatrixDisplayBounds –获取或设置容器的矩阵显示范围（以矩阵的相对单位）。此属性遵循“常规”矩形定义-以与长度和宽度相关的值开始的偏移量。因此，要将给定容器分配给单个矩阵单元（单元0,0），可以执行以下操作（请注意，在以下示例中，矩阵的大小必须至少为8×6）：

chartXy.MatrixDisplayBounds = new Rectangle(0, 0, 1, 1);

chartXy.MatrixDisplayBounds = new Rectangle(0, 0, 8, 6);

• MatrixDisplayOrder –获取或设置容器在矩阵布局中的显示顺序（较高的值位于较低的值之上）。

在以下示例中，将大型背景图的MatrixDisplayOrder设置为0，将较小背景图的MatrixDisplayOrder设置为1。

• MinContentSize –获取或设置容器内容区域的最小大小。如果容器的大小设置为使容器的内容区域变得小于设置的MinContentSize，则将显示相应的滚动条（如果启用）。
• ScrollBounds –获取可滚动范围。该值与ContentBounds相同，只是考虑了容器边框。
• ScrollBoundsEx –获取扩展的Scrollable范围。这是容器的扩展或实际内容区域（不仅仅是屏幕上的可见区域）。面积可以大于MinContentSize，但永远不会小于。
• ScrollBoundsOffset –获取当前的水平和垂直偏移（请参见HScrollOffset和VScrollOffset）。
• Titles–获取或设置对容器标题集合的引用。每个容器（ChartPanel，ChartXy）可以为它定义任意数量的标题。它们可以位于顶部，底部，左侧或右侧，也可以对齐TopLeft，MiddleRight等）。它们可以完全样式化，带有边框，背景，图像和阴影（如果需要）。如果需要，可以将每个标题设置为自动换行，并且可以将每个标题设置为将换行的数量限制为给定数量。
• VScrollBar –获取对容器的垂直滚动条的引用。根据容器的内容区域是否可以在给定区域中完全显示（请参见MinContentSize），可以显示垂直滚动条，也可以不显示垂直滚动条。控件中的每个滚动条都可以根据应用程序的需要进行样式化。
• VScrollBarHeight –获取或设置垂直滚动条的宽度。默认宽度为9，设置此宽度是为了最大程度地减少显示在屏幕上的区域，从而为可视化图表数据和信息提供更大的区域。可以根据应用程序的需要将其设置为更大或更小。
• VScrollOffset –获取或设置垂直滚动条的偏移量。此属性可用于根据需要滚动容器的内容区域。
• VScrollBarVisible –获取或设置是否在需要时显示垂直滚动条（由于控件内容超出可用高度）。默认值为true，但如果不需要垂直滚动条，则可以设置为false。

以下是所有ChartContainer元素（ChartPanel和ChartXy）可用的方法的列表。

• 确保可见(bool center)
• 确保关联的容器（或给定的容器项目）在屏幕上可见，并且可以选择在显示中居中（尽可能）。
• GetElementAt（Point pt）
• 返回位于给定Point（在本地坐标中）的ChartVisualElement；如果Point不在容器内，则返回null。 请注意，在返回ChartVisualElement时，必须将其强制转换为返回的实际图表元素，以便访问特定元素的属性和方法。

例如：

ChartVisualElement item = GetElementAt(pt);
if (item is ChartXy)
{
        ChartXy chart = (ChartXy) item;
        chartXy.EnsureVisible(true);
}

• GetHitArea（pt）（Point pt）

返回与给定Point（在本地坐标中）关联的ItemHitArea。

• 复制（）

创建并返回关联元素的重复副本。

• CopyTo（ChartVisualElement复制）

将所有属性和样式定义从关联的元素复制到给定的副本。

本文的内容就到这里，后期会继续跟进教程，感兴趣的朋友，可以持续关注本教程。

关注慧聚IT微信公众号☟☟☟，了解产品的最新动态及最新资讯。