版本 5.5 是 yFiles.NET 的当前主要版本。 （另请参阅整个 yFiles.NET 更改日志。

技术要求

• 基于 yFiles.NET Complete 或 yFiles.NET Viewer 的应用程序需要 Microsoft .NET Framework 4.0（或更高版本）或 .NET Core 3.1。 基于 yFiles.NET 布局的应用程序需要Microsoft .NET Framework 3.5（或更高版本）或支持.NET Standard 2.0（例如.NET Core 2.0）的.NET实现。
• 用于查看 HTML 文档的浏览器。
• 支持上述.NET版本之一的Microsoft Windows操作系统。

yFiles.NET 5.5 - 自 5.4.0.2 以来的更改

新的

组节点样式

新的仙人掌组布局

对树状图样式布局的新支持

此版本为库的所有部分带来了令人兴奋的新主要功能，以及许多其他次要新功能、改进和错误修复。和往常一样，那里 是新的和改进的演示演示 这些功能和改进。

如果要从旧版本的 yFiles.NET 进行更新，请查看不兼容更改的列表。

主要新功能

图形项的新样式

类是新的节点样式 使用矩形形状，其角是圆形或切割的 对角。它的属性指定哪些角变圆角、拐角半径、 它的填充和边框描边。RectangleNodeStyle

新类是节点样式 主要用于折叠和扩展的组节点。它绘制一个（四舍五入） 带有可选选项卡或功能区的矩形，并提供广泛的配置 可选图标、其各种填充和填充的选项。GroupNodeStyle

新类将节点绘制为 箭头形状。箭头可以指向四个指南针方向之一，并且 箭头头坡度、轴粗细、填充和边框描边可以是 配置。ArrowNodeStyle

同样，新类绘制一个 边缘为箭头形状。此样式始终指向从源端口指向 目标端口，忽略弯曲，并且可以按照与节点相同的方式进行配置 风格。ArrowEdgeStyle

该类现在支持 不同的常见背景形状。DefaultLabelStyle

该类现在支持三个 其他形状：（顶部带有尖端的六边形 和底部），（一个五角星，一个尖端指向 向上），和（边较短的体育场形状 四舍五入）。ShapeNodeStyleHexagon2Star5UpPill

它的新属性定义 是否保持形状的固有纵横比。KeepIntrinsicAspectRatio

新类将边呈现为 在 Edge 的源端口和目标端口之间具有给定高度的 3 段网桥 地点。这对于区分并行多边 同一对节点。BridgeEdgeStyle

将文本换行到形状

现在的文本环绕功能将文本换行到给定形状内 仅矩形标签边界。枚举 提供预定义的形状，包括例如药丸、椭圆形和 六角形。新物业 定义所选形状和文本之间的填充。DefaultLabelStyleTextWrappingShapeDefaultLabelStyle.TextWrappingPadding

如果预定义的形状不符合您的需求，则可以重写该方法以 而是返回任何自定义凸路径。DefaultLabelStyleRenderer.GetTextWrappingOutlineGeneralPath

光盘布局

新类排列图形 在磁盘上，尽可能密集地打包节点。这种布局主要是 适用于具有小组件的图形，其松散连接的节点应 分组并包装在一个小区域内。CompactDiskLayout

关联的新类允许指定考虑的自定义数据 在布局计算期间。CompactDiskLayoutData

仙人掌群布局

新课程提供 分层嵌套数据的替代表示形式。它把孩子们放在 沿组圆形边界的组，类似于 仙人掌。CactusGroupLayout

关联的新类允许指定 布局计算期间考虑的自定义数据。CactusGroupLayoutData

该演示已经过修改以演示该布局。LargeGraphsAggregation

新功能

视图

• 新类提供静态帮助程序方法 可以将内置实现转换为键值对。它 还支持从这些键值对创建实例。PortLocationModelParameterSerializerIPortLocationModelParameterIPortLocationModelParameter
• 将新属性添加到 定义路径的纵横比。AspectRatioGeneralPathNodeStyle
• 新属性可用于设置 用于区分鼠标滚轮滚动和缩放的修饰符。CanvasControl.MouseWheelZoomEventRecognizer
• 新类提供了静态帮助程序方法，这些方法可以 将内置实现转换为键值对。它还支持 从这些键值对创建实例。LabelModelParameterSerializerILabelModelParameterILabelModelParameter
• 方法、 和 已添加到其中，可用于 检索有关展开指定组节点时将使用的折叠状态的信息，或者 倒塌。GetNodesRevealedAfterExpandGetEdgesChangedAfterExpandGetEdgesChangedAfterCollapseFoldingManager

