SnapLine クラス

.NET Framework クラス ライブラリ リファレンス

SnapLine クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Windows.Forms.Design.Behavior
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 SnapLine

Visual Basic (使用法)

Dim instance As SnapLine

C#

public sealed class SnapLine

C++

public ref class SnapLine sealed

J#

public final class SnapLine

JScript

public final class SnapLine

解説

デザイン サーフェイスにおけるコントロールの位置決めとサイズ設定を容易にするために、ビジュアル デザイン ツールがサポートする 共通モードを次の表に示します。

モード	説明
Freeform	コントロールを自由にレイアウトできます。
Grid	コントロールのレイアウト操作を支援する静的なオーバーレイ グリッドが表示されます。
Snapline	コンテナのコントロール間の相対的なレイアウト操作を支援するガイドラインが表示されます。スナップ線の始点は、コントロールおよびそのコンテナです。

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

スナップ線は、コントロールの端を別のコントロールの近くに移動するか、またはコンテナの境界の近くに移動すると、動的かつ自動的に生成されます。スナップ線は、ツールボックスからコントロールを追加するか、またはマウス操作またはキーボード コマンドでコントロールを移動またはサイズ変更すると生成されます。通常、コントロールには水平のスナップ線と垂直のスナップ線の両方が定義されています。四角形のコントロールの場合、4 つの端すべてからスナップ線が伸びます。

SnapLine クラスは、次の表に示すような少数のプロパティだけを使用して各スナップ線を表します。

プロパティ	説明
SnapLineType	関連付けられたコントロールに対する線の位置と方向を指定します。通常、類似する型のスナップ線だけが相互に自動配置されます。
Offset	コントロールの左上隅の原点から、スナップ線が始まる位置までの距離をピクセル単位で指定します。
Priority	スナップ線の相対的な優先順位を指定します。指定されたレイアウトを決定するまでの間、アクティブで最も優先順位の高いスナップ線だけが表示されます。
Filter	スナップ線のカスタム カテゴリを定義します。これはオプションの文字列です。
IsHorizontal および IsVertical	それぞれのスナップ線の方向が水平か垂直かを示します。

ControlDesigner クラスは、対応するコントロールの種類に応じたスナップ線を SnapLines プロパティに格納します。この基本クラスは、コントロールの端に沿って配置される Left、Right、Top、および Bottom の各スナップ線を定義するため、基本クラスによるスナップ線の処理で大部分のコントロールに対応できます。カスタム コントロールを作成するときに、この既定の編成方法では不十分な場合、ControlDesigner から派生したクラスの SnapLines プロパティをオーバーライドします。たとえば、ラベルなどのテキスト ベースのコントロールに対して、コントロールの上端および下端の代わりにテキストの上端の線とベース ラインに水平スナップ線を配置できます。

SnapLineType クラスは派生できません。

Visual Studio では、この機能が幅広くサポートされています。

詳細については、「 チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置」を参照してください。

継承階層

System.Object
  System.Windows.Forms.Design.Behavior.SnapLine

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SnapLine メンバ
System.Windows.Forms.Design.Behavior 名前空間
SnapLineType
SnapLinePriority
ControlDesigner.SnapLines プロパティ
その他の技術情報
デザイン時サポートの拡張