SnapLine Classe

Definizione

Rappresenta i segmenti di linea verticali e orizzontali che vengono creati in modo dinamico nell'interfaccia utente e fungono da guida per il layout di controlli in un contenitore in fase di progettazione.Represents the horizontal and vertical line segments that are dynamically created in the user interface (UI) to assist in the design-time layout of controls in a container. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class SnapLine sealed
public sealed class SnapLine
type SnapLine = class
Public NotInheritable Class SnapLine
Ereditarietà
SnapLine

Commenti

Nella tabella seguente sono elencate le modalità comuni supportate dagli strumenti di progettazione visiva per semplificare il posizionamento e il ridimensionamento di controlli in un'area di progettazione.The following table lists the common modes that visual design tools support to assist you with positioning and sizing controls on a design surface.

ModalitàMode DescriptionDescription
Formato liberoFreeform Consente di disporre liberamente i controlli.Enables you to freely lay out controls.
GridGrid Visualizza una griglia sovrapposta statica che facilita l'installazione di controlli.Displays a static overlaid grid that assists you in laying out controls.
AllineamentoSnapline Visualizza le linee guida che consentono di definire il layout dei controlli del contenitore in relazione l'uno con l'altro.Displays guide lines that assist you in laying out the container's controls relative to each other. Le guide di allineamento provengono da controlli e dal relativo contenitore.Snaplines originate from controls and their container.

La SnapLine classe e i tipi correlati supportano la modalità della Guida di allineamento.The SnapLine class and related types help support the Snapline mode.

Le guide di allineamento vengono generate in modo dinamico e automatico mentre un bordo di controllo si sposta vicino a un altro controllo o vicino ai limiti del relativo contenitore.Snaplines are generated dynamically and automatically as a control edge moves near another control or near the boundaries of its container. Questo problema può verificarsi quando un controllo viene aggiunto dalla casella degli strumenti o spostato o ridimensionato da operazioni del mouse o comandi della tastiera.This can occur when a control is added from the toolbox, or moved or resized by mouse operations or keyboard commands. I controlli in genere dispongono di guide di allineamento orizzontali e verticali definite; per i controlli rettangolari, questi si estendono in genere da tutti e quattro i bordi.Controls typically have both horizontal and vertical snaplines defined; for rectangular controls, these typically extend from all four edges.

La SnapLine classe utilizza solo alcune proprietà per descrivere ogni guide di allineamento, come illustrato nella tabella seguente.The SnapLine class uses only a few properties to describe each snapline, as shown in the following table.

ProprietàProperty DescriptionDescription
SnapLineType Specifica la posizione e la direzione della linea rispetto al controllo associato.Specifies the location and direction of the line with respect to its associated control. In genere, solo le guide di allineamento di tipi simili si allineano automaticamente tra loro.Typically, only snaplines of similar types will auto-align to each other.
Offset Specifica la distanza in pixel dall'origine, ovvero l'angolo superiore sinistro del controllo, alla posizione in cui inizia la guide di allineamento.Specifies the distance in pixels from the origin, which is the upper-left corner of the control, to where the snapline starts.
Priority Specifica l'importanza relativa della guide di allineamento.Specifies the relative importance of the snapline. Durante un determinato punto di decisione del layout, vengono visualizzate solo le guide di allineamento attive e con la priorità più alta.During any given layout decision point, only the snaplines that are active and have the highest priority are displayed.
Filter Definisce le categorie personalizzate delle guide di allineamento.Defines custom categories of snaplines. Si tratta di una stringa facoltativa.This is an optional string.
IsHorizontal e IsVerticalIsHorizontal and IsVertical Indica se una barra di allineamento presenta rispettivamente l'orientamento orizzontale o verticale.Indicates whether a snapline has horizontal or vertical orientation, respectively.

