SnapLine Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms.Design.Behavior

Assembly:: System.Design.dll

Assembly:: System.Windows.Forms.Design.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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. La classe non può essere ereditata.

public ref class SnapLine sealed

public sealed class SnapLine

type SnapLine = class

Public NotInheritable Class SnapLine

Ereditarietà: Object
SnapLine

Commenti

Nella tabella seguente sono elencate le modalità comuni supportate dagli strumenti di progettazione visiva per facilitare la posizionamento e il ridimensionamento dei controlli in un'area di progettazione.

Mode	Descrizione
Freeform	Consente di distribuire liberamente i controlli.
Pannello Grid	Visualizza una griglia overlaid statica che consente di configurare i controlli.
Snapline	Visualizza le linee guida che consentono di definire i controlli del contenitore rispetto all'uno all'altro. Le linee di snap provengono dai controlli e dal relativo contenitore.

La SnapLine classe e i tipi correlati supportano la modalità Snapline.

Le linee di snap vengono generate dinamicamente e automaticamente quando un bordo di controllo si sposta vicino a un altro controllo o vicino ai limiti del contenitore. Ciò può verificarsi quando un controllo viene aggiunto dalla casella degli strumenti o spostato o ridimensionato dalle operazioni del mouse o dai comandi della tastiera. I controlli in genere hanno linee di snapline orizzontali e verticali definite; per i controlli rettangolari, questi in genere si estendono da tutti e quattro i bordi.

La SnapLine classe usa solo alcune proprietà per descrivere ogni linea di snapline, come illustrato nella tabella seguente.

Proprietà	Descrizione
SnapLineType	Specifica la posizione e la direzione della riga rispetto al controllo associato. In genere, solo le linee di snapline di tipi simili verranno allineate automaticamente tra loro.
Offset	Specifica la distanza in pixel dall'origine, ovvero l'angolo superiore sinistro del controllo, in cui inizia la linea di snapline.
Priority	Specifica l'importanza relativa della linea di snapline. Durante qualsiasi punto decisionale del layout specificato, vengono visualizzate solo le linee di blocco attive e hanno la priorità più alta.
Filter	Definisce categorie personalizzate di snapline. Si tratta di una stringa facoltativa.
IsHorizontal e IsVertical	Indica se una linea di snapline ha rispettivamente orientamento orizzontale o verticale.

La ControlDesigner classe archivia le linee di snapline per il tipo di controllo corrispondente nella SnapLines proprietà. Questa gestione delle classi di base delle linee di snapline sarà sufficiente per la maggior parte dei controlli, come definisce le Left Right Toplinee di snapline , , e Bottom allineate lungo i bordi del controllo. Quando si sviluppa un controllo personalizzato, se questa organizzazione predefinita non è sufficiente, eseguire l'override della SnapLines proprietà della classe derivata da ControlDesigner. Ad esempio, è possibile allineare le linee di snapline orizzontali dei controlli basati su testo, ad esempio etichette, con le righe superiore e di base del testo , anziché i bordi superiore e inferiore del controllo.

La SnapLineType classe non può essere derivata da.

È disponibile un supporto completo per questa funzionalità in Visual Studio, vedere Procedura dettagliata: Disposizione dei controlli in Windows Forms Uso delle linee di snapline.

Costruttori

SnapLine(SnapLineType, Int32)	Inizializza una nuova istanza della classe SnapLine usando il tipo di guida di allineamento e l'offset specificati.
SnapLine(SnapLineType, Int32, SnapLinePriority)	Inizializza una nuova istanza della classe SnapLine usando il tipo di guida di allineamento, l'offset e la priorità specificati.
SnapLine(SnapLineType, Int32, String)	Inizializza una nuova istanza della classe SnapLine usando il tipo di guida di allineamento, l'offset e il nome del filtro specificati.
SnapLine(SnapLineType, Int32, String, SnapLinePriority)	Inizializza una nuova istanza della classe SnapLine usando il tipo di guida di allineamento, l'offset, il nome del filtro e la priorità specificati.

Proprietà

Filter	Ottiene una categoria di filtri definita dal programmatore associata a questa guida di allineamento.
IsHorizontal	Ottiene un valore che indica se l'orientamento della guida di allineamento è orizzontale.
IsVertical	Ottiene un valore che indica se l'orientamento della guida di allineamento è verticale.
Offset	Ottiene il numero di pixel che separa la guida di allineamento dall'origine del controllo associato.
Priority	Ottiene un valore che indica l'importanza relativa della guida di allineamento.
SnapLineType	Ottiene il tipo di una guida di allineamento che indica la posizione generale e l'orientamento.

Metodi

AdjustOffset(Int32)	Regola la proprietà Offset della guida di allineamento.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ShouldSnap(SnapLine, SnapLine)	Restituisce un valore che indica se l'oggetto SnapLine specificato deve essere bloccato su un altro oggetto SnapLine.
ToString()	Restituisce una rappresentazione in formato stringa della guida di allineamento corrente.

Si applica a