Splitter.MinExtra Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Splitter.cs

Získá nebo nastaví minimální vzdálenost, která musí zůstat mezi rozdělovačem a okrajem opačné strany kontejneru (nebo nejbližší ovládací prvek ukotvený na této straně). MinExtra byla nahrazena podobnými vlastnostmi SplitContainer a je poskytována pouze z důvodu kompatibility s předchozími verzemi.

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

Hodnota vlastnosti

Int32

Minimální vzdálenost v pixelech mezi ovládacím Splitter prvku a okrajem opačné strany kontejneru (nebo nejbližším ovládacím prvku ukotveným na této straně). Výchozí hodnota je 25.

Příklady

Následující příklad kódu používá Splitter ovládací prvek v kombinaci s TreeView ovládacími ListView prvky k vytvoření okna podobného Průzkumníku Windows. K identifikaci a ListView ovládacích TreeView prvků se uzly a položky přidají do obou ovládacích prvků. Příklad používá MinExtra vlastnosti a MinSize vlastnosti Splitter , které brání TreeView příliš malé nebo příliš velké velikosti ovládacího prvku nebo ListView ovládacího prvku. Tento příklad vyžaduje, aby metoda vytvořená v tomto příkladu je definována v rámci a Form že metoda je volána z konstruktoru 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

Poznámky

U vodorovného Splitter ovládacího prvku ( Splitter ovládací prvek ukotvený k horní nebo dolní části kontejneru) je minimální výška oblasti kontejneru vyhrazená pro nečinné ovládací prvky tato hodnota minus výška Splitter ovládacího prvku. U svislého Splitter ovládacího prvku ( Splitter ovládací prvek ukotvený vlevo nebo vpravo od kontejneru) je minimální šířka oblasti kontejneru vyhrazená pro nečinné ovládací prvky tato hodnota minus šířka Splitter ovládacího prvku. Uživatel nemůže přesunout rozdělovač za limit určený touto vlastností.

Poznámka:

MinExtra Pokud je vlastnost nastavena na zápornou hodnotu, hodnota vlastnosti je resetována na 0.

Viz také

• MinSize