Splitter.MinSize Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

Splitter.cs

Ruft den Mindestabstand ab, der zwischen dem Splitter-Steuerelement und dem Containerrand verbleiben muss, an den das Steuerelement angedockt ist, oder legt diesen fest. MinSize wurde ersetzt Panel1MinSize und Panel2MinSize wird nur zur Kompatibilität mit früheren Versionen bereitgestellt.

public:
 property int MinSize { int get(); void set(int value); };

public int MinSize { get; set; }

member this.MinSize : int with get, set

Public Property MinSize As Integer

Eigenschaftswert

Int32

Der mindeste Abstand in Pixeln zwischen dem Splitter Steuerelement und dem Containerrand, an den das Steuerelement angedockt ist. Der Standardwert ist 25.

Beispiele

Im folgenden Codebeispiel wird ein Splitter Steuerelement in Kombination mit TreeView und ListView Steuerelementen verwendet, um ein Fenster zu erstellen, das dem Windows-Explorer ähnelt. Um die TreeView Steuerelemente zu ListView identifizieren, werden Knoten und Elemente beiden Steuerelementen hinzugefügt. Im Beispiel werden die MinExtra Eigenschaften und MinSize Eigenschaften des Splitter Steuerelements verwendet, um zu verhindern, dass die TreeViewListView Größe des Steuerelements zu klein oder zu groß ist. Dieses Beispiel erfordert, dass die in diesem Beispiel erstellte Methode in einer Form definiert ist und dass die Methode vom Konstruktor der .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

Hinweise

Bei einem horizontalen Splitter Steuerelement (ein Splitter Steuerelement, das an den oberen oder unteren Rand eines Containers angedockt ist) ist dieser Wert die Mindesthöhe des größenveränderbaren Steuerelements. Bei einem vertikalen Splitter Steuerelement (ein Splitter Steuerelement, das links oder rechts neben einem Container verankert ist) ist dieser Wert die Mindestbreite des größenveränderbaren Steuerelements. Der Benutzer kann den Splitter nicht über den von dieser Eigenschaft angegebenen Grenzwert verschieben.

Hinweis

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

Weitere Informationen

• MinExtra