Splitter.MinExtra Splitter.MinExtra Splitter.MinExtra Splitter.MinExtra Property

Definizione

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.Gets or sets the minimum distance that must remain between the splitter control and the edge of the opposite side of the container (or the closest control docked to that side). L'oggetto MinExtra è stato sostituito da proprietà simili in SplitContainer e viene fornito solo per garantire la compatibilità con le versioni precedenti.MinExtra has been replaced by similar properties in SplitContainer and is provided only for compatibility with previous versions.

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à

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.The minimum distance, in pixels, between the Splitter control and the edge of the opposite side of the container (or the closest control docked to that side). Il valore predefinito è 25.The default is 25.

Esempi

Nell'esempio di codice seguente viene Splitter usato un controllo in TreeView combinazione ListView con i controlli e per creare una finestra simile a Esplora risorse.The following code example uses a Splitter control in combination with TreeView and ListView controls to create a window similar to Windows Explorer. Per identificare i TreeView controlli ListView e, i nodi e gli elementi vengono aggiunti a entrambi i controlli.To identify the TreeView and ListView controls, nodes and items are added to both controls. Nell'esempio vengono utilizzate MinExtra le MinSize proprietà e di Splitter per impedire che TreeView la ListView dimensione del controllo o sia troppo piccola o troppo grande.The example uses the MinExtra and MinSize properties of the Splitter to prevent the TreeView or ListView control from being sized too small or too large. Questo esempio richiede che il metodo creato in questo esempio sia definito all'interno Form di un e che il metodo venga chiamato dal costruttore dell' Formoggetto.This example requires that the method created in this example is defined within a Form and that the method is called from the constructor of the 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 Splitter orizzontale (un Splitter controllo ancorato alla parte superiore o inferiore di un contenitore), l'altezza minima dell'area del contenitore riservata ai controlli non ancorati è questo valore Splitter meno l'altezza del controllo.For a horizontal Splitter control (a Splitter control docked to the top or bottom of a container), the minimum height of the area of the container reserved for undocked controls is this value minus the height of the Splitter control. Per un controllo Splitter verticale (un Splitter controllo ancorato a sinistra o a destra di un contenitore), la larghezza minima dell'area del contenitore riservata ai controlli non ancorati è questo valore Splitter meno la larghezza del controllo.For a vertical Splitter control (a Splitter control docked to the left or right of a container), the minimum width of the area of the container reserved for undocked controls is this value minus the width of the Splitter control. L'utente non può spostare la barra di divisione oltre il limite specificato da questa proprietà.The user cannot move the splitter past the limit specified by this property.

Nota

Se la MinExtra proprietà è impostata su un valore negativo, il valore della proprietà viene reimpostato su 0.If the MinExtra property is set to a negative value, the property value is reset to 0.

Si applica a

Vedi anche