SnapLine クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コンテナー内のコントロールのデザイン時にレイアウト操作を支援するために、ユーザー インターフェイス (UI) に動的に作成される水平の線分と垂直の線分を表します。 このクラスは継承できません。
public ref class SnapLine sealedpublic sealed class SnapLinetype SnapLine = classPublic NotInheritable Class SnapLine- 継承
-
SnapLine
注釈
次の表は、デザイン サーフェイスでのコントロールの配置とサイズ設定に役立つビジュアル デザイン ツールでサポートされる一般的なモードの一覧です。
| モード | 説明 |
|---|---|
| 自由形式 | コントロールを自由にレイアウトできます。 |
| グリッド | コントロールをレイアウトする際に役立つ静的オーバーレイ グリッドを表示します。 |
| スナップ | コンテナーのコントロールを互いに相対的にレイアウトするのに役立つガイド ラインが表示されます。 スナップ線は、コントロールとそのコンテナーから作成されます。 |
クラスと関連する型は SnapLine 、Snapline モードをサポートするのに役立ちます。
スナップ線は、コントロール エッジが別のコントロールの近く、またはそのコンテナーの境界の近くに移動すると、動的かつ自動的に生成されます。 これは、コントロールがツールボックスから追加されたとき、またはマウス操作またはキーボード コマンドによって移動またはサイズ変更された場合に発生する可能性があります。 通常、コントロールには水平スナップ線と垂直スナップ線の両方が定義されています。四角形コントロールの場合、これらは通常、4 つのエッジすべてから拡張されます。
このクラスでは SnapLine 、次の表に示すように、各スナップ線の説明に使用するプロパティはわずかです。
| プロパティ | 説明 |
|---|---|
| SnapLineType | 関連するコントロールに対する線の位置と方向を指定します。 通常、類似する種類のスナップ線のみが互いに自動的に整列されます。 |
| Offset | コントロールの左上隅である原点からスナップ線の開始位置までの距離をピクセル単位で指定します。 |
| Priority | スナップ線の相対的な重要度を指定します。 特定のレイアウト決定ポイントでは、アクティブで優先度が最も高いスナップ線のみが表示されます。 |
| Filter | スナップ線のカスタム カテゴリを定義します。 これは省略可能な文字列です。 |
| IsHorizontal および IsVertical | スナップ線の向きが水平方向か垂直方向かを示します。 |
このクラスは ControlDesigner 、対応するコントロール型のスナップ線をプロパティに SnapLines 格納します。 スナップ線のこの基本クラスの処理は、コントロールの端に沿って配置される 、、Right、Top、およびBottomスナップ線を定義Leftするコントロールの大部分で十分です。 カスタム コントロールを開発する場合、この既定の組織で十分でない場合は、派生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) | |
| ToString() |
現在のスナップ線の文字列形式を返します。 |