Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Thema werden Informationen zum ToolStrip Steuerelement und zu den Klassen zusammengefasst, die die Verwendung unterstützen.
Das ToolStrip Steuerelement und die zugehörigen Klassen bieten eine vollständige Lösung zum Erstellen von Symbolleisten, Statusleisten und Menüs.
Namensräume
Hintergrund
Mit dem ToolStrip Steuerelement und den zugehörigen Klassen können Sie erweiterte Symbolleistenfunktionen erstellen, die ein einheitliches und professionelles Aussehen und Verhalten aufweisen. Das ToolStrip Steuerelement und die Klassen bieten die folgenden Verbesserungen gegenüber vorherigen Steuerelementen:
Ein konsistentes Ereignismodell.
Ein mehr konsistentes Designzeitverhalten, das Aufgabenlisten und Itemsammlungs-Editoren enthält.
Benutzerdefiniertes Rendering mit
ToolStripManagerundToolStripRenderer.Integriertes Rafting (Freigabe des horizontalen oder vertikalen Raums innerhalb des Werkzeugbereichs, wenn angedockt) mit
ToolStripContainerundToolStripPanel.Entwurfszeit und Laufzeit neu anordnen von Elementen mit der AllowItemReorder Eigenschaft.
Verlagerung von Elementen in ein Überlaufmenü mit der CanOverflow Eigenschaft.
Vollständig konfigurierbare Steuerungsposition mit dem
ToolStripContainer,ToolStripPanel, undToolStripContentPanel.Hosting von
ToolStrip, herkömmlichen oder benutzerdefinierten Steuerelementen mithilfe vonToolStripControlHost.Zusammenführen von
ToolStripSteuerelementen mitToolStripPanel.
ToolStrip ist die erweiterbare Basisklasse für MenuStrip, ContextMenuStripund StatusStrip. Diese Steuerungselemente sind ToolStripItem Container, die gängiges Verhalten und die Ereignisbehandlung erben und erweitert werden, sodass jede Implementierung das dafür geeignete Verhalten verarbeitet. Steuerelemente, die von ToolStripItem abgeleitet werden, sind in der folgenden Tabelle aufgeführt. Die Basisklasse ToolStrip behandelt Zeichen-, Benutzereingabe- und Drag-and-Drop-Ereignisse für diese Steuerelemente.
Die ToolStripSteuerelemente , MenuStrip, ContextMenuStripund StatusStrip Steuerelemente ersetzen die vorherigen Symbolleisten-, Menü-, Kontextmenü- und Statusleisten-Steuerelemente, obwohl diese Steuerelemente aus Gründen der Abwärtskompatibilität beibehalten werden.
ToolStrip-Klassen auf einen Blick
In der folgenden Tabelle sind die ToolStrip-Klassen nach Technologiebereich gruppiert.
| Technologiebereich | Klasse |
|---|---|
| Symbolleisten, Status- und Menücontainer | ToolStrip MenuStrip ContextMenuStrip StatusStrip ToolStripDropDownMenu |
| ToolStrip-Elemente | ToolStripLabel ToolStripDropDownItem ToolStripMenuItem ToolStripButton ToolStripStatusLabel ToolStripSeparator ToolStripControlHost ToolStripComboBox ToolStripTextBox ToolStripProgressBar ToolStripDropDownButton ToolStripSplitButton |
| Standort | ToolStripContainer ToolStripContentPanel ToolStripPanel |
| Präsentation und Rendering | ToolStripManager ToolStripRenderer ToolStripProfessionalRenderer ToolStripRenderMode ToolStripManagerRenderMode |
ToolStrip Design-Time Funktionen
Die ToolStrip Steuerelementfamilie bietet eine umfangreiche Sammlung von Tools und Vorlagen für die direkte Bearbeitung und Definition der Grundlage der Benutzeroberfläche, sodass Sie schnell eine funktionierende Anwendung erstellen können.
Aufgabendialogfelder
In Visual Studio zeigt das Klicken auf das Smarttag in einem Steuerelement im Designer eine Aufgabenliste an, um bequem auf viele häufig verwendete Befehle zuzugreifen.
Elemente-Sammlungseditoren
Wenn Sie in Visual Studio auf " Elemente bearbeiten" in der Aufgabenliste klicken oder mit der rechten Maustaste auf das Steuerelement klicken und im Kontextmenü " Elemente bearbeiten" auswählen, wird der Sammlungs-Editor für das Steuerelement angezeigt. Mit Sammlungs-Editoren können Sie Elemente hinzufügen, entfernen und neu anordnen, die das Steuerelement enthält. Sie können auch die Eigenschaften für das Steuerelement und die Elemente des Steuerelements anzeigen und ändern.
Hosting-Kontrollen
Die ToolStripControlHost Klasse stellt integrierte Wrapper für ToolStripComboBox, ToolStripTextBoxund ToolStripProgressBar Steuerelemente bereit. Sie können auch jedes andere vorhandene oder COM-Steuerelement in einem ToolStripControlHosthosten.
Ein Beispiel für Steuerelementhosting finden Sie unter How to: Wrap a Windows Forms Control with ToolStripControlHost.
Darstellung
ToolStrip Klassen implementieren ein Renderingschema, das sich erheblich von anderen Windows Forms-Steuerelementen unterscheidet. Mit diesem Schema können Sie Formatvorlagen und Designs ganz einfach anwenden.
Wenn Sie eine Formatvorlage auf ein ToolStrip und alle darin enthaltenen ToolStripItem-Objekte anwenden möchten, müssen Sie nicht das Paint-Ereignis für jedes Element behandeln. Stattdessen können Sie die RenderMode Eigenschaft auf einen der Werte von ToolStripRenderMode setzen, außer Custom. Alternativ können Sie Renderer direkt auf eine beliebige Klasse setzen, die von der ToolStripRenderer Klasse erbt. Durch das Festlegen dieser Eigenschaft wird automatisch die RenderMode eingestellt.
Sie können dieselbe Formatvorlage auf mehrere ToolStrip Objekte in derselben Anwendung anwenden, indem Sie die RenderMode auf ManagerRenderMode setzen und die RenderMode- oder Renderer-Eigenschaft auf den gewünschten Wert ToolStripManagerRenderMode bzw. ToolStripRenderer festlegen.
Beispiele für das Rendern finden Sie unter How to: Create and Set a Custom Renderer for the ToolStrip Control in Windows Forms.
Stile und Themen
ToolStrip und zugeordnete Klassen bieten eine einfache Möglichkeit, visuelle Stile und benutzerdefinierte Darstellungen zu unterstützen, die keine Außerkraftsetzung der OnPaint Methoden für jedes Element erfordern. Verwenden Sie die DisplayStyle, die RenderMode und die Renderer Eigenschaften.
Rafting und Docking
Sie können Steuerungen als Raft montieren, docken oder absolut positionieren ToolStrip. Die ToolStrip Elemente werden durch den LayoutEngine des Containers angeordnet.
Rafting ist die Fähigkeit von Symbolleisten, horizontalen oder vertikalen Raum zu teilen. Ein Windows-Formular kann über ToolStripContainer verfügen, das wiederum Bereiche auf der linken, rechten, oberen und unteren Seite des Formulars hat, um ToolStrip-, MenuStrip- und StatusStrip-Steuerelemente zu positionieren und zu verwalten. Mehrere ToolStrip Steuerelemente stapeln sich vertikal, wenn Sie sie in die linke oder rechte ToolStripContainer einfügen. Sie stapeln sich horizontal, wenn Sie sie oben oder unten ToolStripContainer platzieren. Sie können das zentrale ToolStripContentPanel des ToolStripContainer verwenden, um herkömmliche Steuerelemente auf dem Formular zu positionieren.
Jedes oder alle ToolStripContainer Steuerelemente können zur Entwurfszeit direkt ausgewählt und gelöscht werden. Ein ToolStripContainer ist erweiterbar und reduzierbar und passt sich der Größe der darin enthaltenen Steuerelemente an.
Andocken ist die Angabe der einfachen Position eines Steuerelements auf der linken, rechten, oberen oder unteren Seite des Formulars.
Der Vorteil des Raftings gegenüber dem Andocken besteht darin, dass ToolStrip, MenuStrip und StatusStrip Steuerelemente horizontalen oder vertikalen Raum mit anderen Steuerelementen teilen können.
Die meisten ToolStrip-Steuerelemente können wie andere Steuerelemente an das Formular angedockt werden, anstatt Rafting zu verwenden. Sie können auch angeben, dass ein ToolStrip Steuerelement frei auf dem Formular positioniert werden kann, indem Sie es aus seinem ToolStripContainer entfernen und seine Dock Eigenschaft auf None festlegen, oder Sie können seine absolute Position angeben, indem Sie die jeweilige Location Eigenschaft festlegen. Siehe Vorgehensweise: Verschieben eines ToolStrips aus einem ToolStripContainer auf ein Formular.
Verwenden Sie ein ToolStripPanel oder mehrere Steuerelemente für mehr Flexibilität, insbesondere für MDI-Anwendungen (Multiple Document Interface) oder wenn Sie kein ToolStripContainer benötigen. Ein ToolStripPanel bietet einen andockbaren Platz zum Auffinden und Anordnen von ToolStrip Steuerelementen, jedoch nicht für herkömmliche Steuerelemente. Standardmäßig wird die ToolStripPanel nicht im Toolbox angezeigt, Sie können sie jedoch dort hinzufügen, indem Sie mit der rechten Maustaste auf die Toolbox klicken und dann auf Elemente auswählen klicken. Sie können auch programmgesteuert auf die ToolStripPanel wie jede andere Klasse zugreifen.
Die ToolStrip, MenuStrip und StatusStrip lassen Elemente überlaufen. Dies ähnelt dem Verhalten dieser Elemente auf Microsoft Office-Symbolleisten.
Siehe auch
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
.NET Desktop feedback