互动

• 句柄现在可以对鼠标单击和触摸点击事件做出反应。方法 已添加到接口中，并在 或 被触发时调用 在目标句柄上。要自定义常规句柄单击处理，可以侦听事件 或可以重写该方法。HandleClickIHandleHandleInputMode.ClickedRecognizerHandleInputMode.ClickedRecognizerTouchClickedHandleInputMode.HandleClick

分层布局

• 该类现在支持所谓的表格组节点。的子女 此类组以紧凑的表格方式排列（即，类似于用于布局方向的单列表 从左到右）。属性允许将组标记为“表格”和 属性来指定子项的自定义顺序。HierarchicLayoutHierarchicLayoutData.TabularGroupsHierarchicLayoutData.TabularGroupChildComparers

有机布局

• 该类现在提供了定义组子结构的可能性 作用域，请参见属性 。位于指定范围内的组子结构是 在布局过程中被视为子结构，即子节点排列在包含在 组节点。OrganicLayoutGroupSubstructureScope
• 此外，新属性允许指定是否 或未检测到的簇（参见属性）被视为组子结构。ClusterAsGroupStructureAllowedClusteringPolicy
• 该类现在提供了两个新的调用，这导致了链的紧凑磁盘布局。OrganicLayoutChainSubstructureStylesDiskDiskNested
• 该类现在提供了定义树子结构的可能性 （已经支持星形、链形、循环和平行结构）。该属性指定树子结构的样式，该属性指定其最小大小（较小尺寸的结构） 不作为树子结构处理）。OrganicLayoutOrganicLayout.TreeSubstructureStyleOrganicLayout.TreeSubstructureSize

径向布局

• 现在支持一种新的分层策略，该策略可生成循环 树状图绘制。RadialLayout
• 现在支持两种新的边布线样式，即径向折线 样式和弯曲样式。径向折线样式生成由一系列直线和 弧段。弯曲的折线样式将边布线为弯曲的贝塞尔路径。在后一种情况下，边路径 也可以作为表示三次贝塞尔控制点的控制点返回。RadialLayout
• 现在支持集成节点标签，即采用节点标签 在确定图形节点的位置时考虑并保证标签不会 与图形中的其他对象重叠。RadialLayout

气球布局

• 该类现在支持节点类型。类型影响 子节点和以它们为根的子树，使得相同类型的节点最好放置在每个子节点旁边 其他。节点类型弱于通过比较函数定义的用户指定的自定义顺序。类型可以是 通过属性定义。BalloonLayoutBalloonLayoutData.NodeTypes

圆形布局

• 现在支持集成节点标签，即节点标签是 在确定图形节点的位置时考虑在内，并保证标签将 不与图形中的其他对象重叠。CircularLayout
• 该类现在支持圆内和圆之间的弯曲边布线。CircularLayout

分析

• 添加了解决排名分配的新分析算法类 使用单纯形方法的非循环图上的问题。RankAssignment
• 新的分析类查找图形之间的交集和重叠 项目，具有灵活的配置选项，可仅查找特定的交叉点。相应的类也为 API 提供功能， 但提供的便利性较低。IntersectionsyWorks.Layout.IntersectionsLayoutGraph

改进

常规

• yFiles 现在为 .NET 7 提供程序集。.NET 5 的程序集 已被删除。
• 有关配置项目可视化的文档已得到改进。所有样式及其 配置选项现在在开发人员指南一章中介绍。

视图

• GraphClipboard现在在粘贴项目时尊重值 没有所有者（例如，没有选定源节点或目标节点的边）。PasteDelta
• ModelManager及其派生类 ， ，现在具有在设置或删除管理器时正确分配和释放资源的方法。HighlightIndicatorManagerSelectionIndicatorManagerFocusIndicatorManagerInstallUninstallCanvasControl
• GraphModelManager：属性 、 和 已公开。NodeManagerEdgeManagerPortManagerEdgeLabelManagerNodeLabelManagerPortLabelManagerProvideUserObjectOnMainCanvasObject

