SnapLine Classe
Definizione
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 orizzontale e verticale creati dinamicamente nell'interfaccia utente per facilitare il layout in fase di progettazione dei controlli in un contenitore. Questa classe non può essere ereditata.
public ref class SnapLine sealedpublic sealed class SnapLinetype SnapLine = classPublic NotInheritable Class SnapLine- Ereditarietà
-
SnapLine
Commenti
La tabella seguente elenca le modalità comuni supportate dagli strumenti di progettazione visiva per facilitare il posizionamento e il ridimensionamento dei controlli in un'area di progettazione.
| Modalità | Descrizione |
|---|---|
| Freeform | Consente di disporre liberamente i controlli. |
| Griglia | Visualizza una griglia sovrapposta statica che consente di disporre i controlli. |
| Snapline | Visualizza le linee guida che consentono di definire i controlli del contenitore rispetto agli altri. Le linee di allineamento provengono dai controlli e dal relativo contenitore. |
La SnapLine classe e i tipi correlati supportano la modalità Snapline.
Le linee di ancoraggio vengono generate in modo dinamico 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 da operazioni del mouse o comandi da tastiera. I controlli hanno in genere linee di allineamento orizzontali e verticali definite; per i controlli rettangolari, questi si estendono in genere da tutti e quattro i bordi.
La SnapLine classe usa solo alcune proprietà per descrivere ogni snapline, come illustrato nella tabella seguente.
| Proprietà | Descrizione |
|---|---|
| SnapLineType | Specifica la posizione e la direzione della linea rispetto al controllo associato. In genere, solo le linee di ancoraggio di tipi simili verranno allineate automaticamente l'una all'altra. |
| Offset | Specifica la distanza in pixel dall'origine, ovvero l'angolo superiore sinistro del controllo, alla posizione in cui inizia la linea di allineamento. |
| Priority | Specifica l'importanza relativa dello snapline. Durante un determinato punto decisionale del layout, vengono visualizzate solo le linee di allineamento attive e con la priorità più alta. |
| Filter | Definisce categorie personalizzate di snapline. Si tratta di una stringa facoltativa. |
| IsHorizontal e IsVertical | Indica se una linea di allineamento ha rispettivamente orientamento orizzontale o verticale. |
La ControlDesigner classe archivia le linee di allineamento per il tipo di controllo corrispondente nella SnapLines proprietà . Questa gestione di classi base di snapline sarà sufficiente per la maggior parte dei controlli, in quanto definisce le Leftlinee di allineamento , RightTop, eBottom, 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 allineamento orizzontali dei controlli basati su testo, ad esempio le 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 .
In Visual Studio è disponibile un supporto completo per questa funzionalità, vedere Procedura dettagliata: Disposizione di controlli in Windows Form tramite snapline.
Costruttori
| Nome | Descrizione |
|---|---|
| SnapLine(SnapLineType, Int32, SnapLinePriority) |
Inizializza una nuova istanza della SnapLine classe utilizzando il tipo di linea di allineamento, l'offset e la priorità specificati. |
| SnapLine(SnapLineType, Int32, String, SnapLinePriority) |
Inizializza una nuova istanza della SnapLine classe utilizzando il tipo di linea di allineamento, l'offset, il nome del filtro e la priorità specificati. |
| SnapLine(SnapLineType, Int32, String) |
Inizializza una nuova istanza della SnapLine classe utilizzando il tipo, l'offset e il nome del filtro specificati. |
| SnapLine(SnapLineType, Int32) |
Inizializza una nuova istanza della SnapLine classe utilizzando il tipo di allineamento e l'offset specificati. |
Proprietà
| Nome | Descrizione |
|---|---|
| Filter |
Ottiene la categoria di filtro definita dal programmatore associata a questa snapline. |
| IsHorizontal |
Ottiene un valore che indica se la linea di allineamento ha un orientamento orizzontale. |
| IsVertical |
Ottiene un valore che indica se la linea di allineamento ha un orientamento verticale. |
| Offset |
Ottiene il numero di pixel di offset della linea di allineamento dall'origine del controllo associato. |
| Priority |
Ottiene un valore che indica l'importanza relativa della linea di allineamento. |
| SnapLineType |
Ottiene il tipo di una linea di allineamento, che indica la posizione e l'orientamento generali. |
Metodi
| Nome | Descrizione |
|---|---|
| AdjustOffset(Int32) |
Regola la Offset proprietà dello snapline. |
| 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 il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ShouldSnap(SnapLine, SnapLine) |
Restituisce un valore che indica se l'oggetto specificato deve essere agganciato SnapLine a un altro SnapLineoggetto . |
| ToString() |
Restituisce una rappresentazione di stringa della linea di allineamento corrente. |
