Splitter.MinExtra Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den Mindestabstand ab, der zwischen dem Aufteilungssteuerelement und dem Rand der gegenüberliegenden Seite des Containers (oder dem nächsten an dieser Seite angedockten Steuerelement) verbleiben muss, oder legt diesen fest. MinExtra wurde durch ähnliche Eigenschaften in SplitContainer ersetzt und wird nur bereitgestellt, um die Kompatibilität mit früheren Versionen zu gewährleisten.

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

Eigenschaftswert

Int32

Der Mindestabstand in Pixel zwischen dem Splitter-Steuerelement und dem Rand der gegenüberliegenden Seite des Containers (oder dem nächsten an dieser Seite angedockten Steuerelement). Der Standard ist 25.

Beispiele

Im folgenden Codebeispiel wird ein Splitter Steuerelement in Kombination mit TreeView - und ListView -Steuerelementen verwendet, um ein Fenster ähnlich dem Windows-Explorer zu erstellen. Um die TreeView Steuerelemente und ListView zu identifizieren, werden beiden Steuerelementen Knoten und Elemente hinzugefügt. Im Beispiel werden die MinExtra Eigenschaften und MinSize von Splitter verwendet, um zu verhindern, dass das TreeView - oder ListView -Steuerelement zu klein oder zu groß ist. Dieses Beispiel erfordert, dass die in diesem Beispiel erstellte Methode in einem Form definiert ist und dass die -Methode vom -Konstruktor des Formaufgerufen wird.

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

Hinweise

Bei einem horizontalen Splitter Steuerelement (einem Splitter Steuerelement, das am oberen oder unteren Rand eines Containers angedockt ist) ist die Mindesthöhe des Bereichs des Containers, der für nicht angedockte Steuerelemente reserviert ist, dieser Wert abzüglich der Höhe des Steuerelements Splitter . Für ein vertikales Splitter Steuerelement (ein Splitter Steuerelement, das links oder rechts von einem Container angedockt ist) ist die Mindestbreite des Bereichs des Containers, der für nicht angedockte Steuerelemente reserviert ist, dieser Wert abzüglich der Breite des Steuerelements Splitter . Der Benutzer kann den Splitter nicht über den von dieser Eigenschaft angegebenen Grenzwert verschieben.

Hinweis

Wenn die MinExtra Eigenschaft auf einen negativen Wert festgelegt ist, wird der Eigenschaftswert auf 0 zurückgesetzt.

Weitere Informationen

• MinSize