互动

• 该方法现在是虚拟的，可以在 派生类。MoveViewportInputMode.Uninstall
• 改进了触摸输入期间的惯性行为。
• 已将属性添加到 ，如果未设置显式 ，则会在节点调整大小手势期间查询该属性。SizeConstraintProviderNodeReshapeHandleProviderNodeReshapeHandlerHandleMinimumSizeMaximumSizeMinimumEnclosedArea
• 活动输入模式的光标属性更改现在会立即反映在应用程序的 鼠标光标。以前，应用程序鼠标光标可能仅在下一个鼠标事件之后更新。
• 新物业提供了使用 不同的光标，用于发出有效位置的信号，以开始移动操作和实际移动项目。MoveInputMode.ValidBeginCursor
• 该类现在提供了自定义游标的可能性 用于发出开始调整大小操作以及实际调整列或行大小的有效位置的信号。ResizeStripeInputMode
• 该类现在提供用于设置无效结束游标的属性 用于调整列和行大小。在调整大小操作期间，如果存在相关列或行，则显示无效的结束光标 无法调整为当前鼠标位置的大小。ResizeStripeInputMode
• 属性和已添加 到 、 和 。可用于指示是否 选择分别移动视口手势可以开始，在这种情况下使用。ValidBeginRecognizerValidBeginCursorLassoSelectionInputModeMarqueeSelectionInputModeMoveViewportInputModeValidBeginRecognizerValidBeginCursor
• 已添加已使用的属性 当位置返回 true 时。MouseHoverInputMode.ValidHoverLocationCursorValidHoverLocationHitTestable
• 已添加已使用的属性 当位置返回 true 时。ContextMenuInputMode.ValidMenuLocationCursorValidMenuLocationHitTestable
• IReparentHandler.IsValidParent现在也称为新的 拖动手势期间的父节点（如果没有针对该位置测试真正的父节点）。null
• 键盘导航现在始终将当前项目视为 导航自，而不考虑属性的值。NavigationInputModeNavigableItems
• 现在引发事件、、、和 、、 和方法的开头。GraphClipboardElementsCuttingElementsCopyingElementsPastingElementsDuplicatingCutCopyPasteDuplicate
• GraphEditorInputMode现在在方法的开头和结尾引发 AND 事件。同样，在方法的开头和结尾引发 and 事件。SelectionGroupingSelectionGroupedGroupSelectionSelectionUngroupingSelectionUngroupedUngroupSelection
• 新物业提供了可能性 自定义启动 Edge 后鼠标仍位于源节点上时显示的光标 创造。CreateEdgeInputMode.SourceNodeDraggingCursor
• 对 属性的更改现已生效 如果鼠标指针当前悬停在某个项目上，则立即使用。ItemHoverInputModeHoverCursor
• 现在在调度事件之前释放互斥锁。TextEditorInputModeTextEdited
• 输入模式不会对修饰符的自动重复键关闭事件执行命中测试 钥匙了。

风格

• 添加了一个新属性，以支持在调整大小期间保持图像的宽高比。KeepAspectRatioImageNodeStyleMemoryImageNodeStyle
• 现在渲染的节点在以下情况下尊重其实际轮廓形状 使用 .ShapeNodeStyleLassoSelectionInputMode
• 的图标现在呈现在换行标签样式的上方。这 使图标呈现在 提供的背景上方。IconLabelStyleDefaultLabelStyle
• DefaultLabelStyleRenderer.GetPreferredSize已虚拟化。
• CollapsibleNodeStyleDecorator现在可以处理旋转的图标。

图形生成器

• GraphBuilder现在提供对已使用 给定 ID 或数据项，或通过新方法 、、、、 和 访问已为其创建节点/边的数据。GetNodeByIdGetNodeForItemGetDataItem(INode)GetEdgeByIdGetEdgeForItemGetDataItem(IEdge)
• TreeBuilder现在提供对 使用给定 ID 或数据项创建的节点，或访问已通过 新方法 、 、 和 。AdjacencyGraphBuilderGetNodeByIdGetNodeForItemGetDataItem(INode)GetDataItem(IEdge)

