Übersicht über das SplitContainer-Steuerelement (Windows Forms)

  • Artikel

Das SplitContainer-Steuerelement in Windows Forms kann als zusammengesetztes Steuerelement betrachtet werden. Es setzt sich aus zwei Bereichen zusammen, die durch eine verschiebbare Leiste getrennt sind. Wenn sich der Mauszeiger über der Leiste befindet, ändert sich seine Form und zeigt an, dass die Leiste verschiebbar ist.

Wichtig

In der Toolbox ersetzt das SplitContainer-Steuerelement das Splitter-Steuerelement aus der Vorgängerversion von Visual Studio. Das SplitContainer-Steuerelement ist dem Splitter-Steuerelement vorzuziehen. Die Splitter-Klasse ist aus Gründen der Kompatibilität mit vorhandenen Anwendungen weiterhin in .NET Framework enthalten. Bei neuen Projekten wird jedoch ausdrücklich die Verwendung des SplitContainer-Steuerelements empfohlen.

Mit dem SplitContainer-Steuerelement können Sie komplexe Benutzeroberflächen erstellen. Häufig bestimmt die Auswahl in einem Fensterbereich, welche Objekte im anderen Fensterbereich angezeigt werden. Diese Anordnung eignet sich sehr gut für die Anzeige und das Durchsuchen von Informationen. Die beiden Fensterbereiche ermöglichen Ihnen, Informationen in getrennten Bereichen anzuordnen, und mithilfe der Leiste, die auch als „Splitter“ bezeichnet wird, können Benutzer die Größe der Fensterbereiche leicht anpassen.

Mehrere SplitContainer-Steuerelemente können auch geschachtelt werden, wobei das zweite SplitContainer-Steuerelement horizontal ausgerichtet ist, um einen oberen und einen unteren Panel zu erstellen.

Beachten Sie, dass auf das SplitContainer-Steuerelement standardmäßig über die Tastatur zugegriffen werden kann. Benutzer*innen können die Pfeiltasten drücken, um den Splitter zu verschieben, wenn die IsSplitterFixed-Eigenschaft auf false festgelegt ist.

Die Orientation-Eigenschaft des SplitContainer-Steuerelements bestimmt die Richtung des Splitters, nicht die des Steuerelements selbst. Wenn diese Eigenschaft daher auf Vertical festgelegt ist, ist der Splitter von oben nach unten ausgerichtet und erstellt damit links und rechts Panels.

Beachten Sie außerdem, dass der Wert der SplitterRectangle-Eigenschaft je nach Wert der Orientation-Eigenschaft variiert. Weitere Informationen finden Sie unter der SplitterRectangle-Eigenschaft.

Sie können auch die Größe und Bewegung des SplitContainer-Steuerelements einschränken. Die FixedPanel-Eigenschaft bestimmt, welches Panel bei einer Änderung der Größe des SplitContainer-Steuerelements unverändert bleibt, und die IsSplitterFixed-Eigenschaft bestimmt, ob der Splitter über die Tastatur oder Maus bewegt werden kann.

Hinweis

Auch wenn die IsSplitterFixed-Eigenschaft auf true festgelegt ist, kann der Splitter programmgesteuert verschoben werden, z. B. mithilfe der SplitterDistance-Eigenschaft.

Schließlich verfügt jeder Panel des SplitContainer-Steuerelements über Eigenschaften, um seine Größe zu bestimmen.

Häufig verwendete Eigenschaften, Methoden und Ereignisse

Name Beschreibung
FixedPanel-Eigenschaft Bestimmt, welches Panel des Steuerelements bei einer Änderung der Größe des SplitContainer-Steuerelements unverändert bleibt.
IsSplitterFixed-Eigenschaft Bestimmt, ob der Splitter mit der Tastatur oder Maus verschoben werden kann.
Orientation-Eigenschaft Bestimmt, ob der Splitter vertikal oder horizontal ausgerichtet ist.
SplitterDistance-Eigenschaft Bestimmt den Abstand in Pixeln vom linken oder oberen Rand bis zum beweglichen Splitter.
SplitterIncrement-Eigenschaft Bestimmt den Mindestabstand in Pixeln, um den der Splitter von Benutzer*innen verschoben werden kann.
SplitterWidth-Eigenschaft Bestimmt die Dicke des Splitters in Pixeln.
SplitterMoving -Ereignis Tritt ein, wenn der Splitter verschoben wird.
SplitterMoved -Ereignis Tritt ein, nachdem der Splitter verschoben wurde.

Weitere Informationen