SnapLine SnapLine SnapLine SnapLine Class

定義

コンテナー内のコントロールのデザイン時にレイアウト操作を支援するために、ユーザー インターフェイス (UI) に動的に作成される水平の線分と垂直の線分を表します。Represents the horizontal and vertical line segments that are dynamically created in the user interface (UI) to assist in the design-time layout of controls in a container. このクラスは継承できません。This class cannot be inherited.

public ref class SnapLine sealed
public sealed class SnapLine
type SnapLine = class
Public NotInheritable Class SnapLine
継承
SnapLineSnapLineSnapLineSnapLine

注釈

次の表では、ビジュアル デ ザイン ツールを配置およびデザイン サーフェイス上のコントロールのサイズ変更を支援するためにサポートする一般的なモードを示します。The following table lists the common modes that visual design tools support to assist you with positioning and sizing controls on a design surface.

モードMode 説明Description
自由形式Freeform コントロールを自由に配置できます。Enables you to freely lay out controls.
グリッドGrid コントロールのレイアウト操作を支援する静的なオーバーレイ グリッドが表示されます。Displays a static overlaid grid that assists you in laying out controls.
スナップ線Snapline 相互に比較した、コンテナーのコントロールをレイアウトするために役立つガイド線を表示します。Displays guide lines that assist you in laying out the container's controls relative to each other. スナップ線は、コントロールおよびそのコンテナーから発生します。Snaplines originate from controls and their container.

SnapLineクラスおよび関連する型のヘルプ、スナップ線のモードをサポートします。The SnapLine class and related types help support the Snapline mode.

スナップ線が動的に生成され、自動的にコントロールを edge 上に移動する別のコントロールの近くか、またはそのコンテナーの境界の近くします。Snaplines are generated dynamically and automatically as a control edge moves near another control or near the boundaries of its container. これは、コントロールをツールボックスから追加または移動またはマウス操作またはキーボード コマンドがサイズ変更時に発生します。This can occur when a control is added from the toolbox, or moved or resized by mouse operations or keyboard commands. コントロールに通常水平線と垂直のスナップ線が定義されている場合があります。四角形のコントロールのこれらがすべての 4 辺から拡張通常なりました。Controls typically have both horizontal and vertical snaplines defined; for rectangular controls, these typically extend from all four edges.

SnapLineクラスは、次の表に示すように、各スナップ線を記述するいくつかのプロパティのみを使用します。The SnapLine class uses only a few properties to describe each snapline, as shown in the following table.

プロパティProperty 説明Description
SnapLineType 場所とその関連付けられているコントロールを基準線の方向を指定します。Specifies the location and direction of the line with respect to its associated control. 通常、類似した種類のスナップ線だけが自動整列互いにします。Typically, only snaplines of similar types will auto-align to each other.
Offset スナップ線の開始位置にコントロールの左上隅には、配信元からのピクセル単位で距離を指定します。Specifies the distance in pixels from the origin, which is the upper-left corner of the control, to where the snapline starts.
Priority スナップ線の相対的な重要度を指定します。Specifies the relative importance of the snapline. 特定のレイアウトの意思決定ポイント中にアクティブであり、優先順位が最も高いスナップ線だけが表示されます。During any given layout decision point, only the snaplines that are active and have the highest priority are displayed.
Filter スナップ線のカスタム カテゴリを定義します。Defines custom categories of snaplines. これは、省略可能な文字列です。This is an optional string.
IsHorizontal および IsVerticalIsHorizontal and IsVertical スナップ線が水平または垂直方向の向きをそれぞれがかどうかを示します。Indicates whether a snapline has horizontal or vertical orientation, respectively.

ControlDesignerクラスは、対応するコントロールの種類のためのスナップ線を格納、SnapLinesプロパティ。The ControlDesigner class stores snaplines for its corresponding control type in the SnapLines property. スナップ線の場合は、この基本クラス処理にとって有益な大半のコントロールを定義するため、 LeftRightTop、およびBottomスナップ線は、コントロールの端に沿って配置されます。This base class handling of snaplines will suffice for the majority of controls, as it defines the Left, Right, Top, and Bottom snaplines, which are aligned along the edges of the control. この既定の組織が十分ではない場合、カスタム コントロールを開発する場合は、オーバーライド、SnapLinesから派生したクラスのプロパティControlDesignerします。When you are developing a custom control, if this default organization does not suffice, override the SnapLines property of the class derived from ControlDesigner. たとえば、上部と (コントロールの上端と下端の端) ではなくテキストのベース ラインを使用して、ラベルなどのテキスト ベースのコントロールの水平のスナップ線を配置することがあります。For example, you may want to align the horizontal snaplines of text-based controls, such as labels, with the top and base lines of the text (instead of the top and bottom edges of the control).