分层布局

• 该类现在允许组合 和 属性。 以前，重心模式下不支持边缘矫直。HierarchicLayoutSimplexNodePlacer.StraightenEdgesSimplexNodePlacer.BarycenterMode
• 对于某些具有边缘的情况，该类会生成更紧凑的结果 在同一层的节点和集成边缘标记之间，以前不必要地与 标签和边缘被保留。HierarchicLayout
• 该类现在将没有任何边的节点放置在尽可能左的位置 在不违反任何约束的情况下。这样，它们就不会干扰图形连接部分的布局。HierarchicLayout
• 对于具有结构的输入图，该类现在正确地考虑了由 如果它已经 与指定的网格结构兼容。以前，对于这种情况，算法可能已经计算出 完全不同的图层分配。PartitionGridHierarchicLayoutFromScratchLayerer
• 该类现在考虑放置端口端口的流向 与直接组内容边缘结合使用时的组。HierarchicLayout
• 该类改进了对子组件布局的支持 （请参阅）。定义子组件现在通过分配 将新类映射到节点，以便节点映射到相同的描述符实例形式 一个组件。仅与单个非组件节点具有边缘的组件现在直接集成在 该节点（如果使用新的放置策略或（如果子布局的方向允许）。这 此类情况的总体结果具有更好的边布线质量和更紧凑的图形。HierarchicLayoutHierarchicLayoutData.SubcomponentsSubcomponentDescriptorSubcomponentPlacementPolicy.AlwaysIntegratedSubcomponentPlacementPolicy.Automatic
• 该类现在还考虑了 如果启用了递归组分层，则不同的分组层次结构（属性）。以前，在这种情况下会忽略此类约束。HierarchicLayoutHierarchicLayout.RecursiveGroupLayering
• 该类现在对图形使用更紧凑的图层放置 图层之间的边缘标注。HierarchicLayout
• 对于某些具有分组边的输入，该类现在需要较少的折弯 和端口约束或端口候选。HierarchicLayout

有机布局

• 该类现在为带有节点标签和 确定性模式，以前当使用 相同的参数。OrganicLayout
• 该类现在允许通过将属性设置为 .自定义群集 ID 必须 通过属性指定。OrganicLayoutClusteringPolicyClusteringPolicy.UserDefinedOrganicLayoutData.ClusterIds

圆形布局

• 该类现在支持节点类型（参见），也支持循环分区的布局。以前，这些类型具有 仅影响分区本身的布局。如果分区的所有节点都是同一类型，则 分区也获取该类型，因此最好将相同类型的分区彼此相邻放置。CircularLayoutCircularLayoutData.NodeTypes
• 该类获得了用于计算边缘丛的更快算法。CircularLayout

树布局

• 根对齐还可以考虑端口位置以拉直 出一个边缘。GenericTreeLayout
• 该类现在还支持配置的集成边缘标记 使用 .TreeLayoutLayeredNodePlacer

边缘路由器

• 该类现在为某些具有单调路径的设置生成更好的结果 具有垂直/水平重叠端点的限制和边。EdgeRouter
• 该类现在尝试避免跨越固定外部端口的路由 其他 Edge 以及其他 Edge 的组节点上的固定内部端口。新属性允许指定此类过境的费用。EdgeRouterPenaltySettings.PortCrossingPenalty
• 该类现在支持包含自循环的总线（请参阅类）。以前，自循环被忽略。EdgeRouterBusDescriptor

通用标签

• 通用标记算法具有额外的预设，以避免标签和 分区网格。

布局

• 改进了布局动画的初始化时间和内存消耗。
• 该类现在会自动标记插入的组 具有注册到具有键的输入图形的节点。TemporaryGroupNodeInsertionStageIDataProviderInsertedGroupNodeDpKey
• 该类现在还支持分层指定 嵌套的临时组。因此，添加了新类。TemporaryGroupNodeInsertionStageTemporaryGroupDescriptor

分析

