SnapLine Klasse

Referenz

Definition

Namespace:: System.Windows.Forms.Design.Behavior

Assembly:: System.Design.dll

Assembly:: System.Windows.Forms.Design.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt das horizontale und das vertikale Liniensegment dar, die auf der Benutzeroberfläche dynamisch erstellt werden, um das Layout von Steuerelementen in einem Container zur Entwurfszeit zu unterstützen. Diese Klasse kann nicht vererbt werden.

public ref class SnapLine sealed

public sealed class SnapLine

type SnapLine = class

Public NotInheritable Class SnapLine

Vererbung: Object
SnapLine

Hinweise

In der folgenden Tabelle sind die allgemeinen Modi aufgeführt, die visuelle Entwurfstools unterstützen, um Sie bei der Positionierung und Größe von Steuerelementen auf einer Entwurfsoberfläche zu unterstützen.

Mode	BESCHREIBUNG
Freiform	Ermöglicht Es Ihnen, Steuerelemente frei festzulegen.
Raster	Zeigt ein statisches übergespeichertes Raster an, das Ihnen bei der Erstellung von Steuerelementen hilft.
Ausrichtungslinie	Zeigt Führungslinien an, die Ihnen bei der Erstellung der Steuerelemente des Containers relativ zueinander helfen. Snaplines stammen aus Steuerelementen und ihrem Container.

Die SnapLine Klassen- und verwandten Typen unterstützen den Snapline-Modus.

Snaplines werden dynamisch und automatisch generiert, da sich ein Steuerelementrand in der Nähe eines anderen Steuerelements oder in der Nähe der Grenzen des Containers bewegt. Dies kann auftreten, wenn ein Steuerelement aus der Toolbox hinzugefügt oder durch Mausvorgänge oder Tastaturbefehle verschoben oder geändert wird. Steuerelemente haben in der Regel horizontale und vertikale Snaplines definiert; für rechteckige Steuerelemente erweitern sich diese in der Regel von allen vier Kanten.

Die SnapLine Klasse verwendet nur einige Eigenschaften, um jede Snapline zu beschreiben, wie in der folgenden Tabelle dargestellt.

Eigenschaft	BESCHREIBUNG
SnapLineType	Gibt die Position und Richtung der Linie im Hinblick auf das zugeordnete Steuerelement an. Normalerweise werden nur Snaplines ähnlicher Typen automatisch aneinander ausgerichtet.
Offset	Gibt den Abstand in Pixeln vom Ursprung an, der die obere linke Ecke des Steuerelements ist, zu der die Snapline beginnt.
Priority	Gibt die relative Bedeutung der Snapline an. Während eines bestimmten Layoutentscheidungspunkts werden nur die Snaplines angezeigt, die aktiv sind und die höchste Priorität haben.
Filter	Definiert benutzerdefinierte Kategorien von Snaplines. Dies ist eine optionale Zeichenfolge.
IsHorizontal und IsVertical	Gibt an, ob eine Snapline horizontal oder vertikal ausgerichtet ist.

Die ControlDesigner Klasse speichert Snaplines für den entsprechenden Steuerelementtyp in der SnapLines Eigenschaft. Diese Basisklassenbehandlung von Snaplines reicht für die Mehrheit der Steuerelemente aus, da sie die Left Right Top, und Bottom Snaplines definiert, die entlang der Kanten des Steuerelements ausgerichtet sind. Wenn Sie ein benutzerdefiniertes Steuerelement entwickeln, wenn diese Standardorganisation nicht ausreichend ist, überschreiben Sie die SnapLines Eigenschaft der von der ControlDesignerabgeleiteten Klasse. Beispielsweise möchten Sie die horizontalen Snaplines von textbasierten Steuerelementen, z. B. Beschriftungen, mit den oberen und Basiszeilen des Texts ausrichten (anstelle der oberen und unteren Rand des Steuerelements).

Die SnapLineType Klasse kann nicht abgeleitet werden.

Es gibt umfangreiche Unterstützung für dieses Feature in Visual Studio, siehe Exemplarische Vorgehensweise: Anordnen von Steuerelementen für Windows Forms Verwenden von Snaplines.

Konstruktoren

SnapLine(SnapLineType, Int32)	Initialisiert eine neue Instanz der SnapLine-Klasse unter Verwendung des angegebenen Ausrichtungslinientyps und des angegebenen Offsets.
SnapLine(SnapLineType, Int32, SnapLinePriority)	Initialisiert eine neue Instanz der SnapLine-Klasse unter Verwendung des angegebenen Ausrichtungslinientyps, des angegebenen Offsets und der angegebenen Priorität.
SnapLine(SnapLineType, Int32, String)	Initialisiert eine neue Instanz der SnapLine-Klasse unter Verwendung des angegebenen Ausrichtungslinientyps, des angegebenen Offsets und des angegebenen Filternamens.
SnapLine(SnapLineType, Int32, String, SnapLinePriority)	Initialisiert eine neue Instanz der SnapLine-Klasse unter Verwendung des angegebenen Ausrichtungslinientyps, des angegebenen Offsets, des angegebenen Filternamens und der angegebenen Priorität.

Eigenschaften

Filter	Ruft die vom Programmierer definierte Filterkategorie ab, die dieser Ausrichtungslinie zugeordnet ist.
IsHorizontal	Ruft einen Wert ab, der angibt, ob die Ausrichtungslinie horizontal ausgerichtet ist.
IsVertical	Ruft einen Wert ab, der angibt, ob die Ausrichtungslinie vertikal ausgerichtet ist.
Offset	Ruft den Offset in Pixel der Ausrichtungslinie in Bezug auf den Ursprung des zugeordneten Steuerelements ab.
Priority	Ruft einen Wert ab, der die relative Wichtigkeit der Ausrichtungslinie angibt.
SnapLineType	Ruft den Typ einer Ausrichtungslinie ab, der die allgemeine Position und die allgemeine Ausrichtung angibt.

Methoden

AdjustOffset(Int32)	Passt die Offset-Eigenschaft der Ausrichtungslinie an.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ShouldSnap(SnapLine, SnapLine)	Gibt einen Wert zurück, der angibt, ob die angegebene SnapLine an einer anderen SnapLine ausgerichtet werden soll.
ToString()	Gibt eine Zeichenfolgendarstellung der aktuellen Ausrichtungslinie zurück.

Gilt für