SnapLine 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示在用户界面 (UI) 中动态创建以便在容器中辅助控件的设计时布局的水平和垂直线段。 此类不能被继承。
public ref class SnapLine sealedpublic sealed class SnapLinetype SnapLine = classPublic NotInheritable Class SnapLine- 继承
-
SnapLine
注解
下表列出了可视化设计工具支持的常见模式，这些模式可帮助你在设计图面上定位和调整控件的大小。
| “模式” | 说明 |
|---|---|
| 自由形式 | 使你能够自由布局控件。 |
| 网格 | 显示一个静态叠加网格，该网格可帮助你布局控件。 |
| 对齐线 | 显示有助于设置容器控件彼此相对布局的参考线。 对齐线源自控件及其容器。 |
类 SnapLine 和相关类型有助于支持对齐线模式。
当控件边缘靠近另一个控件或靠近其容器边界时，动态自动生成对齐线。 从工具箱中添加控件，或者通过鼠标操作或键盘命令移动或调整其大小时，可能会发生这种情况。 控件通常同时定义了水平对齐线和垂直对齐线;对于矩形控件，这些控件通常从所有四个边缘扩展。
类 SnapLine 仅使用几个属性来描述每个对齐线，如下表所示。
| properties | 说明 |
|---|---|
| SnapLineType | 指定线条相对于其关联控件的位置和方向。 通常，只有类似类型的对齐线才会自动彼此对齐。 |
| Offset | 指定从原点（控件的左上角）到对齐线开始位置的距离（以像素为单位）。 |
| Priority | 指定对齐线的相对重要性。 在任何给定的布局决策点期间，仅显示处于活动状态且具有最高优先级的对齐线。 |
| Filter | 定义对齐线的自定义类别。 这是一个可选字符串。 |
| IsHorizontal 和 IsVertical | 指示对齐线分别具有水平方向还是垂直方向。 |
类 ControlDesigner 在 属性中 SnapLines 存储其相应控件类型的对齐线。 对齐线的此基类处理对于大多数控件来说就足够了，因为它定义了 Left沿控件边缘对齐的 、 Right、 Top和 Bottom 对齐线。 开发自定义控件时，如果此默认组织不足以满足要求，请重写 SnapLines 派生自 ControlDesigner的 类的 属性。 例如，你可能希望将基于文本的控件（如标签）的水平对齐线与文本 (的上边缘和底线对齐，而不是控件) 的上边缘和下边缘。
SnapLineType类不能派生自。
Visual Studio 中广泛支持此功能，请参阅 演练：使用对齐线在 Windows 窗体上排列控件。
构造函数
| SnapLine(SnapLineType, Int32) |
使用指定对齐线类型和偏移量初始化 SnapLine 类的新实例。 |
| SnapLine(SnapLineType, Int32, SnapLinePriority) |
使用指定的对齐线类型、偏移量和优先级初始化 SnapLine 类的新实例。 |
| SnapLine(SnapLineType, Int32, String) |
使用指定的对齐线类型、偏移量和筛选器名称初始化 SnapLine 类的新实例。 |
| SnapLine(SnapLineType, Int32, String, SnapLinePriority) |
使用指定的对齐线类型、偏移量、筛选器名称和优先级初始化 SnapLine 类的新实例。 |
属性
| Filter |
获取与此对齐线关联的由程序员定义的筛选器类别。 |
| IsHorizontal |
获取一个值，该值指示对齐线是否有水平方向。 |
| IsVertical |
获取一个值，该值指示对齐线是否有垂直方向。 |
| Offset |
获取对齐线偏离关联控件的原点的像素数。 |
| Priority |
获取指示对齐线的相对重要性的值。 |
| SnapLineType |
获取对齐线的类型，它指示一般位置和方向。 |
方法
| AdjustOffset(Int32) |
调整对齐线的 Offset 属性。 |
| Equals(Object) |
确定指定对象是否等于当前对象。 (继承自 Object) |
| GetHashCode() |
作为默认哈希函数。 (继承自 Object) |
| GetType() |
获取当前实例的 Type。 (继承自 Object) |
| MemberwiseClone() |
创建当前 Object 的浅表副本。 (继承自 Object) |
| ShouldSnap(SnapLine, SnapLine) | |
| ToString() |
返回当前对齐线的字符串表示形式。 |