• 和算法使用的枚举已扩展。已添加忽略的枚举值 边缘方向，在语义上与前一个值相对应。的语义已调整为确实返回 和结果的并集。为了保持 和 算法的默认行为，其属性的默认值已从 更改为 。TraversalDirectionNeighborhoodBfsUndirectedBothBothSuccessorPredecessorNeighborhoodBfsTraversalDirectionBothUndirected
• 该类现在支持对图形的子集进行操作。GraphStructureAnalyzer
• 类上的 new 和属性允许定义算法应操作的节点/边的子集。SubgraphNodesSubgraphEdgesReachability

错误修正

视图

• 合并 和撤消不再抛出 .HierarchicNestingPolicy.GroupNodesLabelLayerPolicy.AtOwnerNullReferenceException
• 当缩放级别接近 或 时，视口动画不再突然停止。CanvasControl.MinimumZoomMaximumZoom
• 按住滚动条按钮不再滚动超出此指示的可滚动区域 滚动条。
• 更改属性不再触发不必要的重新创建 的视觉效果。ICanvasObject.Group
• 修复了取消选择项目时不调用的错误。SelectionIndicatorManagerRemoveSelection
• 更改属性不再泄漏内存 某些情况。GraphControl.GraphModelManager
• 通过调用方法显示在给定位置的工具提示在每次鼠标移动后不再立即隐藏。它现在尊重 该物业。MouseHoverInputMode.ShowMouseHoverSize
• 调用普通（即非组）节点不再创建 或 视图状态（包括意外调用，即使结果永远不会被使用）。现在 在普通节点上调用不执行任何操作。IFoldingView.CollapseUndoUnitIFolderNodeConverter.InitializeFolderNodeIFoldingView.Collapse
• 标签的自动翻转行为现在也适用于扭曲标签的投影。
• 修复了显示器与显示器结合使用的潜在文本剪切问题 缩放。HighDPI

图

• 修复了 事件中的一个错误，其中 前提是旧父级可能存在于包装图中，但不存在于过滤的图中。FilteredGraphWrapperNodeRemoved
• 该类现在在过滤出端口时引发正确的事件 标签。以前，事件包含不正确的所有者信息。FilteredGraphWrapper

互动

• 粘贴后，另一个封闭组中的封闭组节点现在保持关闭状态。以前，它 由于类中的错误而打开。GraphClipboard
• 该方法现在每次调用仅更新一次属性。以前曾有过这样的情况 物业会不必要地更新两次。GraphEditorInputMode.AdjustContentRectCanvasControl.ContentRect
• 当属性 改变。TableEditorInputModeGraphControl.SelectionGraphControl.Graph
• 如果 句柄在其自己的调用期间被删除。这修复了一些非常罕见的异常 情况复杂。HandleInputModecanceledDragFinished
• 多个实例现在可以正确考虑其各自的优先级。DropInputMode
• UndoEngine不再为某些罕见的中止操作添加空的撤消单元 例。
• 将 设置为 1 秒不再导致异常 现在将其设置为一秒以上会正确考虑总持续时间，而不仅仅是小数秒部分。CanvasControl.DoubleClickTimeClickInputMode
• 和 的事件现在仅在将鼠标悬停在图形元素上时触发一次，而不是两次。QueryItemToolTipGraphEditorInputModeGraphViewerInputMode

风格

• 现在，克隆实例可以正确克隆表的所有内部状态。 以前，更改克隆表的内陷可能会导致克隆表的条带不更新其几何。ITable
• TableNodeStyle现在允许表背景样式访问表节点的标记。
• 带有圆角的内置样式现在具有适用于所有计算的正确轮廓形状。
• 具有贝塞尔路径的边现在也可以动画化为非贝塞尔路径。
• 边缘裁剪现在在使用类和 终止节点的样式在其实现中不提供大纲。BezierEdgeStyleIShapeGeometry
• DefaultLabelStyle现在正确考虑其属性的标志。以前是 通常用于确定剪辑和换行行为。NoWrapFormatFlagsStringFormatClipText
• DefaultLabelStyle现在正确处理旋转 刷。NormalizeBrushes
• ImageIcon现在考虑图像的像素大小进行绘画，而不是 物理尺寸。这意味着它现在与自己的属性一致。Size
• 现在正确设置新投影可使视口中心保持 相同。CanvasControl