SnapLine Klasa

Definicja

Reprezentuje segmenty linii poziomej i pionowej, które są dynamicznie tworzone w interfejsie użytkownika, aby ułatwić projektowanie układu kontrolek w kontenerze. Klasa ta nie może być dziedziczona.

public ref class SnapLine sealed
public sealed class SnapLine
type SnapLine = class
Public NotInheritable Class SnapLine
Dziedziczenie
SnapLine

Uwagi

W poniższej tabeli wymieniono typowe tryby obsługiwane przez narzędzia do projektowania wizualnego, które ułatwiają pozycjonowanie i określanie rozmiaru kontrolek na powierzchni projektowej.

Tryb Opis
Dowolny kształt Umożliwia swobodne układanie kontrolek.
Siatka Wyświetla statyczną siatkę nakładaną, która pomaga w układaniu kontrolek.
Snapline Wyświetla wiersze przewodnika, które ułatwiają układanie kontrolek kontenera względem siebie. Linie przyciągania pochodzą z kontrolek i ich kontenera.

Klasa SnapLine i powiązane typy ułatwiają obsługę trybu Przyciąganie.

Linie przyciągania są generowane dynamicznie i automatycznie, gdy krawędź kontrolki przesuwa się w pobliżu innej kontrolki lub w pobliżu granic kontenera. Może się to zdarzyć, gdy kontrolka zostanie dodana z przybornika lub przeniesiona lub zmieniana przez operacje myszy lub polecenia klawiatury. Kontrolki zwykle mają zdefiniowane linie przyciągania poziomego i pionowego; w przypadku kontrolek prostokątnych zazwyczaj rozciągają się one od wszystkich czterech krawędzi.

Klasa SnapLine używa tylko kilku właściwości do opisania każdej linii przyciągania, jak pokazano w poniższej tabeli.

Właściwość Opis
SnapLineType Określa lokalizację i kierunek wiersza w odniesieniu do skojarzonej kontrolki. Zazwyczaj tylko linie przyciągania podobnych typów są automatycznie wyrównane do siebie.
Offset Określa odległość w pikselach od źródła, który jest lewym górnym rogu kontrolki, do miejsca, w którym rozpoczyna się linia przyciągania.
Priority Określa względną ważność linii przyciągania. Podczas dowolnego punktu decyzyjnego układu wyświetlane są tylko aktywne linie przyciągania i mają najwyższy priorytet.
Filter Definiuje niestandardowe kategorie linii przyciągania. Jest to opcjonalny ciąg.
IsHorizontal i IsVertical Wskazuje, czy linia przyciągania ma odpowiednio orientację poziomą lub pionową.

Klasa ControlDesigner przechowuje linie przyciągania dla odpowiedniego typu kontrolki SnapLines we właściwości. Ta podstawowa obsługa linii przyciągania wystarczy dla większości kontrolek, ponieważ definiuje Leftlinie przyciągania , Right, i TopBottom , które są wyrównane wzdłuż krawędzi kontrolki. Podczas tworzenia kontrolki niestandardowej, jeśli ta domyślna organizacja nie jest wystarczająca, przesłoń SnapLines właściwość klasy pochodzącej z ControlDesignerklasy . Na przykład możesz wyrównać poziome linie przyciągania kontrolek opartych na tekście, takich jak etykiety, z górnymi i podstawowymi liniami tekstu (zamiast górnej i dolnej krawędzi kontrolki).

Nie SnapLineType można opierać się na klasie .

Istnieje obszerna obsługa tej funkcji w Visual Studio, zobacz Przewodnik: rozmieszczanie kontrolek na Windows Forms przy użyciu linii przyciągania.

Konstruktory

SnapLine(SnapLineType, Int32)

Inicjuje SnapLine nowe wystąpienie klasy przy użyciu określonego typu przyciągania i przesunięcia.

SnapLine(SnapLineType, Int32, SnapLinePriority)

Inicjuje SnapLine nowe wystąpienie klasy przy użyciu określonego typu linii przyciągania, przesunięcia i priorytetu.

SnapLine(SnapLineType, Int32, String)

Inicjuje SnapLine nowe wystąpienie klasy przy użyciu określonego typu przyciągania, przesunięcia i nazwy filtru.

SnapLine(SnapLineType, Int32, String, SnapLinePriority)

Inicjuje SnapLine nowe wystąpienie klasy przy użyciu określonego typu przyciągania, przesunięcia, nazwy filtru i priorytetu.

Właściwości

Filter

Pobiera kategorię filtru zdefiniowanego przez programistę skojarzona z tą linii przyciągania.

IsHorizontal

Pobiera wartość wskazującą, czy linia przyciągania ma orientację poziomą.

IsVertical

Pobiera wartość wskazującą, czy linia przyciągania ma orientację pionową.

Offset

Pobiera liczbę pikseli przesuniętą od źródła skojarzonej kontrolki.

Priority

Pobiera wartość wskazującą względną ważność linii przyciągania.

SnapLineType

Pobiera typ linii przyciągania, który wskazuje ogólną lokalizację i orientację.

Metody

AdjustOffset(Int32)

Offset Dostosowuje właściwość linii przyciągania.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ShouldSnap(SnapLine, SnapLine)

Zwraca wartość wskazującą, czy określona SnapLine wartość powinna zostać przyciągniętą do innego SnapLineelementu .

ToString()

Zwraca ciąg reprezentujący bieżącą linię przyciągania.

Dotyczy

Zobacz też