SnapLine Klas

Definitie

Vertegenwoordigt de horizontale en verticale lijnsegmenten die dynamisch worden gemaakt in de gebruikersinterface (UI) om u te helpen bij de ontwerptijd van besturingselementen in een container. Deze klasse kan niet worden overgenomen.

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

Opmerkingen

De volgende tabel bevat de algemene modi die visuele ontwerphulpprogramma's ondersteunen om u te helpen bij het positioneren en aanpassen van besturingselementen op een ontwerpoppervlak.

Mode Description
Vrije Stelt u in staat om besturingselementen vrij in te delen.
Grid Geeft een statisch overlappend raster weer dat u helpt bij het invullen van besturingselementen.
Uitlijning Geeft hulplijnen weer die u helpen bij het opmaken van de besturingselementen van de container ten opzichte van elkaar. Snaplines zijn afkomstig van besturingselementen en hun container.

De SnapLine klasse en gerelateerde typen ondersteunen de Snapline-modus.

Snaplines worden dynamisch en automatisch gegenereerd als een besturingselementrand zich verplaatst in de buurt van een ander besturingselement of in de buurt van de grenzen van de container. Dit kan gebeuren wanneer een besturingselement wordt toegevoegd vanuit de werkset of wordt verplaatst of gewijzigd door muisbewerkingen of toetsenbordopdrachten. Besturingselementen hebben doorgaans zowel horizontale als verticale snaplines gedefinieerd; voor rechthoekige besturingselementen zijn deze doorgaans van alle vier de randen.

De SnapLine klasse gebruikt slechts enkele eigenschappen om elke snapline te beschrijven, zoals wordt weergegeven in de volgende tabel.

Property Description
SnapLineType Hiermee geeft u de locatie en richting van de lijn met betrekking tot de bijbehorende controle. Normaal gesproken worden alleen snaplijnen van vergelijkbare typen automatisch met elkaar uitgelijnd.
Offset Hiermee geeft u de afstand in pixels van de oorsprong, die de linkerbovenhoek van het besturingselement is, tot waar de snapline begint.
Priority Hiermee geeft u het relatieve belang van de snapline. Tijdens een bepaald beslissingspunt voor de indeling worden alleen de snaplijnen weergegeven die actief zijn en de hoogste prioriteit hebben.
Filter Hiermee definieert u aangepaste categorieƫn van snaplines. Dit is een optionele tekenreeks.
IsHorizontal en IsVertical Geeft aan of een snapline respectievelijk een horizontale of verticale richting heeft.

De ControlDesigner klasse slaat snaplines op voor het bijbehorende besturingselementtype in de SnapLines eigenschap. Deze basisklasseafhandeling van snaplines is voldoende voor het merendeel van de besturingselementen, omdat deze de Left, Righten TopBottom snaplines definieert, die langs de randen van het besturingselement zijn uitgelijnd. Wanneer u een aangepast besturingselement ontwikkelt en deze standaardorganisatie niet volstaat, overschrijft u de SnapLines eigenschap van de klasse die is afgeleid van ControlDesigner. U kunt bijvoorbeeld de horizontale uitlijning van besturingselementen op basis van tekst, zoals labels, uitlijnen met de bovenste en basisregels van de tekst (in plaats van de boven- en onderranden van het besturingselement).

De SnapLineType klasse kan niet worden afgeleid van.

Er is uitgebreide ondersteuning voor deze functie in Visual Studio, zie Walkthrough: Besturingselementen rangschikken op Windows Forms Snaplines.

Constructors

Name Description
SnapLine(SnapLineType, Int32, SnapLinePriority)

Initialiseert een nieuw exemplaar van de SnapLine klasse met behulp van het opgegeven snaplinetype, offset en prioriteit.

SnapLine(SnapLineType, Int32, String, SnapLinePriority)

Initialiseert een nieuw exemplaar van de SnapLine klasse met behulp van het opgegeven snaplinetype, offset, filternaam en prioriteit.

SnapLine(SnapLineType, Int32, String)

Initialiseert een nieuw exemplaar van de SnapLine klasse met behulp van het opgegeven snaplinetype, offset en filternaam.

SnapLine(SnapLineType, Int32)

Initialiseert een nieuw exemplaar van de SnapLine klasse met behulp van het opgegeven snaplinetype en -offset.

Eigenschappen

Name Description
Filter

Hiermee haalt u de door programmeur gedefinieerde filtercategorie op die aan deze snapline is gekoppeld.

IsHorizontal

Hiermee wordt een waarde opgehaald die aangeeft of de snapline een horizontale afdrukstand heeft.

IsVertical

Hiermee wordt een waarde opgehaald die aangeeft of de snapline een verticale afdrukstand heeft.

Offset

Hiermee haalt u het aantal pixels op dat de snapline wordt verschoven van de oorsprong van het gekoppelde besturingselement.

Priority

Hiermee wordt een waarde opgehaald die het relatieve belang van de snapline aangeeft.

SnapLineType

Hiermee haalt u het type van een snapline op, wat de algemene locatie en afdrukstand aangeeft.

Methoden

Name Description
AdjustOffset(Int32)

Hiermee past u de eigenschap van de Offset snapline aan.

Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ShouldSnap(SnapLine, SnapLine)

Retourneert een waarde die aangeeft of de opgegeven SnapLine moet worden uitgelijnd op een andere SnapLinewaarde.

ToString()

Retourneert een tekenreeksweergave van de huidige snapline.

Van toepassing op

Zie ook