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 Designtools unterstützen, um Sie bei der Positionierung und Größenanpassung von Steuerelementen auf einer Entwurfsoberfläche zu unterstützen.

Mode	BESCHREIBUNG
Freiform	Ermöglicht ihnen das freie Layout von Steuerelementen.
Raster	Zeigt ein statisches überlagerte Raster an, das Sie beim Auslegen von Steuerelementen unterstützt.
Ausrichtungslinie	Zeigt Führungslinien an, die Sie beim Layout der Steuerelemente des Containers relativ zueinander unterstützen. Andocklinien stammen von Steuerelementen und deren Containern.

Die SnapLine Klasse und die zugehörigen Typen unterstützen den Snapline-Modus.

Ausrichtungslinien werden dynamisch und automatisch generiert, wenn sich eine Steuerungskante in die Nähe eines anderen Steuerelements oder in die Nähe der Grenzen seines Containers bewegt. Dies kann auftreten, wenn ein Steuerelement aus der Toolbox hinzugefügt oder die Größe durch Mausvorgänge oder Tastaturbefehle verschoben oder geändert wird. Für Steuerelemente sind in der Regel sowohl horizontale als auch vertikale Ausrichtungslinien definiert. bei rechteckigen Steuerelementen erstrecken sich diese in der Regel über alle vier Kanten.

Die SnapLine -Klasse verwendet nur wenige Eigenschaften, um jede Andocklinie zu beschreiben, wie in der folgenden Tabelle gezeigt.

Eigenschaft	BESCHREIBUNG
SnapLineType	Gibt die Position und Richtung der Linie in Bezug auf das zugeordnete Steuerelement an. In der Regel werden nur Ausrichtungslinien ähnlicher Typen automatisch aneinander ausgerichtet.
Offset	Gibt den Abstand in Pixel vom Ursprung (der oberen linken Ecke des Steuerelements) bis zum Anfang der Andocklinie an.
Priority	Gibt die relative Wichtigkeit der Andocklinie an. Während eines bestimmten Layoutentscheidungspunkts werden nur die Ausrichtungslinien angezeigt, die aktiv sind und die höchste Priorität haben.
Filter	Definiert benutzerdefinierte Kategorien von Ausrichtungslinien. Dies ist eine optionale Zeichenfolge.
IsHorizontal und IsVertical	Gibt an, ob eine Ausrichtungslinie horizontal oder vertikal ausgerichtet ist.

Die ControlDesigner -Klasse speichert Ausrichtungslinien für den entsprechenden Steuerelementtyp in der SnapLines -Eigenschaft. Diese Basisklassenbehandlung von Ausrichtungslinien reicht für die meisten Steuerelemente aus, da sie die LeftAusrichtungslinien , Right, Topund Bottom definiert, die an den Rändern des Steuerelements ausgerichtet sind. Wenn Sie ein benutzerdefiniertes Steuerelement entwickeln, wenn diese Standardorganisation nicht ausreicht, überschreiben Sie die SnapLines -Eigenschaft der von ControlDesignerabgeleiteten Klasse. Beispielsweise können Sie die horizontalen Ausrichtungslinien von textbasierten Steuerelementen, z. B. Bezeichnungen, an den oberen und Basiszeilen des Texts ausrichten (anstelle der oberen und unteren Ränder des Steuerelements).

Die SnapLineType -Klasse kann nicht von abgeleitet werden.

Dieses Feature wird in Visual Studio umfassend unterstützt. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Anordnen von Steuerelementen in Windows Forms mithilfe von Ausrichtungslinien.

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:

Freigeben über