Condividi tramite


Cenni preliminari sul controllo SplitContainer (Windows Form)

Aggiornamento: novembre 2007

Il controllo SplitContainer Windows Form può essere considerato un oggetto composto, poiché è costituito da due pannelli separati da una barra mobile. Quando il puntatore del mouse viene posizionato sopra la barra, assume una forma diversa per indicare che la barra è mobile.

Nota importante:

Nella Casella degli strumenti il controllo SplitContainer sostituisce il controllo Splitter della versione precedente di Visual Studio. È consigliabile utilizzare il controllo SplitContainer anziché il controllo Splitter. La classe Splitter è ancora inclusa in .NET Framework per assicurare la compatibilità con le applicazioni esistenti, ma per i nuovi progetti si consiglia di utilizzare il controllo SplitContainer.

Il controllo SplitContainer consente di creare complesse interfacce utente, in cui l'elemento selezionato in un pannello determina in genere gli oggetti visualizzati nell'altro. Questa disposizione è particolarmente efficace per la visualizzazione e la ricerca di informazioni. Grazie alla presenza dei due pannelli è possibile aggregare le informazioni in aree, mentre la barra di divisione consente di ridimensionare i pannelli.

È inoltre possibile nidificare più controlli SplitContainer, orientando il secondo controllo SplitContainer orizzontalmente, per creare un pannello superiore e un pannello inferiore.

Il controllo SplitContainer è accessibile da tastiera per impostazione predefinita. Per spostare la barra di divisione è sufficiente premere i tasti di direzione, se la proprietà IsSplitterFixed è impostata su false.

La proprietà Orientation del controllo SplitContainer determina la direzione della barra di divisione, non quella del controllo stesso. Quando tale proprietà è impostata su Vertical, la barra di divisione è disposta in verticale, creando un pannello a destra e uno a sinistra.

Il valore della proprietà SplitterRectangle dipende inoltre da quello della proprietà Orientation. Per ulteriori informazioni, vedere l'argomento relativo alla proprietà SplitterRectangle.

È inoltre possibile limitare le dimensioni e lo spostamento del controllo SplitContainer. La proprietà FixedPanel determina il pannello le cui dimensioni devono rimanere invariate in caso di ridimensionamento del controllo SplitContainer, mentre la proprietà IsSplitterFixed determina se la barra di divisione può essere spostata tramite mouse o tastiera.

Nota:

Anche se la proprietà IsSplitterFixed è impostata su true, la barra di divisione può essere comunque spostata a livello di codice, ad esempio utilizzando la proprietà SplitterDistance.

Per ciascun pannello del controllo SplitContainer sono infine disponibili proprietà che consentono di determinarne le dimensioni.

Proprietà, metodi ed eventi utilizzati comunemente

Nome

Descrizione

Proprietà FixedPanel

Determina il pannello le cui dimensioni devono rimanere invariate in caso di ridimensionamento del controllo SplitContainer.

Proprietà IsSplitterFixed

Determina se la barra di divisione può essere spostata tramite mouse o tastiera.

Proprietà Orientation

Determina se la barra di divisione deve essere disposta in orizzontale o in verticale.

Proprietà SplitterDistance

Determina la distanza in pixel dal bordo superiore o sinistro alla barra di divisione mobile.

Proprietà SplitterIncrement

Determina la distanza minima, in pixel, per cui la barra di divisione può essere spostata dall'utente.

Proprietà SplitterWidth

Determina lo spessore in pixel della barra di divisione.

Evento SplitterMoving

Viene generato durante lo spostamento della barra di divisione.

Evento SplitterMoved

Viene generato al termine dello spostamento della barra di divisione.

Vedere anche

Attività

Esempio di controllo SplitContainer

Riferimenti

SplitContainer

Altre risorse

Controllo SplitContainer (Windows Form)