SnapLine Klasse

Definition

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
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:

Weitere Informationen