Cenni preliminari sul controllo SplitContainer (Windows Form)
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.
.gif "Nota importante") 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, tuttavia 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 annidare 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 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 di uso comune
Nome |
Oggetto di 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. |