La ControlDesigner classe archivia le guide di allineamento per il tipo SnapLines di controllo corrispondente nella proprietà.The ControlDesigner class stores snaplines for its corresponding control type in the SnapLines property. Questa gestione della classe di base delle guide di allineamento è sufficiente per la maggior parte dei controlli Left, in Topquanto definisce Bottom le guide di allineamento, Right, e, che sono allineate lungo i bordi del controllo.This base class handling of snaplines will suffice for the majority of controls, as it defines the Left, Right, Top, and Bottom snaplines, which are aligned along the edges of the control. Quando si sviluppa un controllo personalizzato, se questa organizzazione predefinita non è sufficiente, eseguire l'override SnapLines della proprietà della classe derivata da ControlDesigner.When you are developing a custom control, if this default organization does not suffice, override the SnapLines property of the class derived from ControlDesigner. È ad esempio possibile allineare le guide di allineamento orizzontali dei controlli basati su testo, ad esempio le etichette, con le prime e le linee di base del testo, anziché i bordi superiore e inferiore del controllo.For example, you may want to align the horizontal snaplines of text-based controls, such as labels, with the top and base lines of the text (instead of the top and bottom edges of the control).

Non SnapLineType è possibile derivare la classe da.The SnapLineType class cannot be derived from.

È disponibile un supporto completo per questa funzionalità in Visual Studio, vedere Procedura dettagliata: Disposizione di controlli su Windows Forms mediante guidedi allineamento.There is extensive support for this feature in Visual Studio, see Walkthrough: Arranging Controls on Windows Forms Using Snaplines.

Costruttori

SnapLine(SnapLineType, Int32)

Inizializza una nuova istanza della classe SnapLine utilizzando il tipo di guida di allineamento e l'offset specificati.Initializes a new instance of the SnapLine class using the specified snapline type and offset.

SnapLine(SnapLineType, Int32, SnapLinePriority)

Inizializza una nuova istanza della classe SnapLine utilizzando il tipo di guida di allineamento, l'offset e la priorità specificati.Initializes a new instance of the SnapLine class using the specified snapline type, offset, and priority.

SnapLine(SnapLineType, Int32, String)

Inizializza una nuova istanza della classe SnapLine utilizzando il tipo di guida di allineamento, l'offset e il nome del filtro specificati.Initializes a new instance of the SnapLine class using the specified snapline type, offset, and filter name.

SnapLine(SnapLineType, Int32, String, SnapLinePriority)

Inizializza una nuova istanza della classe SnapLine utilizzando il tipo di guida di allineamento, l'offset, il nome del filtro e la priorità specificati.Initializes a new instance of the SnapLine class using the specified snapline type, offset, filter name, and priority.

Proprietà

Filter

Ottiene una categoria di filtri definita dal programmatore associata a questa guida di allineamento.Gets the programmer-defined filter category associated with this snapline.

IsHorizontal

Ottiene un valore che indica se l'orientamento della guida di allineamento è orizzontale.Gets a value indicating whether the snapline has a horizontal orientation.

IsVertical

Ottiene un valore che indica se l'orientamento della guida di allineamento è verticale.Gets a value indicating whether the snapline has a vertical orientation.

Offset

Ottiene il numero di pixel che separa la guida di allineamento dall'origine del controllo associato.Gets the number of pixels that the snapline is offset from the origin of the associated control.

Priority

Ottiene un valore che indica l'importanza relativa della guida di allineamento.Gets a value indicating the relative importance of the snapline.

SnapLineType

Ottiene il tipo di una guida di allineamento che indica la posizione generale e l'orientamento.Gets the type of a snapline, which indicates the general location and orientation.

Metodi

AdjustOffset(Int32)

Regola la proprietà Offset della guida di allineamento.Adjusts the Offset property of the snapline.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ShouldSnap(SnapLine, SnapLine)

Restituisce un valore che indica se l'oggetto SnapLine specificato deve essere bloccato su un altro oggetto SnapLine.Returns a value indicating whether the specified SnapLine should snap to another SnapLine.

ToString()

Restituisce una rappresentazione in formato stringa della guida di allineamento corrente.Returns a string representation of the current snapline.

Si applica a

Vedi anche