SnapLine 類別

  • 參考

定義

命名空間:
System.Windows.Forms.Design.Behavior
組件:
System.Design.dll
組件:
System.Windows.Forms.Design.dll

表示在使用者介面 (UI) 中動態建立的水平和垂直線段，用於協助容器中控制項的設計階段配置。 此類別無法獲得繼承。

public ref class SnapLine sealed
public sealed class SnapLine
type SnapLine = class
Public NotInheritable Class SnapLine
繼承
Object
SnapLine

備註

下表列出視覺化設計工具支援的常見模式，以協助您在設計介面上定位和調整大小控制項。

[模式] 描述
自由 可讓您自由配置控制項。
方格 顯示可協助您配置控制項的靜態重設格線。
貼齊線 顯示指引線，協助您配置容器的控制項彼此相對。 貼齊線源自控制項及其容器。

類別 SnapLine 和相關類型可協助支援貼齊模式。

動態產生貼齊線，並自動產生，因為控制項邊緣會移至另一個控制項附近或接近其容器的界限。 當控制項從工具箱新增，或由滑鼠作業或鍵盤命令移動或調整大小時，就會發生此情況。 控制項通常會同時定義水準和垂直對齊線;針對矩形控制項，這些控制項通常會從所有四個邊緣延伸。

類別 SnapLine 只會使用幾個屬性來描述每個貼齊線，如下表所示。

屬性 描述
SnapLineType 指定相對於其相關聯控制項之線條的位置和方向。 一般而言，只有類似類型的貼齊線會自動彼此對齊。
Offset 指定從原點開始對齊線的左上角，以圖元為單位的距離。
Priority 指定貼齊線的相對重要性。 在任何指定的版面配置決策點期間，只會顯示作用中且具有最高優先順序的貼齊線。
Filter 定義貼齊線的自訂類別。 這是選擇性字串。
IsHorizontal 和 IsVertical 指出貼齊線是否分別具有水準或垂直方向。

類別 ControlDesigner 會在 屬性中 SnapLines 儲存其對應控制項類型的貼齊線。 這個對齊線的基類處理就足以處理大部分控制項，因為它會定義 Left 沿著控制項邊緣對齊的 、 Right 、 Top 和 Bottom 貼齊線。 當您開發自訂控制項時，如果這個預設組織不足夠，請覆寫 SnapLines 衍生自 ControlDesigner 的 類別屬性。 例如，您可能想要對齊文字型控制項的水準對齊線，例如標籤，以及文字的頂端和基底線 (，而不是控制項的上邊緣和底邊緣) 。

類別 SnapLineType 無法衍生自 。

Visual Studio中這項功能有廣泛的支援，請參閱逐步解說：使用貼齊線排列Windows Forms上的控制項。

建構函式

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)

傳回值，指出指定的 SnapLine 是否應該與另一個 SnapLine 貼齊。
ToString()

傳回目前對齊線的字串表示。

適用於

另請參閱