SnapLine クラス

定義

コンテナー内のコントロールのデザイン時にレイアウト操作を支援するために、ユーザー インターフェイス (UI) に動的に作成される水平の線分と垂直の線分を表します。 このクラスは継承できません。

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

注釈

次の表に、ビジュアル デザイン ツールがサポートする一般的なモードを示します。これは、デザイン サーフェイスでのコントロールの配置とサイズ設定に役立ちます。

モード 説明
自由形式 コントロールを自由にレイアウトできます。
グリッド コントロールのレイアウトを支援する静的なオーバーレイ グリッドを表示します。
スナップ コンテナーのコントロールを相互に相対的にレイアウトするのに役立つガイド ラインを表示します。 スナップ線は、コントロールとそのコンテナーから生成されます。

クラスと関連する型は SnapLine 、Snapline モードをサポートするのに役立ちます。

スナップ線は、コントロール エッジが別のコントロールの近く、またはそのコンテナーの境界の近くに移動すると、動的かつ自動的に生成されます。 これは、ツールボックスからコントロールが追加された場合や、マウス操作またはキーボード コマンドによって移動またはサイズ変更された場合に発生する可能性があります。 通常、コントロールには水平スナップ線と垂直スナップ線の両方が定義されています。四角形コントロールの場合、これらは通常、4 つのエッジすべてから拡張されます。

クラスでは SnapLine 、次の表に示すように、各スナップ線を記述するためにいくつかのプロパティのみを使用します。

プロパティ 説明
SnapLineType 線の位置と方向を、関連するコントロールに対して指定します。 通常、類似した種類のスナップ線のみが互いに自動的に整列されます。
Offset コントロールの左上隅である原点からスナップ線の開始位置までの距離をピクセル単位で指定します。
Priority スナップ線の相対的な重要度を指定します。 特定のレイアウト決定ポイントでは、アクティブで優先度が最も高いスナップ線のみが表示されます。
Filter スナップ線のカスタム カテゴリを定義します。 これは省略可能な文字列です。
IsHorizontal および IsVertical スナップ線の向きをそれぞれ水平方向と垂直方向のどちらにするかを示します。

クラスは ControlDesigner 、対応するコントロール型のスナップ線を プロパティに SnapLines 格納します。 スナップ線のこの基本クラスの処理は、コントロールの端に沿って配置される 、および Bottom スナップ線を定義LeftRightTopしているため、ほとんどのコントロールで十分です。 カスタム コントロールを開発するときに、この既定の組織で十分でない場合は、 からControlDesigner派生したクラスの プロパティをオーバーライドSnapLinesします。 たとえば、ラベルなどのテキスト ベースのコントロールの水平方向のスナップ線を、テキストの上端と下の端ではなく、テキストの上と下の行に合わせて配置できます。

クラスは 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)

指定した SnapLine が別の SnapLine とスナップする必要があるかどうかを示す値を返します。

ToString()

現在のスナップ線の文字列形式を返します。

適用対象

こちらもご覧ください