SnapLineTypeクラスから派生することはできません。The SnapLineType class cannot be derived from.

Visual Studio でこの機能の広範なサポートを参照してくださいチュートリアル。フォームのスナップ線を使用して Windows 上のコントロールします。There is extensive support for this feature in Visual Studio, see Walkthrough: Arranging Controls on Windows Forms Using Snaplines.

コンストラクター

SnapLine(SnapLineType, Int32) SnapLine(SnapLineType, Int32) SnapLine(SnapLineType, Int32) SnapLine(SnapLineType, Int32)

スナップ線の種類とオフセットを指定して、SnapLine クラスの新しいインスタンスを初期化します。Initializes a new instance of the SnapLine class using the specified snapline type and offset.

SnapLine(SnapLineType, Int32, SnapLinePriority) SnapLine(SnapLineType, Int32, SnapLinePriority) SnapLine(SnapLineType, Int32, SnapLinePriority) SnapLine(SnapLineType, Int32, SnapLinePriority)

スナップ線の種類、オフセット、および優先順位を指定して、SnapLine クラスの新しいインスタンスを初期化します。Initializes a new instance of the SnapLine class using the specified snapline type, offset, and priority.

SnapLine(SnapLineType, Int32, String) SnapLine(SnapLineType, Int32, String) SnapLine(SnapLineType, Int32, String) SnapLine(SnapLineType, Int32, String)

スナップ線の種類、オフセット、およびフィルター名を指定して、SnapLine クラスの新しいインスタンスを初期化します。Initializes a new instance of the SnapLine class using the specified snapline type, offset, and filter name.

SnapLine(SnapLineType, Int32, String, SnapLinePriority) SnapLine(SnapLineType, Int32, String, SnapLinePriority) SnapLine(SnapLineType, Int32, String, SnapLinePriority) SnapLine(SnapLineType, Int32, String, SnapLinePriority)

スナップ線の種類、オフセット、フィルター名、および優先順位を指定して、SnapLine クラスの新しいインスタンスを初期化します。Initializes a new instance of the SnapLine class using the specified snapline type, offset, filter name, and priority.

プロパティ

Filter Filter Filter Filter

このスナップ線に関連付けられている、プログラマが定義したフィルター カテゴリを取得します。Gets the programmer-defined filter category associated with this snapline.

IsHorizontal IsHorizontal IsHorizontal IsHorizontal

スナップ線が水平方向かどうかを示す値を取得します。Gets a value indicating whether the snapline has a horizontal orientation.

IsVertical IsVertical IsVertical IsVertical

スナップ線が垂直方向かどうかを示す値を取得します。Gets a value indicating whether the snapline has a vertical orientation.

Offset Offset Offset Offset

関連付けられたコントロールの原点からのスナップ線のオフセットをピクセル数で取得します。Gets the number of pixels that the snapline is offset from the origin of the associated control.

Priority Priority Priority Priority

スナップ線の相対的な優先順位を示す値を取得します。Gets a value indicating the relative importance of the snapline.

SnapLineType SnapLineType SnapLineType SnapLineType

大まかな位置と方向を示す、スナップ線の種類を取得します。Gets the type of a snapline, which indicates the general location and orientation.

メソッド

AdjustOffset(Int32) AdjustOffset(Int32) AdjustOffset(Int32) AdjustOffset(Int32)

スナップ線の Offset プロパティを調整します。Adjusts the Offset property of the snapline.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ShouldSnap(SnapLine, SnapLine) ShouldSnap(SnapLine, SnapLine) ShouldSnap(SnapLine, SnapLine) ShouldSnap(SnapLine, SnapLine)

指定した SnapLine が別の SnapLine とスナップする必要があるかどうかを示す値を返します。Returns a value indicating whether the specified SnapLine should snap to another SnapLine.

ToString() ToString() ToString() ToString()

現在のスナップ線の文字列形式を返します。Returns a string representation of the current snapline.

適用対象

こちらもご覧ください