Splitter.MinExtra Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece la distancia mínima que se debe mantener entre el control divisor y el borde del lado opuesto del contenedor (o el control más próximo acoplado a ese lado). La propiedad MinExtra ha sido reemplazada por propiedades similares en SplitContainer y únicamente se proporciona para ofrecer compatibilidad con versiones anteriores.

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

Valor de propiedad

Int32

Distancia mínima, en píxeles, entre el control Splitter y el borde del lado opuesto del contenedor (o del control más próximo acoplado a ese lado). El valor predeterminado es 25.

Ejemplos

En el ejemplo de código siguiente se usa un Splitter control en combinación con TreeView los controles y ListView para crear una ventana similar al Explorador de Windows. Para identificar los TreeView controles y ListView , los nodos y los elementos se agregan a ambos controles. En el ejemplo se usan las MinExtra propiedades y MinSize de Splitter para evitar que el TreeView tamaño del control o ListView sea demasiado pequeño o demasiado grande. En este ejemplo se requiere que el método creado en este ejemplo se defina dentro Form de y que se llame al método desde el constructor de 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

Comentarios

Para un control horizontal Splitter (un Splitter control acoplado a la parte superior o inferior de un contenedor), el alto mínimo del área del contenedor reservado para los controles no acoplados es este valor menos el alto del Splitter control. En el caso de un control vertical Splitter (un Splitter control acoplado a la izquierda o a la derecha de un contenedor), el ancho mínimo del área del contenedor reservado para los controles no acoplados es este valor menos el ancho del Splitter control. El usuario no puede mover el divisor más allá del límite especificado por esta propiedad.

Nota

Si la MinExtra propiedad se establece en un valor negativo, el valor de la propiedad se restablece a 0.

Consulte también

• MinSize