SnapLine Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.
Mode | 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 programie Visual Studio. Zobacz Przewodnik: rozmieszczanie kontrolek w formularzach systemu Windows 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 bieżące wystąpienie. (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 reprezentację ciągu bieżącego linii przyciągania. |