Splitter.MinExtra Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta la distanza minima che deve rimanere tra il controllo barra di divisione e il bordo sul lato opposto del contenitore o il controllo ancorato più vicino a tale lato. L'oggetto MinExtra è stato sostituito da proprietà simili in SplitContainer e viene fornito solo per garantire la compatibilità con le versioni precedenti.

public:
 property int MinExtra { int get(); void set(int value); };

public int MinExtra { get; set; }

member this.MinExtra : int with get, set

Public Property MinExtra As Integer

Valore della proprietà

Int32

Distanza minima in pixel tra il controllo Splitter e il bordo sul lato opposto del contenitore o il controllo ancorato più vicino a tale lato. Il valore predefinito è 25.

Esempio

Nell'esempio di codice seguente viene usato un Splitter controllo in combinazione con TreeView i controlli e ListView per creare una finestra simile a Esplora risorse. Per identificare i TreeView controlli e ListView , i nodi e gli elementi vengono aggiunti a entrambi i controlli. Nell'esempio vengono utilizzate le MinExtra proprietà e MinSize di Splitter per impedire che il TreeView controllo o ListView venga ridimensionato troppo piccolo o troppo grande. In questo esempio è necessario che il metodo creato in questo esempio sia definito all'interno di e Form che il metodo venga chiamato dal costruttore di Form.

private:
   void CreateMySplitControls()
   {
      // Create TreeView, ListView, and Splitter controls.
      TreeView^ treeView1 = gcnew TreeView;
      ListView^ listView1 = gcnew ListView;
      Splitter^ splitter1 = gcnew Splitter;

      // Set the TreeView control to dock to the left side of the form.
      treeView1->Dock = DockStyle::Left;

      // Set the Splitter to dock to the left side of the TreeView control.
      splitter1->Dock = DockStyle::Left;

      // Set the minimum size the ListView control can be sized to.
      splitter1->MinExtra = 100;

      // Set the minimum size the TreeView control can be sized to.
      splitter1->MinSize = 75;

      // Set the ListView control to fill the remaining space on the form.
      listView1->Dock = DockStyle::Fill;

      // Add a TreeView and a ListView item to identify the controls on the form.
      treeView1->Nodes->Add( "TreeView Node" );
      listView1->Items->Add( "ListView Item" );

      // Add the controls in reverse order to the form to ensure proper location.
      array<Control^>^temp0 = {listView1,splitter1,treeView1};
      this->Controls->AddRange( temp0 );
   }

private void CreateMySplitControls()
{
    // Create TreeView, ListView, and Splitter controls.
    TreeView treeView1 = new TreeView();
    ListView listView1 = new ListView();
    Splitter splitter1 = new Splitter();

    // Set the TreeView control to dock to the left side of the form.
    treeView1.Dock = DockStyle.Left;
    // Set the Splitter to dock to the left side of the TreeView control.
    splitter1.Dock = DockStyle.Left;
    // Set the minimum size the ListView control can be sized to.
    splitter1.MinExtra = 100;
    // Set the minimum size the TreeView control can be sized to.
    splitter1.MinSize = 75;
    // Set the ListView control to fill the remaining space on the form.
    listView1.Dock = DockStyle.Fill;
    // Add a TreeView and a ListView item to identify the controls on the form.
    treeView1.Nodes.Add("TreeView Node");
    listView1.Items.Add("ListView Item");

    // Add the controls in reverse order to the form to ensure proper location.
    this.Controls.AddRange(new Control[]{listView1, splitter1, treeView1});
}

Private Sub CreateMySplitControls()
   ' Create TreeView, ListView, and Splitter controls.
   Dim treeView1 As New TreeView()
   Dim listView1 As New ListView()
   Dim splitter1 As New Splitter()
   
   ' Set the TreeView control to dock to the left side of the form.
   treeView1.Dock = DockStyle.Left
   ' Set the Splitter to dock to the left side of the TreeView control.
   splitter1.Dock = DockStyle.Left
   ' Set the minimum size the ListView control can be sized to.
      splitter1.MinExtra = 100
   ' Set the minimum size the TreeView control can be sized to.
      splitter1.MinSize = 75
   ' Set the ListView control to fill the remaining space on the form.
      listView1.Dock = DockStyle.Fill

      ' Add a TreeView and a ListView item to identify the controls on the form.
      treeView1.Nodes.Add("TreeView Node")
      listView1.Items.Add("ListView Item")
   
   ' Add the controls in reverse order to the form to ensure proper location.
   Me.Controls.AddRange(New Control() {listView1, splitter1, treeView1})
End Sub

Commenti

Per un controllo orizzontale Splitter (un Splitter controllo ancorato alla parte superiore o inferiore di un contenitore), l'altezza minima dell'area del contenitore riservata per i controlli non ancorati è questo valore meno l'altezza del Splitter controllo. Per un controllo verticale Splitter (un Splitter controllo ancorato a sinistra o a destra di un contenitore), la larghezza minima dell'area del contenitore riservata per i controlli non ancorati è questo valore meno la larghezza del Splitter controllo. L'utente non può spostare il separatore oltre il limite specificato da questa proprietà.

Nota

Se la MinExtra proprietà è impostata su un valore negativo, il valore della proprietà viene reimpostato su 0.

Vedi anche

• MinSize