Splitter-Klasse

Artikel
08/20/2007

Stellt ein Splittersteuerelement dar, mit dessen Hilfe der Benutzer die Größe angedockter Steuerelemente ändern kann. Splitter wurde ersetzt durch 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
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class Splitter
    Inherits Control
'Usage
Dim instance As Splitter

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class Splitter : Control

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class Splitter : public Control

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class Splitter extends Control

ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class Splitter extends Control

Hinweise

Mit dem Splitter-Steuerelement können Benutzer zur Laufzeit die Größe von Steuerelementen ändern, die an die Ränder des Splitter-Steuerelements angedockt sind. Wenn der Benutzer den Mauszeiger über das Splitter-Steuerelement bewegt, verändert sich der Cursor, um anzuzeigen, dass die Größe der an das Splitter-Steuerelement angedockten Steuerelemente geändert werden kann. Mit dem Splitter-Steuerelement kann der Benutzer die Größe des angedockten Steuerelements ändern, das sich in der Andockreihenfolge direkt davor befindet. Damit der Benutzer die Größe eines angedockten Steuerelements ändern kann, docken Sie daher das Steuerelememt, dessen Größe geändert werden soll, an den Rand eines Containers an, und docken Sie dann ein Aufteilungselement auf der gleichen Seite des Containers an. Um z. B. ein dem Windows Explorer ähnliches Fenster zu erstellen, fügen Sie einem Formular ein TreeView-Steuerelement hinzu und legen dessen Dock-Eigenschaft auf DockStyle.Left fest. Fügen Sie dem Formular ein Splitter-Steuerelement hinzu, und legen Sie dessen Dock-Eigenschaft ebenfalls auf DockStyle.Left fest. Zum Vervollständigen des Formularlayouts fügen Sie ein ListView-Steuerelement hinzu und legen dessen Dock-Eigenschaft auf DockStyle.Fill fest, damit der verbleibende Platz im Formular von der ListView eingenommen wird. Der Benutzer kann dann zur Laufzeit die Breite des TreeView-Steuerelements (und auch die des ListView-Steuerelements) durch Verschieben des Splitter-Steuerelements ändern.

Verwenden Sie die MinExtra-Eigenschaft und die MinSize-Eigenschaft, um sicherzustellen, dass mit dem Splitter-Steuerelement die Größe von angedockten Steuerelementen nicht so sehr geändert wird, dass der Benutzer sie nicht mehr verwenden kann. Die MinExtra-Eigenschaft und die MinSize-Eigenschaft bestimmen die minimale Größe für links und rechts angedockte Steuerelemente (bzw. oben und unten bei horizontalen Splitter-Steuerelementen). Wenn die anderen Steuerelemente in dem Formular, an das das Splitter-Steuerelement angedockt ist, eine bestimmte Rahmenart anzeigen, können Sie die BorderStyle-Eigenschaft verwenden, um die Rahmenart der daran angedockten Steuerelemente anzupassen.

Möglicherweise empfiehlt sich das Festlegen einer maximalen Größe für Steuerelemente, an die das Splitter-Steuerelement angedockt ist. Mit dem SplitterMoved-Ereignis und dem SplitterMoving-Ereignis können Sie ermitteln, wann ein Benutzer die Größe eines angedockten Steuerelements ändert. Sie können die SplitPosition-Eigenschaft in einem Ereignishandler für das SplitterMoved-Ereignis oder das SplitterMoving-Ereignis verwenden, um die Größe des Steuerelements zu bestimmen, an das das Splitter-Steuerelement angedockt ist, und Sie können die SplitPosition-Eigenschaft auf einen anderen Wert festlegen, um die Breite des angedockten Steuerelements auf eine bestimmte maximale Breite (bzw. eine maximale Höhe bei horizontal ausgerichteten Splitter-Steuerelementen) zu beschränken.

Hinweis

Wenn die Größe eines Steuerelements durch ein Splitter-Steuerelement geändert werden soll, muss hierzu die Maus verwendet werden. Es ist nicht möglich, mit der Tastatur auf das Splitter-Steuerelement zuzugreifen.

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

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
        System.Windows.Forms.Splitter

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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-Klasse

Syntax

Hinweise

Beispiel

Vererbungshierarchie

Threadsicherheit

Plattformen

Versionsinformationen

.NET Framework

.NET Compact Framework

Siehe auch

Referenz

Zusätzliche Ressourcen