Splitter.MinExtra Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define a distância mínima que deve permanecer entre o controle de divisor e a borda do lado oposto do contêiner (ou o controle mais próximo encaixado nesse lado). MinExtra foi substituído por propriedades similares em SplitContainer e é fornecido somente para compatibilidade com versões 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 da propriedade

Int32

A distância mínima, em pixels, entre o Splitter controle e a borda do lado oposto do contêiner (ou o controle mais próximo encaixado nesse lado). O padrão é 25.

Exemplos

O exemplo de código a seguir usa um Splitter controle em combinação com TreeView e ListView controles para criar uma janela semelhante a Windows Explorer. Para identificar os controles e ListView os TreeView controles, nós e itens são adicionados aos dois controles. O exemplo usa as propriedades e MinSize as MinExtra propriedades para Splitter impedir que o TreeView ou ListView controle seja dimensionado muito pequeno ou muito grande. Este exemplo requer que o método criado neste exemplo seja definido dentro de um Form e que o método seja chamado do construtor do 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

Comentários

Para um controle horizontal Splitter (um Splitter controle encaixado na parte superior ou inferior de um contêiner), a altura mínima da área do contêiner reservada para controles não desencaixados é esse valor menos a altura do Splitter controle. Para um controle vertical Splitter (um Splitter controle encaixado à esquerda ou à direita de um contêiner), a largura mínima da área do contêiner reservada para controles não desencaixados é esse valor menos a largura do Splitter controle. O usuário não pode mover o divisor além do limite especificado por essa propriedade.

Observação

Se a MinExtra propriedade for definida como um valor negativo, o valor da propriedade será redefinido para 0.

Confira também

• MinSize