Condividi tramite


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

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 facilitare la posizionamento e il ridimensionamento dei controlli in un'area di progettazione.

Mode Descrizione
Figura a mano libera 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 LeftRightToplinee 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 Form tramite le 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

Vedi anche