Condividi tramite

Panoramica del controllo SplitContainer (Windows Form)

  • Articolo

Il controllo SplitContainer Windows Form può essere considerato come composito; è costituito da due pannelli separati da una barra mobile. Quando il puntatore del mouse si trova sulla barra, il puntatore cambia forma per indicare che la barra è mobile.

Importante

Nella casella degli strumenti , il controllo SplitContainer sostituisce il controllo Splitter che era presente nella versione precedente di Visual Studio. Il controllo SplitContainer è preferibile rispetto al controllo Splitter. La classe Splitter è ancora inclusa in .NET Framework per garantire la compatibilità con le applicazioni esistenti, ma è consigliabile usare il controllo SplitContainer per i nuovi progetti.

Con il controllo SplitContainer è possibile creare interfacce utente complesse; spesso, una selezione in un pannello determina quali oggetti vengono visualizzati nell'altro pannello. Questa disposizione è molto efficace per la visualizzazione e l'esplorazione delle informazioni. La presenza di due pannelli consente di aggregare le informazioni nelle aree e la barra o "splitter", semplifica il ridimensionamento dei pannelli da parte degli utenti.

È anche possibile annidare più di un controllo SplitContainer, con il secondo controllo SplitContainer orientato orizzontalmente, per creare pannelli superiori e inferiori.

Tenere presente che il controllo SplitContainer è accessibile tramite tastiera per impostazione predefinita; gli utenti possono premere i tasti freccia per spostare il separatore se la proprietà IsSplitterFixed è impostata su false.

La proprietà Orientation del controllo SplitContainer determina la direzione del separatore, non del controllo stesso. Di conseguenza, quando questa proprietà è impostata su Vertical, il separatore si estende dall'alto verso il basso, creando i pannelli sinistro e destro.

Tenere inoltre presente che il valore della proprietà SplitterRectangle varia a seconda del valore della proprietà Orientation. Per ulteriori informazioni, vedere la proprietà SplitterRectangle.

È anche possibile limitare le dimensioni e lo spostamento del controllo SplitContainer. La proprietà FixedPanel determina quale pannello rimarrà la stessa dimensione dopo il ridimensionamento del controllo SplitContainer e la proprietà IsSplitterFixed determina se il separatore è mobile dalla tastiera o dal mouse.

Nota

Anche se la proprietà IsSplitterFixed è impostata su true, il separatore potrebbe comunque essere spostato a livello di codice; ad esempio usando la proprietà SplitterDistance.

Infine, ogni pannello del controllo SplitContainer ha proprietà per determinarne le singole dimensioni.

Proprietà, metodi ed eventi di uso comune

Nome Descrizione
FixedPanel proprietà Determina quale pannello rimarrà la stessa dimensione dopo il ridimensionamento del controllo SplitContainer.
IsSplitterFixed proprietà Determina se il separatore può essere spostato con la tastiera o il mouse.
Orientation proprietà Determina se il separatore è disposto verticalmente o orizzontalmente.
SplitterDistance proprietà Determina la distanza in pixel dal bordo sinistro o superiore alla barra di divisione mobile.
SplitterIncrement proprietà Determina la distanza minima, in pixel, che il separatore può essere spostato dall'utente.
SplitterWidth proprietà Determina lo spessore, in pixel, del separatore.
evento SplitterMoving Si verifica quando il separatore viene spostato.
evento SplitterMoved Si verifica quando il separatore è stato spostato.

Vedere anche