Splitter.MinExtra-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property MinExtra As Integer
'Usage
Dim instance As Splitter
Dim value As Integer

value = instance.MinExtra

instance.MinExtra = value

[LocalizableAttribute(true)] 
public int MinExtra { get; set; }

[LocalizableAttribute(true)] 
public:
property int MinExtra {
    int get ();
    void set (int value);
}

/** @property */
public int get_MinExtra ()

/** @property */
public void set_MinExtra (int value)

public function get MinExtra () : int

public function set MinExtra (value : int)

Eigenschaftenwert

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 Standardwert ist 25.

Hinweise

Für ein horizontales Splitter-Steuerelement (ein am oberen oder unteren Rand eines Containers angedocktes Splitter-Steuerelement) wird als Mindesthöhe des für nicht angedockte Steuerelemente reservierten Containerbereichs der oben angegebene Wert abzüglich der Höhe des Splitter-Steuerelements verwendet. Für ein vertikales Splitter-Steuerelement (ein am linken oder rechten Rand eines Containers angedocktes Splitter-Steuerelement) wird als Mindestbreite des für nicht angedockte Steuerelemente reservierten Containerbereichs der oben angegebene Wert abzüglich der Breite des Splitter-Steuerelements verwendet. Der Benutzer kann den Splitter nicht über die durch diese Eigenschaft angegebene Grenze hinaus verschieben.

Hinweis

Wenn die MinExtra-Eigenschaft auf einen negativen Wert festgelegt ist, wird der Eigenschaftenwert auf 0 (null) zurückgesetzt.

Beispiel

Im folgenden Codebeispiel wird ein Splitter-Steuerelement in Verbindung mit einem TreeView-Steuerelement und einem ListView-Steuerelement verwendet, um ein dem Windows Explorer ähnliches Fenster zu erstellen. Um das TreeView-Steuerelement und das ListView-Steuerelement zu bezeichnen, werden beiden Steuerelementen Knoten und Elemente hinzugefügt. Im Beispiel werden die MinExtra-Eigenschaft und die MinSize-Eigenschaft von Splitter verwendet, um zu verhindern, dass das TreeView-Steuerelements oder das ListView-Steuerelements zu stark vergrößert oder verkleinert werden. Für dieses Beispiel ist es erforderlich, dass die im Beispiel erstellte Methode in einem Form definiert ist und die Methode über den Konstruktor des Form aufgerufen wird.

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 'CreateMySplitControls

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:
   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.set_Dock(DockStyle.Left);
    // Set the Splitter to dock to the left side of the TreeView control.
    splitter1.set_Dock(DockStyle.Left);
    // Set the minimum size the ListView control can be sized to.
    splitter1.set_MinExtra(100);
    // Set the minimum size the TreeView control can be sized to.
    splitter1.set_MinSize(75);
    // Set the ListView control to fill the remaining space on the form.
    listView1.set_Dock(DockStyle.Fill);
    // Add a TreeView and a ListView item to identify the controls on the 
    // form.
    treeView1.get_Nodes().Add("TreeView Node");
    listView1.get_Items().Add("ListView Item");
    // Add the controls in reverse order to the form to ensure proper 
    // location.
    this.get_Controls().AddRange(new Control[] { listView1, splitter1, 
        treeView1 });
} //CreateMySplitControls

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Freigeben über

Splitter.MinExtra-Eigenschaft

Syntax

Eigenschaftenwert

Hinweise

Beispiel

Plattformen

Versionsinformationen

.NET Framework

.NET Compact Framework

Siehe auch

Referenz

Zusätzliche Ressourcen