Splitter.MinExtra Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает наименьшее расстояние, которое должно оставаться между элементом управления разделителем и краем противоположной стороны контейнера (или ближайшим элементом управления, закрепленным на этой стороне). Событие MinExtra было заменено аналогичными свойствами в SplitContainer и предоставляется только в целях совместимости с предыдущими версиями.

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

Значение свойства

Int32

Наименьшее расстояние в пикселях между элементом управления Splitter и краем противоположной стороны контейнера (или ближайшим элементом, присоединенным к этой стороне). Значение по умолчанию — 25.

Примеры

В следующем примере кода используется Splitter элемент управления в сочетании с TreeView элементами управления и ListView для создания окна, аналогичного проводнику Windows. Чтобы идентифицировать TreeView элементы управления и ListView , узлы и элементы добавляются в оба элемента управления. В примере используются MinExtra свойства и MinSize объекта , Splitter чтобы предотвратить слишком малый TreeView или слишком большой размер элемента управления или ListView . В этом примере требуется, чтобы метод, созданный в этом примере, был определен в Form , а метод был вызван из конструктора 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

Комментарии

Для горизонтального Splitter элемента управления ( Splitter элемента управления, закрепленного в верхней или нижней части контейнера) минимальная высота области контейнера, зарезервированной для откровения элементов управления, составляет это значение за вычетом высоты Splitter элемента управления. Для вертикального Splitter элемента управления ( Splitter элемента управления, закрепленного слева или справа от контейнера) минимальная ширина области контейнера, зарезервированной для отстыковки элементов управления, составляет это значение за вычетом ширины Splitter элемента управления. Пользователь не может переместить разделитель за предел, заданный этим свойством.

Примечание

MinExtra Если свойство имеет отрицательное значение, значение свойства сбрасывается на 0.

См. также раздел

• MinSize